Rutas de cobranza

Cobranza y crédito. Ruta base: /pos/cobranza/rutas. ID de menú: cobranza-rutas. Grupo de menú: CREDIT_PAYMENTS.

Qué administra esta pantalla

Rutas de cobranza organiza la cartera de crédito en recorridos operativos. Desde aquí se crean, editan, desactivan y ordenan las rutas que un cobrador sigue en campo. Cada ruta agrupa clientes con crédito vigente o vencido, les asigna un cobrador y conserva la secuencia exacta de visita. La pantalla también muestra indicadores de cobertura: rutas totales, activas, cobradores asignados y clientes en ruta.

Esta pantalla es de administración; los cobradores no la ven. El cobrador consulta sus rutas asignadas en Mi jornada y registra capturas en Cobranza.

Relación con cobranza y crédito

Las rutas son el origen de la programación diaria de cobro. Una venta a crédito registrada en Punto de venta se convierte en cuenta de cobranza. Cuando el administrador la agrega a una ruta, el cobrador puede consultarla en Mi jornada, recorrerla en el orden guardado y capturar abonos que luego pasan a Auditoría de capturas. El Dashboard crédito usa la misma cartera para reportar saldos, atrasos e ingresos esperados.

Solo las cuentas con crédito ACTIVE o DEFAULTED pueden buscarse como candidatas. El servicio prioriza, dentro de un mismo cliente, la venta más atrasada o con estado vencido.

Cómo usar la pantalla

1. Abre Cobranza y crédito → Rutas de cobranza (/pos/cobranza/rutas).
2. Revisa el listado de rutas y los indicadores superiores.
3. Para crear una ruta, selecciona Nueva ruta. Para editar, presiona Editar en la fila.
4. Captura Código, Nombre, Descripción y marca si está Activa.
5. Selecciona un cobrador asignado del listado de usuarios con rol COBRADOR activo en el negocio.
6. En Búsqueda de cuentas, escribe folio o nombre (mínimo 2 caracteres) y presiona Buscar.
7. Agrega cuentas desde los resultados. El sistema evita duplicados por cliente.
8. Reordena el detalle con flechas o arrastrando filas. El orden se conserva al guardar.
9. Revisa el resumen (paradas, saldo pendiente, cuentas con atraso) y presiona Guardar.
10. Para retirar una ruta de operación, usa Desactivar. La ruta se marca inactiva; no se borra.

Campos y controles principales

Sección	Campo o control	Para qué sirve	Validación visible	Efecto operativo
Cabecera	Código	Identificador corto de la ruta.	Obligatorio, máximo 40 caracteres, único en el negocio.	Aparece en listados y reportes; se usa como clave de negocio.
Cabecera	Nombre	Nombre legible de la ruta.	Obligatorio, máximo 120 caracteres.	Identifica la ruta para administradores y cobradores.
Cabecera	Descripción	Notas de zona, cobertura o horario.	Opcional.	Ayuda a ubicar la ruta sin entrar al detalle.
Cabecera	Activa	Disponible para operación.	Booleano, por defecto true.	Si es falsa, la ruta no se muestra en Mi jornada ni en filtros activos.
Cabecera	Cobrador asignado	Usuario responsable del recorrido.	Debe tener rol COBRADOR activo en este negocio; puede quedar sin asignar.	Liga la ruta con Mi jornada y con el desempeño del cobrador.
Búsqueda	Campo de búsqueda	Buscar cuenta por folio o cliente.	Mínimo 2 caracteres.	Busca créditos ACTIVE o DEFAULTED del negocio.
Búsqueda	Resultados	Candidatos a agregar.	Muestra saldo, atraso, dirección y estado.	El botón cambia a Ya asignado si el cliente ya está en el detalle.
Detalle	Orden de visita	Lista de clientes seleccionados.	Flechas o arrastre.	Define la secuencia exacta que verá el cobrador.
Detalle	Cliente enfocado	Tarjeta de resumen del cliente seleccionado.	Se activa al hacer clic.	Muestra folio, saldo, dirección, contacto y días de atraso.
Resumen	Paradas / Saldo / Con atraso	Métricas del detalle.	Calculado en tiempo real.	Ayuda a dimensionar la carga de la ruta.

Acciones disponibles

• Nueva ruta abre el planificador en modo alta.
• Editar carga la ruta, sus datos y sus clientes en el orden guardado.
• Desactivar pasa la ruta a inactiva tras confirmación; no la elimina.
• Buscar ejecuta la consulta de candidatos.
• Agregar incluye un cliente en el detalle.
• Quitar cliente lo elimina del detalle.
• Mover arriba / Mover abajo reordena un cliente.
• Arrastrar y soltar reordena arrastrando la fila.
• Guardar crea o actualiza la ruta.
• Cancelar / Volver al listado cierra el planificador sin guardar.

Estados de las cuentas candidatas

