查询通过 QI SIGN 签署操作的链接

此端点允许通过操作的唯一键查询特定操作中所有通过 QI SIGN 进行签名的链接。

---

查询操作的签名链接 (GET)

Request

ENDPOINT

/commercial_paper/operation/OPERATION-KEY/signers

MÉTODO

GET

Path Params

字段	类型	描述	字符数
OPERATION-KEY	string	操作的唯一键（UUID v4）。	36

---

Response

STATUS

200

Response Body

{
    "envelope_key": "5b930d3d-3713-4c42-85d5-f8e9e44e30ce",
    "status": "pending_signature",
    "documents": [
        {
            "document_type": "adhesion_term",
            "signers": [
                {
                    "document_number": "145.736.070-56",
                    "signature_url": "https://sign.qitech.com.br/s/s2S33dD",
                    "name": "Emissor assinante",
                    "email": "emissor@qitech.com.br",
                    "status": "on_signature"
                },
                {
                    "document_number": "145.736.070-56",
                    "signature_url": "https://sign.qitech.com.br/s/s2S33dD",
                    "name": "Assinante QI CTVM",
                    "email": "dtvm@qitech.com.br",
                    "status": "on_signature"
                },
                {
                    "document_number": "145.736.070-56",
                    "signature_url": "https://sign.qitech.com.br/s/s2S33dD",
                    "name": "Assinante QI TECH",
                    "email": "qi@qitech.com.br",
                    "status": "on_signature"
                }
            ]
        },
        {
            "document_type": "ncom_pre_price",
            "signers": [
                {
                    "document_number": "145.736.070-56",
                    "signature_url": "https://sign.qitech.com.br/s/s2S33dD",
                    "name": "Assinante QI TECH",
                    "email": "qi@qitech.com.br",
                    "status": "on_signature"
                },
                {
                    "document_number": "145.736.070-56",
                    "signature_url": "https://sign.qitech.com.br/s/s2S33dD",
                    "name": "Emissor assinante",
                    "email": "emissor@qitech.com.br",
                    "status": "on_signature"
                },
                {
                    "document_number": "145.736.070-56",
                    "signature_url": "https://sign.qitech.com.br/s/s2S33dD",
                    "name": "Assinante QI CTVM",
                    "email": "dtvm@qitech.com.br",
                    "status": "on_signature"
                }
            ]
        }
    ]
}

Response Body Params

字段	类型	描述	最大字符数
envelope_key	string	信封的唯一键（UUID v4）。	36
status	string	信封的状态。	operation-status 枚举
documents	list	信封中的文件列表。	-

document 对象

字段	类型	描述	最大字符数
document_type	string	文件类型。	document type 枚举
signers	list	签名人列表。	-

signer 对象

字段	类型	描述	最大字符数
document_number	string	签名人的证件号码。	18
signature_url	string	签名人的签名链接。	-
status	string	签名人的状态。	status 枚举
name	string	签名人姓名。	-
email	string	签名人电子邮件。	-

operation-status 枚举

枚举值	描述
waiting_signature	等待相关方签名。
signed	签名完成。
signature_rejected	签名被拒绝。
canceled	操作已取消。

status 枚举

枚举值	描述
on_signature	等待相关方签名。
analyzed	通过 API 完成签名。
signed	签名完成。
signature_rejected	签名被拒绝。
canceled	操作已取消。
created	签名已创建。
submitted	已发送给签名人。
sending_sign_receipt	正在发送简化签名档案。
analyzing	签名人正在分析中。
completed	签名完成。
expired	签名已过期。
removed	签名人已移除。
failed_waiting_for_manual_fix	签名创建失败，需要 QI 人工处理。

document-type 枚举

枚举值	描述
contract	合同标识符。
ncom_pre_price	商业票据 Pre price。
ncom_pre_price_days	商业票据 Pre price days。
ncom_pre_sac	商业票据 Pre sac。
ncom_post_sac_cdi	与 CDI 挂钩的 Pós sac 商业票据。
ncom_post_sac_ipca	与 IPCA 挂钩的 Pós sac 商业票据。
ncom_post_sac_igpm	与 IGP-M 挂钩的 Pós sac 商业票据。
ncom_post_price_cdi	与 CDI 挂钩的 Pós price 商业票据。
ncom_post_price_ipca	与 IPCA 挂钩的 Pós price 商业票据。
ncom_post_price_igpm	与 IGP-M 挂钩的 Pós price 商业票据。
ncom_post_price_days_cdi	与 CDI 挂钩的 Pós price days 商业票据。
ncom_post_price_days_ipca	与 IPCA 挂钩的 Pós price days 商业票据。
ncom_post_price_days_igpm	与 IGP-M 挂钩的 Pós price days 商业票据。
subscription_note	认购公告。
adhesion_term	加入条款。