Tiempo de leer: 5 minutos
Plataforma de flota
Aplicación Movil

Cree integraciones personalizadas
con Zeo API

Conecte sus sistemas a Zeo con nuestra API RESTful. Cree rutas,
Realice un seguimiento del progreso en tiempo real y automatice los flujos de trabajo con webhooks.

API y webhooks de Zeo, Planificador de rutas de Zeo
  • 99.9%

    Acuerdo de nivel de servicio (SLA) de tiempo de actividad de la API

  • 100ms

    Tiempo promedio de respuesta

  • 20+

    Puntos finales API

  • 10K

    Límite de solicitudes por minuto

Plataforma de desarrollador Caracteristicas

Todo lo que necesitas para integrar la planificación de rutas en tus aplicaciones

  • API y webhooks de Zeo, Planificador de rutas de Zeo

    REST API

    API RESTful completa para gestionar rutas, paradas, conductores y más. Formato de solicitud/respuesta JSON con documentación completa.

    • Crear y optimizar rutas programáticamente
    • Gestionar paradas, conductores y vehículos
    • Recuperar datos de seguimiento en tiempo real
    • Acceda a análisis e informes
    • Soporte de operaciones masivas
  • API y webhooks de Zeo, Planificador de rutas de Zeo

    Eventos de webhook

    Notificaciones de eventos en tiempo real enviadas a tus terminales. Reacciona al instante ante cambios de ruta, paradas completadas y actualizaciones de conductores.

    • Eventos de ruta iniciada/completada
    • Detener las notificaciones de cambio de estado
    • Actualizaciones de la ubicación del conductor
    • Alertas de cambio de hora estimada de llegada (ETA)
  • API y webhooks de Zeo, Planificador de rutas de Zeo

    Autenticación

    Acceso seguro a la API con autenticación estándar. Múltiples tipos de claves para diferentes niveles de acceso y casos de uso.

    • Autenticación de token de portador
    • Panel de gestión de claves API
    • Permisos con alcance por clave
    • Soporte de rotación de claves
    • Limitación de velocidad por clave
  • API y webhooks de Zeo, Planificador de rutas de Zeo

    Importación de terceros

    Importe fácilmente pedidos y trabajos desde sistemas externos. Validación automática de direcciones y geocodificación al importar.

    • Punto final de importación de detención masiva
    • Validación de direcciones y geocodificación
    • Asignación de campos personalizados
    • Detección de duplicados
    • Seguimiento del estado de las importaciones

web hook Eventos

