Conceitos
O glossário do Dunning em uma página. Os termos aparecem exatamente como na interface.
Carteira
- Cliente — a pessoa (física ou jurídica) que deve. Carrega documento (CPF/CNPJ), e-mails, telefones, endereços, tags, observações e dados personalizados. É o cadastro central: cobranças, acordos e notificações sempre apontam para um cliente.
- Classificação — o rótulo de perfil de pagador do cliente (por exemplo: Novo, Bom, Regular ou Mau pagador). Pode ser atribuída manualmente ou de forma automática, a partir do histórico de pagamentos. Réguas podem ser associadas a classificações.
- Tags — etiquetas livres para organizar e filtrar clientes e cobranças.
- ID Externo (
external_id) — o identificador do registro no seu sistema (ERP, planilha, CRM). É a chave de deduplicação em importações e integrações: se o Dunning encontra o mesmoexternal_id, atualiza em vez de duplicar.
Cobrança
- Cobrança — um título a receber: valor, vencimento, cliente e status. Nasce Pendente, vira Vencida ao passar do vencimento e termina Paga, Cancelada, Baixada ou em um dos estados jurídicos. Veja o ciclo de vida completo.
- Valor Original / Valor Atual — o valor de emissão e o valor devido hoje (original + juros + multa − desconto).
- Dias em Atraso — quantos dias se passaram desde o vencimento de uma cobrança não paga. Recalculado diariamente.
- Origem — de onde a cobrança veio: manual, planilha, API, ERP ou Kobana. Veja Origens.
Régua
- Régua de Cobrança — a sequência automática de etapas que roda para cada cobrança: lembrete antes do vencimento, aviso no dia, cobranças depois. Uma régua pode ser marcada como Padrão: cobranças criadas sem régua explícita entram nela.
- Etapa — um passo da régua, com gatilho (por exemplo, 3 dias após o vencimento), canal (e-mail, SMS, WhatsApp) e ação (notificação, oferta de acordo, tarefa manual, entre outras).
- Versão da régua — ao entrar numa régua, a cobrança fica presa a um retrato ("snapshot") das etapas naquele momento. Editar a régua depois não muda quem já está dentro dela.
- Execução (do motor) — o registro de cada etapa avaliada para uma cobrança: agendada, enviada, entregue, suprimida, e por quê. Aparece no detalhe da cobrança, em Execuções do motor.
- Template — o modelo de mensagem usado por uma etapa, com variáveis interpoladas (nome do cliente, valor atual, vencimento).
- Supressão — um bloqueio de contato registrado (opt-out, "não sou eu", disputa, entre outros). Supressão vence qualquer etapa da régua: a mensagem não sai e o motivo fica registrado.
Negociação e exceções
- Acordo — parcelamento da dívida com desconto, aceito pelo operador ou pelo devedor no portal. Acordo aceito pausa a régua.
- Disputa — contestação do devedor ("já paguei", "não reconheço", "valor errado"...). Abrir uma disputa pausa a régua na hora; a decisão (procedente ou improcedente) retoma ou encerra a cobrança.
- Negativação / Protesto — ações jurídicas que sempre passam por revisão humana antes de qualquer efeito.
- Trava jurídica (legal hold) — um bloqueio na cobrança que impede etapas incompatíveis com a situação legal dela.
Comunicação e acesso
- Notificação — cada mensagem enviada (ou suprimida) a um devedor, com canal, destinatário, status de entrega e custo.
- Portal do Devedor — a página segura em que o devedor consulta as dívidas, simula e aceita acordos. O operador gera o link pelo botão Link do Portal no cadastro do cliente; o devedor confirma os 4 últimos dígitos do documento antes de ver os valores.
- Tarefa — item da fila de trabalho dos operadores: verificação de comprovante, aprovação de negativação, follow-up manual.