Saltar para o conteúdo principal
Mecalux Easy WMS

Easy WMS API: como o Odoo se liga ao WMS da Mecalux

O Odoo fala com o Easy WMS pela interface que a Mecalux ativou na sua instalação, e a Mecalux não publica nem a sua API nem o formato dos seus documentos. Por isso o conector da FlexigoTech oferece cinco transportes, entre eles a API de comandos do Easy WMS, e dois tipos de ligação: Ativo, em que o Odoo chama o Easy WMS, e Passive, em que o Easy WMS chama o Odoo.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 17 de novembro de 2026

O essencial

Versões
Odoo 17, 18, 19 e 20
Verificado
no código do conector, versão 20.0 · nas fontes indicadas no fim
Leitura
5 min

Que interface abre o Easy WMS a um ERP

A Mecalux escreve: «O Easy WMS pode ser perfeitamente integrado com os principais ERP do mercado». A interface concreta, porém, é acordada com a Mecalux em cada instalação. Precisa do seu próprio Easy WMS com a interface ativada pela Mecalux: a API, SOAP, ficheiros ou uma base de dados. No Odoo escolhe a sua no campo Transporte da ligação, em Easy WMS › Configuração › Ligações ao Easy WMS. Cada ligação usa um só transporte.

TransporteO que a ligação pedeO que faz Testar a ligação
Easy WMS command API (OAuth2 + ExecuteCommand)HostName, Tenant, UriToken e UriExecuteCommand, com ClientId e ClientSecret, ou MAPUser e MAPPassPede o token e chama o UriExecuteCommand
Serviços web SOAPO host e o endereço do serviço, com as suas credenciaisDescarrega o WSDL e verifica que a resposta o é
Troca de ficheiros por SFTPO servidor, o utilizador e a palavra-passe, na porta 22, e as pastasEntra através da FlexigoTech Cloud e lista a pasta de entrada
Troca de ficheiros por pasta partilhadaO formato de ficheiro e as pastas de saída, de entrada e de arquivoVerifica que chega às pastas
Base de dados intermedia de trocaO DSN da base de dados de trocaVerifica que chega à base de dados

A API de comandos, SOAP e SFTP passam pelo FlexigoTech Cloud, que leva cada chamada até ao seu servidor Easy WMS com as suas credenciais.

A API de comandos: os campos do assistente da Mecalux

Para a API de comandos, a ligação pede os oito campos do assistente de ligação da Mecalux. É a Mecalux que lhos dá, porque cada instalação tem os seus.

  • HostName é a raiz da sua própria instalação. Não há um servidor comum da Mecalux: o Easy WMS instala-se por cliente.
  • UriToken é o endereço do serviço de tokens OAuth2. Segundo a ajuda do campo, o exemplo da Mecalux é {HostName}/EasySTS/OAuth/Token, mas cada instalação pode ter outro.
  • UriExecuteCommand é o endereço único dos comandos. A captura da Mecalux corta-o, por isso o caminho exato pede-se à Mecalux.
  • Tenant identifica a sua instalação. O conector envia-o com cada chamada e com o pedido do token.
  • ClientId e ClientSecret, ou MAPUser e MAPPass se a sua instalação pedir a concessão por palavra-passe. Se o serviço de tokens recusar as credenciais, o aviso indica-lhe a outra concessão.
Formulário de uma ligação ao Easy WMS no Odoo 20 com o armazém, o tipo de ligação, o transporte e os botões para a testar e carregar os comandos
A ligação ao Easy WMS: o armazém, o tipo, o transporte e os botões para a testar, no Odoo 20 com dados de demonstração.

Ativo ou Passive: quem chama quem

Com o tipo Ativo manda o Odoo. Envia os documentos e pergunta pelas respostas com duas ações agendadas: Easy WMS: enviar os documentos em fila, a cada 5 minutos, e Easy WMS: sondar respostas, a cada 10 minutos.

Com o tipo Passive manda o Easy WMS, que chama o seu Odoo. Um administrador do sistema carrega em Gerar credencial para a Mecalux e entrega à Mecalux o URL de entrada e essa credencial. O seu Odoo tem então de estar acessível a partir da internet.