Suscríbete a eventos en tiempo real y reacciona instantáneamente a los cambios de ruta

  • Marco 1707478314 20 1, Planificador de rutas Zeo

    ruta iniciada

    Se activa cuando un conductor comienza a navegar por una ruta. Incluye el ID de la ruta, la información del conductor y el tiempo estimado de finalización.

  • Cuadro 1707478314 19, Planificador de rutas Zeo

    parada completada

    Se activa cuando una parada se marca como completada. Contiene datos de comprobante de servicio, marcas de tiempo y notas.

  • Cuadro 1707478314 17, Planificador de rutas Zeo

    parada fallida

    Se envía cuando no se pudo completar una parada. Incluye el motivo de la falla y las fotos y notas capturadas.

  • Grupo 11880, Planificador de rutas Zeo

    actualización de ubicación del controlador

    Actualizaciones periódicas de ubicación para conductores activos. Frecuencia configurable de 30 segundos a 5 minutos.

  • Grupo 11880 1, Planificador de rutas Zeo

    eta.cambiado

    Se activa cuando los tiempos de llegada estimados cambian significativamente debido al tráfico o retrasos.

  • Grupo 11880 2, Planificador de rutas Zeo

    ruta completada

    Se activa al finalizar todas las paradas. Incluye estadísticas finales, duración y métricas de rendimiento.

  • // Ejemplo de carga útil de webhook
    {
      "evento": "detención completada",
      "marca de tiempo": "2024-01-15T14:32:00Z",
      "datos": {
        "id_de_ruta": "ruta_abc123",
        "identificación de parada": "detener_xyz789",
        "conductor": {
          "carné de identidad": "drv_456",
          "nombre": "Juan Smith"
        },
        "completado_en": "2024-01-15T14:31:45Z",
        "prueba": {
          "firma": "https://...",
          "fotos": ["https://..."],
          "notas": "Dejado en la puerta"
        } } }

    Puntos finales de API Noticias

    Puntos finales centrales para la planificación de rutas y la gestión de flotas

    PUBLICAR
    /v1/rutas

    Crear una nueva ruta con paradas y configuraciones de optimización

    /v1/rutas/{id}

    Recupere detalles de la ruta, incluida la secuencia optimizada

    PUBLICAR
    /v1/rutas/{id}/optimizar

    Reoptimizar una ruta existente con parámetros actualizados

    /v1/rutas/{id}/seguimiento

    Obtenga datos de seguimiento en tiempo real para la ruta activa

    PUBLICAR
    /v1/detiene/importar

    La importación masiva se detiene desde sistemas externos

    PUT
    /v1/detiene/{id}/estado

    Actualizar el estado de detención (completado, fallido, omitido)

    /v1/controladores

    Listar todos los conductores con estado de disponibilidad

    /v1/drivers/{id}/ubicación

    Obtenga la ubicación actual y el progreso de la ruta

    PUBLICAR
    /v1/webhooks

    Registrar el punto final del webhook para notificaciones de eventos

    Código Ejemplos

    Comience rápidamente con ejemplos en su idioma favorito



    # Crear y optimizar una ruta con múltiples paradas
    enrollamiento -X POST "https://api.zeoroute.com/v1/rutas" \-H "Autorización: Portador $ZEO_API_KEY" \-H "Tipo de contenido: aplicación/json" \ -d '{ "name": "Entregas matutinas", "driver_id": "drv_123", "optimize": true, "start_location": { "address": "123 Warehouse St, City" }, "stops": [ { "address": "456 Customer Ave", "time_window": {"start": "09:00", "end": "12:00"}, "service_time": 15 }, { "address": "789 Business Blvd", "priority": "high", "service_time": 30 } ] }'
    
    # Obtener detalles de la ruta
    curl -X OBTENER "https://api.zeoroute.com/v1/routes/route_abc123" \-H "Autorización: Portador $ZEO_API_KEY"
    
    # Actualizar el estado de parada
    rizo -X PONER "https://api.zeoroute.com/v1/stops/stop_xyz789/status" \-H "Autorización: Portador $ZEO_API_KEY" \-H "Tipo de contenido: aplicación/json" \ -d '{"status": "completado", "notes": "Dejado en la puerta"}'

    Integración: Casos de uso

    Las actualizaciones automáticas funcionan para cualquier industria con visitas programadas.

    A TODO EL MUNDO

    Integración de gestión de pedidos

    Una plataforma de comercio electrónico importa automáticamente nuevos pedidos mediante API cada hora. Los pedidos se agrupan por región, se optimizan en rutas y se envían a los conductores. Las notificaciones de webhook actualizan el estado de los pedidos en tiempo real a medida que se completan las entregas.

    SERVICIO DE CAMPO

    Programación de servicios basada en CRM

    Una empresa de servicios de campo sincroniza las órdenes de trabajo desde su CRM mediante API. Los nuevos trabajos crean paradas automáticamente con los datos del cliente, los requisitos de servicio y las ventanas de tiempo. Los webhooks de finalización actualizan el CRM y activan la facturación.

    Grupo 1707478361, Planificador de rutas Zeo

    Listo para construir ¿Tu Integración?

    Obtenga su clave API y comience a construir en minutos con nuestra documentación completa

    Grupo 1707478363, Planificador de rutas Zeo

    Cuestionario Zeo

    Preguntas
    Frecuentes
    Frecuentes

    Para saber más

    API y webhooks de Zeo

    ¿Cuáles son los límites de velocidad de la API?

    Las claves API estándar permiten 1,000 solicitudes por minuto. Los planes empresariales pueden solicitar límites superiores de hasta 10 000 solicitudes por minuto. Los encabezados de límite de velocidad se incluyen en cada respuesta para que pueda realizar un seguimiento de su uso.

    ¿Cómo autentico las solicitudes de API?

    Todas las solicitudes de API requieren un token de portador en el encabezado de autorización. Puede generar claves de API desde la configuración de su cuenta. Las claves pueden ajustarse a permisos específicos (solo lectura, escritura, administrador) y direcciones IP.

    ¿Tiene SDK para diferentes idiomas?

    Ofrecemos SDK oficiales para JavaScript/Node.js y Python. Hay SDK de la comunidad disponibles para Ruby, PHP y Go. Todos los SDK son de código abierto y están disponibles en GitHub.

    ¿Cómo funcionan los reintentos de webhook?

    Si su punto final devuelve una respuesta distinta de 2xx, lo reintentamos con un retraso exponencial: 1 minuto, 5 minutos, 30 minutos, 2 horas y 24 horas. Tras 5 intentos fallidos, el webhook se marca como fallido y se le notifica por correo electrónico.

    ¿Existe un entorno sandbox para realizar pruebas?

    Sí, ofrecemos un entorno sandbox completo en api-sandbox.zeoroute.com. Sandbox tiene la misma API, pero con datos de prueba y sin costo. Ideal para desarrollo y pruebas de integración.

    ¿La API está disponible en todos los planes?

    La API REST de Zeo está disponible en los planes de Gestión de Flotas y Enterprise. Incluye gestión completa de rutas, operaciones de paradas, gestión de conductores y compatibilidad con webhooks para notificaciones de eventos en tiempo real.

    ¿Por qué debería utilizar la API de Zeo en lugar de ingresar datos manualmente?

    La API de Zeo le permite crear rutas mediante programación, administrar paradas y sincronizar el seguimiento en tiempo real con sus propios sistemas, eliminando el trabajo manual repetitivo.

    ¿Qué problemas resuelven los webhooks en los flujos de trabajo automatizados?

    Los webhooks envían notificaciones de eventos en tiempo real, como la finalización de una parada o el inicio de una ruta, a su punto final para que los sistemas puedan reaccionar instantáneamente sin tener que buscar actualizaciones.

    ¿Puedo crear automatizaciones personalizadas con la API?

    Sí. Puede integrar Zeo con herramientas internas, ERP o aplicaciones personalizadas utilizando una API REST completa que admite la creación de entidades y la recuperación de detalles.

    ¿Cómo los datos en tiempo real a través de webhooks mejoran las operaciones?

    Los webhooks brindan actualizaciones instantáneas sobre el progreso de la ruta, los cambios de tiempo estimado de llegada (ETA) y la ubicación del conductor para que los sistemas y los equipos permanezcan sincronizados sin actualizaciones manuales.

    ¿Qué tipos de eventos pueden notificarme los webhooks?

    Los webhooks se utilizan para activar eventos como inicio de ruta, finalización de parada, actualizaciones de controladores y otros avances de ruta en sus sistemas.

    ¿Es útil utilizar API y webhooks para escalar operaciones?

    Por supuesto. Permiten a los desarrolladores automatizar grandes volúmenes de datos de enrutamiento e integrar Zeo a fondo en los flujos de trabajo empresariales a medida que el negocio crece.

    zeo Blog

    Explore nuestro blog para obtener artículos interesantes, consejos de expertos y contenido inspirador que lo mantendrá informado.

    2026 02 09 Software de optimización de rutas para ajustadores de seguros destacado, Zeo Route Planner

    Guía de software de optimización de rutas para ajustadores de seguros (2026)

    Tiempo de leer: 6 minutosDescubra cómo el software de optimización de rutas de ajustadores de seguros puede reducir el tiempo de procesamiento de reclamos en un 45% y reducir los costos de viaje en un 35% para los administradores de reclamos.

    2026 02 09 Alternativa destacada de Tookan, Planificador de rutas Zeo

    La mejor alternativa a Tookan (2026): Guía completa de migración

    Tiempo de leer: 7 minutos¿Buscas una alternativa a Tookan? Compara las mejores plataformas de optimización de rutas, consulta las calculadoras de ROI y obtén guías de migración paso a paso para 2026.

    2026 02 09 Alternativa destacada de Routeware, Zeo Route Planner

    La mejor alternativa a RouteWare para empresas de gestión de residuos

    Tiempo de leer: 6 minutosDescubra alternativas asequibles a RouteWare que simplifican las rutas de recolección de residuos. Compare costos, funciones y facilidad de uso para operaciones de 5 a 50 camiones.