Vai al contenuto principale
Mecalux Easy WMS

Easy WMS API: come si collega Odoo al WMS di Mecalux

Odoo parla con Easy WMS attraverso l'interfaccia che Mecalux ha attivato nella tua installazione, e Mecalux non pubblica né la sua API né il formato dei suoi documenti. Per questo il connettore di FlexigoTech offre cinque trasporti, tra cui l'API dei comandi di Easy WMS, e due tipi di connessione: Attivo, in cui Odoo chiama Easy WMS, e Passive, in cui Easy WMS chiama Odoo.

FlexigoTech · Responsabile: Víctor Gómez · Aggiornato il 17 novembre 2026

In breve

Versioni
Odoo 17, 18, 19 e 20
Verificato
nel codice del connettore, versione 20.0 · nelle fonti collegate in fondo
Lettura
5 min

Quale interfaccia apre Easy WMS a un ERP

Mecalux scrive: «Easy WMS si integra con le principali applicazioni ERP presenti sul mercato». L'interfaccia concreta, però, si concorda con Mecalux per ogni installazione. Ti serve un tuo Easy WMS con l'interfaccia attivata da Mecalux: l'API, SOAP, file o un database. In Odoo scegli la tua nel campo Trasporto della connessione, in Easy WMS › Configurazione › Connessioni Easy WMS. Ogni connessione usa un solo trasporto.

TrasportoCosa chiede la connessioneCosa fa Prova la connessione
Easy WMS command API (OAuth2 + ExecuteCommand)HostName, Tenant, UriToken e UriExecuteCommand, con ClientId e ClientSecret, oppure MAPUser e MAPPassChiede il token e chiama UriExecuteCommand
Servizi web SOAPL'host e l'indirizzo del servizio, con le sue credenzialiScarica il WSDL e controlla che la risposta lo sia
Scambio di file via SFTPIl server, l'utente e la password, sulla porta 22, e le cartelleAccede tramite FlexigoTech Cloud ed elenca la cartella di entrata
Scambio di file tramite cartella condivisaIl formato dei file e le cartelle di uscita, di entrata e di archivioControlla che arrivi alle cartelle
Database di scambio intermedioIl DSN del database di scambioControlla che arrivi al database

L'API dei comandi, SOAP e SFTP passano da FlexigoTech Cloud, che porta ogni chiamata al tuo server Easy WMS con le tue credenziali.

L'API dei comandi: i campi della procedura guidata di Mecalux

Per l'API dei comandi, la connessione chiede gli otto campi della procedura guidata di connessione di Mecalux. Te li dà Mecalux, perché ogni installazione ha i suoi.

  • HostName è la radice della tua installazione. Non esiste un server comune di Mecalux: Easy WMS si installa per cliente.
  • UriToken è l'indirizzo del servizio dei token OAuth2. Secondo l'aiuto del campo, l'esempio di Mecalux è {HostName}/EasySTS/OAuth/Token, ma ogni installazione può averne un altro.
  • UriExecuteCommand è l'indirizzo unico dei comandi. Lo screenshot di Mecalux lo taglia, quindi il percorso esatto lo chiedi a Mecalux.
  • Tenant identifica la tua installazione. Il connettore lo invia con ogni chiamata e con la richiesta del token.
  • ClientId e ClientSecret, oppure MAPUser e MAPPass se la tua installazione chiede la concessione con password. Se il servizio dei token rifiuta le credenziali, l'avviso ti indica l'altra concessione.
Modulo di una connessione con Easy WMS in Odoo 20 con il magazzino, il tipo di connessione, il trasporto e i pulsanti per provarla e caricare i comandi
La connessione con Easy WMS: il magazzino, il tipo, il trasporto e i pulsanti per provarla, in Odoo 20 con dati dimostrativi.

Attivo o Passive: chi chiama chi

Con il tipo Attivo comanda Odoo. Invia i documenti e chiede le risposte con due azioni pianificate: Easy WMS: invia i documenti in coda, ogni 5 minuti, e Easy WMS: interroga le risposte, ogni 10 minuti.

Con il tipo Passive comanda Easy WMS, che chiama il tuo Odoo. Un amministratore di sistema preme Genera una credenziale per Mecalux e consegna a Mecalux l'URL in entrata e quella credenziale. Il tuo Odoo deve quindi essere raggiungibile da internet.

