Integration API des bons de livraison electroniques : connecter votre ERP/DMS au portail
Guide technique pour integrer votre ERP ou DMS au portail des bons de livraison electroniques via API. Authentification, points d'acces, formats et problemes 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 creation automatique, la confirmation de reception et la synchronisation des statuts.
Architecture du systeme
- Protocole : HTTPS (TLS 1.2+)
- Format : JSON
- Authentification : certificat electronique qualifie (TLS mutuel) + cle API
- Documentation : disponible sur le portail apres inscription
Points d'acces API cles
| Point d'acces | Methode | Description |
|---|---|---|
| /api/v1/delivery-notes | POST | Creer un nouveau bon de livraison electronique |
| /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 | Creer un bon de reception (confirmer la reception) |
| /api/v1/delivery-notes/{id}/status | GET | Statut du bon de livraison |
| /api/v1/delivery-notes/{id}/pdf | GET | Version PDF pour impression |
Integration avec les systemes ERP courants
SAP
Utilisez SAP PI/PO ou SAP Integration 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.
Systemes ERP locaux
La plupart des solutions ERP locales (Pantheon, Lidder, Bild, 4D) developpent ou disposent deja de modules pour les bons de livraison electroniques.
Problemes d'integration courants
- Certificat mal configure -- doit etre 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 systeme
- Timeout avec les expeditions volumineuses -- divisez les expeditions 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 reel -- confirmation de reception, acceptation/refus, alertes d'echeances.
Conclusion
L'integration API est la seule approche viable pour les operations a fort volume.
Arhivix dispose d'une integration prete a l'emploi avec le portail -- connectez votre ERP a Arhivix, et il communique avec le portail pour vous.
