Versões e publicação
Régua de cobrança muda: você ajusta um texto, adiciona uma etapa, muda um offset. O que não pode mudar é o plano de quem já está no meio do fluxo — nem a sua capacidade de provar, meses depois, exatamente qual sequência valia quando aquele devedor foi cobrado. É para isso que existem versões.
O que é uma versão
Uma versão é um snapshot imutável da régua no momento da publicação: nome, classificação, prioridade e todas as etapas ativas com posição, gatilho, dias, ação, canais, tom, template e condições. As versões são numeradas (1, 2, 3...) e cada publicação entra na trilha de auditoria.
Quando uma régua é usada pela primeira vez sem ter versão publicada, o sistema publica a versão 1 automaticamente — você não precisa se lembrar de "publicar" para a régua funcionar.
Enrollment: a entrada da cobrança na régua
Cada cobrança entra na régua por meio de um enrollment que aponta para a versão vigente naquele momento. Consequências práticas:
- Editar a régua não afeta quem já entrou — enrollments ativos seguem presos ao snapshot da versão em que entraram; as mudanças valem para as próximas cobranças.
- Nenhuma cobrança entra duas vezes — se já existe enrollment ativo ou pausado para a cobrança, o sistema reaproveita o existente, mesmo com jobs concorrentes.
O enrollment tem quatro estados:
| Estado | Significado |
|---|---|
active | A régua está rodando para esta cobrança |
paused | Suspensa temporariamente, com motivo (disputa aberta, "já paguei" em verificação...) — retoma do ponto onde parou |
completed | Saiu com sucesso (pagamento, acordo aceito) |
exited | Saiu por outro motivo (cancelamento, baixa, supressão) |
Quando o enrollment é concluído ou encerrado, toda execução de etapa ainda não disparada é cancelada na hora, com o motivo registrado.
Enrollment automático e régua padrão
Você pode atribuir uma régua específica a uma cobrança na criação (manual, planilha ou API). Mas o cenário mais comum é não atribuir nada — e é aí que entra a régua padrão:
- Marque uma régua como Padrão da organização;
- A verificação diária encontra toda cobrança em aberto sem régua e atribui a padrão automaticamente, criando o enrollment na versão vigente.
É a garantia "nenhuma cobrança esquecida": subiu a planilha com 5.000 títulos sem régua? Amanhã todos estão dentro da régua padrão, com telemetria completa.
Réguas também podem ser vinculadas a uma classificação de cliente e têm prioridade — use classificações para tratar carteiras diferentes com réguas diferentes (ex.: clientes estratégicos com régua mais suave).
Ativação de régua e de etapas
Régua e etapas têm ativação independente:
- Régua inativa não é usada como padrão nem dispara etapas;
- Etapa inativa não dispara e não entra no snapshot da próxima versão publicada — desativar uma etapa é a forma segura de "tirar do ar" sem apagar histórico.
Por que isso importa numa auditoria
Se um devedor questiona a cobrança em juízo, você precisa provar o que foi enviado, quando e sob qual regra. A combinação versão imutável + enrollment + execuções de etapa responde: "esta cobrança entrou na versão 3 da régua X em 12/05, recebeu as etapas 1 e 2, teve a etapa 3 suprimida por disputa aberta". Nada disso depende de memória ou de reconstrução manual.