Cobrar depois do pagamento prejudica confiança. Antes de cada mensagem, o fluxo precisa conciliar o estado e parar diante de contestação ou incerteza.
Resposta curta
Use ID imutável, vencimento, saldo, canal e etapa. Antes de enviar, atualize o pagamento; se o estado estiver antigo, contestado, prometido ou desconhecido, pause para revisão humana.
{"invoice_id":"imutável","cliente":"contato autorizado","vencimento":"data","moeda":"código","total":"valor","saldo_aberto":"valor e horário","etapa":"antes|vencimento|atraso_1|atraso_2|humano","status":"aberto|pago|parcial|contestado|prometido|desconhecido"}
A FreshBooks permite até três lembretes e configurações por fatura, cliente ou conjunto. A SumUp informa que lembra apenas faturas não pagas, mas que uma sequência enviada não pode ser cancelada. Como produtos variam, defina parada explícita em vez de presumir reversibilidade.
| Estado | Ação permitida |
|---|---|
| pago | parar e registrar referência |
| parcial | mostrar saldo; conferir alocação |
| contestado | parar; atribuir responsável |
| prometido | suspender até a data combinada |
| estado antigo | conciliar; não enviar |
| aberto e verificado | enviar uma vez a etapa aprovada |
O tom pode ficar mais firme; os fatos não. Não invente consequência, multa ou escalada jurídica. Multa depende de validação contratual e legal.
Piloto
Use faturas fictícias: paga antes da execução, pagamento parcial, webhook atrasado, evento duplicado, contestação, promessa, e-mail devolvido, fuso e baixa manual. Passe apenas se nenhum caso pago ou contestado receber cobrança, retries forem idempotentes e todo envio guardar o estado conferido.
Meça envios verificados, supressões, atraso de conciliação, respostas, contestações, destinatário errado e dias até pagamento sem alegar causalidade. Ligue ao fluxo de notas fiscais e ao plano de contingência.