Welche Schnittstelle Easy WMS einem ERP öffnet
Mecalux schreibt: «Easy WMS lässt sich mit den wichtigsten ERP-Systemen auf dem Markt sowie mit verschiedenen automatisierten Lagersystemen und Intralogistik-Roboterlösungen integrieren». Die konkrete Schnittstelle wird aber für jede Installation mit Mecalux vereinbart. Sie brauchen Ihr eigenes Easy WMS mit der von Mecalux freigeschalteten Schnittstelle: die API, SOAP, Dateien oder eine Datenbank. In Odoo wählen Sie Ihre im Feld Transport der Verbindung, unter Easy WMS › Konfiguration › Easy-WMS-Verbindungen. Jede Verbindung nutzt einen Transport.
| Transport | Was die Verbindung braucht | Was Verbindung testen tut |
|---|---|---|
Easy WMS command API (OAuth2 + ExecuteCommand) | HostName, Tenant, UriToken und UriExecuteCommand, mit ClientId und ClientSecret oder MAPUser und MAPPass | Fordert das Token an und ruft UriExecuteCommand auf |
SOAP-Webservices | Den Host und die Adresse des Dienstes, mit seinen Zugangsdaten | Lädt die WSDL herunter und prüft, dass die Antwort eine ist |
Dateiaustausch über SFTP | Den Server, den Benutzer und das Passwort, auf Port 22, und die Ordner | Meldet sich über FlexigoTech Cloud an und listet den Eingangsordner auf |
Dateiaustausch über einen freigegebenen Ordner | Das Dateiformat und die Ordner für Ausgang, Eingang und Archiv | Prüft, dass er die Ordner erreicht |
Zwischen-Austauschdatenbank | Die DSN der Austauschdatenbank | Prüft, dass er die Datenbank erreicht |
Die Befehls-API, SOAP und SFTP laufen über FlexigoTech Cloud, das jeden Aufruf mit Ihren Zugangsdaten an Ihren Easy-WMS-Server weitergibt.
Die Befehls-API: die Felder des Mecalux-Assistenten
Für die Befehls-API verlangt die Verbindung die acht Felder des Verbindungsassistenten von Mecalux. Sie bekommen sie von Mecalux, weil jede Installation ihre eigenen hat.
- HostName ist die Wurzel Ihrer eigenen Installation. Es gibt keinen gemeinsamen Server von Mecalux: Easy WMS wird pro Kunde bereitgestellt.
- UriToken ist die Adresse des OAuth2-Tokendienstes. Laut Hilfetext des Feldes lautet das Beispiel von Mecalux {HostName}/EasySTS/OAuth/Token, doch jede Bereitstellung kann eine andere haben.
- UriExecuteCommand ist die einzige Adresse für Befehle. Der Screenshot von Mecalux schneidet sie ab, also erfragen Sie den genauen Pfad bei Mecalux.
- Tenant kennzeichnet Ihre Installation. Der Konnektor sendet ihn bei jedem Aufruf und mit der Tokenanfrage.
- ClientId und ClientSecret, oder MAPUser und MAPPass, wenn Ihre Installation die Gewährung per Passwort verlangt. Lehnt der Tokendienst die Zugangsdaten ab, nennt die Warnung die andere Gewährung.

