Cobranzas¶

Para qué sirve: gestionar la cobranza de carteras de deuda de uno o varios clientes acreedores — deudores, promesas de pago, acuerdos de refinanciación y cobros — con paneles para el cobrador y el supervisor.

Requisitos: módulo Cobranzas habilitado (cobranzas_enabled) + permiso cobranzas.read (ver) / cobranzas.write (operar).

Conceptos básicos¶

Concepto	Qué es
Cliente acreedor	La empresa dueña de la deuda (banco, fintech, comercio).
Cartera (portfolio)	Un lote de deudas de un acreedor.
Deuda	Lo que un contacto (deudor) le debe al acreedor.
Promesa	Compromiso del deudor de pagar un monto en una fecha.
Acuerdo	Refinanciación de una deuda en un plan de cuotas.
Cobro	Un pago efectivamente recibido (el "cobrado real").

Cómo llegar¶

Menú lateral → Cobranzas. La pantalla tiene cinco solapas: Mi panel, Deudores, Promesas, Acuerdos y Carteras.

📷 Captura pendiente

pantalla Cobranzas, solapa Deudores — assets/cobranzas/00-cobranzas-deudores.png

Mi panel (cobrador)¶

Tu tablero personal del período (arriba a la derecha elegís el rango de fechas, por defecto el mes actual).

📷 Captura pendiente

Mi panel con las tarjetas de KPIs — assets/cobranzas/01-mi-panel.png

Tarjetas:

Cartera asignada — monto y cantidad de deudas activas a tu nombre.
Cobrado en período (real) ⓘ — suma de cobros registrados (ledger). Es el dinero que efectivamente entró. Es el dato autoritativo.
Recuperado (promesas) ⓘ — suma de promesas cumplidas. Es un indicador adelantado/proxy: si no se registran los cobros, no coincide con el cobrado real. Ver Indicadores.
Gestiones / período — cantidad de gestiones y cuántas positivas.
Ratio promesa-cumple — cumplidas / (cumplidas + incumplidas).
Promesas — pendientes, cumplidas, incumplidas y hechas en el período.
Callbacks — devoluciones de llamado pendientes para hoy.

Deudores¶

El listado de deudas de todas las carteras.

📷 Captura pendiente

tabla de deudores con filtros — assets/cobranzas/02-deudores.png

Filtros (y botón Filtrar): Cliente acreedor, Estado, Días en mora (mínimo), Monto mínimo.

Columnas: Contacto (nombre + documento), Cliente, Producto, Monto, Vencimiento, Días en mora, Estado, Score, Ref. externa.

Estados de una deuda: en mora, refinanciada (tiene un acuerdo), pagada, incobrable, dada de baja.

Hacé clic en el nombre del deudor para abrir su ficha de contacto, donde está toda su información de cobranzas (ver En la ficha del contacto).

Cómo se cargan las deudas¶

Individual: desde la ficha del contacto → solapa Cobranzas → botón de nueva deuda (ícono $ en el encabezado del contacto).
Masiva (recomendado para carteras): con la automatización del sistema de carga de cartera (subís un xls). Ver Carga masiva.

Promesas¶

Bandeja de promesas de pago.

📷 Captura pendiente

bandeja de promesas — assets/cobranzas/03-promesas.png

Filtros: estado (Pendientes…), Vencimiento, Cliente acreedor + botón Refrescar.

Columnas: Deudor, Cliente, Deuda, Promete (monto), Vence, Medio, Cobrador, Estado, Acciones.

Cargar una promesa¶

Las promesas se cargan desde una gestión

No hay un botón "Nueva promesa" suelto. Una promesa nace de una gestión (interacción con el deudor) tipificada como "Promesa de pago".

Abrí el contacto del deudor (o cerrá la llamada/conversación).
Tocá Nueva gestión (botón de tipificar en el encabezado del contacto).
Elegí la tipificación con resultado "Promesa de pago".
Se despliega el sub-formulario: elegí la deuda en mora, el monto prometido, la fecha, y opcional medio de pago y nota.
Guardar → queda registrada la gestión + la promesa.

📷 Captura pendiente

panel de gestión con sub-form de promesa — assets/cobranzas/04-gestion-promesa.png

Confirmar o marcar incumplida¶

Desde la bandeja (o desde la solapa Promesas del contacto):

Cumplir → se registra el cumplimiento (monto cobrado). Esto genera el cobro automáticamente (ver Cobros).
Incumplir → marca la promesa como no cumplida.

