Amortização Extraordinária

Visão geral

Amortização extraordinária é o processo de reduzir o saldo devedor de uma emissão fora do cronograma ordinário — quando o emissor antecipa um pagamento, quita parcelas adiante do vencimento ou refinancia parte da dívida. O QI Tech recebe esse pedido via API, valida os valores e registra o evento para liquidação posterior, sem interferir nas amortizações ordinárias geradas em cada due_date (data de vencimento).

Os cenários típicos envolvem quitação antecipada pelo emissor, pagamento antecipado de uma ou mais parcelas e operações de refinanciamento parcial. Em todos esses casos o integrador inicia o fluxo sob demanda, informando qual parcela (ou conjunto de parcelas) está sendo amortizada e qual o valor.

Você recorre a esta API sempre que precisa alterar o saldo devedor fora da agenda ordinária de pagamentos. O resultado é sempre um evento rastreável, com status próprio e registro financeiro. A criação é fire-and-forget: a QI Tech orquestra liquidação, finalização e cancelamento internamente, sem que o integrador precise chamar endpoints adicionais.

Amortização ordinária vs extraordinária

A amortização ordinária é gerada automaticamente pela QI Tech: em cada due_date (data de vencimento), o processo de liquidação da parcela é criado internamente sem ação do integrador. Já a amortização extraordinária é sempre iniciada sob demanda, por chamada explícita à API. As duas coexistem — registrar uma amortização extraordinária não cancela nem substitui as ordinárias que ainda vão vencer; apenas adiciona um novo evento de liquidação sobre o ativo.

Tipos de amortização

Os cinco tipos suportados ficam no campo amortization_type:

• equal_amount (valores proporcionais) — distribui proporcionalmente o valor informado entre as parcelas vencidas primeiro e depois entre as futuras.
• first_installments (primeiras parcelas) — aplica o valor sequencialmente às N primeiras parcelas até esgotá-lo.
• present_amount (valor presente) — o integrador escolhe as parcelas e pode informar total_discount; a ordem de distribuição é juros → multa → principal.
• matured_installments (parcelas vencidas) — aplica o valor exclusivamente a parcelas já vencidas.
• early_amortization (amortização antecipada) — antecipa o pagamento de uma parcela futura.

Apenas early_amortization permite pagamento parcial — os outros quatro exigem cobertura integral do valor declarado dentro da tolerância.

Conceitos-chave

• event_conciliation — corresponde ao evento de conciliação de uma parcela específica. Responsável pelo ato de conciliação de pagamentos e/ou amortizações extraordinárias de parcelas de um valor mobiliário.
• reference_date — data de referência fornecida pelo chamador em toda criação (deve corresponder à data de quitação). O QI Tech nunca usa date.today(): toda lógica relativa a datas (classificação de vencimento, projeção do Valor Presente, discriminação de parcelas vencidas vs a vencer) parte desse campo.
• Valor Presente — calculado internamente e consumido durante a criação do evento. O integrador não precisa calcular Valor Presente no seu lado.
• Tolerância (tolerance_amount) — diferença máxima aceita entre o valor de liquidação e o valor esperado da parcela. Default de R$ 0,01. Diferenças acima da tolerância fazem a liquidação ser rejeitada.
• Estado parcial derivado — quando paid_amount > 0 e paid_amount < expected_amount, a parcela é considerada parcialmente paga. Não há novo status: o estado é DERIVADO das colunas paid_amount e expected_amount. O status pending_conciliation cobre tanto o "ainda não pago" quanto o "parcialmente pago"; paid só aparece quando o acumulado cobre o esperado dentro da tolerância.

Próximos passos

Siga para o Roteiro de Integração para ver o fluxo passo a passo.