Planes de ruta de visita

El planeador de rutas de visita es un componente de Handy que permite organizar las visitas recurrentes de tu equipo de ventas. Funciona con un ciclo rotativo de días numerados (Día 1, Día 2, Día 3…) que se reinicia automáticamente al completarse. Cada ruta tiene un vendedor asignado y una lista de clientes distribuidos en los días del ciclo.

Cada noche, el sistema genera automáticamente los eventos de calendario para el siguiente día operativo, asignando una visita por cada cliente en su ruta correspondiente.

Acceso: Solo usuarios con rol Administrador de empresa pueden acceder a esta pantalla.

Conoce un poco más:

Configuración inicial

Al entrar por primera vez a Rutas de Visitas, se muestra una pantalla vacía con el botón Comenzar configuración. Al presionarlo se abre el asistente de configuración inicial que realiza lo siguiente:

1. Crea una ruta por cada usuario móvil activo de la empresa con tipo de usuario Preventa o Venta en ruta, nombradas "Ruta 1", "Ruta 2", etc.
2. Distribuye hasta 100 clientes habilitados de forma equitativa entre las rutas y los días del ciclo (distribución round-robin).
3. Establece la configuración del ciclo con valores predeterminados:

• Días operativos: Lunes a Sábado
• Duración del ciclo: 6 días
• Hora de inicio de visitas: 08:00 hrs
• Duración de cada visita: 15 minutos
• Fecha de inicio del ciclo: el lunes más reciente

4. Si la empresa tiene más de 100 clientes activos, se asignan los primeros 100 y el resto queda disponible para asignación manual.

Se necesita al menos un usuario con rol Usuario móvil activo y tipo de usuario Preventa o Venta en ruta para completar la configuración inicial.

Configuración del ciclo

Después de la configuración inicial, puedes modificar los parámetros del ciclo en cualquier momento. Debajo del título de la pantalla se muestra un resumen de la configuración actual (por ejemplo: "Ciclo de 6 días · Lun Mar Mié Jue Vie Sáb · Visitas desde las 08:00"). Al presionar el ícono de lápiz junto al resumen se abre el modal de configuración con los siguientes campos:

Códigos de días operativos: L = Lunes, M = Martes, X = Miércoles, J = Jueves, V = Viernes, S = Sábado, D = Domingo.

Cálculo del día de ciclo

El sistema calcula el día de ciclo para cualquier fecha del calendario con la siguiente lógica:

1. Si la fecha no cae en un día operativo, no tiene día de ciclo asignado.
2. Se cuentan los días operativos transcurridos desde la fecha de inicio del ciclo hasta la fecha objetivo.
3. El día de ciclo es el residuo de esa cuenta dividido entre la duración del ciclo, más 1.

Por ejemplo, con un ciclo de 6 días y días operativos de lunes a sábado: si el ciclo inició un lunes, ese lunes es Día 1, martes es Día 2, y así hasta sábado que es Día 6. El siguiente lunes vuelve a ser Día 1.

Navegación

Navegación por semanas

La parte superior de la pantalla muestra una barra de navegación con flechas para moverse entre semanas. Se muestra el rango de fechas de la semana visible (por ejemplo: "10 Feb – 14 Feb 2026"). La fecha de hoy está resaltada.

Pestañas de día

Debajo de la barra de navegación aparece una pestaña por cada día de la semana. Cada pestaña muestra:

• Nombre del día (Lun, Mar, Mié…)
• Número de fecha (10, 11, 12…)
• Día de ciclo en formato "Día N/Total" (por ejemplo: "Día 3/6")

Los días no operativos (por ejemplo, domingo si no está configurado como día operativo) aparecen en gris y no se pueden seleccionar.

Indicadores en las pestañas

