Le connecteur annonce une transmission réussie. Pourtant, la commande n’existe pas dans l’ERP du client. Entre ces deux états, il manque souvent un accusé de réception métier.
Comparer EDI et API uniquement sur leur modernité masque ce point essentiel. Une entreprise veut savoir si son partenaire a reçu, compris et accepté l’information, puis ce qu’il en a fait.
En bref — Séparez transport, validation et traitement métier. « Message envoyé » ne signifie ni « commande acceptée » ni « marchandise expédiée ».
Un échange EDI utilise des messages structurés convenus entre partenaires. Une API expose une interface permettant de demander ou transmettre des données. L’un n’est pas systématiquement remplacé par l’autre : les choix dépendent des partenaires, des formats, des exigences et de l’intégration existante.
La documentation GS1 sur les échanges structurés distingue notamment les commandes et les avis d’expédition. Ces documents portent des informations différentes. Leur enchaînement décrit une opération commerciale ; un simple statut technique ne remplit pas tous ces rôles.
Trois réponses à ne pas confondre
La première confirme le transport : le système destinataire a reçu une requête ou un fichier. La deuxième concerne sa validité : format, champs requis et valeurs reconnues. La troisième décrit l’acceptation métier : articles disponibles, conditions applicables ou commande créée.
Selon l’interface, ces étapes peuvent se trouver dans une réponse immédiate, des messages séparés ou un traitement asynchrone. Il faut lire le contrat d’interface. Un code de succès HTTP ne décrit pas toujours la réalisation complète du processus demandé.
Imaginons un cas fictif. Un distributeur transmet dix lignes de commande. Le fichier arrive correctement, mais une référence n’est plus utilisée par le fournisseur. Celui-ci peut rejeter tout le document, accepter neuf lignes ou demander une correction. Le résultat attendu doit être défini avant de connecter les systèmes.
L’identification des produits et conditionnements, déjà déterminante dans un projet WMS, devient ici une convention commune entre deux entreprises.
| État observé | Ce qu’il faut encore établir |
|---|---|
| Transmission réussie | Validation du contenu |
| Document valide | Acceptation métier |
| Commande créée | Quantités et dates confirmées |
| Avis d’expédition reçu | Réception physique et éventuels écarts |
Les erreurs doivent être exploitables. Une ligne refusée a besoin d’une référence, d’un motif compréhensible et d’un responsable du traitement. « Échec de synchronisation » oblige sinon les équipes à reconstituer toute la transaction.
Prévoyez également la reprise. Un nouvel envoi après un délai dépassé ne doit pas créer une deuxième commande si la première avait déjà été enregistrée. Identifiant stable du document, règles de détection des doublons et historique des tentatives sont des éléments à demander au prestataire.
N’oubliez pas les changements. Une évolution de catalogue, d’unité ou de structure de message doit être coordonnée entre partenaires. Un environnement de test et des exemples anonymisés facilitent cette préparation.
Les tests doivent également couvrir une modification ou une annulation après acceptation. Ces actions ne sont pas toujours représentées par le même message que la création initiale. Le partenaire peut imposer un nouvel échange ou une référence au document d’origine. Documentez les statuts autorisés et ce qui arrive trop tard pour être modifié. Cette règle évite qu’une équipe pense avoir annulé une commande alors que le traitement avait déjà avancé chez son interlocuteur.
Le meilleur choix n’est donc pas « EDI ou API » dans l’absolu. C’est une chaîne dont chaque état est observable, dont les exceptions ont un propriétaire et dont la reprise conserve l’identité de l’opération. Cette exigence reste valable avec les deux technologies.





La discussion