Estado en el sistema	Etiqueta en pantalla	Significado	¿Puede agregarse a una ruta?
ACTIVE	Activo	Crédito vigente con pagos pendientes.	Sí.
DEFAULTED	Vencido	Crédito con pagos vencidos.	Sí (prioritario).
PAID_OFF	Liquidado	Crédito totalmente pagado.	No.
CANCELLED	Cancelado	Crédito cancelado.	No.

Impacto en la operación de cobranza

Una ruta bien configurada determina qué clientes ve cada cobrador, en qué orden los visita y cuánto saldo esperado lleva. El cobrador abre su jornada desde Mi jornada; el sistema le presenta las cuentas asignadas a su ruta activa. Las capturas que hace en campo generan lotes que el supervisor audita en Auditoría de capturas. Si una ruta se desactiva, sus clientes dejan de estar asignados y el cobrador ya no las ve en su recorrido, pero los créditos y abonos existentes no se modifican.

Buenas prácticas

• Usa códigos descriptivos y únicos (p. ej. NORTE-MAT, CENTRO-VES). Duplicar códigos produce error de llave única.
• Asigna cobradores cuyo usuario tenga el rol COBRADOR activo; si no aparece, revísalo en Usuarios.
• Agrupa clientes por zona o cercanía para reducir tiempos de traslado.
• Coloca primero las cuentas Vencido o con mayor atraso.
• Evita sobrecargar una ruta; revisa el resumen de paradas y saldo pendiente.
• Desactiva rutas que ya no operan en lugar de borrar información.
• Revisa y reordena las rutas al inicio de cada semana.

Errores comunes y cómo evitarlos

Situación	Cómo prevenirla
No aparecen cuentas al buscar.	Escribe al menos 2 caracteres; confirma que el crédito esté ACTIVE o DEFAULTED.
No puedo guardar la ruta.	Completa código y nombre, y agrega al menos una cuenta.
El cobrador no aparece en el selector.	El usuario debe tener rol COBRADOR activo en el negocio.
Un cliente aparece dos veces.	El planificador previene duplicados por cliente; si ya existe, pasa a Ya asignado.
La ruta no se ve en Mi jornada.	Activa la ruta, asígnale un cobrador y confirma el usuario del cobrador.
El cobrador asignado muestra stale.	El usuario fue asignado pero ya no tiene rol COBRADOR; reasigna o corrige el rol.
Se perdió el orden de visita.	Reordena antes de guardar; el guardado conserva el orden actual.

Checklist antes de guardar

• Código único y nombre descriptivo.
• Estado activo/inactivo correcto.
• Cobrador asignado (o explícitamente sin asignar).
• Al menos una cuenta en el detalle.
• Orden de visita revisado.
• Resumen de paradas, saldo y atrasos acorde a la carga operativa.

Preguntas frecuentes

1. ¿Cómo creo una ruta de cobranza? Entra a Rutas de cobranza, presiona Nueva ruta, captura Código y Nombre, selecciona un cobrador si aplica, busca cuentas por folio o nombre, agrégalas, reordénalas y guarda.

2. ¿Cómo edito el orden de visita? Abre la ruta con Editar. En el panel Detalle y orden de visita usa las flechas o arrastra las filas hasta quedar en la secuencia deseada, luego Guardar.

3. ¿Por qué no veo cobradores en el selector? Solo aparecen usuarios con rol COBRADOR activo en el negocio. Revisa la membresía en Usuarios. Si el rol es nuevo, cierra y vuelve a abrir el planificador para recargar la lista.

4. ¿Puedo agregar una cuenta pagada o cancelada a la ruta? No. El buscador solo devuelve créditos ACTIVE o DEFAULTED. Las cuentas PAID_OFF y CANCELLED no son candidatas.

5. ¿Qué pasa si desactivo una ruta? La ruta pasa a inactiva y ya no se muestra en Mi jornada. Los clientes dejan de estar asignados a esa ruta, pero los créditos, saldos y pagos capturados permanecen.

6. ¿Un cliente puede estar en varias rutas? El planificador evita agregar el mismo cliente dos veces en la misma ruta. Entre rutas distintas el sistema no bloquea automáticamente, por lo que conviene revisar la cobertura semanalmente para evitar duplicados.

7. ¿Cómo busco una cuenta por folio parcial? Captura los últimos dígitos del folio (mínimo 2 caracteres) o el nombre del cliente; el buscador prioriza coincidencias exactas, terminaciones del folio y coincidencias parciales.

8. ¿El cobrador puede editar la ruta? No. Esta pantalla requiere rol ADMIN, TENANT_ADMIN o SUPER_ADMIN. El cobrador opera la ruta desde Mi jornada.

9. ¿Dónde se usan las rutas después de guardar? En Mi jornada para el recorrido del cobrador, en Auditoría de capturas para revisar abonos y en Dashboard crédito para reportes de cartera.

10. ¿Qué datos debo revisar antes de guardar? Código, nombre, cobrador, estado activo, lista de clientes, orden de visita y el resumen de saldo/atraso. El orden del detalle se guarda exactamente como aparece.