Monitoramento de inadimplência

Um título está inadimplente na data de referência quando o vencimento real (já com prorrogações) é anterior a essa data e ele não foi pago. A vencer e vence hoje não entram. Cancelado sai sempre. Pagamento parcial deixa inadimplente só o saldo restante. No billing com cobrança automática no cartão a fatura costuma não ter data de vencimento: o vencimento real é a data de finalização da fatura, quando a primeira cobrança é tentada (no Stripe, `due_date` vem nulo em `charge_automatically`; use `status_transitions.finalized_at`).

A inadimplência oficial é a fotografia de um dia: quem está devendo naquela data, quanto e há quanto tempo. Ter atrasado em algum momento do mês é outra métrica, só para histórico. Grave a foto diária ou mensal em modo de acumulação, para que a inadimplência de um mês passado possa ser refeita igual. Enquanto não houver foto gravada, a de uma data passada pode ser reconstruída pelas datas de transição de status de cada título (emitido, pago, cancelado, baixado como perda), nunca pelo status atual. No Stripe, essas datas ficam em `status_transitions`.

As faixas de atraso cobrem só títulos sem baixa. Título pago sai do aging, mesmo que tenha ficado meses vencido, e vai para a métrica de pontualidade: dias entre o vencimento e o pagamento. As faixas são contíguas e começam em 1 dia, para que a soma das faixas seja igual ao saldo vencido.

O saldo de cada título é o valor do título menos as baixas registradas. Antes de confiar no campo de saldo pronto do ERP, teste: em casos reais ele vinha vazio ou zerado na maioria das parcelas. Juros e multa recebidos ficam separados do principal. No billing, o saldo restante pronto também engana: no Stripe, `amount_remaining` continua preenchido em faturas anuladas (`void`), em rascunho (`draft`) e nas pagas fora do Stripe (`paid_out_of_band`, sem `amount_paid`). Considere quitado todo título com data de pagamento até a data de referência e descarte rascunhos e anulados. Some o saldo por moeda, nunca moedas diferentes juntas.

Quando a dívida é reparcelada, o título antigo é substituído pelas parcelas novas. O título com status de renegociado (que alguns ERPs zeram) sai, e só as parcelas novas contam. Se o ERP mantém o antigo como atrasado, marque-o pela renegociação e tire da soma. No billing, renegociar costuma ser anular a fatura e emitir outra (no Stripe, `void` e fatura nova): a anulada sai a partir da data de anulação, e as fotos de datas anteriores não mudam.

No billing, cada tentativa de cartão recusada vira uma linha, e a mesma fatura pode ter várias. O grão da inadimplência é a fatura ou o título, nunca a tentativa. Enquanto a fatura está em retentativa e passou do vencimento, ela aparece na foto na primeira faixa, como qualquer título em aberto; quando é paga, sai. Não crie exceção para faturas em retentativa. A recuperação dentro do ciclo de cobrança é medida à parte, na taxa de recuperação.

Agrupe por CPF ou CNPJ normalizado e validado (11 ou 14 dígitos), não por nome. Documento com tamanho errado é tratado como sem documento, para não grudar a dívida no cliente errado. O pagador pode ser diferente do titular (pai pagando pelo aluno, matriz pagando pela filial): ligue o título ao contrato pelo id, e use o documento do pagador para cobrar.

Quando os títulos são copiados para um CRM de cobrança, o CRM tem atraso de sincronização e uma data de corte: o que é anterior à integração não está lá. Use o CRM para saber em que etapa da régua o cliente está, e o ERP ou o billing para saber quanto ele deve.

Mútuos entre sócios, saldos entre empresas do grupo, títulos-companheiros de adiantamento de cartão e cobranças de teste não são inadimplência. Cobrança pendente antiga sem nenhum rastro operacional (sem link, boleto, QR Code Pix ou nota) também não é dívida real.