Panoramica
L’API di FleetZip è REST, autenticata con token e documentata in OpenAPI 3.1. Tutto ciò che la piattaforma fa dall’interfaccia è possibile anche tramite l’API.
- Ordini — crea, aggiorna e interroga gli ordini da ottimizzare.
- Percorsi — avvia l’ottimizzazione, interroga le sequenze e segui l’avanzamento.
- Eventi — ricevi webhook di partenza, fermata, imprevisto, consegna e reso.
Diagramma di integrazione: a sinistra i sistemi del cliente (ERP, TMS, e-commerce); al centro FleetZip (API REST + coda di webhook); a destra l'app dell'autista e la torre di controllo.
Webhook per evento
Configura gli endpoint per ricevere notifiche in tempo reale. Ogni evento porta il payload completo e viene riconsegnato automaticamente in caso di errore:
| Evento | Quando si attiva |
|---|---|
route.dispatched | Percorso inviato all’app dell’autista |
stop.arrived | L’autista è arrivato alla fermata |
delivery.completed | Consegna completata con prova |
occurrence.created | Imprevisto registrato (rifiuto, assente…) |
return.created | Reso ritirato |
SDK ufficiali
Librerie per accelerare l’integrazione, con autenticazione, ritentativi e validazione dei webhook già inclusi:
- Node, Python e Java — wrapper tipizzati sull’API REST.
Frammento di codice che mostra la creazione di un ordine tramite l'SDK Node e la ricezione di un webhook di consegna completata.
Per una guida passo passo, consulta la documentazione.