Vue d’ensemble
L’API de FleetZip est REST, authentifiée par token et documentée en OpenAPI 3.1. Tout ce que la plateforme fait via l’interface est aussi possible via l’API.
- Commandes — créez, mettez à jour et consultez les commandes à optimiser.
- Tournées — déclenchez l’optimisation, consultez les séquences et suivez la progression.
- Événements — recevez des webhooks d’expédition, arrêt, incident, livraison et retour.
Schéma d'intégration: à gauche les systèmes du client (ERP, TMS, e-commerce); au centre FleetZip (API REST + file d'attente de webhooks); à droite l'appli chauffeur et la tour de contrôle.
Webhooks par événement
Configurez des endpoints pour recevoir des notifications en temps réel. Chaque événement porte le payload complet et est redélivré automatiquement en cas d’échec:
| Événement | Quand il se déclenche |
|---|---|
route.dispatched | Tournée envoyée vers l’appli chauffeur |
stop.arrived | Le chauffeur est arrivé à l’arrêt |
delivery.completed | Livraison terminée avec preuve |
occurrence.created | Incident enregistré (refus, absent…) |
return.created | Retour collecté |
SDK officiels
Des bibliothèques pour accélérer l’intégration, avec authentification, nouvelles tentatives et validation de webhook déjà incluses:
- Node, Python et Java — des wrappers typés au-dessus de l’API REST.
Extrait de code montrant la création d'une commande via le SDK Node et la réception d'un webhook de livraison terminée.
Pour un guide pas à pas, consultez la documentation.