Intégration API des bons de livraison électroniques : connecter votre ERP/DMS au portail
Guide technique pour intégrer votre ERP ou DMS au portail des bons de livraison électroniques via API. Authentification, points d'acces, formats et problèmes courants.
Pourquoi l'integration API est essentielle
Le portail dispose d'une interface web pour la saisie manuelle, mais pour les entreprises envoyant plus de 5 a 10 bons de livraison par jour, la saisie manuelle n'est pas viable. L'integration API permet la création automatique, la confirmation de réception et la synchronisation des statuts.
Architecture du système
- Protocole : HTTPS (TLS 1.2+)
- Format : JSON
- Authentification : certificat électronique qualifie (TLS mutuel) + clé API
- Documentation : disponible sur le portail apres inscription
Points d'acces API clés
| Point d'acces | Méthode | Description |
|---|---|---|
| /api/v1/delivery-notes | POST | Créer un nouveau bon de livraison électronique |
| /api/v1/delivery-notes/{id} | GET | Consulter un bon de livraison |
| /api/v1/delivery-notes | GET | Lister les bons de livraison (avec filtres) |
| /api/v1/receipt-notes | POST | Créer un bon de réception (confirmer la réception) |
| /api/v1/delivery-notes/{id}/status | GET | Statut du bon de livraison |
| /api/v1/delivery-notes/{id}/pdf | GET | Version PDF pour impression |
Intégration avec les systèmes ERP courants
SAP
Utilisez SAP PI/PO ou SAP Intégration Suite. Mappez depuis le module SD (document expedition/livraison) vers le format API.
Microsoft Dynamics
Utilisez Power Automate ou des connecteurs personnalises. Mappez depuis les commandes de vente/transfert.
Systèmes ERP locaux
La plupart des solutions ERP locales (Panthéon, Lidder, Bild, 4D) développent ou disposent déjà de modules pour les bons de livraison électroniques.
Problèmes d'integration courants
- Certificat mal configure: doit être sur le serveur, pas seulement sur le poste de travail
- Mauvais format de date: l'API attend le format ISO 8601 (AAAA-MM-JJTHH:mm:ss)
- Champs obligatoires manquants: l'API renvoie une erreur 400 avec la liste des champs
- Destinataire non inscrit: le destinataire doit exister dans le système
- Timeout avec les expéditions volumineuses: divisez les expéditions de plus de 100 articles en plusieurs bons
Notifications par webhook
Le portail prend en charge les webhooks pour les mises a jour de statut en temps réel: confirmation de réception, acceptation/refus, alertes d'echeances.
Conclusion
L'integration API est la seule approche viable pour les opérations a fort volume.
Docavelo dispose d'une intégration prete a l'emploi avec le portail: connectez votre ERP a Docavelo, et il communique avec le portail pour vous.
