Connecter TrueCommerce : messages de commande entrants, messages d’expédition et de facture sortants

Demandez l’URL de base à votre équipe TrueCommerce, saisissez une clé API ou vos identifiants client OAuth, testez, configurez le mapping par partenaire commercial, activez.

Le connecteur TrueCommerce échange des documents EDI avec vos partenaires commerciaux via TrueCommerce : les messages de commande de vos partenaires entrent et deviennent des commandes, et les messages d’expédition et de facture repartent vers ces partenaires. Ce n’est pas une connexion de boutique — tout est organisé par partenaire commercial et par message.

Prérequis#

• Un compte TrueCommerce, avec une équipe de compte à qui demander l’URL de base de l’API et les identifiants.
• Au moins un partenaire commercial avec lequel vous échangez des messages EDI — messages de commande entrants, messages d’expédition et de facture sortants. Chaque partenaire est mappé séparément plus loin dans ce guide.
• Un choix du mode d’authentification de cette connexion : une clé API seule, ou les identifiants client OAuth (Client ID + Client Secret) quand vous n’avez pas de clé API. Les deux modes sont des alternatives — ne mélangez pas leurs champs.

Obtenir les identifiants#

1. Demandez à votre équipe de compte TrueCommerce l’URL de base de l’API de votre compte. Sans elle, la connexion ne peut pas être remplie — c’est l’adresse par laquelle passe tout l’échange de messages.
2. Si vous utilisez une clé API : demandez à TrueCommerce la clé API de votre compte et copiez-la en entier. Avec une clé API, vous n’avez pas besoin des champs OAuth.
3. Si vous n’avez pas de clé API : demandez plutôt à TrueCommerce les identifiants client OAuth — le Client ID OAuth et le Client Secret OAuth. Les deux sont obligatoires ensemble.
4. Conservez le Client Secret en lieu sûr dès que vous le recevez : il n’est affiché qu’une fois. Si vous le perdez, demandez à votre équipe de compte TrueCommerce d’en émettre un nouveau.

Remplir dans Integration#

1. Ouvrez Integration → Marketplace → TrueCommerce → Nouvelle connexion.
2. URL de base : collez l’URL de base de l’API TrueCommerce que votre équipe de compte vous a donnée, en commençant par https://. Ce champ est obligatoire et doit être l’adresse TrueCommerce — l’adresse d’un autre système ne répondra pas.
3. Clé API : si vous utilisez la méthode par clé API, collez ici la clé API de TrueCommerce. Si vous utilisez OAuth à la place, laissez ce champ vide — un champ de clé API vide indique à la connexion d’utiliser vos identifiants client OAuth.
4. Client ID OAuth : obligatoire uniquement quand le champ de clé API est vide. Collez le Client ID OAuth que TrueCommerce a émis pour votre compte. Si vous avez saisi une clé API, vous pouvez laisser ce champ vide.
5. Client Secret OAuth : obligatoire uniquement quand le champ de clé API est vide, et il va de pair avec le Client ID OAuth — les deux doivent venir du même ensemble émis. Il est chiffré au repos et jamais réaffiché.

Tester la connexion#

Cliquez sur Tester la connexion. Le test se rend à l’URL de base saisie et présente les identifiants du mode choisi — la clé API, ou le Client ID et le Client Secret OAuth quand le champ de clé API est vide. Un succès signifie que TrueCommerce a été joint à cette adresse et a accepté ces identifiants. En cas d’échec, gardez l’erreur affichée par le test : elle indique si c’est l’adresse ou les identifiants qui ont été rejetés, et la FAQ ci-dessous traite chaque cas.

Mapping / choisir un modèle#

