Salta al contingut principal
Mecalux Easy WMS

API d'Easy WMS: com es connecta Odoo amb el SGA de Mecalux

Odoo parla amb Easy WMS per la interfície que Mecalux hagi activat a la teva instal·lació, i Mecalux no publica ni la seva API ni el format dels seus documents. Per això el connector de FlexigoTech ofereix cinc transports, entre ells l'API d'ordres d'Easy WMS, i dos tipus de connexió: Actiu, en què Odoo crida Easy WMS, i Passive, en què Easy WMS crida Odoo.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 17 de novembre de 2026

L'essencial

Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del connector, versió 20.0 · a les fonts enllaçades al final
Lectura
5 min

Quina interfície obre Easy WMS a un ERP

Mecalux diu que Easy WMS s'integra amb els principals ERP del mercat, però la interfície concreta s'acorda amb Mecalux a cada instal·lació. Necessites el teu propi Easy WMS amb la interfície activada per Mecalux: l'API, SOAP, fitxers o una base de dades. A Odoo tries la teva al camp Transport de la connexió, a Easy WMS › Configuració › Connexions amb Easy WMS. Cada connexió fa servir un sol transport.

TransportQuè demana la connexióQuè fa Provar la connexió
Easy WMS command API (OAuth2 + ExecuteCommand)HostName, Tenant, UriToken i UriExecuteCommand, amb ClientId i ClientSecret, o MAPUser i MAPPassDemana el testimoni i crida UriExecuteCommand
Serveis web SOAPEl host i l'adreça del servei, amb les seves credencialsDescarrega el WSDL i comprova que la resposta ho és
Intercanvi de fitxers per SFTPEl servidor, l'usuari i la contrasenya, al port 22, i les carpetesEntra per FlexigoTech Cloud i llista la carpeta d'entrada
Intercanvi de fitxers per carpeta compartidaEl format de fitxer i les carpetes de sortida, d'entrada i d'arxiuComprova que arriba a les carpetes
Base de dades intermedia d'intercanviLa DSN de la base de dades d'intercanviComprova que arriba a la base de dades

L'API d'ordres, SOAP i SFTP passen per FlexigoTech Cloud, que porta cada crida al teu servidor d'Easy WMS amb les teves credencials.

L'API d'ordres: les dades de l'assistent de Mecalux

Per a l'API d'ordres, la connexió demana els vuit camps de l'assistent de connexió de Mecalux. Te'ls dona Mecalux, perquè cada instal·lació té els seus.

  • HostName és l'arrel de la teva pròpia instal·lació. No hi ha cap servidor comú de Mecalux: Easy WMS es desplega per client.
  • UriToken és l'adreça del servei de testimonis OAuth2. Segons l'ajuda del camp, l'exemple de Mecalux és {HostName}/EasySTS/OAuth/Token, però cada desplegament en pot tenir un altre.
  • UriExecuteCommand és l'adreça única de les ordres. La captura de Mecalux la talla, així que la ruta exacta l'has de demanar a Mecalux.
  • Tenant identifica la teva instal·lació. El connector l'envia amb cada crida i amb la petició del testimoni.
  • ClientId i ClientSecret, o MAPUser i MAPPass si la teva instal·lació demana la concessió per contrasenya. Si el servei de testimonis rebutja les credencials, l'avís t'indica l'altra concessió.
Formulari d'una connexió amb Easy WMS a Odoo 20 amb el magatzem, el tipus de connexió, el transport i els botons per provar-la i carregar les ordres
La connexió amb Easy WMS: el magatzem, el tipus, el transport i els botons per provar-la, a Odoo 20 amb dades de demostració.

Actiu o Passive: qui crida qui

Amb el tipus Actiu mana Odoo. Envia els documents i pregunta per les respostes amb dues tasques programades: Easy WMS: enviar els documents en cua, cada 5 minuts, i Easy WMS: sondejar respostes, cada 10 minuts.

