Ciclo de vida
Todo cobro tiene un estado que resume dónde está en el ciclo de cobranza. Las transiciones siguen una máquina de estados: el sistema rechaza cambios inválidos (como reabrir un cobro cancelado por error), y cada transición queda registrada en la auditoría.
Los estados
| Estado en la interfaz | Código (API) | Qué significa |
|---|---|---|
| Pendiente | pending | Emitido, a la espera del vencimiento. La regla puede enviar recordatorios preventivos. |
| Vencido | overdue | Pasó el vencimiento sin pago. Es aquí donde la regla trabaja de verdad. |
| Pagado | paid | Pago confirmado. Estado final feliz — la regla cierra y cualquier envío pendiente se cancela. |
| En acuerdo | negotiated | La deuda entró en un acuerdo de negociación. El cobro sale de la regla mientras el acuerdo esté en pie. |
| Cancelado | cancelled | Cancelado por el operador (cobro indebido, error de emisión). No se cobra ni cuenta en la cartera abierta. |
| Negativado | negatived | Registrado en el buró de crédito (SPC/Serasa). Solo ocurre tras revisión humana obligatoria. |
| Protestado | protested | Protestado ante notaría (cartório). También exige revisión humana previa. |
| Dado de baja | written_off | Baja administrativa/pérdida. La deuda deja de cobrarse sin haber sido pagada. |
Las transiciones del día a día
- Pendiente → Vencido: automática. Un proceso diario reevalúa todos los cobros abiertos, actualiza los días en mora y cambia el estado cuando el vencimiento pasa. El mismo proceso corrige el camino inverso (si el vencimiento se prorrogó, el cobro vuelve a Pendiente).
- → Pagado: disparada por un evento de pago — webhook del gateway, integración o registro manual. La baja interrumpe de inmediato cualquier envío pendiente de la regla. Consulta Pago y baja.
- → Pagado (liquidación parcial): un pago parcial cierra el título original como Pagado por el monto recibido y genera un nuevo cobro (hijo) para el saldo, que entra en la regla desde el inicio.
- → En acuerdo: cuando un acuerdo se acepta (por el operador o por el deudor en el portal). Si el acuerdo se rompe, el cobro vuelve a cobrarse.
- → Cancelado: acción manual del operador, con el botón Cancelar Cobro del detalle.
- → Negativado / Protestado: la regla o el operador pueden solicitarlo, pero el estado solo cambia después de que alguien lo aprueba en la cola de revisión humana.
- → Dada de baja: acción administrativa de baja/pérdida. Un cobro puede darse de baja desde Vencido, En acuerdo, Protestado o Negativado — la deuda deja de cobrarse sin haber sido pagada.
- Dada de baja → Pagado (recuperación tras la baja): un cobro dado de baja puede volver a Pagado si el pago finalmente entra — la recuperación se registra incluso después de la baja.
- Pagado → Vencido (reverso): si el pago se revierte, el cobro se reabre y reinicia la regla desde el comienzo (nuevo ciclo de cobranza), recibiendo los avisos nuevamente. Las acciones jurídicas ya registradas no se duplican.
El cobro y la regla
El estado del cobro y su situación en la regla son cosas relacionadas, pero distintas. En el detalle del cobro, la tarjeta Regla de Cobranza muestra el enrollment: Activa (la regla está corriendo), Pausada (con el motivo — disputa abierta, "ya pagué", acuerdo en análisis), Completada o Finalizada (con el motivo de salida).
Un cobro Vencido con regla Pausada, por ejemplo, no recibe ningún mensaje hasta que la pausa se resuelva — y el motivo está siempre visible.
¿Por qué mi estado no cambió al instante?
Dos situaciones comunes:
- Paso de Pendiente a Vencido: ocurre en el procesamiento diario (de madrugada), no en el segundo exacto del vencimiento.
- "Figura abierto, pero el cliente pagó": si el pago llegó por fuera (una transferencia directa, por ejemplo), el sistema no tiene cómo saberlo. Registra el pago manualmente o gestiona el "ya pagué" del deudor — el flujo pausa el cobro y abre una tarea de verificación antes de cualquier mensaje nuevo.