跳到主要内容

提交操作的已签署文件

此端点用于接收 signature_method 为 client_side 的操作中形式化文件的签名。

发行方在自有认证机构签署文件，并且只向 QI Tech 提交签名文件（p7s_base64），不提交 PDF。

警告

此端点仅应用于 signature_method 为 client_side 的操作。在 QI Sign 和 CertifiQI 流程中，合同由平台自行生成并签署。批准会议纪要请使用**批准会议纪要提交端点**。

提交已签署文件 (POST)​

Request​

ENDPOINT
/commercial_paper/operation/OPERATION-KEY/upload_signed_document
方法
POST

Path Params​

字段类型描述字符数
OPERATION-KEYstring操作的唯一标识 (UUID v4)。36

Request Body​

设立条款的签名
{
    "contract_type": "commercial_paper",
    "p7s_base64": "MIIJugYJKoZIhvcNAQcCoIIJqzCCCacC..."
}
担保物的签名
{
    "contract_type": "collateral",
    "collateral_key": "8f0b6f0a-1a2b-4c3d-9e8f-7a6b5c4d3e2f",
    "p7s_base64": "MIIJugYJKoZIhvcNAQcCoIIJqzCCCacC..."
}

Request Body Params​

字段类型描述最大字符数
contract_type *string提交文件的类型。contract_type 枚举值
p7s_base64 *stringbase64 编码的 CAdES 签名，分离式或附加式均可。-
collateral_keystring签名所对应担保物的标识。当 contract_type 为 collateral 时必填。36

contract_type 枚举值​

枚举值描述
commercial_paper商业票据的设立条款。
adhesion_term商业票据的加入条款。
collateral操作的担保物文件。需要 collateral_key。

Response​

响应体为更新后操作的完整 JSON。

形式化文件的签署​

操作在分析中获批后，可通过**操作文件查询端点**下载这些文件。

每个文件只接受一个 .p7s，并需单独发起请求提交。所有必需文件均被接受后，QI Tech 的签署人完成签署，操作即可发行。

请严格签署下载到的文件

QI Tech 会将 .p7s 中声明的摘要（SHA-256）与获批时生成的文件摘要进行比对。在签署前重新处理 PDF 的工具，例如重新打开并保存或重新压缩，都会改变该摘要，签名将以 COM000074 被拒绝。

错误码​

以下错误码也记录在错误目录中。

错误码HTTP描述
COM000072400形式化文件需要签名文件，但未提交 p7s_base64。
COM000073400文件无法被解析为 CMS 结构，或超出允许的大小。
COM000074422签名与 QI Tech 出具的文件不匹配。
COM000075409该文件已有一个被接受的签名。