Recuperación

Las métricas de recuperación responden a la pregunta que justifica el producto: ¿qué hizo la regla por ti? La respuesta se construye con atribución honesta — el sistema solo llama "recuperado" a lo que de verdad estaba en recuperación, y dice qué etapa y canal tocaron al deudor por última vez antes de que el dinero entrara.

Qué cuenta como recuperación

Un registro de recuperación se crea en el momento en que un pago se confirma, si el cobro estaba en una de estas situaciones:

• En regla (rule) — había una regla activa o pausada trabajando el cobro.
• Negociado (agreement) — el cobro estaba en acuerdo.
• Vencido sin regla (overdue_no_rule) — estaba en mora, aunque fuera de regla.

Un pago puntual, sin regla, no cuenta. Ese dinero entraría de todos modos; sumarlo inflaría el número. Es esa separación por método (rule / agreement / overdue_no_rule) la que deja claro cuánto vino del trabajo de la regla y cuánto vino de un acuerdo o de una mora resuelta por otros medios.

Un pago parcial también genera recuperación, atribuida al monto efectivamente pagado en la liquidación parcial del título original (el saldo sigue como un cobro hijo y, si se recupera después, genera su propio registro).

Cómo funciona la atribución

Cada registro de recuperación guarda la telemetría de la regla hasta el pago:

• Última etapa y canal — la atribución va a la última etapa efectivamente enviada (enviada, entregada, respondida o convertida) antes del pago, con el canal usado. Es un modelo last-touch deliberadamente simple y verificable: nada de repartir el crédito entre toques por heurística.
• Etapas ejecutadas — cuántos pasos corrió la regla hasta convertir (mide el esfuerzo por recuperación).
• Días de mora al pagar — calculados directo de las fechas (pago − vencimiento), sin depender de contadores actualizados una vez al día.
• Monto recuperado — el monto pagado (o el monto actual del cobro al momento de la baja).
• Origen del pago — kobana, PSP, CNAB o manual.

Cada pago genera como máximo un registro por cobro (idempotente): las reentregas de webhook no duplican el número.

Las métricas disponibles

A partir de esos registros, el sistema calcula para el período (por defecto, los últimos 6 meses; configurable de 1 a 24):

• Total recuperado — monto y cantidad de cobros.
• Tasa de recuperación — recuperado ÷ (recuperado + cartera en mora hoy). Una lectura conservadora: el denominador incluye todo lo que aún está vencido ahora.
• Mora promedio en la recuperación — cuántos días de mora, en promedio, tenían los cobros al ser pagados.
• Etapas promedio hasta recuperar — el esfuerzo promedio de la regla por conversión.
• Serie mensual — monto y cantidad recuperados mes a mes.
• Por método — cuánto vino de regla, de acuerdo y de vencidos sin regla.
• Por canal — cuánto convirtió cada canal (correo, SMS, WhatsApp) como último toque.

Estas métricas están disponibles por la API (GET /api/v1/metrics/recovery) para alimentar tus propios reportes.

La tarjeta en el panel

En el panel, la tarjeta Recuperado por la regla muestra el monto recuperado en el mes corriente y la cantidad de cobros vencidos pagados en el mes. Está al lado de Recibido en el mes a propósito: la primera es el resultado del trabajo de cobranza; la segunda es todo el efectivo que entró. La diferencia entre las dos es lo que habría entrado solo.

La serie mensual y la tasa de recuperación también aparecen como un gráfico de tendencia en el panel (valor recuperado por mes), alimentado por GET /api/v1/metrics/recovery — útil para ver la evolución de la recuperación a lo largo del tiempo, no solo el mes corriente.