Connecter Cleo Integration Cloud : échanger des fichiers EDI via les boîtes partenaires

Saisissez l’adresse de votre instance Cleo ainsi que l’identifiant et le mot de passe de boîte émis par votre administrateur Cleo, testez la connexion, mappez chaque partenaire, activez.

Le connecteur Cleo échange des fichiers EDI avec vos partenaires commerciaux via une boîte partenaire dans votre instance Cleo Integration Cloud : les nouveaux fichiers arrivent dans le dossier de téléchargement de la boîte et deviennent des commandes, et les fichiers sortants, comme les avis d’expédition et les factures, sont renvoyés via la boîte. Cette connexion n’utilise pas de paire de clés API — il n’y a aucun Client ID à chercher dans Cleo. Vous vous connectez avec l’adresse de votre instance et un compte de boîte, exactement comme décrit ci-dessous.

Prérequis#

• Une instance Cleo Integration Cloud à laquelle vous pouvez vous connecter, et son adresse — la même que celle que vous utilisez pour ouvrir Cleo Integration Cloud ou Harmony dans votre navigateur.
• Une boîte partenaire configurée dans cette instance pour les partenaires avec lesquels vous échangerez des fichiers. L’identifiant et le mot de passe de la boîte sont émis par votre propre administrateur Cleo lors de la création de la boîte partenaire.
• Au moins un partenaire commercial EDI dont les fichiers passent par cette boîte — par exemple des bons de commande entrants, et des avis d’expédition et des factures sortants.
• Un point à confirmer avec votre administrateur Cleo avant de commencer : si votre instance a activé le contrôle par clé API pour les appels API. Ce n’est que dans ce cas que vous aurez besoin d’une clé API — la plupart des instances ne l’ont pas, et la plupart des gens laissent ce champ vide.

Obtenir les identifiants#

1. Notez l’adresse de votre instance Cleo. C’est l’adresse avec laquelle vous vous connectez à Cleo Integration Cloud ou Harmony, par exemple https://mycompany.cleointegration.com. Ce sera l’URL de base à l’étape suivante — elle est obligatoire et doit être votre propre instance, pas une adresse partagée ni un exemple.
2. Demandez à votre administrateur Cleo l’identifiant et le mot de passe de la boîte partenaire. Ils ont été émis ensemble lors de la création de la boîte, et c’est le compte que la connexion utilise pour se connecter et échanger des fichiers — c’est un compte de boîte dans votre instance, pas votre identifiant personnel, sauf si votre administrateur les a rendus identiques.
3. Si le mot de passe est perdu, ne le devinez pas : votre administrateur Cleo réinitialise le mot de passe de la boîte dans votre instance Cleo, et vous utilisez ensuite le nouveau mot de passe. Il n’existe pas de page de récupération séparée pour cette connexion en dehors de l’instance.
4. Uniquement si votre administrateur confirme que votre instance exige une clé API pour les appels API : demandez-lui aussi cette clé API et conservez-la avec les identifiants de la boîte. Si votre instance ne l’exige pas, vous n’avez besoin de rien d’autre — ne cherchez pas de Client ID ni de Client Secret, car cette connexion ne les utilise pas.

Remplir dans Integration#

1. Ouvrez Integration → Marketplace → Cleo → Nouvelle connexion.
2. URL de base : l’adresse de votre instance Cleo, par exemple https://mycompany.cleointegration.com. Ce champ est obligatoire. Copiez-la exactement comme vous l’utilisez pour vous connecter — une adresse incorrecte signifie que le test de l’étape suivante n’aura nulle part où se connecter.
3. Identifiant de la boîte : l’identifiant de boîte que votre administrateur Cleo a émis lors de la création de la boîte partenaire. Saisissez le compte de boîte lui-même, pas une adresse e-mail personnelle.
4. Mot de passe de la boîte : le mot de passe émis avec cet identifiant. Il est chiffré au repos et jamais réaffiché. Si vous réinitialisez ensuite ce mot de passe dans votre instance Cleo, mettez-le aussi à jour ici, sinon la connexion ne pourra plus se connecter.
5. Clé API (facultatif) : laissez ce champ vide, sauf si votre instance a activé le contrôle par clé API pour les appels API. Dans ce seul cas, collez la clé API que votre administrateur vous a donnée. Laisser ce champ vide est le cas normal pour la plupart des instances — un champ vide ici ne rend pas la connexion incomplète.

Tester la connexion#

Cliquez sur Tester la connexion. Le test se connecte à l’URL de base avec l’identifiant et le mot de passe de la boîte et les échange contre un jeton de connexion. Un succès ne signifie qu’une seule chose : l’adresse de l’instance est joignable et ce compte de boîte peut se connecter. Le test ne télécharge ni n’envoie aucun fichier de la boîte, et il ne vérifie pas vos dossiers de téléchargement et d’envoi — un test réussi ne signifie donc pas à lui seul que les fichiers EDI peuvent déjà circuler. La configuration des dossiers et des partenaires est traitée dans la section suivante, et la FAQ ci-dessous explique quoi vérifier si la connexion fonctionne mais que les fichiers ne bougent pas.