• HOY — Etiqueta roja sobre la fecha actual.
• FERIADO — Etiqueta naranja cuando la fecha corresponde a un día festivo oficial del país de la empresa. Al pasar el cursor se muestra el nombre del feriado.
• Línea azul vertical — Aparece entre dos pestañas de día cuando el segundo día es Día 1 del ciclo, indicando visualmente que un nuevo ciclo comienza ahí.
• Día de ciclo en gris — Los días que ya pasaron muestran el indicador de ciclo en gris. Los días actuales y futuros lo muestran en azul.

Rutas y vendedores

Diseño de tres columnas

La pantalla principal se divide en tres columnas:

1. Rutas (izquierda) — Lista de todas las rutas para el día seleccionado, con el nombre del vendedor asignado y la cantidad de clientes.
2. Clientes de la ruta (centro) — Clientes asignados a la ruta seleccionada en el día de ciclo correspondiente.
3. Clientes sin asignar (derecha) — Clientes que no están asignados a ninguna ruta en ese día de ciclo.

Crear rutas

Las rutas se crean de dos formas:

• Configuración inicial: Se crea automáticamente una ruta por cada usuario móvil activo con tipo Preventa o Venta en ruta.
• Importación desde Excel: Se crean las rutas definidas en la plantilla.

No existe un botón para crear rutas individuales desde la pantalla principal.

Asignar vendedor a una ruta

Al hacer clic en el nombre del vendedor de una ruta se abre el modal de selección de usuario, que muestra los vendedores disponibles (aquellos que no están asignados a otra ruta en ese día).

Cambiar vendedor de una ruta

Si la ruta ya tiene un vendedor asignado, al seleccionar uno nuevo se presenta la siguiente pregunta:

¿Cómo deseas aplicar este cambio de vendedor?

Cuando un vendedor tiene un cambio temporal en un día específico, su nombre aparece en naranja en la tarjeta de la ruta para indicar la excepción.

Si los eventos de visita ya fueron generados para ese día, no se puede cambiar el vendedor. El sistema muestra un mensaje indicando que los eventos ya existen.

Quitar vendedor de una ruta

Desde el modal de cambio de vendedor se puede seleccionar la opción Quitar vendedor de esta ruta, que elimina la asignación de vendedor de forma permanente. Las rutas sin vendedor muestran el texto "Sin vendedor" en rojo.

Si una ruta no tiene vendedor asignado, no se generarán eventos de visita para ella. El sistema omite las rutas sin vendedor durante la generación automática.

Intercambio automático de vendedores

Si asignas un vendedor que ya está en otra ruta para ese día, el sistema realiza un intercambio automático: el vendedor pasa a la nueva ruta y la ruta anterior queda con el vendedor que se acaba de reemplazar (o sin vendedor si la ruta destino no tenía uno).

Clientes

Asignar clientes mediante arrastrar y soltar

Los clientes del panel Clientes sin asignar (columna derecha) se pueden arrastrar y soltar sobre:

• Una tarjeta de ruta en la columna izquierda.
• El panel de clientes en la columna central (si hay una ruta seleccionada).

La asignación se aplica al día de ciclo correspondiente a la fecha seleccionada, y afecta todos los ciclos futuros (no solo la semana actual).

Mover clientes entre rutas

Un cliente puede moverse de una ruta a otra arrastrándolo. Al soltarlo en una ruta diferente, se elimina de la ruta original y se asigna a la nueva para ese día de ciclo.

Restricciones de asignación

• Un cliente solo puede estar asignado a una ruta por día de ciclo. No es posible asignar el mismo cliente a dos rutas diferentes en el mismo día.
• Máximo 75 clientes por ruta por día de ciclo.
• Máximo 200 rutas por empresa.

Quitar cliente de una ruta

Cada cliente en la lista tiene un botón X para eliminarlo de la ruta. Se solicita confirmación antes de proceder. El cliente vuelve al panel de clientes sin asignar.

Clientes deshabilitados

Los clientes que están deshabilitados en el sistema aparecen en la lista con una etiqueta roja "Deshabilitado" y con opacidad reducida. Durante la generación de eventos, los clientes deshabilitados se omiten automáticamente (no se crea evento de visita para ellos).

