跳到主要内容

申请自动签署

此端点用于为已审核通过的发行人申请启用自动签署。在同一次调用中，QI Tech 生成加入协议并开启签署信封，因此响应返回时启用即已处于待签署状态。

完整的流程衔接请参阅自动签署流程。

发行人已审核通过

仅当发行人登记处于 approved 状态且客户已开通自动签署时，申请才会被接受。不存在自动创建 — 在调用此端点之前不会发生任何事情。

申请自动签署 (POST)​

Request​

ENDPOINT
/issuer_management/issuer/ISSUER-KEY/auto_signature
MÉTODO
POST

Path Params​

字段类型描述字符数
ISSUER-KEYstring发行人的唯一键（UUID v4）。36

Request Body​

此端点不接收请求体。签署人组与加入协议模板由 QI Tech 根据发行人登记信息和客户配置确定。

Response​

STATUS
201
Response Body
{
  "issuer_auto_signature_key": "9c3f0f1e-6a2b-4c58-9c9c-0f6b1d2a7e34",
  "status": "pending_signature",
  "signed_at": null,
  "enabled_at": null,
  "issuer_key": "07b1ac01-5fc4-475f-930b-19595f24bc1e",
  "term_document_key": "07b1ac01-5fc4-475f-930b-19595f24bc1e/adhesion_auto_signature_term/5d1c8b30-2f44-4a9e-8c7b-1e0a6f2d9b55",
  "envelope_key": "5b930d3d-3713-4c42-85d5-f8e9e44e30ce",
  "created_at": "2026-02-10T09:15:44",
  "event_list": [
    {
      "event_type": "auto_signature_creation",
      "status": "pending_term_generation",
      "event_data": {
        "tenant_key": "5e3045af-8be8-4cbd-9aab-9e15c4e92154"
      },
      "created_at": "2026-02-10T09:15:44"
    },
    {
      "event_type": "adhesion_term_generation",
      "status": "pending_term_generation",
      "event_data": {
        "term_document_key": "07b1ac01-5fc4-475f-930b-19595f24bc1e/adhesion_auto_signature_term/5d1c8b30-2f44-4a9e-8c7b-1e0a6f2d9b55",
        "template_key": "b71f1a2c-9e44-4c1d-8f3a-6d2c0b5e7a19"
      },
      "created_at": "2026-02-10T09:15:46"
    },
    {
      "event_type": "envelope_creation",
      "status": "pending_signature",
      "event_data": {
        "envelope_key": "5b930d3d-3713-4c42-85d5-f8e9e44e30ce"
      },
      "created_at": "2026-02-10T09:15:47"
    }
  ]
}

响应与自动签署查询返回的对象相同，通常已处于 pending_signature，并已填充 term_document_key 与 envelope_key。随后请查询签署链接，获取每位签署人的链接。

错误​

HTTP代码触发条件
400ISS0000032 (IssuerNotApproved)发行人不处于 approved 状态。
400ISS0000033 (AutoSignatureNotEnabledForTenant)客户未开通自动签署。
403ISS000011 (TenantForbidden)客户对所指定发行人的登记信息不具备完整访问权限。
404ISS000009 (IssuerNotFound)不存在与所给键对应的发行人。
404ISS0000026 (TenantConfigurationNotFound)客户未登记自动签署配置。
409ISS0000029 (AutoSignatureAlreadyExists)发行人已有一个处于 pending_signature 或 enabled 的有效自动签署。请先取消当前的自动签署，再申请新的。