Propuesta Técnica · Confidencial

Sistema de Gestión de Cobranzas

Automatización del proceso interno de cobros B2B — desde la emisión de la factura hasta el pago, sin depender del email como herramienta de gestión

Junio 2026

El negocio y el problema

🏢

Cobros B2B mensuales

Se factura mensualmente a empresas clientes por servicios prestados. Los montos son variables según consumo del período.

👥

Múltiples departamentos involucrados

Cobranzas, Comercial, Finanzas y Gerencia participan en el proceso de cobro. Cada uno desde su rol, sin visibilidad de lo que hacen los demás.

📧

El email como herramienta de gestión

Desde que se emite la factura, todo el seguimiento interno ocurre por correo. El email se convirtió en el "sistema" de cobros — con todos los problemas que eso implica.

📈

Montos variables

Cada mes el monto difiere según el consumo del cliente. Eso genera preguntas, verificaciones y más emails internos por cada factura.

⚠️ El problema real — es 100% interno

El ruido no lo genera el cliente externo. Lo genera el propio equipo al gestionar los cobros por email. Desde el momento en que se emite una factura, cada paso del proceso — verificar si se envió, hacer seguimiento, escalar si no pagaron, preguntar el desglose, confirmar el pago — se hace enviando un correo a alguien.

Con decenas de facturas activas en distintos estados, las bandejas de entrada de Cobranzas, Comercial y Finanzas se llenan de hilos entrelazados. Nadie tiene visibilidad real del estado de los cobros sin leer todos esos emails.

El diagnóstico: No hay un sistema de gestión — el email ES el sistema. Cada hilo de correo es un cobro en proceso. Cada respuesta es una actualización de estado que solo existe en la bandeja de quien la recibió. El sistema propuesto no elimina el email, sino que lo captura y lo convierte en datos estructurados y visibles para todos.

Ciclo de vida de un cobro mensual

Cada factura mensual sigue este recorrido — con o sin sistema. La diferencia es quién lleva el control.

📄
Factura
Se emite y envía por correo al cliente
Recordatorio
Días antes del vencimiento
🔴
Vencida
No llegó el pago — inicia la gestión activa
📨
En Cobro
Emails, llamadas, escalaciones internas
💬
Negociación
Disputa de monto, pago parcial, plan de pago
Pagada
Total o parcial. Acreditada y reconciliada

El flujo interno real — desde que se emite la factura:

1

Factura emitida — Cobranzas la envía al cliente

Se registra en algún Excel o sistema contable. Se envía por email al cliente. ¿Quién confirma que llegó? ¿Hay acuse de recibo? Nadie lo sabe a menos que alguien revise.

2

Se acerca el vencimiento — hay que hacer seguimiento

Cobranzas envía un recordatorio por email al cliente. ¿Ya se había enviado antes? ¿Quién lo envió? Hay que buscar en el historial del inbox.

3

Factura vencida — Cobranzas escala a Comercial

Email interno: "Oye, ¿sabes algo del cliente X? Llevan 5 días sin pagar". Comercial responde: "Tienen una duda sobre el monto de este mes". Nuevo hilo, sin referencia a la factura. Cobranzas no sabe qué duda tiene el cliente.

4

Comercial pregunta a Finanzas el desglose

Otro email: "¿Pueden enviarme el detalle del consumo de cliente X en mayo?" Tercer hilo separado. Finanzas no sabe por qué se pide ni cuál es la urgencia. La respuesta tarda 2 días.

5

Gerencia pide reporte de cobros

"¿Cómo vamos con los cobros de este mes?" Alguien tiene que revisar 4 bandejas de entrada distintas para armar la respuesta. Esa revisión se repite cada semana y tarda horas.

Con el sistema — cada factura tiene su expediente digital

Todos los emails relacionados a esa factura se capturan automáticamente. El estado es visible para todos los departamentos en tiempo real. Gerencia abre el panel y ve el consolidado — sin preguntar a nadie.


Cómo funciona el sistema

Una capa de inteligencia que se conecta al correo interno y convierte automáticamente cada email relacionado a un cobro en un registro estructurado. Los equipos siguen trabajando como siempre — pero ahora cada acción queda registrada, cada factura tiene su expediente completo y el estado es visible para todos sin tener que preguntar.

📬

Mailpit (servidor de correo)

Simula las cuentas internas de cada departamento: cobranzas@, finanzas@, comercial@, gerencia@. En producción se conecta al servidor de correo existente vía IMAP.

⚙️

n8n (orquestación)

Lee el email, lo clasifica, lo conecta a la factura correcta, actualiza estados, dispara alertas. Todo automático.

🧠

Gemini AI (comprensión)

Extrae datos de emails en texto libre: número de factura, monto, cliente, intención del mensaje, acción requerida. También resume hilos completos.

🗄️

PostgreSQL

Base de datos central. Clientes, facturas, pagos, tickets, hilos de email. Todo relacionado y consultable.

🖥️

Panel web (Next.js)

Dashboard, aging report, gestión de tickets, analytics. Cada rol ve lo que necesita. Sin acceso a los emails crudos.

🔒

Seguridad por roles

Cobranzas ve sus cuentas. Gerencia ve el consolidado. Comercial ve solo sus clientes. Cada uno con su acceso.


6 flows de procesamiento

Flow 01

Ingesta de emails

Polling IMAP cada 5 min en todas las cuentas departamentales deduplicación por Message-ID detecta si es email externo (cliente) o interno (entre departamentos) encola para clasificación.

Flow 02

Clasificación IA (Gemini)

Para cada email: extrae número de factura, monto mencionado, nombre del cliente, intención (PAGO_CONFIRMADO / DISPUTA_MONTO / SOLICITUD_DESGLOSE / PROMESA_PAGO / SIN_FONDOS / INTERNO) vincula al registro de factura correspondiente en la DB.

Flow 03

Gestión de hilos internos

Detecta emails internos (entre departamentos) via headers In-Reply-To + dominio agrupa en un ticket vinculado a la factura identifica departamento responsable actual cada nuevo mensaje actualiza el ticket. Este flow es el núcleo del sistema.

Flow 04

Resumen IA del ticket

Cuando llega un nuevo mensaje al hilo Gemini lee el hilo completo genera: estado actual en una oración, acción pendiente, departamento responsable, riesgo de no cobro actualiza el ticket. Gerencia ve el resumen, no los 15 emails.

Flow 05

Detección de pagos y conciliación

Email de confirmación de pago (del cliente o del banco) extrae monto y referencia cruza con factura pendiente marca como PAGADA o PAGO_PARCIAL detecta si hay diferencia entre monto facturado y monto pagado.

Flow 06

SLA, alertas y escalación automática

Trigger cada hora facturas vencidas sin gestión activa en +24h tickets sin respuesta en +4h / +24h / +48h clientes con más de 2 facturas pendientes alerta al responsable correcto según reglas de escalación configurables.


Modelo de datos

👤 clientes
id uuid
nombre
nit unique
email_contacto
email_ap cuentas x pagar
ejecutivo_id fk
dias_credito
limite_credito
📄 facturas
id uuid
numero_factura unique
cliente_id fk
monto_total
monto_pagado
fecha_emision
fecha_vencimiento
status enum
periodo 2026-06
🎫 tickets
id uuid
factura_id fk
status enum
depto_actual
ai_resumen
ai_accion_pendiente
ai_riesgo ALTO/MEDIO/BAJO
ultimo_mensaje_at
resuelto_at
💬 mensajes_ticket
id uuid
ticket_id fk
email_id fk
tipo INTERNO/EXTERNO
de_depto
para_depto
enviado_at
💳 pagos
id uuid
factura_id fk
monto
fecha_pago
referencia_bancaria
email_id origen
📧 emails_raw
id uuid
message_id unique
de / para
asunto
cuerpo
tipo_clasificado
recibido_at
procesado bool

Status facturas: EMITIDA → ENVIADA → VENCIDA → EN_GESTION → PAGADA / PAGO_PARCIAL / INCOBRABLE
Status tickets: ABIERTO → EN_GESTION → ESPERANDO_CLIENTE → ESPERANDO_INFO → RESUELTO / ESCALADO


Aging report — la vista que más importa

El aging report (reporte de antigüedad) es el corazón del sistema. Muestra cuánto dinero está pendiente de cobro y hace cuánto tiempo lleva sin pagarse. Es lo que gerencia necesita ver cada mañana.

Cliente Al corriente 1–30 días 31–60 días 61–90 días +90 días Total Riesgo IA
Empresa A Q 45,000 Q 45,000 BAJO
Empresa B Q 12,000Q 8,500 Q 20,500 MEDIO
Empresa C Q 32,000Q 15,000 Q 47,000 ALTO
Empresa D Q 28,000 Q 28,000 CRÍTICO

El riesgo IA lo calcula Gemini basado en el historial de pagos del cliente, el contenido de los hilos de email y cuántos días lleva sin respuesta.


8 módulos del dashboard

📊

Dashboard ejecutivo

  • Total por cobrar este mes
  • % cobrado vs emitido
  • Facturas vencidas hoy
  • Tickets abiertos sin respuesta
  • DSO (días promedio de cobro)
📄

Facturas

  • Lista con filtros por status
  • Por cliente, período, monto
  • Vista de historial de pagos
  • Exportar a CSV/Excel
🎫

Tickets de cobro

  • Una vista por factura en gestión
  • Hilo de emails adjunto
  • Resumen IA en una oración
  • Acción pendiente clara
  • Timer SLA visible
⏱️

SLA y escalaciones

  • Tickets vencidos por depto.
  • Cuellos de botella visibles
  • Tiempo promedio por etapa
  • Alertas de escalación activas
📉

Aging report

  • Tabla de antigüedad en tiempo real
  • Por cliente, por ejecutivo
  • Riesgo IA por cuenta
  • Comparativo vs mes anterior
🏢

Clientes

  • Historial de pagos por cliente
  • Comportamiento de pago (DSO)
  • Facturas activas
  • Tickets abiertos
📈

Analytics

  • Tendencias de cobro 30d/90d
  • Efectividad por ejecutivo
  • Motivos de disputa más frecuentes
  • Proyección de cobros del mes
📬

Emails

  • Bandeja unificada por factura
  • Emails sin clasificar
  • Re-procesar con IA
  • Trazabilidad completa

Tipos de emails que el sistema procesa

El entorno de prueba simula ambos canales: emails externos del cliente y emails internos entre departamentos.


Qué se construye nuevo vs qué se reutiliza

🆕 Nuevo (específico de este sistema)

  • Modelo de datos AR (facturas, pagos, aging)
  • Detección de hilos internos vs externos
  • Resumen IA por ticket de cobro
  • Aging report en tiempo real
  • Motor de escalación por reglas
  • Simulador de emails B2B realistas
  • Vista de hilo de email por factura

♻️ Reutilizado del stack existente

  • Patrón n8n + Gemini (= RecruitAI)
  • Next.js 14 + Prisma + NextAuth
  • Roles y permisos (= MGP)
  • shared-postgres + shared-redis
  • Traefik HTTPS automático
  • Patrón MCP + Skill
  • Mailpit (= reclutamiento)

¿Confirmamos el approach?

Si está alineado con lo que necesitan, el siguiente paso es crear la estructura del proyecto, el docker-compose, los 6 flows de n8n, el modelo de datos y el MCP — todo en la misma sesión.