KPIs de Cobranza

El módulo de Cobranza expone cuatro indicadores clave de desempeño (KPIs) que permiten evaluar la salud de la cartera vencida de su empresa. Estos indicadores se muestran en la parte superior de la bandeja principal (/cobranza) como tarjetas resumen.

Requisitos y permisos

Permiso requerido	Acción
`cobranza.ver`	Ver los KPIs y la tabla de top deudores

Periodo de análisis

Los KPIs se calculan por defecto sobre los últimos 90 días (desde hoy hacia atrás). Este rango se envía automáticamente al cargar la bandeja; no existe actualmente un selector de fechas en la interfaz para modificarlo.

Los datos se actualizan con un tiempo de caché de 5 minutos en el cliente. Para obtener valores frescos, recargue la página o espere que el caché expire.

Indicadores disponibles

DSO — Días de Ventas Pendientes

Qué mide: El promedio de días transcurridos desde el último pago registrado para los clientes que actualmente tienen saldo vencido.

Cómo se calcula: El sistema consulta la tabla de clientes filtrando aquellos con saldoVencido > 0 y calcula el promedio de días entre NOW() y la columna ultimoPago. El resultado se redondea al entero más cercano.

Interpretación:

Valor	Significado
DSO bajo (< 30d)	La cartera vencida es reciente; los clientes son nuevos en mora
DSO medio (30–90d)	Mora establecida; requiere gestión activa
DSO alto (> 90d)	Cartera de difícil recuperación; revisar estrategia de cobranza

Tasa de Recuperación

Qué mide: El porcentaje de promesas de pago cumplidas sobre el total de promesas creadas en el periodo.

Cómo se calcula:

Tasa de Recuperación = Promesas CUMPLIDA / Total de Promesas × 100

Si no se ha registrado ninguna promesa en el periodo, el valor es 0%.

Interpretación:

Valor	Significado
> 70%	Buena tasa; los clientes cumplen sus compromisos
40–70%	Tasa media; revisar proceso de seguimiento de promesas
< 40%	Tasa baja; los compromisos no se están cumpliendo; revisar calidad del acuerdo

Casos Activos

Qué mide: El total de gestiones de cobranza en estados activos al momento de la consulta.

Estados activos contados: ABIERTO, EN_GESTION, EN_PROMESA.

Interpretación: Un número alto de casos activos no es necesariamente negativo; indica el volumen de trabajo actual del equipo. Combínelo con el DSO y la Tasa de Recuperación para obtener una imagen completa.

Promesas Vigentes

Qué mide: El total de promesas de pago en estado VIGENTE al momento de la consulta (sin filtro de fecha).

Interpretación: Un número alto de promesas vigentes indica que el equipo está obteniendo compromisos de los clientes. Si la Tasa de Recuperación es baja con muchas promesas vigentes, los compromisos no se están materializando en pagos.

Tabla de los 10 principales deudores

Debajo de las tarjetas KPI se muestra la lista de los 10 clientes con mayor saldo vencido, limitada a casos en estado activo (ABIERTO, EN_GESTION o EN_PROMESA) y ordenada de mayor a menor saldo.

Cada entrada incluye:

Columna	Descripción
Nombre	Razón social del cliente (o RFC si no tiene nombre registrado)
RFC	RFC del cliente
Saldo Vencido	Monto actual pendiente en MXN
Ver	Enlace directo al detalle del caso de cobranza

Métricas en Prometheus

Además de los KPIs en la interfaz, el módulo exporta dos métricas hacia Prometheus que pueden visualizarse en Grafana:

Métrica	Tipo	Descripción
`cobranza_dso_days`	Gauge	DSO calculado por tenant, actualizado en cada consulta de KPIs
`cobranza_promise_kept_rate`	Gauge	Tasa de recuperación por tenant (valor entre 0 y 1), actualizada en cada consulta de KPIs

Estas métricas se actualizan de forma reactiva cada vez que un usuario con el permiso cobranza.ver consulta los KPIs desde la interfaz.

Preguntas frecuentes

¿Por qué el DSO muestra 0? Significa que ningún cliente con saldo vencido tiene registrada una fecha de último pago, o que no existen clientes con saldo vencido en este momento. Verifique que el módulo de Cuentas por Cobrar esté actualizando correctamente el campo ultimoPago de los clientes.

¿Por qué la Tasa de Recuperación es 0% si sé que hubo pagos? La tasa se basa en promesas de pago registradas en el módulo de Cobranza, no en pagos directos. Si los pagos se recibieron sin que se haya registrado previamente una promesa, no se contabilizan en este indicador.

¿Cada cuánto se actualizan los KPIs? El cliente almacena en caché el resultado durante 5 minutos. Recargue la página para forzar una consulta nueva al servidor.

¿Los KPIs incluyen clientes de casos cerrados? Los Casos Activos y la Tabla de top deudores excluyen casos en RESUELTO e INCOBRABLE. El DSO y la Tasa de Recuperación pueden incluir datos históricos del periodo porque consideran todos los registros de promesas y el campo ultimoPago del catálogo de clientes, independientemente del estado del caso.