Qué interfaz abre Easy WMS a un ERP
Mecalux dice que «Easy WMS se integra con los principales ERP del mercado», pero la interfaz concreta se acuerda con Mecalux en cada instalación. Necesitas tu propio Easy WMS con la interfaz activada por Mecalux: la API, SOAP, ficheros o una base de datos. En Odoo eliges la tuya en el campo Transporte de la conexión, en Easy WMS › Configuración › Conexiones con Easy WMS. Cada conexión usa un solo transporte.
| Transporte | Qué pide la conexión | Qué hace Probar conexión |
|---|---|---|
Easy WMS command API (OAuth2 + ExecuteCommand) | HostName, Tenant, UriToken y UriExecuteCommand, con ClientId y ClientSecret, o MAPUser y MAPPass | Pide el token y llama a UriExecuteCommand |
Servicios web SOAP | El host y la dirección del servicio, con sus credenciales | Descarga el WSDL y comprueba que la respuesta lo sea |
Intercambio de ficheros por SFTP | El servidor, el usuario y la contraseña, en el puerto 22, y las carpetas | Entra por FlexigoTech Cloud y lista la carpeta de entrada |
Intercambio de ficheros por carpeta compartida | El formato de fichero y las carpetas de salida, entrada y archivo | Comprueba que llega a las carpetas |
Base de datos intermedia de intercambio | La DSN de la base de datos de intercambio | Comprueba que llega a la base |
En castellano, la opción de la API de comandos sale con su nombre en inglés, tal como la ves arriba. La API de comandos, SOAP y SFTP pasan por FlexigoTech Cloud, que lleva cada llamada a tu servidor de Easy WMS con tus credenciales.
La API de comandos: los datos del asistente de Mecalux
Para la API de comandos, la conexión pide los ocho campos del asistente de conexión de Mecalux. Te los da Mecalux, porque cada instalación tiene los suyos.
- HostName es la raíz de tu propia instalación. No hay un servidor común de Mecalux: Easy WMS se despliega por cliente.
- UriToken es la dirección del servicio de tokens OAuth2. Según la ayuda del campo, el ejemplo de Mecalux es {HostName}/EasySTS/OAuth/Token, pero cada despliegue puede tener otro.
- UriExecuteCommand es la dirección única de los comandos. La captura de Mecalux la corta, así que la ruta exacta se la pides a Mecalux.
- Tenant identifica tu instalación. El conector lo envía con cada llamada y con la petición del token.
- ClientId y ClientSecret, o MAPUser y MAPPass si tu instalación pide la concesión por contraseña. Si el servicio de tokens rechaza las credenciales, el aviso te indica la otra concesión.

Activo o Passive: quién llama a quién
Con Activo manda Odoo. Envía los documentos y pregunta por las respuestas con dos tareas programadas: Easy WMS: enviar documentos en cola, cada 5 minutos, y Easy WMS: sondear respuestas, cada 10 minutos.
Con Passive manda Easy WMS, que llama a tu Odoo. Un administrador del sistema pulsa Generar credencial para Mecalux y entrega a Mecalux la URL de entrada y esa credencial. Para eso tu Odoo tiene que ser accesible desde internet.
Credenciales y seguridad de la conexión
Las credenciales son de solo escritura. Se guardan en FlexigoTech Cloud, en servidores de Alemania, y Odoo no se queda con ellas. Antes de guardarlas, un administrador del sistema marca Acepto que FlexigoTech Cloud guarde mis credenciales de Easy WMS y que las llamadas a Easy WMS pasen por él.
Adónde van los datos tampoco lo cambia cualquiera. El host, UriToken, UriExecuteCommand, el transporte y las carpetas solo los cambia un administrador del sistema, que es quien puede ver las credenciales, así que nadie más puede llevar el ClientId y el ClientSecret a otro servidor.
La conexión hace más comprobaciones. Pide direcciones con https y, si escribes una IP en lugar de un nombre, rechaza las privadas. FlexigoTech añade tu host a una lista cerrada antes de la primera llamada. No sigue ninguna redirección de Easy WMS. Si Easy WMS limita el ritmo con un HTTP 429, el mensaje se queda en cola y se reintenta. Por SFTP, un fichero que sigue esperando en la carpeta de salida nunca se sobrescribe.
Los documentos: un juego de partida que ajustas a tu instalación
Mecalux no publica su vocabulario de comandos. Por eso Cargar juego de comandos inicial crea los documentos de partida con nombres provisionales, como SetItem, SetEntryOrder, SetExitOrder o GetEntryConfirmations. Los que ya existen no se tocan, así que puedes pulsarlo dos veces. Después los renombras en la pestaña Comandos, según lo que acordaste con Mecalux.
Cada documento que sale o entra queda guardado en Odoo como un mensaje, con su contenido tal cual. Es lo primero que mirar si algo no cuadra, y lo contamos en mensajes y errores con Easy WMS.

Lo que aún hay que confirmar con un Easy WMS real
Las pruebas automáticas (255 en la versión para Odoo 20 y 252 en las de 17, 18 y 19) corren contra un simulador de Easy WMS que sigue la captura publicada del conector propio de Mecalux y el perfil de partida de los documentos. FlexigoTech no tiene una instalación de Easy WMS para probar y Mecalux no publica el formato de sus documentos, así que el conector todavía no se ha probado con un Easy WMS real. Con la primera instalación de verdad hay que confirmar qué concesión OAuth pide, dónde viaja el Tenant, la ruta exacta de UriExecuteCommand, cómo lleva el comando el documento, el servicio SOAP y el SFTP.
Preguntas frecuentes sobre la API de Easy WMS y Odoo
¿Necesita la suscripción a FlexigoTech Cloud?
Sí. Las llamadas por la API de comandos, SOAP y SFTP pasan por FlexigoTech Cloud, que guarda tus credenciales cifradas. Tienes el conector en Odoo Apps y todos sus detalles en la página del conector de Mecalux Easy WMS.
¿Tengo que tocar código para adaptar los documentos?
No. El conector trae un perfil de partida que ajustas en pantalla, en la pestaña Comandos de la conexión, sin tocar código.
¿Qué es exactamente Easy WMS?
Es el sistema de gestión de almacenes de Mecalux. Lo que dice de él su web, y cómo trabaja con Odoo, está en qué es Easy WMS.
Sigue leyendo
Comprobado en el código del conector (versión 20.0) y en las fuentes enlazadas
Fuentes
- 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/conector-mecalux-odoo.html
- Código del módulo: flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_backend.py
- Código del módulo: flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_transport.py
- Código del módulo: flexigo_mecalux_connector 20.0 (05a27c9c): static/description/index.html
- Código del módulo: flexigo_mecalux_connector 20.0 (05a27c9c): data/mecalux_data.xml
- Código del módulo: flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_default_profile.py
