Send Signed Operation Documents

This endpoint receives the signatures of the formalization documents of operations whose signature_method is client_side.

The issuer signs the documents at its own certificate authority and sends QI Tech only the signature file (p7s_base64), without the PDF.

Warning

Use this endpoint only for operations whose signature_method is client_side. In the QI Sign and CertifiQI flows the contracts are generated and signed by the platform itself. For the approval minutes use the approval minutes endpoint.

---

Send Signed Document (POST)

Request

ENDPOINT

/commercial_paper/operation/OPERATION-KEY/upload_signed_document

METHOD

POST

Path Params

Field	Type	Description	Characters
OPERATION-KEY	string	Unique key of the operation (UUID v4).	36

---

Request Body

Signature of the constitutive term

{
    "contract_type": "commercial_paper",
    "p7s_base64": "MIIJugYJKoZIhvcNAQcCoIIJqzCCCacC..."
}

Signature of a collateral

{
    "contract_type": "collateral",
    "collateral_key": "8f0b6f0a-1a2b-4c3d-9e8f-7a6b5c4d3e2f",
    "p7s_base64": "MIIJugYJKoZIhvcNAQcCoIIJqzCCCacC..."
}

Request Body Params

Field	Type	Description	Max. Characters
contract_type *	string	Type of the document being sent.	contract_type enumerators
p7s_base64 *	string	CAdES signature in base64, detached or attached.	-
collateral_key	string	Key of the collateral the signature refers to. Required when contract_type is collateral.	36

contract_type enumerators

Enum	Description
commercial_paper	Constitutive term of the commercial paper.
adhesion_term	Adhesion term of the commercial paper.
collateral	Collateral document of the operation. Requires collateral_key.

Response

The response body is the complete JSON of the updated operation.

---

Signature of the formalization documents

The documents become available for download once the operation is approved in the analysis, through the operation documents endpoint.

Each document accepts a single .p7s and is sent in its own request. Once every required document is accepted, the QI Tech signers sign and the operation is issued.

Sign exactly the document you downloaded

QI Tech compares the digest (SHA-256) declared inside the .p7s with the one of the document generated at approval. Tools that reprocess the PDF before signing, such as reopening and saving or recompressing, change that digest and the signature is rejected with COM000074.

Errors

The codes below are also described in the error catalogue.

Code	HTTP	Description
COM000072	400	The formalization document requires the signature file and p7s_base64 was not sent.
COM000073	400	The file could not be read as a CMS structure, or exceeds the accepted size.
COM000074	422	The signature does not match the document issued by QI Tech.
COM000075	409	The document already had a signature accepted.