Gestion EDI : connexions EDI et configuration des partenaires

Connectez un détaillant via une plateforme EDI en un seul assistant, mappez ses documents sans code et suivez chaque transmission en langage clair.

La gestion EDI se trouve sous Integration → EDI et compte quatre pages qui travaillent ensemble : Connexions (une ligne par détaillant + compte de plateforme), Mappings (comment chaque type de document est traduit), Tables de codes (les listes de consultation utilisées par les mappings) et Transmissions (chaque document envoyé ou reçu). Toutes les plateformes utilisent le même assistant, la même vue détaillée, le même outil de mapping et le même format d’erreur en langage clair. Les types de document activables incluent 850 Bon de commande, 855 Accusé de réception, 856 Avis d’expédition, 940 / 945 documents d’expédition d’entrepôt, 846 Avis d’inventaire, 947 Ajustement d’inventaire, 943 / 944 transferts de stock, 810 Facture, 210 Facture de transport, 204 Appel d’offres transport et 214 Statut d’expédition.

Étape 1 : Ouvrir l’assistant de connexion et choisir la plateforme#

1. Ouvrez Integration → EDI → Connexions (/integration/edi/connections) et cliquez sur « + Nouvelle connexion ». Le même assistant en cinq étapes s’ouvre pour toutes les plateformes : 1 Plateforme → 2 Identifiants → 3 Tester la connexion → 4 Mapping / modèle → 5 Aperçu d’exemple.
2. Choisissez la plateforme EDI (connecteur), puis le nom de la connexion et le code du détaillant — par exemple WALMART. Saisissez le code directement ; les mêmes codes sont utilisés partout dans Docklify.
3. Cochez les types de document que cette connexion utilisera. Entrant signifie détaillant → Docklify, sortant signifie Docklify → détaillant. Chaque type activé devrait recevoir un mapping à l’étape 4.
4. Laissez le Mode test et le Mode exemple activés pendant la configuration : la connexion peut alors être créée, testée et prévisualisée avec des documents d’exemple avant l’arrivée des documents réels.

Étape 2 : Saisir les identifiants et régler les alertes d’échec#

• Le formulaire d’identifiants est généré depuis la liste de champs de la plateforme elle-même : vous ne voyez que les champs dont elle a besoin. Les champs secrets sont des mots de passe et ne sont jamais réaffichés.
• Les alertes d’échec se règlent à la même étape : alerte après N échecs consécutifs (défaut 3) et pause automatique après N échecs consécutifs (défaut 10), pour qu’une connexion cassée arrête de marteler la plateforme au lieu d’échouer indéfiniment.
• Notifications : la notification dans l’app est activée par défaut, celle par e-mail est désactivée. Activez l’e-mail si l’équipe qui suit ce détaillant ne vit pas dans Docklify toute la journée.

Étape 3 : Tester la connexion#

1. Cliquez sur « Créer et tester la connexion ». Docklify crée la connexion et lance le test aussitôt : vous verrez soit « Test de connexion réussi » avec sa latence, soit un échec en langage clair — ce qui s’est passé et la marche à suivre, jamais de stack trace.
2. Quand le test récupère un document d’exemple, il s’affiche dans l’assistant et une vérification du mapping s’exécute. Si elle liste des problèmes, corrigez-les à l’étape 4 / dans l’outil de Mapping et retestez avant d’activer la connexion.

Étape 4 : Lier un mapping ou cloner un modèle#

• Pour chaque type activé, liez un mapping existant ou clonez un modèle de la bibliothèque. Au clic sur Terminer, le modèle cloné devient un vrai mapping appartenant à cette connexion.
• Vous pouvez aussi laisser un type « sans mapping pour le moment » et terminer — mais les transmissions de ce type échoueront tant qu’un mapping n’est pas lié dans Integration → EDI → Mappings, alors liez-le avant l’arrivée des documents réels.

Étape 5 : Lancer un aperçu d’exemple, puis terminer#

1. Choisissez le type de document à prévisualiser et collez un document d’exemple (JSON) dans le champ d’exemple.
2. Cliquez sur « Lancer l’aperçu ». Chaque champ mappé revient avec sa cible, la valeur source, la chaîne de fonctions appliquée, la valeur de sortie et, en cas d’échec, la raison en langage clair.
3. Quand tous les champs passent, cliquez sur Terminer. Si un champ échoue, corrigez le mapping dans l’outil de Mapping et relancez l’aperçu — ne terminez pas sur un aperçu en échec en espérant que ça passe.

Au quotidien : gérer les connexions depuis la liste et le détail#