Panel de clientes sin asignar

• Si hay 100 o menos clientes sin asignar, se muestran en una lista con scroll.
• Si hay más de 100 clientes sin asignar, el panel muestra un mensaje indicando que hay demasiados para mostrar en pantalla, con un botón Descargar Excel para obtener el listado completo.

Generación de eventos

Proceso automático nocturno

Cada noche a las 22:00 hrs (en la zona horaria de la empresa), un proceso automático genera los eventos de calendario para el siguiente día operativo. El proceso:

1. Identifica las empresas cuya hora local es 22:00.
2. Calcula el día de ciclo correspondiente al día siguiente.
3. Para cada ruta activa con vendedor asignado, crea un evento de calendario por cada cliente habilitado asignado a ese día de ciclo.
4. Los eventos se crean de forma consecutiva: el primer cliente recibe la hora de inicio configurada, y cada cliente siguiente comienza al terminar la visita anterior (según la duración configurada).

Generación manual

En la pantalla se muestra un botón Generar eventos para cada día operativo. Al presionarlo aparece un diálogo de confirmación que explica:

"Se crearán los eventos de visita para el día seleccionado, asignando un evento por cada cliente en sus rutas correspondientes. Este proceso se ejecuta automáticamente cada noche a las 22:00 hrs. Ejecutarlo manualmente es seguro: si los eventos ya fueron creados, no se duplicarán."

La generación manual es útil cuando:

• Necesitas crear los eventos antes de las 22:00 hrs.
• Quieres generar eventos en un día festivo (la generación manual ignora los feriados).
• Quieres volver a generar eventos después de usar la opción "Eliminar visitas".

Protección contra duplicados

El sistema garantiza que los eventos no se dupliquen. Si la generación ya se ejecutó para una ruta en un día específico, intentar ejecutarla nuevamente no crea eventos adicionales. Esto hace que sea seguro presionar el botón de generación manual varias veces o que el proceso automático se ejecute más de una vez.

Contador de creación automática

Junto a la lista de rutas se muestra un contador que indica el tiempo restante para la próxima ejecución automática (22:00 hrs). Después de las 22:00, el contador cambia a una etiqueta verde "Creación automática disparada". Cuando todas las rutas del día ya tienen eventos generados, se muestra "Visitas generadas".

Indicador de eventos generados

Las rutas que ya tienen eventos generados para el día seleccionado se muestran con un borde izquierdo verde y fondo verde claro. Los clientes dentro de esas rutas muestran una etiqueta verde "Con evento".

Zonas y permisos automáticos

Cuando se generan los eventos de visita, el sistema verifica automáticamente que el vendedor asignado tenga permiso para visitar a cada cliente según su zona. Si un vendedor no tiene asignada la zona de alguno de sus clientes, el sistema asigna automáticamente esa zona al vendedor antes de crear el evento. Esto garantiza que el vendedor pueda acceder a la información del cliente desde la app móvil.

Días festivos

Detección de feriados

El sistema consulta automáticamente los días festivos oficiales del país de la empresa. Los feriados se muestran en las pestañas de día con una etiqueta naranja FERIADO. Al pasar el cursor sobre la etiqueta, se muestra el nombre del feriado.

Omisión automática en días festivos

El proceso automático nocturno omite la generación de eventos en días festivos. Si mañana es feriado, el CRON de las 22:00 no creará eventos para ese día.

Generación manual en feriados

Si necesitas generar eventos en un día festivo, puedes hacerlo presionando el botón Generar eventos manualmente. El diálogo de confirmación mostrará una advertencia indicando que el día es feriado, pero permitirá continuar. La generación manual siempre ignora la restricción de feriados.

Configuración "Ignorar días festivos"

En la configuración del ciclo existe la opción Ignorar días festivos. Al activarla, el proceso automático nocturno genera eventos incluso en días festivos, sin necesidad de intervención manual. Esto es útil para empresas que operan normalmente en días feriados.

