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.
| Transporte | O que a ligação pede | O que faz Testar a ligação |
|---|---|---|
Easy WMS command API (OAuth2 + ExecuteCommand) | HostName, Tenant, UriToken e UriExecuteCommand, com ClientId e ClientSecret, ou MAPUser e MAPPass | Pede o token e chama o UriExecuteCommand |
Serviços web SOAP | O host e o endereço do serviço, com as suas credenciais | Descarrega o WSDL e verifica que a resposta o é |
Troca de ficheiros por SFTP | O servidor, o utilizador e a palavra-passe, na porta 22, e as pastas | Entra através da FlexigoTech Cloud e lista a pasta de entrada |
Troca de ficheiros por pasta partilhada | O formato de ficheiro e as pastas de saída, de entrada e de arquivo | Verifica que chega às pastas |
Base de dados intermedia de troca | O DSN da base de dados de troca | Verifica 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.

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.

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
Verificado no código do conector (versão 20.0) e nas fontes indicadas
Fontes
- 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/pt/conector-mecalux-odoo.html
- Código do módulo: flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_backend.py
- Código do módulo: flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_transport.py
- Código do módulo: flexigo_mecalux_connector 20.0 (05a27c9c): static/description/index.html
- Código do módulo: flexigo_mecalux_connector 20.0 (05a27c9c): data/mecalux_data.xml
- Código do módulo: flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_default_profile.py
