Envio do log de aceite do cliente

Este endpoint anexa à operação um PDF com o log de aceite do cliente — o registro das evidências de que o cliente final aceitou as condições da operação. Ele existe para o fluxo de auto-assinatura: quando a QI Tech assina o Termo Constitutivo em nome do emissor com o certificado privado liberado na CertifiQI, nenhum link de assinatura é gerado para o cliente, e o log de aceite é o que documenta o consentimento dele.

Envio opcional

O envio não é obrigatório e nenhuma etapa da emissão depende dele. A operação segue para análise, assinatura e emissão normalmente sem o log de aceite — o documento é guardado como evidência anexada à operação.

Exige emissor com auto-assinatura habilitada

O envio só é aceito quando o emissor da operação tem a habilitação de auto-assinatura em enabled no sistema de emissores. Emissor sem habilitação, ou com habilitação em qualquer outro status (pending_term_generation, pending_signature, reproved, canceled), é recusado com COM000077 e nada é armazenado.

O envio também só é aceito enquanto a operação está no status in_filling; fora desse status a requisição é recusada com COM000010.

---

Envio do log de aceite (POST)

Request

ENDPOINT

/commercial_paper/operation/OPERATION-KEY/acceptance_log

MÉTODO

POST

Path Params

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

Request Body

{
    "document_base64": "JVBERi0xLjQKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwo..."
}

Request Body Params

O corpo não aceita campos além do listado (additionalProperties: false) — um campo desconhecido, ou a ausência de document_base64, retorna QIT000001.

Campo	Tipo	Descrição	Caracteres Máx.
document_base64 *	string	PDF do log de aceite do cliente, codificado em base64, sem prefixo data: e sem quebras de linha.	—

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

Campo	Tipo	Descrição
document_key *	string	Chave única do documento gerada neste envio (UUID v4).
operation_key *	string	Chave única da operação à qual o documento foi anexado.
created_at *	string	Data e hora do envio, em UTC.

Como conferir o que ficou anexado

A operação passa a expor o campo acceptance_log_document_key na consulta de operação por chave, preenchido a partir do envio mais recente. Antes do primeiro envio o campo retorna null.

Reenvio substitui o documento anterior

Um novo envio para a mesma operação gera um novo document_key e passa a ser o log de aceite vigente — a referência anterior deixa de ser apontada pela operação. Não há atualização parcial e não há endpoint de remoção.

---

Erros

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

Código	HTTP	Descrição
QIT000001	400	Falha de schema — document_base64 ausente ou campo desconhecido no corpo.
COM000010	400	Operação não pode ser atualizada fora do status in_filling.
COM000077	400	Emissor da operação não está habilitado para auto-assinatura.
COM000007	404	Operação não encontrada.
COM000008	403	Operação não pertence ao tenant solicitante.