Pausar y reanudar rutas

Pausar una ruta para un día

Desde el menú desplegable de la ruta (ícono de engranaje) se puede seleccionar Pausar para este día. Esto tiene los siguientes efectos:

• La ruta muestra una etiqueta gris "PAUSADA" y opacidad reducida.
• El proceso de generación automática omite esta ruta para el día pausado.
• La pausa aplica solo al día seleccionado. En los demás días la ruta funciona normalmente.

Reanudar una ruta

Desde el mismo menú desplegable, la opción cambia a Reanudar para este día, que elimina la pausa y permite la generación de eventos nuevamente.

Si los eventos ya fueron generados para ese día, no se puede pausar la ruta. Si necesitas cancelar las visitas ya generadas, usa la opción "Eliminar visitas" del menú de la ruta.

Eliminar visitas de un día

El menú desplegable de cada ruta también incluye la opción Eliminar visitas de este día, que desactiva los eventos de calendario ya creados y permite volver a generar eventos para ese día.

Importación desde Excel

El botón con ícono de Excel en la barra superior abre el asistente de importación, que consta de 4 pasos:

Paso 1 — Configurar y descargar

Se configuran los parámetros del ciclo (los mismos campos que el modal de configuración). Se ofrecen dos opciones de descarga:

• Plantilla vacía: Descarga un archivo Excel con las columnas requeridas pero sin datos.
• Plantilla con planes actuales: Exporta las asignaciones existentes de rutas, vendedores y clientes en formato Excel.

Las columnas requeridas en la plantilla son:

Límites de importación:

• Máximo 200 rutas
• Máximo 75 clientes por ruta por día
• Máximo 31 días de ciclo
• Máximo 50,000 filas por archivo

La importación requiere que no existan rutas previas. Si ya tienes rutas configuradas, debes restablecer los datos antes de importar.

Paso 2 — Cargar plantilla

Se sube el archivo Excel (formatos .xls o .xlsx). El sistema valida el formato del archivo antes de continuar.

Paso 3 — Análisis

El sistema analiza el archivo y reporta los resultados:

• Sin errores: Se muestra un resumen con la cantidad de rutas, asignaciones, usuarios y días encontrados.
• Con errores: Se muestra la cantidad de errores y un botón para descargar el archivo con las filas marcadas en rojo y los mensajes de error correspondientes.

Algunos errores comunes:

• "El día del plan debe ser un número entero positivo"
• "El día del plan excede la longitud del ciclo configurado"
• "El nombre de la ruta no puede estar vacío"
• "El usuario no existe, no es usuario móvil con tipo Preventa o Venta en ruta, o está deshabilitado"
• "El cliente no existe o está deshabilitado"
• "El cliente ya está asignado a este día del ciclo"

Paso 4 — Completado

El sistema procesa la importación y muestra el resultado final. Si el archivo es muy grande y excede el tiempo límite, se muestra un mensaje sugiriendo reducir la cantidad de registros e intentar nuevamente.

Restablecer datos

El botón rojo con ícono de barrido en la barra superior abre el diálogo de restablecimiento. Esta acción elimina permanentemente:

• Configuración del ciclo
• Rutas y asignaciones de vendedores
• Asignaciones de clientes a rutas
• Días de ruta generados
• Vínculos entre días de ruta y eventos de calendario

Los eventos de calendario ya creados no se eliminan. Las visitas que ya aparecen en el calendario de los vendedores permanecen, pero pierden su asociación con las rutas.

Esta acción no se puede deshacer. Se recomienda exportar los planes actuales desde el asistente de importación antes de restablecer.

Indicadores visuales

Preguntas frecuentes

¿Qué es un ciclo de visitas?

Un ciclo es un conjunto de días numerados (Día 1, Día 2, etc.) que se repite continuamente. Los clientes se asignan a días específicos del ciclo, y al completarse se reinicia automáticamente. Por ejemplo, con un ciclo de 6 días, después del Día 6 vuelve a empezar con el Día 1.

