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.
| Transport | Què 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 MAPPass | Demana el testimoni i crida UriExecuteCommand |
Serveis web SOAP | El host i l'adreça del servei, amb les seves credencials | Descarrega el WSDL i comprova que la resposta ho és |
Intercanvi de fitxers per SFTP | El servidor, l'usuari i la contrasenya, al port 22, i les carpetes | Entra per FlexigoTech Cloud i llista la carpeta d'entrada |
Intercanvi de fitxers per carpeta compartida | El format de fitxer i les carpetes de sortida, d'entrada i d'arxiu | Comprova que arriba a les carpetes |
Base de dades intermedia d'intercanvi | La DSN de la base de dades d'intercanvi | Comprova 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ó.

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.

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
Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades
Fonts
- 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/ca/connector-mecalux-odoo.html
- Codi del mòdul: flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_backend.py
- Codi del mòdul: flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_transport.py
- Codi del mòdul: flexigo_mecalux_connector 20.0 (05a27c9c): static/description/index.html
- Codi del mòdul: flexigo_mecalux_connector 20.0 (05a27c9c): data/mecalux_data.xml
- Codi del mòdul: flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_default_profile.py