• La liste affiche, par connexion : la plateforme, le détaillant, les types activés, le mode (badges Test / Exemple quand ils sont actifs) et le statut. Les actions de ligne sont Tester, Détails et Supprimer — supprimer une connexion supprime aussi ses identifiants.
• L’interrupteur d’une connexion la met en pause ou la relance sans rien supprimer — utilisez-le quand un détaillant demande d’arrêter les envois pour un moment.
• Détails ouvre le panneau de la connexion : Santé (dernières 24 h) avec taux de réussite et échecs consécutifs — Sain, Dégradé (le seuil d’alerte est atteint) ou En pause — plus les réglages d’alerte / pause, le dernier test et les transmissions récentes avec les boutons Réessayer et Rejouer.

Mappings : traduire les documents sans écrire de code#

1. Ouvrez Integration → EDI → Mappings (/integration/edi/mappings). Commencez par « + Nouveau mapping », ou ouvrez l’onglet Bibliothèque de modèles et clonez un modèle qui correspond déjà à votre plateforme et à votre type de document.
2. Dans l’éditeur, nommez le mapping, choisissez le type de document et la direction, puis construisez les lignes : cliquez ou glissez un champ source sur une ligne, définissez le champ cible (Canonical) et enchaînez les fonctions — ou utilisez une constante, une recherche en table de codes et une condition facultative — jusqu’à ce que la ligne produise la bonne valeur.
3. Testez avec un exemple dans l’éditeur, puis Activez. L’activation est bloquée tant que des champs obligatoires ne sont pas mappés — l’éditeur liste précisément lesquels manquent.
4. Chaque enregistrement crée une nouvelle version. Versions ouvre l’historique : comparez deux versions côte à côte (lignes ajoutées / supprimées / modifiées) ou revenez en arrière — le retour ouvre cette version dans l’éditeur, et vous la testez avant de l’activer, comme tout changement.

Tables de codes : les listes utilisées par les mappings#

• Ouvrez Integration → EDI → Tables de codes (/integration/edi/code-tables) et cliquez sur « + Nouvelle table ». Nommez-la en minuscules_avec_underscores — par exemple upc_to_sku, uom_map ou carrier_map — et donnez-lui un libellé clair.
• Modifiez les entrées comme de simples paires : De (la valeur envoyée par le détaillant) → À (la valeur utilisée par Docklify), plus une note facultative. Les tables typiques traduisent les codes ship-to du détaillant, les unités de mesure et les codes transporteurs — les opérateurs les entretiennent ici, sans code.
• Les valeurs De en double sont surlignées en rouge — corrigez-les avant d’enregistrer, car un De ne peut pointer que vers un seul À. Pour les longues listes, utilisez Importer CSV (collez des lignes de,à,note, une par ligne ; les doublons sont ignorés) et Exporter CSV pour télécharger la table.
• Enregistrer une table crée une nouvelle version. Les mappings référencent la table avec sa version, donc modifier une table ici ne change pas en silence les mappings déjà actifs.

Transmissions : suivre chaque document, corriger ce qui a échoué#

• Ouvrez Integration → EDI → Transmissions (/integration/edi/transmissions). Filtrez par statut, type de document ou direction, ou cherchez par numéro d’affaire / id externe. Les statuts se lisent clairement : Reçu, Mappé, Terminé, Échoué, Doublon, Mort et ACK en attente.
• Ouvrez les Détails d’une transmission pour voir le document brut tel que reçu et sa forme Canonique après mapping, avec son statut et son ACK — c’est ce couple qu’on vérifie en premier quand un partenaire dit qu’un document « semble faux ».
• Les erreurs sont écrites pour des humains : un titre, ce qui s’est passé et la marche à suivre. Si l’erreur est réessayable, la ligne affiche le badge « Réessayable » et un bouton Réessayer. Les erreurs que réessayer ne répare pas — échecs d’authentification, erreurs de mapping — n’ont pas de bouton : corrigez d’abord les identifiants ou le mapping, puis utilisez Rejouer pour relancer le document brut d’origine (disponible pour les transmissions Échouées et Mortes).

Fonctionnalités Docklify utilisées dans cet article#

• Assistant EDI en cinq étapes : plateforme, identifiants, test, mapping / modèle, aperçu — Integration → EDI → Connexions → + Nouvelle connexion (/integration/edi/connections)
• Détail de connexion : santé sur 24 h, échecs consécutifs, réglages d’alerte / pause et transmissions récentes — Integration → EDI → Connexions → Détails
• Éditeur de mapping sans code avec bibliothèque de modèles, test sur exemple, historique de versions, comparaison et retour arrière — Integration → EDI → Mappings (/integration/edi/mappings)
• Tables de codes versionnées avec contrôle des doublons et import / export CSV — Integration → EDI → Tables de codes (/integration/edi/code-tables)
• Journal des transmissions avec erreurs en langage clair, réessai et rejeu — Integration → EDI → Transmissions (/integration/edi/transmissions)