发行人自动签署

自动签署使 QI Tech 能够代表发行人自动签署此后各笔发行的文件 — 无需代表逐笔操作进行签署。

为此，发行人只需一次性签署一份自动签署加入协议。在该协议签署之前，发行仍按正常的人工签署流程进行。

按客户开通

自动签署默认不开通。它由 QI Tech 按客户（tenant）配置，包括所使用的加入协议模板。如需开通，请联系团队 suporte-dcm@qitech.com.br。

前提条件

前提条件	满足方式
客户已开通自动签署	由 QI Tech 配置，并配置加入协议模板
发行人登记已审核通过	正常的发行人资质审核流程
发行人拥有有效的签署人组	发行人签署人登记

发行人登记的签署人组正是签署加入协议的人员。如果在审核通过时该组为空或信息过时，请先更正登记再继续。

端到端流程

启用由集成方申请，且仅在发行人登记审核通过后才被接受。不存在自动创建：在提出申请之前，发行人不具备自动签署。

发行人审核通过。 登记经过正常的资质审核流程，直至状态变为 approved。此时不会创建任何内容。
申请启用。 集成方调用 POST /issuer_management/issuer/{issuer_key}/auto_signature。在同一次调用中，QI Tech 创建自动签署，根据为该客户配置的模板生成加入协议，并开启签署信封 — 与任何操作无关。响应状态即为 pending_signature，并带有 issuer_auto_signature_key 与 envelope_key。
签署协议。 集成方查询签署链接，并引导发行人的每一位签署人访问其专属链接。该协议在任何操作之外签署，可以在第一笔发行之前完成。
协议已签署。 所有必要的签署完成后，自动签署转为 enabled，并填充 signed_at 与 enabled_at 字段。随后 QI Tech 签发发行人的私有证书，用于签署各笔发行的文件。已签署的协议可通过已签署协议查询下载。
拒签或过期。 如果信封被拒签、取消或已过期，自动签署转为 reproved，发行将走人工签署流程。需要重新申请启用。

第 2、4、5 步会触发 webhook issuer_management.auto_signature_status_change — 即 pending_signature、enabled 与 reproved 状态。取消（canceled）不会产生 webhook，需通过查询观察。由于 pending_signature 已在申请的响应中返回，该状态的 webhook 对于调用该端点的一方是冗余的 — 它对同一 tenant 下的其他消费方有用。

不要假定自动签署已生效

申请会开启信封，但并未完成启用：协议仍需签署。只有在自动签署处于 enabled 之后，才可认为某笔发行可使用自动签署。在其他任何状态下，文件都将进入人工签署 — 集成必须同时处理这两条路径。

状态机

状态	含义	新发行的签署方式
`pending_term_generation`	申请过程中的过渡状态	人工
`pending_signature`	协议已生成并送签；签署人链接可用	人工
`enabled`	协议已签署；发行人已启用自动签署	自动
`reproved`	协议信封被拒签、取消或已过期	人工
`canceled`	自动签署已取消	人工

可能的状态转换：

pending_term_generation → pending_signature（均在申请过程中完成）→ enabled
pending_signature → reproved（信封被拒签、取消或已过期）
pending_term_generation 或 pending_signature → canceled

当发行人离开 approved 状态时 — 即转为 reproved、expired 或 canceled — 自动签署会被自动取消。此时需在登记重新审核通过后重新完成启用。

端点

端点	用途
`POST .../auto_signature`	为已审核通过的发行人申请启用
`GET .../auto_signature`	查询当前状态及事件历史
`GET .../auto_signature/signers`	获取协议每位签署人的签署链接
`GET .../auto_signature/report`	在自动签署处于 `enabled` 之后，下载已签署的加入协议

如何跟踪

有两种互为补充的方式：

Webhook — issuer_management.auto_signature_status_change 在 pending_signature、enabled 与 reproved 状态时发送。收到 pending_signature 时，请查询签署链接。
查询 — 自动签署查询返回当前状态及完整的事件历史。

摘要信息也会出现在发行人查询的 auto_signature 字段中：

{
    "issuer_key": "07b1ac01-5fc4-475f-930b-19595f24bc1e",
    "status": "approved",
    "auto_signature": {
        "issuer_auto_signature_key": "9c3f0f1e-6a2b-4c58-9c9c-0f6b1d2a7e34",
        "status": "enabled",
        "signed_at": "2026-02-11T14:02:31",
        "enabled_at": "2026-02-11T14:02:31"
    }
}

对于从未申请过自动签署的发行人，该字段为 null。

前提条件​

端到端流程​

状态机​

端点​

如何跟踪​

前提条件

端到端流程

状态机

端点

如何跟踪