# Manual de uso del módulo de Cobranzas ## 1. Objetivo del módulo El módulo de Cobranzas permite construir una cartera a partir de Phantom, organizar la gestión de cada cuenta, contactar al cliente mediante el teléfono registrado en Medusa y conservar un historial auditable de todo el ciclo. El módulo no reemplaza a Phantom: - Phantom continúa siendo la fuente de identidad, servicio, deuda y facturas. - Medusa es la fuente válida del teléfono de WhatsApp. - Los estados, notas, plantillas, comunicaciones y archivos de cobranza se administran localmente en Medusa. - Las sincronizaciones consultan Phantom, pero no modifican datos en Phantom. > **Importante:** el transporte inicia cerrado. `PRUEBA` sólo admite los contactos autorizados en la configuración y `PRODUCCION` habilita los contactos Medusa que superan todas las políticas de cobranza. La interfaz identifica visiblemente el modo activo. --- ## 2. Guía rápida para el operador Procedimiento habitual: 1. Ingresar a **Cartera**. 2. Aplicar los filtros necesarios para formar el grupo de trabajo. 3. Abrir un cliente haciendo clic sobre su fila. 4. Revisar en **Resumen** la deuda, vencimientos, períodos, datos de Phantom y estado de gestión. 5. Entrar en **Comunicación** y confirmar que exista un contacto Medusa válido. 6. Seleccionar o aceptar la plantilla automática. 7. Previsualizar el mensaje y revisar cuidadosamente su contenido y destino. 8. Enviar la notificación sólo si el entorno y el destinatario están autorizados. 9. Registrar llamadas, promesas, comprobantes y resultados desde **Resumen**. 10. Consultar **Historial** ante cualquier duda sobre acciones anteriores. 11. Finalizar la gestión únicamente cuando corresponda. Reglas rápidas: - Nunca utilizar los teléfonos informados por Phantom como destino de WhatsApp. - No marcar `FINALIZADA_PAGO` sólo porque el cliente diga que pagó; debe aplicarse el criterio operativo definido por la organización. - No confundir `SIN_RESPUESTA_NOTIFICACION` con `SIN_RESPUESTA_LLAMADA`. - Una llamada o promesa debe tener fecha programada. - Los comprobantes recibidos deben validarse o rechazarse manualmente. - Si otro operador modificó la gestión, actualizar el cliente antes de volver a guardar. --- ## 3. Roles y permisos ### Operador Puede: - consultar y filtrar la cartera; - abrir el detalle de un cliente; - cambiar estados permitidos; - programar llamadas y promesas de pago; - agregar notas; - previsualizar y enviar mensajes dentro de la política habilitada; - revisar, validar o rechazar archivos recibidos; - consultar comunicaciones e historial. ### Administrador Puede realizar todo lo anterior y además: - crear la cartera y el ciclo inicial; - sincronizar la cartera con Phantom; - cerrar un ciclo; - cancelar o reintentar ejecuciones; - consultar diagnósticos y errores; - configurar el plazo de respuesta; - crear, editar, activar y versionar plantillas; - consultar ciclos históricos. Los permisos actuales son temporales y se basan en los rangos `admin` y no administrador de Medusa. Está prevista una reestructuración posterior de permisos más granular. --- ## 4. Conceptos fundamentales ### 4.1 Cartera Es el listado de clientes que ingresaron al ciclo por poseer deuda. Incluye tanto quienes continúan debiendo como quienes se regularizaron durante ese mismo ciclo. ### 4.2 Snapshot Es una lectura completa de Phantom en un momento determinado. La interfaz continúa mostrando el snapshot vigente mientras se genera uno nuevo. Un nuevo snapshot sólo reemplaza al anterior si termina correctamente. Una ejecución con errores no modifica la cartera vigente. ### 4.3 Sincronización Es un nuevo barrido completo de Phantom dentro del mismo ciclo. Compara la situación actual con el snapshot anterior y detecta: - nuevos deudores; - clientes regularizados; - deuda aumentada; - deuda reducida; - cuentas sin cambios. Las notas, estados y operadores de las gestiones abiertas se conservan. ### 4.4 Ciclo de cobranza Representa un período completo de trabajo, por ejemplo «Cobranzas agosto 2026». Flujo recomendado: 1. Crear un ciclo y su snapshot inicial. 2. Trabajar sobre la cartera. 3. Realizar tantas sincronizaciones como sean necesarias. 4. Completar o cerrar las gestiones operativas. 5. Cerrar el ciclo con una sincronización final. 6. Iniciar un ciclo nuevo cuando corresponda. Un ciclo cerrado queda congelado y disponible para auditoría. Sus gestiones no se mezclan con las del ciclo siguiente. ### 4.5 Gestión Es el expediente local de cobranza de una cuenta Phantom dentro de un ciclo. Contiene estado, operador, próximas acciones, notas, comunicaciones, respuestas y archivos. ### 4.6 Regla operativa Es una clasificación; no determina si el cliente aparece o no en la cartera general. Todo cliente con deuda puede aparecer, aunque no cumpla una regla para contacto automático. Segmentos principales: - `ACTIVO_SIN_DEBITO`: servicio activo y sin `SDC`/`SDT`. - `ACTIVO_CON_DEBITO`: servicio activo con `SDC` o `SDT`. - `SUSPENDIDO`: servicio suspendido que cumple los criterios de comprobantes y vencimientos. - `SIN_REGLA`: tiene deuda, pero no encaja en una regla operativa gestionable. ### 4.7 Estado financiero - **Con deuda:** Phantom informa balance negativo. - **Regularizado:** Phantom informa balance igual o superior a cero después de haber integrado el ciclo. Los balances se muestran con el mismo signo utilizado por Phantom: la deuda aparece en negativo. --- ## 5. Navegación principal ### Cartera Vista operativa principal. Reúne deuda, clasificación, gestión y archivos de todos los clientes del ciclo vigente. ### Contactos Vista de conciliación entre el DNI de Phantom y los contactos de Medusa. Permite detectar cuentas sin teléfono válido o seleccionar un contacto preferido cuando existen varios teléfonos para un mismo DNI. ### Generación de cartera — sólo administrador Permite crear la cartera inicial, sincronizar contra Phantom, ver el progreso, cancelar una ejecución y revisar errores. ### Historial de ciclos — sólo administrador Permite consultar ciclos anteriores. Una cartera histórica es de sólo lectura. ### Configuración — sólo administrador Contiene el plazo de respuesta y la biblioteca de plantillas versionadas. ### Volver al chat Regresa al módulo principal de conversaciones de Medusa. ### Salir Cierra la sesión actual. --- ## 6. Cartera: filtros y métricas ### 6.1 Buscador general Busca coincidencias por: - ID Phantom; - nombre o razón social; - documento o CUIT; - ciudad o dirección; - teléfono informativo. Presionar `Enter` equivale a aplicar los filtros. ### 6.2 Estado financiero - **Todo estado financiero:** muestra deudores y regularizados. - **Con deuda actual:** sólo balances negativos. - **Regularizados:** clientes que ingresaron con deuda y luego alcanzaron balance cero o positivo. ### 6.3 Segmento Permite ver toda la cartera o separar activos sin débito, activos con débito, suspendidos y casos sin regla operativa. ### 6.4 Vencimientos - **Todos los vencimientos.** - **Con vencidas.** - **Sin vencidas.** ### 6.5 Hasta N comprobantes Muestra clientes cuya cantidad adeudada se encuentra entre cero y el número indicado. ### 6.6 Estado de gestión Filtra por el estado operativo actual. `Sin gestión` incluye registros informativos que no poseen una gestión habilitada. ### 6.7 Estado de archivos - todos los archivos; - con archivos pendientes; - con algún archivo recibido; - con archivos validados; - con archivos rechazados. ### 6.8 Aplicar filtros Ejecuta la búsqueda utilizando todos los criterios seleccionados. ### 6.9 Limpiar Restablece todos los filtros y vuelve a la primera página. ### 6.10 Métricas de cartera Las métricas siempre corresponden al conjunto filtrado completo, no solamente a la página visible: - **Registros filtrados:** total encontrado; debajo se indica cuántos hay en la página actual. - **Activos:** clientes con servicio activo. - **Suspendidos:** clientes suspendidos. - **Con débito automático:** cuentas con `SDC` o `SDT`. - **Regularizados:** cuentas que ya no presentan saldo deudor. - **Archivos pendientes:** total de archivos que requieren revisión. Se puede hacer clic para aplicar ese filtro. - **Cumplen regla operativa.** - **No cumplen regla.** ### 6.11 Actualizar Vuelve a consultar las tablas locales de Medusa. No ejecuta una sincronización con Phantom. ### 6.12 Exportar Excel Exporta la cartera completa correspondiente a los filtros aplicados, no sólo la página visible. ### 6.13 Personalizar columnas Permite mostrar, ocultar y reordenar columnas. La preferencia queda guardada en el navegador del operador. ### 6.14 Restaurar Recupera el orden y la visibilidad predeterminados de las columnas. ### 6.15 Ordenamiento Las flechas disponibles en los encabezados ordenan alfabética, numérica o cronológicamente según el campo. El orden se aplica al conjunto completo antes de paginar. ### 6.16 Navegación horizontal Cuando existen muchas columnas, la tabla puede desplazarse horizontalmente mediante la barra inferior o arrastrando con el mouse mientras se mantiene presionado el botón. ### 6.17 Reporte de métricas del ciclo La pestaña **Métricas** permite analizar el ciclo activo o seleccionar un ciclo histórico ya cerrado. No consulta nuevamente Phantom: utiliza los snapshots y los datos operativos auditados en Medusa. El encabezado resume: - **Saldo inicial:** deuda existente en el snapshot inicial y cantidad de clientes que la componían. - **Pendiente actualmente:** deuda y clientes que permanecen con saldo deudor en la última situación consolidada. - **Recuperación neta:** saldo inicial menos saldo pendiente actual, junto con su porcentaje. - **Clientes regularizados:** cuentas incorporadas al ciclo que actualmente ya no tienen deuda, junto con su porcentaje. El gráfico muestra la evolución del saldo pendiente y de la cantidad de clientes pendientes en cada snapshot o sincronización confirmada. Si una ejecución omitió algún cliente por un error puntual, se conserva para ese punto su último saldo conocido; así el total histórico coincide con la cartera consolidada y no simula una regularización inexistente. Los indicadores operativos muestran notificados, respuestas, archivos recibidos, promesas de pago, finalizaciones por pago, tareas vencidas y notificaciones pendientes en la cola. > **Interpretación:** la recuperación es neta, no una suma contable de pagos. Puede disminuir si durante el ciclo ingresan nuevos deudores o aumenta la deuda de cuentas existentes. --- ## 7. Modal del cliente Se abre haciendo clic sobre una fila de la cartera. ### 7.1 Cabecera Muestra: - ID Phantom; - nombre; - DNI; - CUIT; - ciudad. La línea horizontal representa únicamente los estados realmente recorridos. El nodo verde lima es el estado actual; los nodos turquesa son estados anteriores. ### 7.2 Resumen #### Métricas rápidas - **Balance C.C.:** saldo con la convención de signos de Phantom. - **Comprobantes adeudados:** total y cantidad vencida. - **Vencimiento última factura:** fecha y cantidad de días vencida o faltantes. - **Períodos adeudados:** chips por período. Si Phantom entregó una URL, hacer clic abre la factura en otra pestaña. #### Ficha Phantom Incluye razón social, dirección, teléfonos informativos, servicio, conexión, medio de pago, alta, instalación, estado financiero, regla operativa y datos de las últimas facturas. Los teléfonos Phantom son informativos y nunca se utilizan para enviar WhatsApp. #### Gestión Muestra el estado, el operador asignado y, cuando corresponde, la próxima acción con su línea de tiempo. El selector **Seleccionar acción** sólo ofrece transiciones permitidas desde el estado actual. La nota del cambio es opcional, pero se recomienda utilizarla para registrar cualquier información que ayude a otro operador a comprender la decisión. El botón **Aplicar cambio** guarda el estado, la fecha programada, el operador y la nota. Cada modificación queda en el historial. ### 7.3 Comunicación #### Contacto y destino Medusa Informa si existe un teléfono válido vinculado por DNI. Posibles situaciones: - **Vinculado:** existe un único destino válido o una preferencia elegida. - **Sin contacto:** no existe un contacto Medusa con ese DNI. - **Sin teléfono válido:** existe contacto, pero el identificador no sirve para WhatsApp. - **Documento Phantom ausente:** no es posible relacionar la identidad. - **Requiere selección:** existen varios teléfonos válidos y todavía no se eligió uno. #### Plantilla El sistema intenta seleccionar automáticamente la plantilla correspondiente al segmento. El operador puede elegir otra plantilla activa. #### Previsualizar mensaje Resuelve las variables con los datos actuales del snapshot y muestra el contenido exacto y el teléfono de destino. Previsualizar no envía nada. Antes de enviar revisar: 1. nombre del cliente; 2. saldo; 3. períodos; 4. enlaces de facturas; 5. teléfono de destino; 6. tipo de mensaje apropiado para el segmento. #### Enviar notificación Envía el texto previsualizado cuando la política de seguridad lo permite. El estado cambia a `NOTIFICACION_ENVIADA` únicamente después de que WhatsApp confirma el envío. Al enviarse: - se registra una copia exacta del mensaje; - comienza el plazo de respuesta; - se abre o se traslada silenciosamente el chat al área **Gestión Cobranza**; - si estaba siendo gestionado en otra área, Cobranzas toma su propiedad; - el chat queda bloqueado para el operador que confirmó el envío; - la gestión local también queda asignada a ese operador, reemplazando una asignación anterior; - las respuestas futuras ingresan al chat humano sin atravesar la IA. #### Mensajes enviados Muestra el texto exacto, versión de plantilla, destino, estado, apertura del chat y línea de espera. La versión enviada no cambia aunque un administrador edite la plantilla posteriormente. #### Archivos recibidos Un archivo recibido durante una gestión abierta queda pendiente de revisión. - **Ver:** abre el archivo. - **Validar:** lo marca como válido para esa gestión. - **Rechazar:** indica que no corresponde o no es aceptable. Validar o rechazar no modifica Phantom ni imputa pagos. ### 7.4 Historial Permite agregar notas internas y consultar una línea temporal vertical con: - cambios de estado; - fecha y hora; - operador o sistema responsable; - fechas programadas; - notas; - respuestas y archivos detectados. El evento más reciente aparece primero y se destaca visualmente. --- ## 8. Estados de gestión ### `PENDIENTE` Gestión creada y todavía no trabajada. Es el punto inicial normal. ### `NOTIFICACION_ENVIADA` WhatsApp confirmó el envío. Comienza el plazo configurado para esperar respuesta. ### `NOTIFICACION_PENDIENTE` Estado técnico exclusivo de las colas. Se asigna al confirmar un lote y evita incorporar la gestión a otra campaña mientras espera su horario. Al confirmarse el envío pasa a `NOTIFICACION_ENVIADA`; si se omite o falla sin otra programación activa, vuelve a `PENDIENTE` registrando el motivo. Los envíos manuales no utilizan este estado intermedio. ### `SIN_RESPUESTA_NOTIFICACION` El plazo venció sin respuesta. El sistema realiza esta transición automáticamente. Normalmente corresponde evaluar una llamada. ### `LLAMADA_PROGRAMADA` Existe una llamada futura con fecha obligatoria. La interfaz destaca si está programada, corresponde hoy o está vencida. ### `SIN_RESPUESTA_LLAMADA` Un operador intentó llamar y no obtuvo respuesta. Es un resultado manual y diferente de la falta de respuesta al WhatsApp. ### `EN_GESTION` Un operador está trabajando activamente el caso. Debe quedar identificado el operador responsable. Una respuesta del cliente a una notificación abierta puede llevar automáticamente la gestión a este estado. ### `PROMESA_PAGO` El cliente asumió un compromiso de pago. La fecha es obligatoria. Actualmente el vencimiento no cambia automáticamente el estado; la interfaz sirve como recordatorio para el operador. ### `COMPROBANTE_RECIBIDO` Existe constancia de un comprobante asociado a la gestión. El archivo todavía puede requerir validación. ### `FINALIZADA_PAGO` La gestión se considera resuelta por pago. También puede asignarse automáticamente cuando una sincronización confirma balance cero o positivo. Es un estado terminal dentro del ciclo, salvo que una sincronización posterior detecte deuda nuevamente y reactive la gestión. ### `NO_GESTIONAR` Decisión explícita de excluir la cuenta del trabajo operativo dentro del ciclo. Es terminal y no equivale a pago. ### `FINALIZADA_CICLO` El ciclo fue cerrado y la gestión quedó archivada sin importar el saldo final. Es de sólo lectura. --- ## 9. Líneas de tiempo y vencimientos ### Línea de estados - Turquesa: estado ya recorrido. - Verde lima: estado actual. No muestra caminos futuros; sólo hechos auditados. ### Espera de respuesta - Turquesa: espera activa normal. - Verde: respuesta recibida o espera completada. - Rojo: plazo vencido o error. - El nodo móvil indica cuánto tiempo transcurrió. ### Llamadas y promesas - Azul: programada para una fecha futura. - Amarillo: corresponde hoy. - Rojo: vencida. La fecha y el texto de tiempo restante son la referencia operativa; el color sirve como ayuda visual. --- ## 10. Contactos y teléfonos Phantom puede entregar teléfonos nulos, antiguos o mal formateados. Por ese motivo, Medusa utiliza exclusivamente la tabla `contactos` como fuente del destino. La vinculación se realiza por documento: ```text DNI Phantom ↔ contactos.dni de Medusa ``` La pestaña **Contactos** muestra toda la cartera del ciclo, tanto clientes con deuda como regularizados. No se limita a quienes cumplen una regla operativa. Su contador representa el universo completo y la tabla se recorre en páginas de 50 registros. Desde esa tabla se puede buscar por cualquier dato del cliente y filtrar por: - sin contacto; - sin teléfono válido; - vinculado; - sin documento Phantom; - con deuda o regularizado. Cada fila informa la cantidad de contactos encontrados, los teléfonos válidos y el destino finalmente elegido. Un mismo DNI puede tener varios contactos porque una persona puede utilizar más de un teléfono. En ese caso se debe elegir un contacto preferido. El número de teléfono no puede repetirse en contactos, pero un mismo número puede haber sido utilizado en pruebas para gestionar cuentas diferentes cambiando el DNI. Las respuestas se asocian a la comunicación abierta más reciente de ese teléfono; no se duplican automáticamente entre cuentas. Modificar el DNI de un contacto no actualiza por sí solo una cartera ya generada. La conciliación puede refrescarse, pero el snapshot y la relación operativa deben revisarse según el caso. --- ## 11. Generación y sincronización de cartera ### Crear cartera inicial Uso exclusivo del administrador. 1. Ingresar el nombre del ciclo. 2. Elegir la fecha de evaluación. 3. Presionar **Crear cartera operativa**. 4. Esperar la finalización completa. La ejecución recorre activos y suspendidos y puede demorar varios minutos. ### Sincronizar con Phantom Repite el barrido completo y compara contra el snapshot vigente. Puede ejecutarse más de una vez al día cuando se necesite información más reciente. ### Métricas de ejecución - **Transcurrido:** tiempo utilizado. - **Velocidad de revisión:** clientes revisados por minuto. - **Tiempo restante:** estimación dinámica, no garantía. - **Revisados en Phantom:** clientes leídos en la consulta masiva. - **Con saldo deudor:** cuentas que pasaron a evaluación de deuda. - **Cumplen regla operativa:** deudores clasificados en un segmento gestionable. - **No cumplen regla:** clientes revisados que no satisfacen una regla. - **Deudores sin regla:** tienen deuda y aparecen en cartera, pero no son gestionables por regla. - **Errores:** clientes que no pudieron evaluarse correctamente. ### Diferencias de sincronización - nuevos; - regularizados; - deuda aumentada; - deuda reducida; - sin cambios. ### Ejecución con errores Una ejecución operativa con errores no reemplaza la cartera vigente. El administrador puede revisar el detalle y usar **Reintentar errores**. ### Cancelar ejecución Solicita una cancelación cooperativa. Las consultas ya iniciadas pueden terminar, pero no se comienzan nuevos clientes. ### Diagnóstico avanzado Permite limitar clientes o estados para investigar. Nunca reemplaza ni reconcilia la cartera operativa. --- ## 12. Cierre de ciclo El botón **Cerrar ciclo con sincronización final**: 1. ejecuta un último barrido; 2. aplica las regularizaciones confirmadas; 3. finaliza las gestiones todavía abiertas como `FINALIZADA_CICLO`; 4. congela el ciclo para auditoría. Si la sincronización final falla o se cancela, el ciclo vuelve a estado activo y no se cierra. No cerrar un ciclo mientras existan acciones que deban completarse dentro de ese período sin antes revisar la cartera y las gestiones pendientes. --- ## 13. Configuración y plantillas ### Tiempo de respuesta Define las horas corridas desde la confirmación de WhatsApp hasta `SIN_RESPUESTA_NOTIFICACION`. - predeterminado: 48 horas; - mínimo: 1 hora; - máximo: 720 horas. Cambiar la configuración afecta comunicaciones futuras. Cada mensaje conserva el plazo con el que fue enviado. ### Crear plantilla Campos: - **Nombre:** identificación visible para operadores. - **Finalidad:** descripción interna. - **Aplicación automática:** segmento al que se asigna. - **Contenido:** texto enviado. - **Plantilla activa:** determina si está disponible. Sólo puede existir una plantilla automática activa por segmento. ### Variables disponibles - `{{nombre}}` - `{{balance}}` - `{{periodos}}` - `{{primer_vencimiento}}` - `{{links_facturas}}` - `{{id_phantom}}` ### Versiones Editar una plantilla no sobrescribe la versión anterior. Crea una versión nueva. Los mensajes ya enviados conservan el texto y la versión exacta utilizada. --- ## 14. Selección múltiple y cola de envíos La cartera permite seleccionar varios clientes y preparar un lote controlado. Sólo se habilita el selector cuando el cliente: - mantiene deuda; - cumple una regla operativa; - tiene una gestión activa; - posee un teléfono vinculado en Medusa; - cuenta con una plantilla automática activa para su segmento; - no se encuentra finalizado; - nunca fue notificado previamente durante ese ciclo. El botón **Seleccionar elegibles de esta página** marca únicamente los registros habilitados de la página visible. **Preparar envíos** abre una revisión obligatoria con el destinatario, la plantilla y el texto exacto de cada mensaje. Cerrar esa revisión cancela el borrador; confirmar crea la programación definitiva. El filtro **Segmentos** admite selección múltiple, por ejemplo activos sin débito y suspendidos en una misma consulta. El filtro **Aptos para campaña** y la columna homónima identifican los casos que reúnen simultáneamente deuda vigente, regla y plantilla automática, gestión abierta, destino Medusa resuelto, autorización de envío y ausencia de una notificación anterior en el ciclo. La pestaña **Cola de envíos** muestra los lotes, sus mensajes enviados, pendientes, omitidos y con error. El límite es global: como máximo pueden enviarse 60 mensajes diarios entre todos los operadores. La ventana operativa es de **09:00 a 20:00**. Los mensajes se separan mediante un intervalo aleatorio de **8 a 11 minutos**: - un lote confirmado antes de las 09:00 comienza a las 09:00; - dentro de la ventana comienza desde el horario de confirmación, respetando cualquier lote ya programado; - después de las 20:00 comienza a las 09:00 del día siguiente; - si no queda tiempo o cupo para completar el lote, el excedente pasa automáticamente al siguiente día a partir de las 09:00. La pantalla de revisión muestra la fecha y hora estimada de cada mensaje y un resumen de cuántos se programarán por día. Al confirmar se recalcula el cronograma dentro de una transacción para incorporar otros lotes que pudieran haberse confirmado mientras se revisaba. Antes de cada envío se revalidan deuda, estado, teléfono, plantilla, versión y contenido. Si algo cambió después de la revisión, el mensaje queda **Omitido** y no se envía. Sólo un envío confirmado consume el cupo definitivo y cambia la gestión a **Notificación enviada**. > En `PRUEBA`, la selección y el transporte se limitan a la lista autorizada. En `PRODUCCION`, se habilitan todos los destinos Medusa elegibles, manteniendo el cupo, la cola y las validaciones previas a cada envío. --- ## 15. Chat principal de Medusa Después de una notificación confirmada: - si el teléfono no existe en `clientesactivo`, se crea silenciosamente en **Gestión Cobranza**; - si ya estaba activo, se traslada a **Gestión Cobranza**, incluso si pertenecía a otra área; - el lock anterior se reemplaza por uno persistente a nombre del operador que envió la notificación; - los demás operadores no pueden tomar ese chat mientras el lock continúe activo; un administrador conserva las facultades generales de desbloqueo; - el mensaje enviado queda visible en el chat; - la respuesta del cliente ingresa a operadores humanos y no a la IA; - administradores y usuarios del área pueden utilizar el filtro **Gestión Cobranza**. Finalizar la gestión de cobranza no cierra automáticamente el chat. El operador debe cerrarlo desde el módulo principal cuando la conversación realmente haya terminado. --- ## 16. Actualización de la información ### Botón Actualizar Refresca la vista desde la base local. No consulta Phantom. ### Sincronización Es la única operación normal que vuelve a recorrer Phantom y actualiza saldos, comprobantes y estado financiero de toda la cartera. ### Tiempo real El módulo todavía no utiliza una room propia de Socket.IO. Algunos cambios realizados por otro operador pueden requerir presionar **Actualizar** o volver a abrir el cliente. Existe control de concurrencia: si dos operadores modifican la misma versión, uno puede recibir un error de gestión desactualizada. En ese caso: 1. cerrar o actualizar el cliente; 2. revisar el cambio del otro operador; 3. volver a realizar la acción si todavía corresponde. --- ## 17. Casos frecuentes ### El cliente no tiene contacto válido 1. Ir a **Contactos**. 2. Buscar la cuenta. 3. Corregir el DNI o teléfono desde la administración de contactos de Medusa. 4. Volver a actualizar la conciliación. 5. Si existen varios teléfonos, guardar uno como preferido. No copiar manualmente el teléfono de Phantom como destino. ### El cliente pagó pero todavía aparece con deuda El módulo muestra el último snapshot confirmado. Ejecutar una sincronización para volver a consultar Phantom. No asumir que una ausencia o error equivale a pago. ### Llegó un archivo 1. Abrir el indicador de archivos pendientes. 2. Entrar al cliente y a **Comunicación**. 3. Abrir el archivo. 4. Validar o rechazar. 5. Registrar una nota si requiere seguimiento. 6. Cambiar el estado sólo cuando corresponda. ### La llamada está vencida Realizar o reprogramar la acción. Después del intento utilizar `EN_GESTION`, `SIN_RESPUESTA_LLAMADA`, `PROMESA_PAGO`, `COMPROBANTE_RECIBIDO`, `FINALIZADA_PAGO` o `NO_GESTIONAR`, según el resultado real. ### La promesa venció El sistema no cambia automáticamente el estado. El operador debe revisar Phantom, contactar al cliente y registrar el resultado. ### No se puede enviar una notificación Verificar: - contacto válido y preferido; - plantilla activa; - previsualización generada; - política de envío del entorno; - conexión de WhatsApp; - permisos del usuario. ### El mensaje se envió pero el chat no se abrió El historial puede indicar un error de apertura del chat. No reenviar automáticamente: el WhatsApp ya pudo haber sido entregado. Informar el error y revisar el chat principal. ### Una sincronización muestra errores La cartera anterior sigue vigente. Revisar el listado de errores y utilizar **Reintentar errores**. No interpretar esos clientes como regularizados. --- ## 18. Acciones que no realiza el MVP Actualmente el módulo no: - escribe o modifica datos en Phantom; - crea tickets en Phantom; - registra promesas de pago en Phantom; - imputa pagos; - valida automáticamente comprobantes; - genera links de Mercado Pago; - entrega alias bancarios; - cierra automáticamente chats al finalizar una gestión; - envía fuera de la cola, el cupo y la ventana horaria configurados; - actualiza todas las pantallas en tiempo real. --- ## 19. Buenas prácticas operativas - Trabajar siempre sobre el ciclo activo correcto. - Aplicar filtros pequeños y comprensibles. - Revisar el destino antes de cada envío. - Utilizar notas breves, objetivas y auditables. - Programar fechas realistas. - No usar `NO_GESTIONAR` como sustituto de “no respondió”. - No usar `FINALIZADA_PAGO` como sustituto de “envió comprobante”. - Validar archivos antes de tomar decisiones definitivas. - Sincronizar antes de una revisión importante o cierre de ciclo. - Revisar errores antes de confiar en los resultados de una ejecución. - Cerrar el chat principal sólo cuando la conversación haya terminado. --- ## 20. Glosario - **Balance C.C.:** balance de cuenta corriente informado por Phantom. - **Comprobante:** factura o documento de deuda/pago informado por Phantom o recibido por WhatsApp, según el contexto. - **Contacto Medusa:** registro local que aporta el teléfono válido. - **Cuenta Phantom:** cliente identificado por su ID único en Phantom. - **Destino:** teléfono de WhatsApp elegido desde Medusa. - **Gestión:** expediente operativo local de una cuenta dentro de un ciclo. - **Período:** mes y año asociado a una factura. - **Regularizado:** cliente que ingresó con deuda y luego alcanzó balance cero o positivo. - **Snapshot:** fotografía completa de la cartera en un momento. - **Sincronización:** comparación de un snapshot nuevo contra el vigente. --- ## 21. Soporte y auditoría Ante una duda, registrar: - ID Phantom; - ID de gestión, si está disponible; - ciclo; - estado actual; - operador; - fecha y hora; - captura del error; - acción que se intentó realizar. Antes de repetir un envío o una acción, consultar las pestañas **Comunicación** e **Historial**. El objetivo del registro auditable es evitar duplicaciones y permitir reconstruir exactamente qué ocurrió.