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.
