跳到主要内容

客户接受日志上传

此端点用于向一笔操作附加一份包含客户接受日志的 PDF — 即最终客户已接受该操作条件的证据记录。该端点服务于自动签署流程：当 QI Tech 使用在 CertifiQI 中放行的私有证书代发行人签署 Termo Constitutivo 时，不会为客户生成任何签署链接，客户的同意即由接受日志来记录。

上传为可选项

上传不是必需的，发行流程的任何环节都不依赖它。即使没有接受日志，操作也会正常进入审核、签署和发行 — 该文件仅作为附加在操作上的证据保存。

要求发行人已开通自动签署

只有当操作的发行人在发行人系统中的自动签署开通状态为 enabled 时，才会接受上传。未开通的发行人，或开通状态为其他任意值（pending_term_generation、pending_signature、reproved、canceled）的发行人，请求会以 COM000077 被拒绝，且不会存储任何内容。

此外，只有当操作处于 in_filling 状态时才接受上传；不在该状态时，请求会以 COM000010 被拒绝。

客户接受日志上传 (POST)​

Request​

ENDPOINT
/commercial_paper/operation/OPERATION-KEY/acceptance_log
MÉTODO
POST

Path Params​

字段类型描述最大字符数
OPERATION-KEY *string操作的唯一键（UUID v4）。36
Request Body
{
    "document_base64": "JVBERi0xLjQKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwo..."
}

Request Body Params​

请求体不接受除下列字段以外的任何字段（additionalProperties: false） — 含有未知字段或缺少 document_base64 时返回 QIT000001。

字段类型描述最大字符数
document_base64 *string客户接受日志的 PDF，采用 base64 编码，不含 data: 前缀，不含换行符。—

Response​

STATUS
201
Response Body
{
    "document_key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "operation_key": "a846cc4a-b542-4f66-9823-b6d5458bd127",
    "created_at": "2026-09-10T14:30:00.000000+00:00"
}

Response Body Params​

字段类型描述
document_key *string本次上传生成的文件唯一键（UUID v4）。
operation_key *string该文件所附加操作的唯一键。
created_at *string上传的日期与时间，UTC 时区。
如何确认已附加的内容

该操作会在按键值查询操作中开始返回 acceptance_log_document_key 字段，其取值来自最近一次上传。首次上传之前，该字段返回 null。

再次上传会替换此前的文件

对同一笔操作再次上传会生成新的 document_key，并成为当前生效的接受日志 — 此前的引用不再被该操作指向。不支持部分更新，也没有删除端点。

错误​

以下错误代码同样记录在错误目录中。

错误代码HTTP描述
QIT000001400Schema 校验失败 — document_base64 缺失或请求体中含有未知字段。
COM000010400操作不处于 in_filling 状态，无法更新。
COM000077400该操作的发行人未开通自动签署。
COM000007404未找到该操作。
COM000008403该操作不属于发起请求的 tenant。