Aditamento

Visão geral

Aditamento é o processo de alterar as condições de um título já emitido. Depois que a Nota Comercial foi assinada e emitida, qualquer mudança nas condições pactuadas — repactuar o fluxo de pagamento, substituir uma garantia, incluir ou remover um avalista, corrigir o número da emissão — precisa ser formalizada em um termo aditivo assinado pelas partes.

A QI Tech recebe esse pedido via API, valida a elegibilidade do título, calcula o novo fluxo, gera o termo aditivo, cobra a taxa do serviço, coleta as assinaturas e só então aplica as alterações no título. O resultado é um evento rastreável, com status próprio, histórico de transições e os documentos assinados disponíveis para download.

O integrador inicia o fluxo com uma chamada e acompanha o restante por consulta. As etapas intermediárias — geração do termo, emissão do boleto, envio do envelope de assinatura, aplicação das alterações — são orquestradas internamente pela QI Tech.

O que pode ser aditado

Cada aditamento carrega uma ou mais alterações, no campo changes. Os cinco tipos ficam em changes[].type:

• financial_flow (fluxo financeiro) — repactuação do cronograma: novas datas de vencimento, novos valores e/ou nova taxa de juros.
• collateral (garantia) — inclusão ou remoção de uma garantia do título.
• related_party (parte relacionada) — inclusão, alteração ou remoção de avalista, devedor solidário, fiel depositário e demais papéis.
• issue_number (número da emissão) — correção do número da emissão.
• term_clause (cláusula do termo) — regeração do documento com campos livres preenchidos pelo solicitante.

Um mesmo aditamento pode combinar vários tipos. As alterações são aplicadas em conjunto: ou todas valem, ou nenhuma vale.

Conceitos-chave

• financial_base_date — data em que o aditamento passa a valer e a âncora de todo o cálculo. O saldo devedor é apurado nessa data e o novo fluxo parte dela. Aditamento com data base no passado é recusado, salvo operações com origem de tombamento.
• outstanding_balance (saldo devedor) — calculado internamente na financial_base_date e devolvido na simulação, na validação e na consulta. O integrador não precisa calcular saldo devedor do seu lado.
• Fechamento (closing) — em uma repactuação de fluxo, a QI Tech confere se o novo cronograma fecha contra o valor presente do título dentro de uma tolerância. Um fluxo que não fecha faz o aditamento nascer recusado, com o difference e a tolerance na resposta.
• Termo aditivo — o documento que formaliza a alteração. Pode ser gerado pela QI Tech a partir dos dados do aditamento, ou enviado pronto pelo integrador no array documents. A escolha muda o caminho que o aditamento percorre (veja Regras de Negócio).
• Cobrança — o aditamento tem uma taxa, cobrada por boleto. O pagamento é o que libera o envio do termo para assinatura. O valor segue a configuração comercial do seu contrato e vem na simulação, em charge_amount.
• Envelope de assinatura — o conjunto de signatários do termo. Os signatários vêm dos grupos de assinatura cadastrados na operação; uma parte relacionada incluída pelo próprio aditamento também pode ser eleita signatária.
• Um aditamento por vez — um título só admite um aditamento em andamento. Enquanto o anterior não chega a um estado terminal, uma nova criação é recusada com AMD000031.

O ciclo de vida

Um aditamento atravessa a esteira uma vez, e cada parada espera por uma coisa só:

status	O que está acontecendo
created	Criado e roteado. Estado transitório.
validation_failed	Recusado na validação. Nada foi cobrado nem assinado. Estado terminal.
pending_manual_approval	O termo foi enviado pronto pelo integrador e aguarda conferência da QI Tech.
pending_term_generation	A QI Tech está gerando o termo aditivo.
pending_charge_settlement	Boleto emitido, aguardando o pagamento da taxa.
pending_signature	Montando e enviando o envelope de assinatura.
pending_signature_confirmation	Envelope enviado, aguardando os signatários.
pending_application	Aplicando as alterações no título.
applied	Alterações aplicadas. Estado terminal.
application_failed	Falha ao aplicar. Estado terminal até intervenção.
canceled	Cancelado ou recusado. O motivo fica em status_reason. Estado terminal.

Acompanhamento por consulta

Não há webhook dedicado às transições de status do aditamento. Acompanhe pelo endpoint de consulta — o campo status_history traz cada transição com data, ator e motivo.

Próximos passos

• Regras de Negócio — elegibilidade, fechamento, assinatura e cancelamento.
• Tipos de Alteração — o formato de new_value para cada type.
• Simular Aditamento — o ensaio, sem criar nada.
• Criar Aditamento — o disparo do rito.
• Exemplos — casos completos de ponta a ponta.