Configuração de Dunning
A configuração de dunning define como o sistema trata pagamentos em atraso: quantas tentativas, intervalo entre elas e comportamento após esgotamento.
Campos de Configuração
| Campo | Padrão | Faixa | Descrição |
|---|---|---|---|
| Máximo de tentativas | 3 | 1-10 | Total de tentativas permitidas |
| Intervalo entre tentativas (dias) | [2, 5, 7] | - | Dias de espera entre cada tentativa |
| Período de carência (dias) | 3 | 1-90 | Dias antes da suspensão |
| Retry automático | Sim | - | Se as tentativas são disparadas automaticamente |
| Suspender após tentativas | Sim | - | Se a conta é suspensa após esgotar tentativas |
| Métodos de pagamento para retry | pix, bank_slip, card | - | Quais métodos usar nas tentativas |
Hierarquia de Configuração
- Configuração da organização: Cada organização pode personalizar suas regras
- Configuração global padrão: Usada quando a organização não tem config personalizada
- Padrões do sistema: Valores hardcoded como fallback final
Exemplo de Timeline
Com a configuração padrão (tentativas: [2, 5, 7], carência: 3 dias):
Dia 0: Fatura vence
Dia 2: 1ª tentativa de retry
Dia 5: 2ª tentativa de retry (se 1ª falhou)
Dia 7: 3ª tentativa de retry (se 2ª falhou)
Dia 10: Período de carência encerra → conta suspensa
Estágios de Dunning
A conta inadimplente progride pelos seguintes estágios:
| Estágio | Dias em atraso | Descrição |
|---|---|---|
initial | 1-7 dias | Atraso recente |
reminder | 8-15 dias | Lembretes enviados |
warning | 16-30 dias | Aviso de suspensão iminente |
final | 30+ dias | Última chance antes de ação |
suspended | Após carência | Conta suspensa |
Gerenciamento
Pausar Dunning
Use "Parar Dunning" para suspender as comunicações temporariamente mantendo a fatura como past-due.
Cancelar Tentativas
Cancela todas as tentativas pendentes para uma fatura específica e limpa a data da próxima tentativa.
Retry Manual
O operador pode disparar uma tentativa manual a qualquer momento, independente do agendamento automático.