Acuerdos¶

Refinanciaciones: una deuda se reestructura en un plan de cuotas.

📷 Captura pendiente

bandeja de acuerdos — assets/cobranzas/05-acuerdos.png

Filtros: estado (Activos…), Cliente acreedor + Refrescar.

Columnas: Deudor, Cliente, Ref. deuda, Monto acuerdo, Cuotas, Cobrado, Próxima cuota, Estado, Acciones.

Armar un acuerdo¶

Desde la ficha del contacto → solapa Cobranzas:

Si la deuda está en mora, aparece + Nuevo acuerdo de refinanciación.
Definí monto total, cantidad de cuotas, fecha de la primera cuota y frecuencia (mensual / quincenal / semanal).
Al crearlo, la deuda pasa a refinanciada y se generan las cuotas.

Marcar una cuota pagada¶

En la solapa Acuerdos del contacto, expandí el acuerdo para ver sus cuotas y usá Marcar pagada.

Marcar una cuota pagada genera el cobro automáticamente

No registres además un cobro manual por esa misma cuota: se duplicaría.

Cobros¶

El registro de pagos efectivamente recibidos (el "cobrado real"). Vive en la solapa Cobros de la ficha del contacto.

📷 Captura pendiente

solapa Cobros del contacto — assets/cobranzas/06-cobros.png

Registrar cobro → carga un pago suelto (monto, fecha, deuda opcional, medio, nota). Útil cuando el deudor paga por fuera de una cuota/promesa.
Automáticos → marcar una cuota pagada o cumplir una promesa genera un cobro (la columna "Registró" muestra auto).
Anular → da de baja un cobro mal cargado (deja de contar en el total).

Indicadores¶

Clave para no confundir los números.

Cobrado (real): suma de los cobros del ledger. Dinero que entró. Es lo que importa para la rendición al acreedor.
Recuperado (promesas): suma de promesas cumplidas. Indicador adelantado/proxy — útil para proyectar, pero no es el cobrado real.

Ambos se muestran por separado en Mi panel, en la ficha del contacto y en los reportes del supervisor.

En la ficha del contacto¶

Cuando el deudor está abierto (Contactos → [deudor]), la primera solapa es Cobranzas, con un encabezado de totales y cuatro sub-solapas:

📷 Captura pendiente

solapa Cobranzas del contacto con totales y sub-tabs — assets/cobranzas/07-contacto-cobranzas.png

Totales: Total adeudado · En mora · Promesas pendientes · Acuerdos activos · Total cobrado · Recuperado (promesas).
Deudas — alta/edición/baja + botón de acuerdo de refinanciación.
Acuerdos — con cuotas expandibles (marcar pagada, cambiar estado).
Promesas — cumplir / incumplir.
Cobros — registrar / anular, e historial.

Carteras¶

Listado de carteras (portfolios) por cliente acreedor. Sirve para ver y organizar los lotes de deuda importados.

📷 Captura pendiente

solapa Carteras — assets/cobranzas/08-carteras.png

Reportes (supervisor)¶

Reportes → Cobranzas (/reportes/cobranzas): dashboard cross-cobrador y cross-cliente.

📷 Captura pendiente

reportes de cobranzas — assets/cobranzas/09-reportes.png

Resumen: Cobrado en período (real), % cobrado, Recuperado (promesas), Cartera en mora + aging.
Por cliente: cartera, cobrado (real), recuperado (proxy), % recupero, edad de mora, promesas.
Por cobrador: gestiones, promesas, ratio, cobrado (real), recuperado.

Carga masiva de carteras¶

Las deudas y los acuerdos se cargan en bloque desde Automatizaciones (subiendo un xls), sin tocar la API:

Menú → Automatizaciones → "Carga de cartera (deudas)" → Iniciar.
Adjuntá el xls y completá Cliente (código del acreedor) y Cartera.
Seguí el progreso en la solapa Ejecuciones.

Hay una automatización equivalente para acuerdos. (Disponibilidad según configuración de tu cuenta.)

Tips y errores comunes¶

El cliente acreedor debe existir antes de importar su cartera.
Una promesa cumplida decanta en un cobro — no lo cargues dos veces.
Cobrado real ≠ Recuperado (promesas): si no registrás los cobros, solo tenés el proxy de promesas cumplidas.
Si una deuda figura refinanciada, ya tiene un acuerdo: no se le crea otro.