Credenciais e segurança da ligação

As credenciais são só de escrita. Guardam-se no FlexigoTech Cloud, em servidores na Alemanha, e o Odoo não fica com elas. Antes de as guardar, um administrador do sistema marca I accept that my Easy WMS credentials are kept by FlexigoTech Cloud and that the calls to Easy WMS go through it.

O destino dos dados também está protegido. Só um administrador do sistema, que é quem pode ver as credenciais, altera o host, o UriToken, o UriExecuteCommand, o transporte e as pastas, por isso mais ninguém pode levar o ClientId e o ClientSecret para outro servidor.

A ligação faz mais verificações. Exige endereços com https e, se escrever um IP em vez de um nome, recusa os privados. A FlexigoTech acrescenta o seu host a uma lista fechada antes da primeira chamada. Não segue nenhum redirecionamento do Easy WMS. Se o Easy WMS limitar o ritmo com um HTTP 429, a mensagem fica em fila e volta a ser tentada. Por SFTP, um ficheiro que ainda espera na pasta de saída nunca é substituído.

Os documentos: um conjunto inicial que ajusta à sua instalação

A Mecalux não publica o seu vocabulário de comandos. Por isso Carregar o conjunto de comandos inicial cria os documentos iniciais com nomes provisórios, como SetItem, SetEntryOrder, SetExitOrder ou GetEntryConfirmations. Os que já existem não mudam, portanto pode carregar duas vezes. Depois muda-lhes o nome no separador Comandos, conforme o que acordou com a Mecalux.

Cada documento que sai ou entra fica no Odoo como mensagem, com o seu conteúdo tal como viajou. É o primeiro sítio a ver quando algo não bate certo, e falamos disso em mensagens e erros com o Easy WMS.

Mensagem aberta no Odoo 20 com o documento enviado ao Easy WMS, o seu estado e o botão para abrir o registo do Odoo
Uma mensagem aberta: o que foi enviado ou recebido, tal como viajou, no Odoo 20 com dados de demonstração.

O que falta confirmar com um Easy WMS real

Os testes automáticos (255 na versão para Odoo 20 e 252 nas versões para 17, 18 e 19) correm contra um simulador do Easy WMS que segue a captura de ecrã publicada do conector da própria Mecalux e o perfil inicial dos documentos. A FlexigoTech não tem uma instalação do Easy WMS para testar, e a Mecalux não publica o formato dos seus documentos, por isso o conector ainda não foi testado com um Easy WMS real. A primeira instalação real terá de confirmar que concessão OAuth pede, por onde viaja o Tenant, o caminho exato do UriExecuteCommand, como o comando leva o documento, o serviço SOAP e o SFTP.

Perguntas frequentes sobre a API do Easy WMS e o Odoo

Precisa da subscrição do FlexigoTech Cloud?

Sim. As chamadas pela API de comandos, SOAP e SFTP passam pelo FlexigoTech Cloud, que guarda as suas credenciais cifradas. Tem o conector no Odoo Apps e todos os detalhes na página do conector Mecalux Easy WMS.

Tenho de mexer no código para adaptar os documentos?

Não. O conector traz um perfil inicial que ajusta no ecrã, no separador Comandos da ligação, sem mexer no código.

O que é exatamente o Easy WMS?

É o sistema de gestão de armazéns da Mecalux. O que diz o seu site, e como trabalha com o Odoo, está em Easy WMS da Mecalux.

Continue a ler

Easy WMS da Mecalux: o que é este WMS e como funciona com o OdooO Easy WMS é o WMS da Mecalux. O que diz o seu site, como trabalha e o que o Odoo e o Easy WMS trocam através do conector da FlexigoTech.Mensagens com o Easy WMS no Odoo: estados, novas tentativas e errosOs estados de uma mensagem com o Easy WMS, como o Odoo volta a tentar, quem recebe o aviso e o que fazer com cada erro de uma confirmação.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes