Connecter B2BGateway : commandes entrantes, expéditions et factures sortantes en EDI

Demandez l’URL de base à votre équipe de compte B2BGateway, copiez la clé API depuis votre compte B2BGateway, collez les deux dans Integration, testez, mappez chaque partenaire commercial et activez : les messages de commande entrent, les messages d’expédition et de facture sortent.

Le connecteur B2BGateway échange des documents EDI avec vos partenaires commerciaux via B2BGateway : les messages de bon de commande arrivent des partenaires et deviennent des commandes, et les messages d’expédition et de facture repartent vers ces mêmes partenaires. Ce n’est pas une connexion de boutique — tout est organisé par partenaire commercial et par type de document, donc chaque partenaire se configure et se vérifie séparément.

Prérequis#

• Un compte B2BGateway. L’URL de base n’est pas une adresse publique à chercher vous-même — votre équipe de compte B2BGateway vous la donne pour votre compte.
• L’accès à la clé API de ce compte B2BGateway, ou un contact qui peut la fournir. La clé est envoyée comme en-tête X-API-Key à chaque requête.
• Au moins un partenaire commercial avec qui échanger des documents via B2BGateway. Cette connexion ne crée pas le partenaire à votre place — le côté partenaire de l’échange doit exister avant que ses messages puissent circuler.
• Pour la première connexion, validez d’abord la configuration avec un message de test d’un partenaire — ne testez jamais un nouveau mapping sur des documents réels d’un partenaire.

Obtenir les identifiants#

1. Demandez à votre équipe de compte B2BGateway l’URL de base de l’API pour votre compte et copiez-la exactement comme elle vous est donnée. Elle commence par https:// — si l’adresse semble incomplète, faites-la confirmer plutôt que de deviner la suite.
2. Récupérez la clé API depuis votre compte B2BGateway. Si vous ne la trouvez pas dans le compte, demandez à votre équipe de compte B2BGateway où votre compte l’affiche — ne réutilisez pas une clé d’un autre compte.
3. Conservez les deux valeurs ensemble : l’URL de base dit à qui la connexion parle, et la clé API prouve que c’est votre compte. Il vous faudra les deux à l’étape suivante.

Remplir dans Integration#

1. Ouvrez Integration → Marketplace → B2BGateway → Nouvelle connexion.
2. URL de base (obligatoire) : collez l’URL de base de l’API B2BGateway donnée par votre équipe de compte, par exemple https://… Copiez l’adresse entière exactement — un caractère manquant, un espace en plus ou l’adresse d’un autre compte feront échouer le test de l’étape suivante, même si la clé API est correcte.
3. Clé API (obligatoire) : collez la clé API de votre compte B2BGateway. Elle est envoyée comme en-tête X-API-Key quand la connexion parle à B2BGateway. Elle est stockée comme un secret, chiffrée au repos, et jamais réaffichée après l’enregistrement.
4. Enregistrez la connexion, mais ne l’activez pas encore. Testez-la d’abord, puis faites le mapping des partenaires commerciaux — une connexion avec les bons identifiants mais sans mapping de partenaire ne peut faire passer aucun document.

Tester la connexion#

Cliquez sur Tester la connexion. Le test parle à l’URL de base que vous avez saisie et présente votre clé API comme en-tête X-API-Key, donc il vérifie l’adresse et la clé ensemble : s’il réussit, B2BGateway a répondu et a accepté la clé de votre compte. Lancez ensuite l’aperçu au niveau document avec un vrai message de commande d’un partenaire commercial, pour voir les champs du partenaire à côté de la commande standard avant toute mise en production. Si aucun partenaire n’a encore envoyé de message de test, demandez au partenaire — ou à votre équipe de compte B2BGateway — d’en envoyer un d’abord ; l’aperçu a besoin d’un message réel. Si le test lui-même échoue, utilisez la FAQ ci-dessous : déterminez si c’est l’URL de base ou la clé API qui est en cause avant de changer les deux à la fois.

Mapping / choisir un modèle#

Sur B2BGateway, le mapping se fait par partenaire commercial, pas en un seul réglage pour toute la connexion. Pour chaque partenaire, choisissez le modèle de ce partenaire et vérifiez les types de documents que vous échangez avec lui : messages de commande entrants, messages d’expédition et de facture sortants. Dans l’aperçu, vérifiez que les identifiants du partenaire, les références d’articles, les quantités et les coordonnées de livraison tombent dans les bons champs de la commande standard, et que vos données d’expédition et de facture sont remappées dans les champs attendus par ce partenaire. Les partenaires ne partagent pas un même mapping — un partenaire dont le mapping est terminé peut passer en production pendant qu’un autre est encore en configuration, et un nouveau partenaire a toujours besoin de sa propre vérification de mapping avant son premier document réel.

Activer#

Après activation, les messages de commande de vos partenaires commerciaux mappés entrent comme des commandes et, une fois ces commandes expédiées, les messages d’expédition et de facture repartent vers le partenaire via B2BGateway. Surveillez les premiers documents de chaque partenaire dans Runs / Logs — un partenaire pas encore mappé n’échangera aucun document, donc vérifiez séparément la première commande, la première expédition et la première facture de chaque partenaire avant de laisser la connexion sans surveillance.

FAQ#

Le test échoue : la clé API est rejetée

La clé API saisie dans la connexion ne correspond pas à la clé de votre compte B2BGateway. La clé voyage comme en-tête X-API-Key, donc un seul caractère faux ou manquant, un espace final au collage, ou une clé appartenant à un autre compte B2BGateway se lisent de la même façon pour B2BGateway : ce n’est pas votre clé.

Récupérez à nouveau la clé API depuis votre compte B2BGateway — demandez à votre équipe de compte où le compte l’affiche si vous ne la trouvez pas — collez-la dans le champ de clé API sans rien avant ni après, enregistrez et testez à nouveau. Ne changez pas l’URL de base en même temps, pour savoir quelle correction a fonctionné.

Le test échoue : la connexion n’atteint pas B2BGateway

L’URL de base saisie dans la connexion est fausse, donc la requête n’atteint jamais la bonne adresse B2BGateway pour votre compte. C’est la cause habituelle quand l’adresse a été tapée à la main, raccourcie ou copiée depuis un autre compte — la clé API peut être parfaite et le test ne passe quand même pas.

Demandez à votre équipe de compte B2BGateway de confirmer l’URL de base exacte de l’API pour votre compte, remplacez le champ d’URL de base par cette adresse copiée en entier — commençant par https://, sans rien ajouter ni retirer — enregistrez et testez à nouveau.

Le test réussit, mais les documents d’un partenaire commercial ne circulent pas

Le mapping de ce partenaire commercial n’est pas encore configuré, ou pas terminé. Le test de connexion prouve seulement que l’adresse et la clé API sont bonnes — les documents circulent par partenaire, donc un partenaire sans mapping complet n’a rien pour convertir ses messages de commande, ni rien pour envoyer ses messages d’expédition et de facture, même si d’autres partenaires sur la même connexion fonctionnent bien.

Ouvrez l’étape Mapping pour ce partenaire, choisissez le modèle du partenaire, mappez les types de documents que vous échangez avec lui — commandes entrantes, expéditions et factures sortantes — et lancez l’aperçu de document avec un vrai message de ce partenaire. N’activez l’échange du partenaire qu’après que l’aperçu a placé chaque champ au bon endroit, et vérifiez ses premiers documents réels dans Runs / Logs.