Créer une Connection : le flux général

Les mêmes cinq étapes pour tous les connecteurs : le choisir dans le Marketplace, nommer la connexion, remplir les identifiants, tester, mapper et activer. Plus le mode simulation quand vous n’avez pas encore de clés.

Une Connection est un lien configuré vers un système externe précis : une boutique Shopify, un compte UPS, une société ERP. Les guides par connecteur et le répertoire donnent les champs exacts de chaque plateforme ; cet article décrit le flux commun.

Avant de commencer#

• Un compte sur l’autre plateforme avec accès administrateur (ou développeur) : la plupart des identifiants se trouvent derrière une page admin ou développeur.
• La liste des champs de votre connecteur dans le répertoire des connecteurs (trois parties, dans cette section) : vous saurez exactement quoi rassembler.
• Pour une première connexion, préférez les identifiants de test / sandbox quand la plateforme en propose ; ne pratiquez jamais le mapping sur des données réelles.

Étapes 1–2 : choisir le connecteur et nommer la connexion#

1. Ouvrez Integration → Marketplace des connecteurs, filtrez par catégorie et cliquez sur la carte de votre connecteur → Nouvelle connexion.
2. Donnez un nom reconnaissable, ex. « Shopify — boutique principale US » ou « UPS — compte de production ». Une plateforme peut avoir plusieurs connexions (deux boutiques, test + production) ; le nom les distingue.

Étape 3 : remplir les identifiants#

• L’assistant affiche exactement les champs requis par ce connecteur : ils viennent du registre des connecteurs, la même liste que le répertoire. Les champs requis sont marqués ; aucun champ caché.
• Chaque champ a une aide indiquant où se trouve la valeur sur l’autre plateforme ; le répertoire donne le chemin complet.
• Les secrets (clés, tokens, mots de passe) sont chiffrés et jamais réaffichés en entier : après enregistrement, seul un aperçu masqué est visible. Si un secret est faux, collez-en un nouveau ; l’ancien ne peut pas être « affiché ».
• Si un connecteur n’a pas de liste de champs enregistrée (rare), l’assistant bascule sur un éditeur clé-valeur générique plus des champs de secret : saisissez les clés exactement comme la documentation de la plateforme les nomme.

Étape 4 : tester la connexion#

Le test a deux niveaux : la connectivité (les identifiants fonctionnent-ils ?) et, pour les connecteurs de documents, l’aperçu d’un document réel (champs plateforme → champs standard, côte à côte). Un échec indique le niveau : 401 = identifiants ; écart dans l’aperçu = mapping. Corrigez et retestez ; le test ne modifie rien d’aucun côté.

Où se trouve le compte rendu du test : le journal de diagnostic

Chaque test de connexion laisse un compte rendu étape par étape sur la page de détail de la connexion ; pour les transporteurs, dans le diagnostic dépliable de la ligne. Ouvrez-le si un test échoue : il indique quelle étape s’est arrêtée et pourquoi, dans l’ordre d’exécution, pour distinguer un problème d’identifiants d’un problème de mapping sans deviner. Le journal ne conserve que les étapes et les résultats, jamais vos secrets, seulement les noms de clés utilisés. Sans test préalable, la section le dit clairement : lancez un test et le compte rendu apparaît ici.

Étape 5 : mapping et activation#

1. Choisissez le modèle de mapping prédéfini de votre connecteur et revérifiez l’aperçu du document : SKU, quantités, adresses et champs personnalisés.
2. Associez vos produits : les SKU du canal sans correspondance produit OMS restent en attente dans Product Mapping ; associez-les là, sinon les commandes arriveront avec des lignes non mappées.
3. Activez. Dès lors, la connexion synchronise selon la programmation définie et chaque exécution apparaît dans Integration → Runs et Logs. Surveillez les premiers documents avant de la laisser seule.

Gérer les connexions ensuite#

• La consultation et la modification ont leurs propres pages : cliquez sur une connexion dans Integration → Connexions pour ouvrir sa page de détail — statut, paramètres de synchronisation, résumé de configuration et Flows qui l’utilisent, tout au même endroit. La modification (nom, contenu, fréquence, identifiants) se fait sur la page de modification de la connexion ; l’enregistrement vous ramène au détail.
• Modifier les identifiants : ouvrez la connexion et collez le nouveau secret — nécessaire après rotation d’une clé ou expiration d’un token. Testez juste après.
• Désactivez plutôt que supprimer quand vous mettez un canal en pause : la connexion désactivée garde son mapping et son historique et se réactive en un clic. Supprimer fait perdre la configuration.
• Les connexions en double ont du sens quand c’est utile (deux boutiques d’une même plateforme, une de test + une de production). Chaque Flow choisit la connexion exacte qu’il utilise.