Mapping / choisir un modèle#

Cleo fonctionne par échange de fichiers, donc le mapping se configure par partenaire commercial autour des dossiers de boîte de ce partenaire. Pour chaque partenaire, choisissez le modèle de ce partenaire et vérifiez deux sens : les fichiers entrants tirés du dossier de téléchargement de la boîte — par exemple un fichier de bon de commande (850) — doivent atterrir comme une commande standard, avec le numéro de commande, les lignes, les quantités et les coordonnées de livraison au bon endroit ; et les résultats sortants — l’avis d’expédition (856) et la facture (810) construits à partir du fulfillment — doivent être écrits dans le format de fichier attendu par ce partenaire et placés pour l’envoi via la boîte. Confirmez aussi que le dossier de téléchargement pour les nouveaux fichiers entrants et le dossier d’envoi pour les fichiers sortants sont configurés dans les paramètres de connexion EDI de ce partenaire : ces dossiers sont distincts des quatre champs d’identifiants, et un partenaire dont les dossiers ou le mapping manquent n’a nulle part où faire atterrir ses fichiers, même si le test réussit. Vérifiez l’aperçu de mapping avec un vrai fichier de chaque partenaire avant d’activer.

Activer#

Après activation, Integration récupère les nouveaux fichiers du dossier de téléchargement de la boîte partenaire selon la fréquence que vous définissez, transforme les fichiers de commande en commandes et envoie les fichiers sortants — avis d’expédition et factures — via la boîte pour les livrer à chaque partenaire. Seuls les partenaires dont les dossiers et le mapping sont configurés circuleront ; un partenaire ignoré restera silencieux tant que sa configuration n’est pas terminée. Surveillez les premiers fichiers de chaque partenaire dans Runs / Logs avant de laisser l’échange sans surveillance.

FAQ#

Le test échoue : la connexion est rejetée

L’identifiant ou le mot de passe de la boîte dans la connexion ne correspond pas au compte de boîte de votre instance Cleo, ou le mot de passe a été réinitialisé dans l’instance après que vous l’avez saisi ici. Le test ne va que jusqu’à la connexion, donc un rejet à cette étape concerne toujours l’adresse ou le compte de boîte lui-même — pas les dossiers ni le mapping, que le test n’atteint jamais.

Vérifiez d’abord l’URL de base et assurez-vous qu’il s’agit de l’adresse de votre propre instance, exactement comme vous l’utilisez pour vous connecter. Demandez ensuite à votre administrateur Cleo de confirmer l’identifiant de la boîte et, si le mot de passe a pu changer, de réinitialiser le mot de passe de la boîte dans l’instance. Collez le mot de passe actuel dans la connexion, enregistrez et testez à nouveau.

Je ne trouve aucun Client ID et le champ de clé API me trouble

Votre configuration Cleo n’a aucun problème — cette connexion n’a tout simplement pas de Client ID. Cleo utilise ici une connexion à l’instance au lieu d’une paire de clés API, donc aucun Client ID ni Client Secret n’est jamais émis pour elle. Le champ de clé API est un supplément séparé et conditionnel : il ne s’applique que lorsqu’une instance a activé le contrôle par clé API, ce que la plupart n’ont pas.

Arrêtez de chercher un Client ID et saisissez uniquement l’adresse de l’instance ainsi que l’identifiant et le mot de passe de la boîte. Laissez le champ de clé API vide, sauf si votre administrateur Cleo confirme que votre instance exige une clé API — dans ce cas, demandez-la-lui et collez-la. Testez ensuite la connexion.

Le test réussit, mais aucun fichier EDI n’arrive d’un partenaire

La connexion fonctionne, donc l’adresse et le compte de boîte sont bons. Le manque se situe après la connexion : le test ne touche jamais les fichiers ni les dossiers de la boîte, donc un partenaire peut toujours manquer de la configuration de son dossier de téléchargement, de son dossier d’envoi ou de son mapping — et sans cela, ses fichiers n’ont nulle part d’où être récupérés et ne deviennent jamais des commandes.

Demandez à votre administrateur Cleo de confirmer que la boîte partenaire reçoit bien les fichiers de ce partenaire, puis ouvrez les paramètres de connexion EDI de ce partenaire et vérifiez que le dossier de téléchargement pour les nouveaux fichiers et le dossier d’envoi pour les fichiers sortants sont tous deux configurés. Terminez le mapping de ce partenaire dans la section Mapping ci-dessus, vérifiez-le avec un vrai fichier et surveillez Runs / Logs pour le prochain fichier du partenaire.

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

L’entrant fonctionne, donc la boîte et son côté téléchargement sont bons. Le manque se situe côté sortant dans la configuration de ce partenaire : son dossier d’envoi ou son mapping sortant pour l’avis d’expédition (856) et la facture (810) n’a jamais été terminé, donc les résultats du fulfillment n’ont aucun fichier pour repartir.

Ouvrez les paramètres de connexion EDI et le mapping de ce partenaire et terminez le côté sortant : le dossier d’envoi, plus les mappings 856 et 810 dans le format de fichier 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 fichier sortant vers ce partenaire.