Aktiv oder Passive: wer wen aufruft
Bei der Art Aktiv führt Odoo. Es sendet die Dokumente und fragt mit zwei geplanten Aktionen nach den Antworten: Easy WMS: eingereihte Dokumente senden, alle 5 Minuten, und Easy WMS: Antworten abfragen, alle 10 Minuten.
Bei der Art Passive führt Easy WMS und ruft Ihr Odoo auf. Ein Systemadministrator klickt auf Zugangsdaten fur Mecalux erzeugen und gibt Mecalux die Eingangs-URL und diese Zugangsdaten. Ihr Odoo muss dann aus dem Internet erreichbar sein.
Zugangsdaten und Sicherheit der Verbindung
Die Zugangsdaten sind nur schreibbar. Sie werden in FlexigoTech Cloud auf Servern in Deutschland gespeichert, und Odoo behält sie nicht. Bevor er sie speichert, setzt ein Systemadministrator das Häkchen I accept that my Easy WMS credentials are kept by FlexigoTech Cloud and that the calls to Easy WMS go through it.
Wohin die Daten gehen, ist ebenfalls abgesichert. Nur ein Systemadministrator, also die Person, die die Zugangsdaten sehen kann, ändert Host, UriToken, UriExecuteCommand, Transport und Ordner. So kann niemand sonst ClientId und ClientSecret auf einen anderen Server umleiten.
Die Verbindung prüft noch mehr. Sie verlangt https-Adressen und lehnt private Adressen ab, wenn Sie statt eines Namens eine IP eintragen. FlexigoTech nimmt Ihren Host vor dem ersten Aufruf in eine geschlossene Liste auf. Weiterleitungen von Easy WMS folgt sie nicht. Begrenzt Easy WMS die Rate mit einem HTTP 429, bleibt die Nachricht in der Warteschlange und wird erneut versucht. Über SFTP wird eine Datei, die noch im Ausgangsordner wartet, nie überschrieben.
Die Dokumente: ein Startpaket, das Sie an Ihre Installation anpassen
Mecalux veröffentlicht sein Befehlsvokabular nicht. Darum legt Anfangs-Befehlssatz laden die Startdokumente mit vorläufigen Namen an, etwa SetItem, SetEntryOrder, SetExitOrder oder GetEntryConfirmations. Vorhandene bleiben unangetastet, Sie können die Schaltfläche also zweimal drücken. Danach benennen Sie sie im Reiter Befehle so um, wie Sie es mit Mecalux vereinbart haben.
Jedes Dokument, das hinaus- oder hereinkommt, bleibt in Odoo als Nachricht, mit seinem Inhalt genau so, wie er übertragen wurde. Dort schauen Sie zuerst nach, wenn etwas nicht stimmt. Mehr dazu in Nachrichten und Fehler mit Easy WMS.

Was mit einem echten Easy WMS noch zu bestätigen ist
Die automatischen Tests (255 in der Version für Odoo 20 und 252 in den Versionen für 17, 18 und 19) laufen gegen einen Easy-WMS-Simulator, der dem veröffentlichten Screenshot des eigenen Konnektors von Mecalux und dem Startprofil der Dokumente folgt. FlexigoTech hat keine Easy-WMS-Installation zum Testen, und Mecalux veröffentlicht das Format seiner Dokumente nicht, deshalb wurde der Konnektor noch nicht mit einem echten Easy WMS getestet. Die erste echte Installation muss bestätigen, welche OAuth-Gewährung sie verlangt, wo der Tenant übertragen wird, den genauen Pfad von UriExecuteCommand, wie der Befehl das Dokument trägt, den SOAP-Dienst und SFTP.
Häufige Fragen zur Easy WMS API und Odoo
Braucht es das Abonnement von FlexigoTech Cloud?
Ja. Aufrufe über die Befehls-API, SOAP und SFTP laufen über FlexigoTech Cloud, das Ihre Zugangsdaten verschlüsselt speichert. Den Konnektor finden Sie in Odoo Apps und alle Details auf der Seite des Mecalux-Easy-WMS-Konnektors.
Muss ich Code anfassen, um die Dokumente anzupassen?
Nein. Der Konnektor bringt ein Startprofil mit, das Sie am Bildschirm anpassen, im Reiter Befehle der Verbindung, ohne Code.
Was genau ist Easy WMS?
Das Lagerverwaltungssystem von Mecalux. Was seine Website darüber sagt und wie es mit Odoo arbeitet, steht in Easy WMS von Mecalux.
Weiterlesen
Geprüft im Quellcode des Connectors (Version 20.0) und in den verlinkten Quellen
Quellen
- 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/de/mecalux-odoo-anbindung.html
- Quellcode des Moduls: flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_backend.py
- Quellcode des Moduls: flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_transport.py
- Quellcode des Moduls: flexigo_mecalux_connector 20.0 (05a27c9c): static/description/index.html
- Quellcode des Moduls: flexigo_mecalux_connector 20.0 (05a27c9c): data/mecalux_data.xml
- Quellcode des Moduls: flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_default_profile.py
