Clientes
Los clientes son las personas (físicas o jurídicas) de tu cartera — en la interfaz, la página Clientes del menú lateral. Todo lo demás en el sistema gira en torno a ellos: cobros, acuerdos, notificaciones y el portal del deudor siempre apuntan a un cliente.

La lista
La lista muestra nombre, documento, teléfono, correo, saldo adeudado, días en mora, clasificación y fecha de registro, con búsqueda por nombre, documento o correo. El saldo adeudado y los días en mora aparecen en rojo cuando hay mora, y quedan en guion cuando la persona no debe nada. Cada fila da acceso a las acciones Visualizar, Editar y Eliminar.
Un filtro de Situación de deuda recorta la cartera en cuatro opciones: Todos, Con deuda (cualquier saldo abierto), Vencido (con un cobro en mora) y Al día (sin mora). Es el atajo para separar a quien necesita cobranza de quien está regular.
El registro
El formulario de Nuevo Cliente tiene estas secciones:
- Información Básica — Nombre (obligatorio), Razón Social (para empresas), Tipo de Documento (CPF o CNPJ) y Número de Documento (solo números), Alias (o nombre de fantasía), Fecha de Nacimiento, Clasificación e ID Externo.
- Correos — tantas direcciones como necesites, con tipo (Personal, Comercial, Financiero).
- Teléfonos — país, código de área y número, con tipo (Celular, Fijo, Comercial, WhatsApp).
- Direcciones — calle, número, complemento, barrio, ciudad, estado (UF) y código postal (CEP).
- Tags — etiquetas libres para organizar y filtrar la cartera.
- Información Adicional — Observaciones en texto libre y Datos Personalizados en JSON, para guardar cualquier metadato de tu negocio (código del contrato, vendedor responsable, etc.).
Dos campos merecen atención especial:
- Documento (CPF/CNPJ): además de identificar al cliente, es lo que el deudor usa para confirmar su identidad en el portal (4 últimos dígitos) y una de las claves de deduplicación en la importación.
- ID Externo (
external_id): el identificador del cliente en tu sistema (ERP, CRM, hoja de cálculo). Es la clave de deduplicación preferente en importaciones e integraciones — cuando está presente, prevalece sobre el documento. Si mantienes la cartera sincronizada con otro sistema, complétalo siempre.
El detalle del cliente
Resumen financiero arriba
Antes que nada, cuatro tarjetas dan la posición de deuda de la persona de un vistazo:
- Total adeudado — el valor sumado de los cobros abiertos.
- Total vencido — cuánto de ese total ya pasó del vencimiento (destacado en rojo cuando hay mora).
- Cobros vencidos — cuántos títulos están vencidos.
- Aging — el vencido abierto por rango de días en mora: 1–30, 31–60, 61–90 y 90+. Es la lectura de qué tan vieja es la deuda de esa persona; cuanto más peso en los rangos de la derecha, más difícil la recuperación.
Estos números vienen del agregado de todos los cobros abiertos de la persona, no solo de los que aparecen en la pantalla.
Las tarjetas de información
La página reúne el registro en tarjetas: información personal, clasificación (con tags y observaciones), contactos, direcciones, los últimos cobros de la persona (con vencimiento y días en mora), notificaciones recientes, interacciones recientes y los datos personalizados.
En los contactos, cada correo y teléfono tiene botón de copiar, y todo teléfono gana un atajo para abrir la conversación en WhatsApp directo al número, ahorrando digitación en el momento del contacto.
El estado de cuenta interactivo
El estado de cuenta ahora aparece en pantalla, no solo en PDF. La sección muestra los totales (en abierto, vencido, total adeudado y ya pagado) y una tabla con la posición de cada cobro de la persona (documento, vencimiento, estado, valor original y actual), actualizada en la fecha de la consulta. El botón Descargar PDF genera la misma posición en documento para enviar o archivar. Consulta Documentos generados.
Las acciones
En la parte superior, además de Editar y Eliminar, hay acciones específicas:
- Enlace del Portal — genera un enlace seguro del portal del deudor para esa persona. Al generar un enlace nuevo, los anteriores se revocan; el enlace tiene vigencia y el deudor confirma los 4 últimos dígitos del documento antes de ver cualquier monto.
- Estado de cuenta — abre la posición de todos los cobros de la persona (el estado de cuenta descrito arriba), con la opción de descargar en PDF.
- Nuevo cobro — crea un cobro ya vinculado a esa persona, sin necesidad de buscarla de nuevo en el formulario.
- Reclasificar — cambia manualmente la clasificación del cliente, con un campo de motivo opcional. Consulta Clasificaciones para entender cuándo es necesario y cuándo el sistema lo hace solo.
En la tarjeta de interacciones recientes, el botón Registrar contacto abre un diálogo para lanzar una interacción a mano: el tipo (llamada, correo, WhatsApp, reunión o nota), la dirección (recibido o enviado) y un resumen de lo que se trató. Es como la operación mantiene en el historial de la persona el contacto que ocurrió fuera de la regla (una llamada, una conversación presencial). Vía API, la interacción puede llevar también el desenlace — incluida una promesa de pago, que pausa la regla hasta la fecha prometida.
Buenas prácticas
- El contacto es el combustible de la regla: un cliente sin correo ni teléfono no recibe nada. Prioriza completar esos campos en la importación.
- Eliminar es definitivo (la interfaz pide confirmación). Si el problema es "no contactar", el camino correcto es la supresión/opt-out, que preserva el historial.
- Usa tags para recortes operativos (cartera antigua, mayorista, región) y Datos Personalizados para lo que necesita viajar junto al cliente en las integraciones.