Detalle de Caso y Registro de Actividades

La pantalla de detalle de un caso (/cobranza/{id}) concentra toda la información de una gestión de cobranza: datos del cliente, saldo vencido, historial de actividades y promesas de pago. Desde aquí el cobrador realiza y registra todas las acciones de contacto.

Requisitos y permisos

Permiso requerido	Acción
cobranza.ver	Ver el detalle del caso, actividades y promesas
cobranza.gestionar	Registrar nuevas actividades y promesas de pago

Pantalla de detalle

Acceda desde la bandeja haciendo clic en Ver en la fila del caso. La pantalla se divide en:

1. Botón Regresar — navega a /cobranza.
2. Encabezado del caso — datos clave del cliente y del caso.
3. Panel Actividades (izquierda) — línea de tiempo de todas las actividades registradas.
4. Panel Promesas de pago (derecha) — lista de compromisos de pago registrados.

Encabezado del caso

El encabezado muestra en una sola tarjeta:

Campo	Descripción
Nombre / RFC	Razón social y RFC del cliente
Teléfono	Número de contacto del cliente (si está registrado)
Saldo Vencido	Monto actual pendiente en MXN, resaltado en rojo
Días Vencidos	Días transcurridos desde la apertura del caso
Estado	Estado actual de la gestión
Asignado a	Nombre del cobrador o “Sin asignar”
Nivel	Nivel de escalación actual (inicia en 1)
Notas	Observaciones generales del caso (si existen)

Asignar cobrador

Para asignar o reasignar el cobrador responsable de un caso, utilice la mutación asignarCobrador desde la API. Si no se especifica un cobrador, el sistema selecciona automáticamente uno de los cobradores activos disponibles usando un algoritmo round-robin ponderado por capacidad de casos.

Nota

La pantalla de detalle actual no incluye un selector de cobrador visible. La asignación se realiza desde procesos automatizados o mediante integración de API. Si necesita reasignar manualmente un caso, contacte al administrador del sistema.

Historial de actividades (línea de tiempo)

El panel Actividades muestra todas las interacciones registradas en el caso, ordenadas cronológicamente. Cada entrada incluye:

• Ícono de tipo — identifica visualmente el tipo de actividad.
• Resultado — etiqueta del resultado del contacto.
• Fecha y hora — en formato dd MMM HH:mm.
• Notas — texto libre del agente (máximo 1 000 caracteres).
• Agente — nombre del usuario que registró la actividad (cuando aplica).

Tipos de actividad

Tipo	Descripción
LLAMADA	Llamada telefónica al cliente
EMAIL	Correo electrónico enviado al cliente
WHATSAPP	Mensaje de WhatsApp enviado al cliente
NOTA	Anotación interna sin contacto directo
VISITA	Visita presencial al cliente
ESCALACION_AUTOMATICA	Escalación generada por el sistema (automática o manual)

Resultados de actividad

Resultado	Descripción
CONTACTADO	Se logró hablar con el cliente
NO_CONTACTADO	No se pudo contactar al cliente
COMPROMISO_OBTENIDO	El cliente verbalizó un compromiso de pago
PAGO_RECIBIDO	Se confirmó la recepción del pago
INCOBRABLE	El agente determinó que la deuda es irrecuperable

Registrar una nueva actividad

El botón Nueva actividad (parte superior del panel Actividades) abre un diálogo con el siguiente formulario:

Campos del formulario

Campo	Obligatorio	Valores
Tipo	Sí	Llamada · Email · WhatsApp · Nota · Visita
Resultado	Sí	Contactado · No contactado · Compromiso obtenido · Pago recibido · Incobrable
Notas	No	Texto libre (máximo 1 000 caracteres)

Pasos para registrar una actividad

1. Haga clic en Nueva actividad.
2. Seleccione el Tipo de contacto realizado.
3. Seleccione el Resultado obtenido.
4. Escriba Notas opcionales con el detalle de la conversación.
5. Presione Registrar.

El sistema guarda la actividad y actualiza la línea de tiempo inmediatamente. Si el registro falla, aparece una notificación de error en la esquina de la pantalla.

Precaución

Las notas no pueden exceder 1 000 caracteres. El sistema rechazará el registro si se supera este límite.

Escalación manual de un caso

Para subir el nivel de escalación de un caso sin esperar al proceso automático nocturno, utilice la acción de escalación manual. Esta acción:

• Incrementa nivelActual en 1.
• Si el caso estaba en ABIERTO, lo cambia a EN_GESTION.
• Registra automáticamente una actividad de tipo ESCALACION_AUTOMATICA con resultado OK_ENVIADO y el motivo indicado.

Nota

La escalación manual solo está disponible para casos en estado ABIERTO, EN_GESTION o EN_PROMESA. Los casos en estado RESUELTO o INCOBRABLE no pueden escalarse.

Preguntas frecuentes

¿Puedo editar una actividad registrada? No. Las actividades son registros inmutables de auditoría. Si necesita corregir información, registre una nueva actividad del tipo NOTA con la corrección.

¿Cómo sé si una actividad fue generada automáticamente? Las actividades automáticas muestran el tipo ESCALACION_AUTOMATICA o RECORDATORIO_AUTOMATICO en la línea de tiempo, en lugar de un nombre de usuario.

¿Qué sucede cuando registro el resultado “Pago recibido”? La actividad queda registrada, pero el cierre del caso se realiza automáticamente cuando el sistema detecta que las parcialidades vinculadas a una promesa de pago han sido liquidadas.