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 (marcada automaticamente pela verificação diária)
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

A quebra é detectada automaticamente. Um processo diário (de madrugada, logo após a virada do dia civil) varre os acordos aceitos e ativos e:

1. Marca as parcelas vencidas — parcela pending cujo vencimento passou vira overdue (contagem em dias civis, no fuso da organização).
2. Quebra o acordo depois da carência — se a parcela mais atrasada excede a carência de 5 dias civis, o acordo vira defaulted (exibido como "Descumprido"). Com o padrão, a quebra acontece no 6º dia de atraso: a parcela pode ser paga durante toda a carência sem consequência. A carência pode ser ajustada por acordo via API (campo graceDays nos metadados do acordo; 0 quebra no primeiro dia de atraso).
3. Devolve as cobranças à régua — no mesmo momento da quebra, as cobranças que estavam negotiated por causa do acordo são revertidas e reinscritas na régua vigente (veja abaixo).
4. Conclui o que foi quitado — a mesma varredura fecha o outro lado: acordo ativo sem nenhuma parcela em aberto vira completed sozinho. Ninguém precisa "encerrar" um acordo cujas parcelas foram todas pagas.

A quebra emite o webhook agreement.broken, entra na trilha de auditoria e gera um aviso no sino da equipe ("Acordo quebrado"). Dois caminhos a partir dela:

• 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.

Efeito na cobrança original

Quando o acordo foi aceito, a cobrança original saiu da régua com status negotiated. A quebra automática — e também o cancelamento — reabre o jogo: 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 negotiated se estiver também vinculada a outro acordo vivo (aceito/ativo). As demais cobranças deste acordo são reabertas normalmente — quebrar ou 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_defaulted na quebra automática, agreement_cancelled no cancelamento).

cuidado

A detecção parte do status das parcelas no sistema. Parcela paga por outro meio (transferência direta, pagamento no caixa) precisa ter o pagamento registrado antes do fim da carência — uma parcela quitada no mundo real mas em aberto no sistema quebra o acordo e devolve a cobrança à régua.

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.

Acompanhamento

A lista de Acordos mostra valor original, desconto, valor final, parcelas e status de cada acordo. Filtre por status (defaulted, "Descumprido") para ver a carteira de acordos quebrados que precisa de ação, e acompanhe pelos webhooks (agreement.broken, agreement.completed e demais eventos de acordo) para conciliar com o financeiro.