Sur TrueCommerce, 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 comment ses messages de commande se mappent dans la commande standard — numéro de commande, lignes, quantités, coordonnées de livraison — et comment les données d’expédition et de facture se mappent en retour dans le format de message attendu par ce partenaire. Un partenaire sans mapping configuré n’a nulle part où faire atterrir ses messages : ses messages de commande ne peuvent pas devenir des commandes, et les messages d’expédition et de facture ne peuvent pas être construits pour lui. Traitez vos partenaires un par un et vérifiez l’aperçu de mapping de chacun avant d’activer.

Activer#

Après activation, les messages de commande de vos partenaires commerciaux mappés entrent et deviennent des commandes, et les messages d’expédition et de facture sont renvoyés à chaque partenaire via TrueCommerce. Les partenaires sans mapping restent silencieux — rien ne circule pour eux tant que leur mapping n’est pas configuré. Surveillez les premiers messages de chaque partenaire dans Runs / Logs avant de laisser l’échange sans surveillance.

FAQ#

Le test échoue : les identifiants sont rejetés

Les identifiants de la connexion ne correspondent pas à ce que TrueCommerce a émis pour votre compte. Les causes habituelles sont une valeur copiée de façon incomplète, ou un mode rempli à moitié : le champ de clé API a été laissé vide — ce qui bascule la connexion vers OAuth — mais un seul des deux, Client ID ou Client Secret OAuth, a été saisi, donc la paire est incomplète et ne peut pas être acceptée.

Choisissez un mode et remplissez-le en entier. Mode clé API : collez la clé API complète et laissez les champs OAuth vides. Mode OAuth : laissez la clé API vide et collez à la fois le Client ID et le Client Secret OAuth du même ensemble émis — rappelez-vous que le secret n’est affiché qu’une fois, donc si votre copie sauvegardée est perdue, demandez-en un nouveau à votre équipe de compte TrueCommerce. Enregistrez puis testez à nouveau.

Le test échoue : TrueCommerce est totalement injoignable

L’URL de base de la connexion est incorrecte, donc le test frappe à la mauvaise porte. Les causes fréquentes sont une adresse mal saisie ou tronquée, une adresse destinée à un autre système, ou une ancienne adresse alors que votre équipe de compte vous en a donné une nouvelle — les identifiants ne sont même pas vérifiés, car rien de TrueCommerce ne répond à cet endroit.

Demandez à votre équipe de compte TrueCommerce de confirmer l’URL de base de l’API exacte de votre compte, remplacez l’URL de base de la connexion par cette adresse exactement comme elle vous a été donnée — en commençant par https:// — puis enregistrez et testez à nouveau.

Connecté, mais les messages de commande d’un partenaire ne deviennent jamais des commandes

La connexion elle-même fonctionne — le test passe et d’autres partenaires peuvent circuler normalement. Le problème est que ce partenaire commercial n’a pas de mapping configuré, ou que son modèle ne couvre pas ses messages de commande, donc ses messages entrants n’ont nulle part où atterrir et ne deviennent jamais des commandes.

Ouvrez le mapping de ce partenaire commercial, choisissez son modèle et vérifiez l’aperçu de mapping avec l’un de ses vrais messages de commande — numéro de commande, lignes, quantités et coordonnées de livraison doivent tous atterrir dans la commande standard. Enregistrez le mapping, puis vérifiez Runs / Logs pour le prochain message de ce partenaire.

Les commandes entrent, mais les messages d’expédition et de facture n’arrivent pas chez le partenaire

L’entrant fonctionne, donc l’adresse et les identifiants sont bons. Le manque se situe côté sortant dans le mapping de ce partenaire : le partenaire est mappé pour les messages de commande entrants, mais ses messages d’expédition et de facture sortants n’ont jamais été configurés, donc les résultats du fulfillment n’ont aucun message pour repartir.

Ouvrez le mapping de ce partenaire commercial et configurez aussi le côté sortant : messages d’expédition et messages de facture, dans le format attendu par ce partenaire. Vérifiez l’aperçu de mapping avec une commande déjà traitée, puis surveillez Runs / Logs pour le prochain message sortant vers ce partenaire.