Amb el tipus Passive mana Easy WMS, que crida el teu Odoo. Un administrador del sistema prem Generar credencial per a Mecalux i lliura a Mecalux la URL d'entrada i aquesta credencial. Llavors el teu Odoo ha de ser accessible des d'internet.

Credencials i seguretat de la connexió

Les credencials són només d'escriptura. Es desen a FlexigoTech Cloud, en servidors d'Alemanya, i Odoo no se les queda. Abans de desar-les, un administrador del sistema marca I accept that my Easy WMS credentials are kept by FlexigoTech Cloud and that the calls to Easy WMS go through it.

On van les dades tampoc no ho canvia qualsevol. El host, UriToken, UriExecuteCommand, el transport i les carpetes només els canvia un administrador del sistema, que és qui pot veure les credencials, així que ningú més no pot portar el ClientId i el ClientSecret a un altre servidor.

La connexió fa més comprovacions. Demana adreces amb https i, si escrius una IP en lloc d'un nom, rebutja les privades. FlexigoTech afegeix el teu host a una llista tancada abans de la primera crida. No segueix cap redirecció d'Easy WMS. Si Easy WMS limita el ritme amb un HTTP 429, el missatge es queda a la cua i es torna a provar. Per SFTP, un fitxer que encara espera a la carpeta de sortida no se sobreescriu mai.

Els documents: un joc de partida que ajustes a la teva instal·lació

Mecalux no publica el seu vocabulari d'ordres. Per això Carregar el joc de comandes inicial crea els documents de partida amb noms provisionals, com SetItem, SetEntryOrder, SetExitOrder o GetEntryConfirmations. Els que ja existeixen no es toquen, així que el pots prémer dues vegades. Després els canvies el nom a la pestanya Comandes, segons el que vas acordar amb Mecalux.

Cada document que surt o entra queda desat a Odoo com un missatge, amb el seu contingut tal qual. És el primer lloc on mirar si alguna cosa no quadra, i ho expliquem a missatges i errors amb Easy WMS.

Missatge obert a Odoo 20 amb el document enviat a Easy WMS, el seu estat i el botó per obrir el registre d'Odoo
Un missatge obert: el que es va enviar o rebre, tal qual, a Odoo 20 amb dades de demostració.

El que encara cal confirmar amb un Easy WMS real

Les proves automàtiques (255 a la versió per a Odoo 20 i 252 a les de 17, 18 i 19) es fan contra un simulador d'Easy WMS que segueix la captura publicada del connector de la mateixa Mecalux i el perfil de partida dels documents. FlexigoTech no té cap instal·lació d'Easy WMS per provar i Mecalux no publica el format dels seus documents, així que el connector encara no s'ha provat amb un Easy WMS real. La primera instal·lació de debò haurà de confirmar quina concessió OAuth demana, per on viatja el Tenant, la ruta exacta d'UriExecuteCommand, com porta l'ordre el document, el servei SOAP i l'SFTP.

Preguntes freqüents sobre l'API d'Easy WMS i Odoo

Cal la subscripció a FlexigoTech Cloud?

Sí. Les crides per l'API d'ordres, SOAP i SFTP passen per FlexigoTech Cloud, que desa les teves credencials xifrades. Tens el connector a Odoo Apps i tots els detalls a la pàgina del connector de Mecalux Easy WMS.

He de tocar codi per adaptar els documents?

No. El connector porta un perfil de partida que ajustes a la pantalla, a la pestanya Comandes de la connexió, sense tocar codi.

Què és exactament Easy WMS?

És el sistema de gestió de magatzems de Mecalux. Què en diu el seu web, i com treballa amb Odoo, ho tens a què és Easy WMS.

Continua llegint

Què és Easy WMS, el SGA de Mecalux, i com funciona amb OdooEasy WMS és el SGA de Mecalux. Què en diu el seu web, com treballa i què s'intercanvien Odoo i Easy WMS amb el connector de FlexigoTech.Missatges amb Easy WMS a Odoo: estats, reintents i errorsEls estats d'un missatge amb Easy WMS, com reintenta Odoo, qui rep l'avís i què fer amb cada error que pot donar una confirmació.
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts