Como funciona

Uma régua de cobrança é uma sequência de etapas ancoradas no vencimento da cobrança: um lembrete 3 dias antes, um aviso no dia, um e-mail firme 5 dias depois, uma oferta de acordo aos 15, e assim por diante. Você desenha a sequência uma vez e o motor executa para cada cobrança, todos os dias, sem ninguém precisar lembrar de nada.

O ciclo diário

Uma verificação automática roda diariamente e, para cada cobrança em aberto (pending ou overdue):

1. Recalcula os valores — juros, multa, desconto e dias em atraso.
2. Atualiza o status — a cobrança que passou do vencimento vira overdue.
3. Atribui a régua padrão — cobrança que chegou sem régua (planilha, API, integração) recebe automaticamente a régua marcada como Padrão da organização. É isso que garante a promessa "subiu a planilha, a régua roda sozinha": nenhuma cobrança fica esquecida.
4. Dispara as etapas devidas — compara a data de hoje com o gatilho de cada etapa (antes do vencimento, no dia, X dias depois) e executa as que chegaram na hora. Cada etapa executa no máximo uma vez por cobrança.

O que uma etapa pode fazer

Etapas não são só mensagens. Uma etapa pode:

• Notificar o devedor por e-mail, SMS ou WhatsApp, usando um template com variáveis (o canal de voz ainda não dispara — veja Etapas e canais);
• Criar uma oferta de negociação que o devedor vê no portal;
• Abrir uma tarefa manual para a sua equipe (ex.: ligar pessoalmente);
• Iniciar negativação ou protesto — que nunca acontecem sozinhos: criam um registro pendente e uma tarefa de revisão humana obrigatória;
• Encaminhar ao jurídico, criando uma tarefa urgente.

Os detalhes de gatilhos, canais e ações estão em Etapas e canais.

Compliance antes de todo envio

Imediatamente antes de cada envio, o motor avalia o compliance de contato: supressões ativas, trava jurídica (legal hold), janela legal da UF do devedor (com feriados nacionais) e limites de contato por pessoa. Envio fora da janela é reagendado para a próxima abertura — nunca descartado silenciosamente. Essa é a página mais importante desta seção: Compliance de contato.

Interrupção imediata por evento

O motor reage a eventos na hora, não no próximo ciclo:

• Pagamento confirmado — a cobrança sai da régua com sucesso e todo envio pendente é cancelado. Ninguém cobra dívida paga.
• "Já paguei" — a declaração do devedor pausa a régua imediatamente enquanto o comprovante é verificado; confirmado, encerra; não confirmado, a régua retoma de onde parou.
• Acordo aceito — a cobrança vira negotiated e sai da régua (Acordos).
• Disputa aberta — pausa imediata e supressão dos envios pendentes.
• Pagamento parcial — liquida o título original (baixa parcial) e cria uma cobrança-filha do saldo, que reentra na régua desde o início; os juros passam a incidir sobre o saldo.
• Estorno/chargeback — a cobrança reabre e recomeça a régua do início (novo ciclo), reenviando os avisos; ações de negativação/protesto ativas não se repetem.

Como última linha de defesa, existe uma revalidação pré-envio dentro do próprio worker: mesmo que um envio já esteja na fila quando o pagamento chega, ele é barrado com o estado mais fresco do banco antes de ir ao provedor.

Versões: quem entrou, entrou numa foto

Cada cobrança entra numa versão publicada da régua — um snapshot imutável das etapas. Editar a régua depois não muda o plano de quem já está dentro; as alterações valem para as próximas entradas. Detalhes em Versões e publicação.

Tudo auditado

Cada execução de etapa registra o que foi enviado, por qual canal, quando e — igualmente importante — por que algo não foi enviado (suprimido, reagendado, cancelado, com o motivo). Essa telemetria alimenta a trilha de auditoria probatória e o relatório de recuperação.