Saltar al contenido principal
Mecalux Easy WMS

API de Easy WMS: cómo se conecta Odoo con el SGA de Mecalux

Odoo habla con Easy WMS por la interfaz que Mecalux haya activado en tu instalación, y Mecalux no publica ni su API ni el formato de sus documentos. Por eso el conector de FlexigoTech ofrece cinco transportes, entre ellos la API de comandos de Easy WMS, y dos tipos de conexión: Activo, en el que Odoo llama a Easy WMS, y Passive, en el que Easy WMS llama a Odoo.

FlexigoTech · Responsable: Víctor Gómez · Actualizado el 17 de noviembre de 2026

Lo esencial

Versiones
Odoo 17, 18, 19 y 20
Comprobado
en el código del conector, versión 20.0 · en las fuentes enlazadas al final
Lectura
5 min

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.

TransporteQué pide la conexiónQué hace Probar conexión
Easy WMS command API (OAuth2 + ExecuteCommand)HostName, Tenant, UriToken y UriExecuteCommand, con ClientId y ClientSecret, o MAPUser y MAPPassPide el token y llama a UriExecuteCommand
Servicios web SOAPEl host y la dirección del servicio, con sus credencialesDescarga el WSDL y comprueba que la respuesta lo sea
Intercambio de ficheros por SFTPEl servidor, el usuario y la contraseña, en el puerto 22, y las carpetasEntra por FlexigoTech Cloud y lista la carpeta de entrada
Intercambio de ficheros por carpeta compartidaEl formato de fichero y las carpetas de salida, entrada y archivoComprueba que llega a las carpetas
Base de datos intermedia de intercambioLa DSN de la base de datos de intercambioComprueba 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.
Formulario de una conexión con Easy WMS en Odoo 20 con el almacén, el tipo de conexión, el transporte y los botones Probar conexión y Cargar juego de comandos inicial
La conexión con Easy WMS: el almacén, el tipo, el transporte y los botones para probarla, en Odoo 20 con datos de demostració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.

Mensaje abierto en Odoo 20 con el documento enviado a Easy WMS, su estado y el botón para abrir el registro de Odoo
Un mensaje abierto: lo que se envió o recibió, tal cual, en Odoo 20 con datos de demostración.

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

Qué es Easy WMS, el SGA de Mecalux, y cómo funciona con OdooEasy WMS es el SGA de Mecalux. Qué dice de él su web, cómo trabaja y qué se envían Odoo y Easy WMS con el conector de FlexigoTech.Mensajes con Easy WMS en Odoo: estados, reintentos y erroresLos estados de un mensaje con Easy WMS, cómo reintenta Odoo, quién recibe el aviso y qué hacer con cada error que puede dar una confirmación.
Comprobado en el código del conector (versión 20.0) y en las fuentes enlazadas

Fuentes