Visión general
La API de FleetZip es REST, autenticada por token y documentada en OpenAPI 3.1. Todo lo que la plataforma hace por la interfaz también es posible por la API.
- Pedidos — crea, actualiza y consulta pedidos a optimizar.
- Rutas — dispara la optimización, consulta secuencias y sigue el progreso.
- Eventos — recibe webhooks de salida, parada, incidencia, entrega y devolución.
Diagrama de integración: a la izquierda los sistemas del cliente (ERP, TMS, e-commerce); al centro FleetZip (API REST + cola de webhooks); a la derecha la app del conductor y la torre de control.
Webhooks por evento
Configura endpoints para recibir notificaciones en tiempo real. Cada evento trae el payload completo y se reentrega automáticamente en caso de fallo:
| Evento | Cuándo se dispara |
|---|---|
route.dispatched | Ruta despachada a la app del conductor |
stop.arrived | El conductor llegó a la parada |
delivery.completed | Entrega completada con comprobante |
occurrence.created | Incidencia registrada (rechazo, ausente…) |
return.created | Devolución recogida |
SDKs oficiales
Bibliotecas para acelerar la integración, con autenticación, reintentos y validación de webhook ya incluidos:
- Node, Python y Java — wrappers tipados sobre la API REST.
Fragmento de código que muestra la creación de un pedido vía el SDK Node y la recepción de un webhook de entrega completada.
Para una guía paso a paso, mira la documentación.