Cuotas e incumplimiento
La aceptación de un acuerdo genera el plan de cuotas; a partir de ahí, la gestión gira en torno a las cuotas — registrar pagos, dar seguimiento a los atrasos y reaccionar ante el incumplimiento del acuerdo.
Cómo se generan las cuotas
Al momento de la aceptación, el sistema crea automáticamente una cuota por mes, a partir de la fecha de la primera:
- Valor de cada cuota = valor final ÷ número de cuotas, redondeado a 2 decimales;
- La última cuota ajusta el redondeo, garantizando que la suma cierre exactamente en el valor final del acuerdo (ej.: R$ 1.000,00 en 3 cuotas se convierte en 333,33 + 333,33 + 333,34);
- Vencimientos mensuales — misma fecha base, mes a mes (acuerdo aceptado en el portal: primera cuota en 10 días).
Cada cuota tiene su propio ciclo:
| Status | Significado |
|---|---|
pending | Abierta, a la espera de pago |
paid | Pagada (con valor y fecha del pago registrados) |
overdue | Vencida sin pago |
cancelled | Cancelada (ej.: acuerdo cancelado) |
Registrando pagos de cuota
Registra el pago informando el valor pagado y la fecha — desde la pantalla del acuerdo o vía API (PUT /api/v1/agreements/{id}/installments). Solo es posible actualizar cuotas de acuerdos aceptados o activos; una cuota cancelada no puede modificarse. La pantalla del acuerdo consolida el progreso: cuántas cuotas pagadas, valor ya recibido y saldo restante.
Incumplimiento del acuerdo
Un acuerdo con cuotas vencidas y no pagadas es un acuerdo incumplido. Esta marcación es manual: el Dunning no detecta el incumplimiento por sí solo — no hay un proceso automático que recorra las cuotas vencidas y cambie el status. Tras confirmar que las cuotas no se pagaron, tú registras el incumplimiento (vía API, actualizando el acuerdo) y el status pasa a defaulted (mostrado como "Moroso"). Dos caminos a partir de ahí:
- Regularización — el deudor pone las cuotas al día y el acuerdo vuelve a
active. No se pierde nada. - Cancelación — tú cierras el acuerdo (
cancelled); las cuotas aún pendientes se cancelan junto con él y los cobros originales vuelven a la regla de cobranza (ver abajo).
Efecto en el cobro original
Cuando el acuerdo fue aceptado, el cobro original salió de la regla de cobranza con status negotiated. Cancelar el acuerdo reabre el juego automáticamente: cada cobro que estaba negotiated por ese acuerdo es revertido — vuelve a overdue si ya venció, o a pending si el vencimiento aún es futuro — y es reinscrito en la regla de cobranza vigente, retomando el cobro desde donde tenga sentido. Con el cobro de vuelta en overdue, la verificación diaria vuelve a tratarlo como cualquier cobro en atraso.
Esa reversión respeta algunas salvaguardas:
- La reversión actúa por cobro vinculado a este acuerdo, no por la persona: un cobro solo sigue
negotiatedsi está también vinculado a otro acuerdo vivo (aceptado/activo). Los demás cobros de este acuerdo se reabren normalmente — cancelar un acuerdo nunca retiene los cobros de otro. - Cobros ya pagados o cancelados no se tocan; la reversión solo actúa sobre lo que la máquina de estados permite.
- Cada reversión queda registrada en la pista de auditoría (motivo
agreement_cancelled).
Marca el incumplimiento solo después de confirmar que la cuota no fue pagada por otro medio (transferencia directa, pago en caja). Cobrar un acuerdo que en realidad está al día es el tipo de error que el motor de compliance existe para evitar — pero depende de que el status refleje la realidad.
Efectos en el saldo
El acuerdo no borra la deuda original en la aceptación — el descuento solo se consolida con el cumplimiento:
- Acuerdo completado (
completed): la deuda está saldada por el valor final acordado; la diferencia (descuento) es el costo de la recuperación. - Acuerdo incumplido: el descuento estaba condicionado al cumplimiento. El cobro original vuelve a ser exigible por el valor actualizado — y el recálculo diario de intereses y multa parte del valor original del cobro. Si hubo cuotas pagadas antes del incumplimiento, ajusta el valor del cobro para reflejar la rebaja antes de retomar el cobro.
Seguimiento
La lista de Acuerdos muestra valor original, descuento, valor final, cuotas y status de cada acuerdo. Filtra por status (defaulted) para ver la cartera de acuerdos incumplidos que necesita acción, y da seguimiento por webhook a los eventos de acuerdo para conciliar con el área financiera.