Parcelas e quebra
O aceite de um acordo gera o plano de parcelas; a partir daí, a gestão é sobre as parcelas — registrar pagamentos, acompanhar atrasos e reagir à quebra.
Como as parcelas são geradas
No momento do aceite, o sistema cria automaticamente uma parcela por mês, a partir da data da primeira:
- Valor de cada parcela = valor final ÷ número de parcelas, arredondado a 2 casas;
- A última parcela ajusta o arredondamento, garantindo que a soma feche exatamente no valor final do acordo (ex.: R$ 1.000,00 em 3× vira 333,33 + 333,33 + 333,34);
- Vencimentos mensais — mesma data-base, mês a mês (acordo aceito no portal: primeira parcela em 10 dias).
Cada parcela tem seu próprio ciclo:
| Status | Significado |
|---|---|
pending | Em aberto, aguardando pagamento |
paid | Paga (com valor e data do pagamento registrados) |
overdue | Vencida sem pagamento |
cancelled | Cancelada (ex.: acordo cancelado) |
Registrando pagamentos de parcela
Registre o pagamento informando valor pago e data — pela tela do acordo ou pela API (PUT /api/v1/agreements/{id}/installments). Só é possível atualizar parcelas de acordos aceitos ou ativos; parcela cancelada não pode ser alterada. A tela do acordo consolida o progresso: quantas parcelas pagas, valor já recebido e saldo restante.
Quebra do acordo
Acordo com parcelas vencidas e não pagas é um acordo quebrado. Essa marcação é manual: o Dunning não detecta a quebra sozinho — não há um processo automático que varra as parcelas em atraso e vire o status. Depois de confirmar que as parcelas não foram pagas, você registra a quebra (via API, atualizando o acordo) e o status passa a defaulted (exibido como "Inadimplente"). Dois caminhos a partir daí:
- Regularização — o devedor põe as parcelas em dia e o acordo volta a
active. Nada se perde. - Cancelamento — você encerra o acordo (
cancelled); as parcelas ainda pendentes são canceladas junto e as cobranças originais voltam à régua (veja abaixo).
Efeito na cobrança original
Quando o acordo foi aceito, a cobrança original saiu da régua com status negotiated. Cancelar o acordo reabre o jogo automaticamente: cada cobrança que estava negotiated por causa desse acordo é revertida — volta a overdue se já venceu, ou a pending se o vencimento ainda é futuro — e é reinscrita na régua vigente, retomando a cobrança de onde fizer sentido. Com a cobrança de volta a overdue, a verificação diária volta a tratá-la como qualquer cobrança em atraso.
Essa reversão respeita algumas salvaguardas:
- A reversão age por cobrança vinculada a este acordo, não pela pessoa: uma cobrança só continua
negotiatedse estiver também vinculada a outro acordo vivo (aceito/ativo). As demais cobranças deste acordo são reabertas normalmente — cancelar um acordo nunca prende as cobranças de outro. - Cobranças que já estão pagas ou canceladas não são tocadas; a reversão só age sobre o que a máquina de estados permite.
- Cada reversão fica registrada na trilha de auditoria (motivo
agreement_cancelled).
Marque a quebra apenas depois de confirmar que a parcela não foi paga por outro meio (transferência direta, pagamento no caixa). Cobrar um acordo que na verdade está em dia é o tipo de erro que o motor de compliance existe para evitar — mas ele depende do status refletir a realidade.
Efeitos no saldo
O acordo não apaga a dívida original no aceite — o desconto só se consolida com o cumprimento:
- Acordo concluído (
completed): a dívida está quitada pelo valor final acordado; a diferença (desconto) é o custo da recuperação. - Acordo quebrado: o desconto era condicionado ao cumprimento. A cobrança original volta a ser exigível pelo valor atualizado — e o recálculo diário de juros e multa parte do valor original da cobrança. Se houve parcelas pagas antes da quebra, ajuste o valor da cobrança para refletir o abatimento antes de retomar a cobrança.
Acompanhamento
A lista de Acordos mostra valor original, desconto, valor final, parcelas e status de cada acordo. Filtre por status (defaulted) para ver a carteira de acordos quebrados que precisa de ação, e acompanhe pelo webhook os eventos de acordo para conciliar com o financeiro.