¿Puedo combinar clientes semanales y quincenales?

Si, puedes hacer las combinaciones que necesites pues para cada ruta-día, se definen los clientes que quieras, en un periodo cíclico máximo de 31 días.

Lo que NO puedes hacer es visitar al mismo cliente en diferentes rutas del mismo día, pero sí de diferentes días.

¿Cuándo se crean los eventos de visita?

Automáticamente cada noche a las 22:00 hrs (en la zona horaria de la empresa) para el siguiente día operativo. También se pueden crear manualmente con el botón "Generar eventos".

¿Se pueden duplicar los eventos si presiono el botón varias veces?

No. El sistema tiene protección contra duplicados. Si los eventos ya fueron creados para una ruta en un día, no se crean nuevamente.

¿Qué pasa si un vendedor no tiene asignada la zona de un cliente?

El sistema asigna automáticamente las zonas faltantes al vendedor antes de crear los eventos. Esto garantiza que pueda ver la información del cliente en la app móvil.

¿Qué pasa en días festivos?

El proceso automático omite los días festivos. Los feriados se identifican con una etiqueta naranja "FERIADO" en las pestañas de día. Si necesitas generar visitas en un feriado, puedes hacerlo manualmente o activar la opción "Ignorar días festivos" en la configuración.

¿Puedo pausar una ruta sin eliminarla?

Sí. Desde el menú de la ruta puedes pausarla para un día específico. La ruta se omite durante la generación automática de ese día, pero sigue activa para los demás días.

¿Qué pasa si cambio el vendedor de una ruta?

Puedes elegir entre un cambio temporal (solo para el día seleccionado) o permanente (para toda la ruta). Los cambios temporales se indican visualmente con el nombre del vendedor en naranja.

¿Puedo importar rutas desde Excel?

Sí. El asistente de importación permite descargar una plantilla, llenarla con las asignaciones deseadas, y subirla para que el sistema cree las rutas automáticamente. La importación requiere que no existan rutas previas.

¿Qué hace "Restablecer datos"?

Elimina toda la configuración de rutas: el ciclo, las rutas, las asignaciones de vendedores y clientes, y los días generados. Los eventos de calendario ya creados no se eliminan.

¿Qué roles pueden acceder a esta pantalla?

Solo los usuarios con rol Administrador de empresa tienen acceso a la pantalla de Rutas de Visitas.

¿Los clientes deshabilitados reciben visitas?

No. Los clientes deshabilitados aparecen en las listas con una etiqueta "Deshabilitado" pero se omiten automáticamente durante la generación de eventos.

¿Puedo tener más de un vendedor por ruta?

No. Cada ruta tiene un solo vendedor asignado. Sin embargo, puedes hacer cambios temporales para días específicos sin modificar la asignación permanente.

¿Qué pasa si cambio la duración del ciclo después de tener eventos futuros generados?

Si aumentas días, se agregarán vacíos, hasta que les agregues clientes.

¿Qué pasa si cambio la hora de inicio o duración después de generar eventos?

Los eventos ya generados no son afectados.

Las nuevas reglas sólo aplicarían a los eventos creados automáticamente después de los ajustes.

¿Qué pasa si restablezco datos pero ya existen eventos futuros generados?

Las visitas programadas ya generadas no se afectan.

¿Cómo se identifica un evento como duplicado?

El sistema no permite crear duplicados

No se puede agregar más de una vez el mismo cliente a la misma ruta.

Tampoco el mismo cliente a diferentes rutas del mismo día.

¿Con los feriados qué pasa si el país de la empresa cambia?

Se tomarán los días feriados correspondientes a partir del cambio.

Si ya hay 75 clientes y el usuario intenta importar 76 ¿Falla toda la importación o solo el #76?

Falla toda. Siempre que haya fallas en la importación, de cualquier naturaleza, detenemos la importación, indicamos cuáles son los errores y permitimos que el usuario decida qué hacer.

Actualizado el: 20/02/2026