Ciclo de vida
Toda cobrança tem um status que resume onde ela está no ciclo de cobrança. As transições seguem uma máquina de estados: o sistema rejeita mudanças inválidas (como reabrir uma cobrança cancelada por engano), e cada transição fica registrada na auditoria.
Os status
| Status na interface | Código (API) | O que significa |
|---|---|---|
| Pendente | pending | Emitida, aguardando o vencimento. A régua pode enviar lembretes preventivos. |
| Vencida | overdue | Passou do vencimento sem pagamento. É aqui que a régua trabalha de verdade. |
| Paga | paid | Pagamento confirmado. Estado final feliz — a régua encerra e qualquer envio pendente é cancelado. |
| Em acordo | negotiated | A dívida entrou num acordo de negociação. A cobrança sai da régua enquanto o acordo estiver de pé. |
| Cancelada | cancelled | Cancelada pelo operador (cobrança indevida, erro de emissão). Não é cobrada nem conta na carteira em aberto. |
| Negativada | negatived | Registrada em birô (SPC/Serasa). Só acontece após revisão humana obrigatória. |
| Protestada | protested | Protestada em cartório. Também exige revisão humana antes. |
| Baixada | written_off | Baixa administrativa/perda. A dívida deixa de ser cobrada sem ter sido paga. |
As transições do dia a dia
- Pendente → Vencida: automática. Um processo diário reavalia todas as cobranças em aberto, atualiza os dias em atraso e vira o status quando o vencimento passa. O mesmo processo corrige o caminho inverso (se o vencimento foi prorrogado, a cobrança volta a Pendente).
- → Paga: disparada por um evento de pagamento — webhook do gateway, integração ou registro manual. A baixa interrompe imediatamente qualquer envio pendente da régua. Veja Pagamento e baixa.
- → Paga (baixa parcial): um pagamento parcial fecha o título original como Paga pelo valor recebido e gera uma nova cobrança (filha) para o saldo, que entra na régua desde o início.
- → Em acordo: quando um acordo é aceito (pelo operador ou pelo devedor no portal). Se o acordo é quebrado, a cobrança volta a ser cobrada.
- → Cancelada: ação manual do operador, no botão Cancelar Cobrança do detalhe.
- → Negativada / Protestada: a régua ou o operador podem solicitar, mas o status só muda depois que alguém aprova na fila de revisão humana.
- → Baixada: ação administrativa de baixa/perda. Uma cobrança pode ser baixada a partir de Vencida, Em acordo, Protestada ou Negativada — a dívida deixa de ser cobrada sem ter sido paga.
- Baixada → Paga (recuperação pós-baixa): uma cobrança já baixada pode voltar a Paga se o pagamento acabar entrando — a recuperação é registrada mesmo depois da baixa.
- Paga → Vencida (estorno): se o pagamento é estornado, a cobrança reabre e reinicia a régua do começo (novo ciclo de cobrança), recebendo os avisos novamente. Ações jurídicas já registradas não são duplicadas.
A cobrança e a régua
O status da cobrança e o estado dela na régua são coisas relacionadas, mas distintas. No detalhe da cobrança, o card Régua de Cobrança mostra o enrollment: Ativa (a régua está rodando), Pausada (com o motivo — disputa aberta, "já paguei", acordo em análise), Concluída ou Encerrada (com o motivo de saída).
Uma cobrança Vencida com régua Pausada, por exemplo, não recebe nenhuma mensagem até a pausa ser resolvida — e o motivo está sempre visível.
Por que meu status não mudou na hora?
Duas situações comuns:
- Virada de Pendente para Vencida: acontece no processamento diário (de madrugada), não no segundo exato do vencimento.
- "Consta em aberto, mas o cliente pagou": se o pagamento veio por fora (transferência direta, por exemplo), o sistema não tem como saber. Registre o pagamento manualmente ou trate o "já paguei" do devedor — o fluxo pausa a cobrança e abre uma tarefa de verificação antes de qualquer nova mensagem.