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.
| Transport | Ce que demande la connexion | Ce que fait Tester la connexion |
|---|---|---|
Easy WMS command API (OAuth2 + ExecuteCommand) | HostName, Tenant, UriToken et UriExecuteCommand, avec ClientId et ClientSecret, ou MAPUser et MAPPass | Demande le jeton et appelle UriExecuteCommand |
Services web SOAP | L'hôte et l'adresse du service, avec ses identifiants | Télécharge le WSDL et vérifie que la réponse en est un |
Echange de fichiers par SFTP | Le serveur, l'utilisateur et le mot de passe, sur le port 22, et les dossiers | Se connecte via FlexigoTech Cloud et liste le dossier d'entrée |
Echange de fichiers par dossier partage | Le format de fichier et les dossiers de sortie, d'entrée et d'archive | Vérifie qu'il atteint les dossiers |
Base de données d'echange intermediaire | Le DSN de la base de données d'echange | Vé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.

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.

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
Vérifié dans le code du connecteur (version 20.0) et dans les sources citées
Sources
- www.mecalux.es/software/sga-software-gestion-almacenes
- www.mecalux.com/software/warehouse-management-system-wms
- www.mecalux.de/lagersoftware/lvs-lagerverwaltungssystem
- www.mecalux.fr/logiciel/wms-logiciel-logistique-gestion-entrepot
- www.mecalux.it/software/wms-software-gestione-magazzino
- www.mecalux.pt/software/sga-sistema-gestao-armazens
- www.mecalux.nl/magazijnsoftware/wms-systeem-warehouse-management
- www.mecalux.pl/oprogramowanie/system-wms
- flexigotech.com/fr/connecteur-mecalux-odoo.html
- Code du module : flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_backend.py
- Code du module : flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_transport.py
- Code du module : flexigo_mecalux_connector 20.0 (05a27c9c): static/description/index.html
- Code du module : flexigo_mecalux_connector 20.0 (05a27c9c): data/mecalux_data.xml
- Code du module : flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_default_profile.py
