Rutas

El módulo Rutas permite agrupar múltiples visitas y rellenos en una secuencia geográfica óptima para que un técnico las ejecute en una sola jornada, minimizando tiempo de traslado.

Crear una ruta

1. Menú lateral → Operaciones → Rutas
2. Pulsa "+ Nueva ruta"
3. Define:
   • Nombre (ej: "Ruta Norte 28-Mayo")
   • Técnico asignado
   • Vehículo asignado
   • Fecha de ejecución
4. Agrega las máquinas que componen la ruta
5. Define el orden de las paradas según tu criterio
6. Guarda la ruta

Vista principal con KPIs (Rutas activas, Máquinas asignadas, Técnicos asignados, Vehículos en ruta) y tarjetas por ruta. Cada tarjeta muestra el código (RUTA01, RUTA02...), estado (Activa / Pendiente configurar), nombre, máquinas asignadas con sus códigos, técnico responsable y vehículo. Botón "+ Nueva Ruta" arriba a la derecha y acciones rápidas por tarjeta (editar, configurar, eliminar).

Ejecución de la ruta — qué ve el técnico

La app móvil del técnico no muestra una pantalla unificada llamada "Ruta". En su lugar, el técnico ve directamente el trabajo asignado distribuido en los módulos operativos del día:

• Visitas — visitas técnicas programadas (mantenimientos, inspecciones, instalaciones, retiros)
• Rellenos — máquinas que toca rellenar hoy según el calendario de la ruta
• Recolectas — máquinas a las que toca recolectar el efectivo
• Tickets — incidencias abiertas asignadas al técnico
• Home — pantalla principal con resumen del día

En cada uno de estos módulos el técnico ve:

• Lista ordenada del trabajo pendiente
• Ubicación de cada máquina con su dirección y código
• Botón para abrir la dirección en la app de mapas habitual (Waze o Google Maps)
• Estado de cada parada (pendiente, en progreso, completada)

Las capturas específicas de cada uno de estos módulos en la app móvil están en la sección App Móvil de este manual.

Define el orden tú mismo

El orden de las paradas en la ruta lo defines manualmente cuando creas la ruta. Tú conoces tu zona mejor que cualquier algoritmo: sabes a qué horas hay más tráfico, qué calles están cerradas, qué clientes tienen ventanas de atención específicas y qué visitas dependen de otras.

Calendario semanal y feriados

Cada ruta tiene su propio calendario semanal donde puedes visualizar y reasignar el plan de la semana, así como configurar feriados y días no laborables.

Cómo acceder al calendario de una ruta

1. Menú lateral → Operaciones → Rutas
2. Entra a la ruta específica que quieres ver
3. En los botones superiores de la ruta encuentras el botón de "Calendario" (también accesible como vista programada de la ruta)

Vista calendario de la ruta con header (código RUTA, estado Activa, vehículo asignado y rango de la semana), KPIs (Máquinas semana, Rellenadas, Reprogramadas, No cumplidas), banner de Pendientes rezagados cuando aplica, filtros por estado (Programada, Rellenada, Reprogramada, No cumplida) y por tipo (Vending, Café), y grilla semanal LUN–SÁB con las máquinas programadas por día. Acciones de período (Semana/Mes, Anterior, Esta semana, Siguiente, Copiar semana anterior).

Vista semanal — lo que ves

El calendario semanal muestra los días de lunes a sábado (el sistema no opera domingo) en columnas, con las máquinas programadas en cada día:

• KPIs de la semana arriba: Máquinas Semana, Rellenadas, Reprogramadas, No Cumplidas
• Filtros rápidos: Programada, Rellenada, Reprogramada, No cumplida, Vending, Café
• Alerta "Pendientes Rezagados" si quedan máquinas sin rellenar en días pasados de la semana
• Botones de navegación: Anterior, Esta semana, Siguiente, además del toggle Semana / Mes
• Botón "Copiar semana anterior" — replica el plan de la semana previa para acelerar la planificación

Reasignar máquinas entre días

Puedes arrastrar una máquina (drag & drop) de un día a otro para reasignarla. También puedes hacer clic sobre la máquina para abrir un modal de reasignación más detallado. Esto es útil cuando:

• Un cliente no estuvo disponible y debes reprogramar la visita
• Quieres balancear la carga entre días
• Una máquina urgente debe atenderse antes

Vista mensual

Cuando activas el toggle "Mes" ves todo el mes en una grilla de calendario completo (de lunes a sábado, sin domingo). Cada celda muestra:

• Número del día con badge HOY si es el día actual o FERIADO si lo configuraste
• Nombre del feriado si aplica
• Chips de estado con texto completo: "Completadas X/Y", "Reprogramadas X", "Programadas X", "No cumplidas X"
• KPIs del mes en la parte superior: visitas mes, completadas, reprogramadas, eficiencia (%)

Al hacer clic en cualquier día del mes te lleva a la vista semanal de esa semana específica.

Configuración por máquina · Días asignados

Debajo del calendario hay una tabla titulada "Configuración por Máquina · Días Asignados" que lista todas las máquinas de la ruta con:

• Código (MAQ-XXXX)
• Marca / Modelo
• Cliente
• Tipo (Vending / Café)
• Días asignados (L, M, X, J, V, S resaltados según corresponda)
• Frecuencia (ejemplo: 1x/semana, 2x/semana)
• Botón "Editar días" que abre un modal para reconfigurar

Sección "Configuración por máquina · Días asignados" debajo del calendario semanal. Tabla con cada máquina de la ruta: código (MAQ-XXXX), marca/modelo, cliente, tipo (Café / Vending), días asignados con las iniciales L M X J V S resaltadas según corresponda, frecuencia (1x/semana, 2x/semana, etc.) y botón "Editar días" para reconfigurar.

Tipos de frecuencia disponibles

Al editar los días de una máquina puedes elegir uno de tres tipos de frecuencia:

Feriados y días no laborables

Dentro de cada calendario de ruta hay un botón llamado "Feriados" (arriba a la derecha junto a "Volver a rutas"). Ahí configuras los días festivos y no laborables específicos del país o cliente.

Pantalla "Feriados y días no laborables" con KPIs (Total feriados, Globales, Por ruta), atajo "Pre-cargar universales" (Año Nuevo + Navidad), filtros por año/tipo/búsqueda, listado de feriados con su fecha, ámbito (Global / Por ruta) y recurrencia (Anual). Botón "+ Nuevo feriado" para crear excepciones específicas.

Qué puedes registrar como feriado

• Festivos nacionales (3 de noviembre, 25 de diciembre, etc.)
• Festivos regionales (carnaval, fiestas patronales locales)
• Días no laborables del cliente (inventario anual, capacitaciones internas)
• Cierres temporales (vacaciones del cliente, traslado de oficina)

Cómo configurar un feriado

1. Entra al botón Feriados dentro del calendario de la ruta
2. Pulsa "+ Nuevo feriado"
3. Define nombre (ejemplo: "Día de la Independencia"), fecha y tipo
4. Opcionalmente marca si es recurrente cada año
5. Guarda

Una vez configurados, los feriados se muestran en el calendario semanal y mensual con un badge "FERIADO" y su nombre, evitando que se programen visitas en esos días.