Enviar Documentos Assinados da Operação

Este endpoint recebe as assinaturas dos documentos de formalização de operações com signature_method igual a client_side.

O emissor assina os documentos na certificadora dele e envia à QI Tech apenas o arquivo de assinatura (p7s_base64), sem o PDF.

Aviso

Use este endpoint apenas em operações com signature_method client_side. Nos fluxos QI Sign e CertifiQI os contratos são gerados e assinados pela própria plataforma. Para a ata de aprovação use o endpoint de envio de ata de aprovação.

---

Enviar Documento Assinado (POST)

Request

ENDPOINT

/commercial_paper/operation/OPERATION-KEY/upload_signed_document

MÉTODO

POST

Path Params

Campo	Tipo	Descrição	Caracteres
OPERATION-KEY	string	Chave única da operação (UUID v4).	36

---

Request Body

Assinatura do termo constitutivo

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

Assinatura de uma garantia

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

Request Body Params

Campo	Tipo	Descrição	Caracteres Máx.
contract_type *	string	Tipo do documento enviado.	Enumeradores contract_type
p7s_base64 *	string	Assinatura CAdES em base64, destacada ou anexada.	-
collateral_key	string	Chave da garantia a que a assinatura se refere. Obrigatório quando contract_type é collateral.	36

Enumeradores contract_type

Enum	Descrição
commercial_paper	Termo constitutivo da nota comercial.
adhesion_term	Termo de adesão da nota comercial.
collateral	Documento de garantia da operação. Exige collateral_key.

Response

O corpo da resposta é o JSON completo da operação atualizada.

---

Assinatura dos documentos de formalização

Os documentos ficam disponíveis para download depois que a operação é aprovada na análise, pelo endpoint de consulta de documentos da operação.

Cada documento aceita um único .p7s e é enviado em uma requisição própria. Quando todos os documentos exigidos são aceitos, os assinantes da QI Tech assinam e a operação é emitida.

Assine exatamente o documento baixado

A QI Tech compara o resumo (SHA-256) declarado dentro do .p7s com o do documento gerado na aprovação. Ferramentas que reprocessam o PDF antes de assinar, como reabrir e salvar ou recomprimir, alteram esse resumo e a assinatura é recusada com COM000074.

Erros

Os códigos abaixo estão descritos também no catálogo de erros.

Código	HTTP	Descrição
COM000072	400	O documento de formalização exige o arquivo de assinatura e o p7s_base64 não foi enviado.
COM000073	400	O arquivo enviado não pôde ser lido como estrutura CMS, ou excede o tamanho aceito.
COM000074	422	A assinatura não corresponde ao documento emitido pela QI Tech.
COM000075	409	O documento já teve uma assinatura aceita.