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.
| Trasporto | Cosa chiede la connessione | Cosa fa Prova la connessione |
|---|---|---|
Easy WMS command API (OAuth2 + ExecuteCommand) | HostName, Tenant, UriToken e UriExecuteCommand, con ClientId e ClientSecret, oppure MAPUser e MAPPass | Chiede il token e chiama UriExecuteCommand |
Servizi web SOAP | L'host e l'indirizzo del servizio, con le sue credenziali | Scarica il WSDL e controlla che la risposta lo sia |
Scambio di file via SFTP | Il server, l'utente e la password, sulla porta 22, e le cartelle | Accede tramite FlexigoTech Cloud ed elenca la cartella di entrata |
Scambio di file tramite cartella condivisa | Il formato dei file e le cartelle di uscita, di entrata e di archivio | Controlla che arrivi alle cartelle |
Database di scambio intermedio | Il DSN del database di scambio | Controlla 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.

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.

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
Verificato nel codice del connettore (versione 20.0) e nelle fonti collegate
Fonti
- 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/it/connettore-mecalux-odoo.html
- Codice del modulo: flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_backend.py
- Codice del modulo: flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_transport.py
- Codice del modulo: flexigo_mecalux_connector 20.0 (05a27c9c): static/description/index.html
- Codice del modulo: flexigo_mecalux_connector 20.0 (05a27c9c): data/mecalux_data.xml
- Codice del modulo: flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_default_profile.py