Credenziali e sicurezza della connessione

Le credenziali sono di sola scrittura. Si conservano in FlexigoTech Cloud, su server in Germania, e Odoo non le tiene. Prima di salvarle, un amministratore di sistema spunta I accept that my Easy WMS credentials are kept by FlexigoTech Cloud and that the calls to Easy WMS go through it.

Anche la destinazione dei dati è protetta. Solo un amministratore di sistema, cioè chi può vedere le credenziali, cambia host, UriToken, UriExecuteCommand, trasporto e cartelle, così nessun altro può portare il ClientId e il ClientSecret su un altro server.

La connessione fa altri controlli. Chiede indirizzi in https e, se scrivi un IP invece di un nome, rifiuta quelli privati. FlexigoTech aggiunge il tuo host a un elenco chiuso prima della prima chiamata. Non segue nessun reindirizzamento di Easy WMS. Se Easy WMS limita il ritmo con un HTTP 429, il messaggio resta in coda e viene riprovato. Via SFTP, un file che aspetta ancora nella cartella di uscita non viene mai sovrascritto.

I documenti: un set di partenza da adattare alla tua installazione

Mecalux non pubblica il suo vocabolario dei comandi. Per questo Carica il set di comandi iniziale crea i documenti di partenza con nomi provvisori, come SetItem, SetEntryOrder, SetExitOrder o GetEntryConfirmations. Quelli che esistono già restano come sono, quindi puoi premerlo due volte. Poi li rinomini nella scheda Comandi, secondo quanto hai concordato con Mecalux.

Ogni documento che esce o entra resta in Odoo come messaggio, con il suo contenuto così com'è viaggiato. È il primo posto da guardare quando qualcosa non torna, e ne parliamo in messaggi ed errori con Easy WMS.

Messaggio aperto in Odoo 20 con il documento inviato a Easy WMS, il suo stato e il pulsante per aprire il record di Odoo
Un messaggio aperto: ciò che è stato inviato o ricevuto, così com'è, in Odoo 20 con dati dimostrativi.

Cosa resta da confermare con un Easy WMS reale

I test automatici (255 nella versione per Odoo 20 e 252 in quelle per 17, 18 e 19) girano contro un simulatore di Easy WMS che segue lo screenshot pubblicato del connettore di Mecalux stessa e il profilo di partenza dei documenti. FlexigoTech non ha un'installazione di Easy WMS per provare e Mecalux non pubblica il formato dei suoi documenti, quindi il connettore non è ancora stato provato con un Easy WMS reale. La prima installazione reale dovrà confermare quale concessione OAuth chiede, dove viaggia il Tenant, il percorso esatto di UriExecuteCommand, come il comando porta il documento, il servizio SOAP e l'SFTP.

Domande frequenti sull'API di Easy WMS e Odoo

Serve l'abbonamento a FlexigoTech Cloud?

Sì. Le chiamate con l'API dei comandi, SOAP e SFTP passano da FlexigoTech Cloud, che conserva cifrate le tue credenziali. Trovi il connettore su Odoo Apps e tutti i dettagli nella pagina del connettore Mecalux Easy WMS.

Devo toccare il codice per adattare i documenti?

No. Il connettore porta un profilo di partenza che adatti a schermo, nella scheda Comandi della connessione, senza toccare codice.

Che cos'è esattamente Easy WMS?

È il sistema di gestione del magazzino di Mecalux. Cosa ne dice il suo sito, e come lavora con Odoo, lo trovi in Easy WMS di Mecalux.

Continua a leggere

Easy WMS di Mecalux: che cos'è il WMS e come funziona con OdooEasy WMS è il WMS di Mecalux. Cosa ne dice il suo sito, come lavora e cosa si scambiano Odoo ed Easy WMS con il connettore di FlexigoTech.Messaggi con Easy WMS in Odoo: stati, nuovi tentativi ed erroriGli stati di un messaggio con Easy WMS, come riprova Odoo, chi riceve l'avviso e cosa fare con ogni errore che può dare una conferma.
Verificato nel codice del connettore (versione 20.0) e nelle fonti collegate

Fonti