Tienda

Mapa de Clientes y rutas

Mapa interactivo con la ubicación de tus clientes y pedidos, zonas de cobertura por radio, ruta de visitas sugerida y descarga a Excel.

Con limitaciones: Necesita aplicar la migración 0010_customer_map.sql. Los proveedores públicos de mapa y rutas no están pensados para alto volumen.

Cómo acceder

Menú lateral > Tienda > Mapa de Clientes. Pestañas Cliente, Zonas, Ruta, Analítica y Pendientes.

Requisitos y permisos: Permiso Pedidos (orders.manage) y plan Business o Agency (siempre aplicado, no depende de PLAN_ENFORCEMENT). En Free y Pro se ve una tarjeta informativa con el botón «Cambiar de plan». Agency puede elegir una «Sub-cuenta».

Botones e iconos

Sincronizar
Trae pedidos nuevos y ubica las direcciones pendientes. Se ejecuta sola al abrir la pantalla; el estado se ve en la insignia Sincronizando… / Sincronizado / Error de sincronización.
Asignar Zona
Abre el borrador de una zona por radio en la pestaña Zonas.
Ruta
Abre la pestaña Ruta para armar la ruta de visitas.
Filtros / Limpiar filtros
Muestran u ocultan los filtros (cliente o empresa, teléfono, pedido, categoría, estado, pago, fechas, ubicación) y los reinician.
Reintentar
Vuelve a cargar el mapa si falló la carga.
Cargar datos de demostración / Quitar demostración
Crea o elimina clientes y pedidos ficticios para probar el mapa. Requiere permiso Configuración (settings.manage).
Centrar
En la tarjeta del cliente, lleva el mapa a su ubicación.
Agregar a ruta / Quitar de la ruta
En la tarjeta del cliente, suma o quita una parada manual.
Descargar ruta a Excel
Exporta la ruta. Requiere además el permiso Clientes y mensajes (customers.manage).

Paso a paso

  1. 1Abre Mapa de Clientes: el mapa se sincroniza solo y ubica las direcciones de tus pedidos.
  2. 2Revisa las tarjetas resumen: Clientes en el mapa, Pedidos, Valor comercial y Pendientes de geolocalizar.
  3. 3Usa «Filtros» para acotar por cliente/empresa, teléfono, categoría, estado, pago, fechas o ubicación (Confirmada / Pendiente de geolocalizar). Cambia el color de los marcadores por Zona o por Estado del último pedido.
  4. 4Pulsa un marcador para ver la tarjeta del cliente en la pestaña Cliente.
  5. 5En «Zonas» pulsa «Asignar Zona» (o «Nueva zona»), escribe el Nombre, elige Color, Prioridad y Radio, usa «Elegir centro» para marcar el punto en el mapa y confirma con «Confirmar zona».
  6. 6En «Ruta» elige «Paradas desde» (origen, zona y fechas), define Inicio y Fin, y revisa la ruta sugerida. Pulsa «Guardar ruta» o «Descargar ruta a Excel».
  7. 7En «Pendientes» ubica manualmente las direcciones que no se pudieron geolocalizar con «Ubicar».

Resultado esperado: Ves a tus clientes en el mapa, agrupados por zona o estado. La ruta es una sugerencia («Ruta de Visitas Sugerida»), no se garantiza que sea la óptima. Eliminar una zona no borra clientes ni pedidos.

Campos y su significado

Nombre de la zona
Hasta 60 caracteres.
Prioridad
Si dos zonas se solapan, gana la de mayor prioridad; si empatan, la de menor radio.
Radio
De 0.1 a 30 km.
Zona activa
Una zona inactiva no asigna clientes.
Inicio / Fin de la ruta
Inicio: Primera parada, Dirección del negocio, Mi ubicación, Última parada de mi ruta anterior o Elegir en el mapa. Fin: Última parada, Volver al inicio, Dirección del negocio o Elegir en el mapa.
Paradas
Máximo 100 por ruta. Si hay más se usan las primeras 100.

Ejemplo práctico

Creas la zona «Miraflores» con radio 3 km. Aparece el aviso «Zona guardada: 12 agregados, 0 movidos, 3 se mantienen» y los clientes de ese radio quedan asignados.

Errores frecuentes

«Máximo N zonas por cuenta»

Elimina o reutiliza una zona existente.

«Escribe una dirección más completa»

En Pendientes, agrega calle, número y distrito.

«Configura la dirección del negocio en Configuración para usarla como punto de partida»

Completa la dirección en Configuración > General > Contacto.

«Elige un origen para volver a él»

Define un Inicio antes de elegir «Volver al inicio».

«Ya hay datos de demostración en esta cuenta. Quítalos antes de volver a crearlos.»

Usa «Quitar demostración».

«Las sub-cuentas están disponibles en el plan Agency.» / «No tienes acceso a esa sub-cuenta.»

Cambia de plan o pide acceso a la sub-cuenta.

«Contacto oculto (requiere permiso de clientes)»

Pide el permiso Clientes y mensajes al propietario.

Relación con otros módulos

Preguntas frecuentes

¿El mapa usa servicios de pago?

Por defecto usa mapas y buscadores públicos (OpenStreetMap, Nominatim y OSRM), pensados para uso moderado. Para mucho volumen hay que configurar tus propios proveedores en las variables de entorno MAP_*, GEOCODER_* y ROUTING_*.

¿Por qué mis direcciones quedan Pendientes?

Cuando no se pudo ubicar la dirección escrita. Ubícalas a mano desde la pestaña Pendientes.