Aller au contenu principal
Mecalux Easy WMS

Easy WMS API : comment Odoo se connecte au WMS de Mecalux

Odoo parle à Easy WMS par l'interface que Mecalux a activée sur votre installation, et Mecalux ne publie ni son API ni le format de ses documents. C'est pourquoi le connecteur de FlexigoTech propose cinq transports, dont l'API de commandes d'Easy WMS, et deux types de connexion : Actif, où Odoo appelle Easy WMS, et Passive, où Easy WMS appelle Odoo.

FlexigoTech · Responsable : Víctor Gómez · Mis à jour le 17 novembre 2026

L'essentiel

Versions
Odoo 17, 18, 19 et 20
Vérifié
dans le code du connecteur, version 20.0 · dans les sources citées à la fin
Lecture
5 min

Quelle interface Easy WMS ouvre à un ERP

Mecalux écrit : «Easy WMS s’intègre aux principaux ERP du marché». Mais l'interface concrète se convient avec Mecalux pour chaque installation. Il vous faut votre propre Easy WMS avec l'interface activée par Mecalux : l'API, SOAP, des fichiers ou une base de données. Dans Odoo, vous choisissez la vôtre dans le champ Transport de la connexion, sous Easy WMS › Configuration › Connexions Easy WMS. Chaque connexion utilise un seul transport.

TransportCe que demande la connexionCe que fait Tester la connexion
Easy WMS command API (OAuth2 + ExecuteCommand)HostName, Tenant, UriToken et UriExecuteCommand, avec ClientId et ClientSecret, ou MAPUser et MAPPassDemande le jeton et appelle UriExecuteCommand
Services web SOAPL'hôte et l'adresse du service, avec ses identifiantsTélécharge le WSDL et vérifie que la réponse en est un
Echange de fichiers par SFTPLe serveur, l'utilisateur et le mot de passe, sur le port 22, et les dossiersSe connecte via FlexigoTech Cloud et liste le dossier d'entrée
Echange de fichiers par dossier partageLe format de fichier et les dossiers de sortie, d'entrée et d'archiveVérifie qu'il atteint les dossiers
Base de données d'echange intermediaireLe DSN de la base de données d'echangeVérifie qu'il atteint la base

L'API de commandes, SOAP et SFTP passent par FlexigoTech Cloud, qui porte chaque appel jusqu'à votre serveur Easy WMS avec vos identifiants.

L'API de commandes : les champs de l'assistant de Mecalux

Pour l'API de commandes, la connexion demande les huit champs de l'assistant de connexion de Mecalux. C'est Mecalux qui vous les donne, car chaque installation a les siens.

  • HostName est la racine de votre propre installation. Il n'y a pas de serveur commun de Mecalux : Easy WMS se déploie par client.
  • UriToken est l'adresse du service de jetons OAuth2. D'après l'aide du champ, l'exemple de Mecalux est {HostName}/EasySTS/OAuth/Token, mais chaque déploiement peut en avoir un autre.
  • UriExecuteCommand est l'adresse unique des commandes. La capture de Mecalux la coupe, donc vous demandez le chemin exact à Mecalux.
  • Tenant identifie votre installation. Le connecteur l'envoie avec chaque appel et avec la demande de jeton.
  • ClientId et ClientSecret, ou MAPUser et MAPPass si votre installation demande l'autorisation par mot de passe. Si le service de jetons refuse les identifiants, l'avertissement indique l'autre autorisation.
Formulaire d'une connexion Easy WMS dans Odoo 20 avec l'entrepôt, le type de connexion, le transport et les boutons pour tester et charger les commandes
La connexion Easy WMS : l'entrepôt, le type, le transport et les boutons pour la tester, dans Odoo 20 avec des données de démonstration.

Actif ou Passive : qui appelle qui

Avec le type Actif, c'est Odoo qui mène. Il envoie les documents et demande les réponses avec deux actions planifiées : Easy WMS : envoyer les documents en file, toutes les 5 minutes, et Easy WMS : interroger les réponses, toutes les 10 minutes.

Avec le type Passive, c'est Easy WMS qui mène et qui appelle votre Odoo. Un administrateur système clique sur Générer un identifiant pour Mecalux et remet à Mecalux l'URL entrante et cet identifiant. Votre Odoo doit alors être joignable depuis internet.

Identifiants et sécurité de la connexion

Les identifiants sont en écriture seule. Ils sont conservés dans FlexigoTech Cloud, sur des serveurs en Allemagne, et Odoo ne les garde pas. Avant de les enregistrer, un administrateur système coche I accept that my Easy WMS credentials are kept by FlexigoTech Cloud and that the calls to Easy WMS go through it.

La destination des données est elle aussi verrouillée. Seul un administrateur système, la personne qui peut voir les identifiants, modifie l'hôte, UriToken, UriExecuteCommand, le transport et les dossiers, si bien que personne d'autre ne peut emmener le ClientId et le ClientSecret vers un autre serveur.

La connexion fait d'autres contrôles. Elle exige des adresses en https et, si vous saisissez une IP au lieu d'un nom, refuse les adresses privées. FlexigoTech ajoute votre hôte à une liste fermée avant le premier appel. Elle ne suit aucune redirection d'Easy WMS. Si Easy WMS limite le débit avec un HTTP 429, le message reste en file et il est relancé. En SFTP, un fichier qui attend encore dans le dossier de sortie n'est jamais écrasé.

Les documents : un jeu de départ à ajuster à votre installation

Mecalux ne publie pas son vocabulaire de commandes. C'est pourquoi Charger le jeu de commandes initial crée les documents de départ avec des noms provisoires, comme SetItem, SetEntryOrder, SetExitOrder ou GetEntryConfirmations. Ceux qui existent déjà restent intacts, vous pouvez donc appuyer deux fois. Ensuite, vous les renommez dans l'onglet Commandes, selon ce que vous avez convenu avec Mecalux.

Chaque document qui sort ou qui entre reste dans Odoo sous forme de message, avec son contenu tel quel. C'est le premier endroit où regarder quand quelque chose ne colle pas, et nous en parlons dans messages et erreurs avec Easy WMS.

Message ouvert dans Odoo 20 avec le document envoyé à Easy WMS, son statut et le bouton qui ouvre l'enregistrement Odoo
Un message ouvert : ce qui a été envoyé ou reçu, tel quel, dans Odoo 20 avec des données de démonstration.

Ce qu'il reste à confirmer avec un vrai Easy WMS

Les tests automatiques (255 dans la version pour Odoo 20 et 252 dans celles pour 17, 18 et 19) tournent contre un simulateur d'Easy WMS qui suit la capture d'écran publiée du connecteur de Mecalux lui-même et le profil de départ des documents. FlexigoTech n'a pas d'installation d'Easy WMS pour tester, et Mecalux ne publie pas le format de ses documents, donc le connecteur n'a pas encore été testé avec un vrai Easy WMS. La première vraie installation devra confirmer quelle autorisation OAuth elle demande, par où passe le Tenant, le chemin exact d'UriExecuteCommand, comment la commande porte le document, le service SOAP et SFTP.

Questions fréquentes sur l'API d'Easy WMS et Odoo

Faut-il l'abonnement FlexigoTech Cloud ?

Oui. Les appels par l'API de commandes, SOAP et SFTP passent par FlexigoTech Cloud, qui garde vos identifiants chiffrés. Le connecteur est sur Odoo Apps et tous ses détails sur la page du connecteur Mecalux Easy WMS.

Faut-il toucher au code pour adapter les documents ?

Non. Le connecteur fournit un profil de départ que vous ajustez à l'écran, dans l'onglet Commandes de la connexion, sans toucher au code.

Qu'est-ce qu'Easy WMS, exactement ?

C'est le système de gestion d'entrepôt de Mecalux. Ce qu'en dit son site, et comment il fonctionne avec Odoo, se trouve dans le logiciel Easy WMS de Mecalux.

À lire aussi

Le logiciel Easy WMS de Mecalux : ce que c'est et comment il fonctionne avec OdooEasy WMS est le WMS de Mecalux. Ce qu'en dit son site, comment il fonctionne et ce qu'Odoo et Easy WMS s'échangent grâce au connecteur.Messages avec Easy WMS dans Odoo : statuts, relances et erreursLes statuts d'un message Easy WMS, comment Odoo relance, qui reçoit l'alerte et que faire de chaque erreur qu'une confirmation peut produire.
Vérifié dans le code du connecteur (version 20.0) et dans les sources citées

Sources