Zum Hauptinhalt springen
Mecalux Easy WMS

Easy WMS API: wie sich Odoo mit dem LVS von Mecalux verbindet

Odoo spricht mit Easy WMS über die Schnittstelle, die Mecalux in Ihrer Installation freigeschaltet hat, und Mecalux veröffentlicht weder seine API noch das Format seiner Dokumente. Deshalb bietet der Konnektor von FlexigoTech fünf Transporte, darunter die Befehls-API von Easy WMS, und zwei Verbindungsarten: Aktiv, bei der Odoo Easy WMS aufruft, und Passive, bei der Easy WMS Odoo aufruft.

FlexigoTech · Verantwortlich: Víctor Gómez · Aktualisiert am 17. November 2026

Das Wichtigste

Versionen
Odoo 17, 18, 19 und 20
Geprüft
im Quellcode des Connectors, Version 20.0 · in den Quellen am Ende
Lesezeit
5 Min.

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.

TransportWas die Verbindung brauchtWas Verbindung testen tut
Easy WMS command API (OAuth2 + ExecuteCommand)HostName, Tenant, UriToken und UriExecuteCommand, mit ClientId und ClientSecret oder MAPUser und MAPPassFordert das Token an und ruft UriExecuteCommand auf
SOAP-WebservicesDen Host und die Adresse des Dienstes, mit seinen ZugangsdatenLädt die WSDL herunter und prüft, dass die Antwort eine ist
Dateiaustausch über SFTPDen Server, den Benutzer und das Passwort, auf Port 22, und die OrdnerMeldet sich über FlexigoTech Cloud an und listet den Eingangsordner auf
Dateiaustausch über einen freigegebenen OrdnerDas Dateiformat und die Ordner für Ausgang, Eingang und ArchivPrüft, dass er die Ordner erreicht
Zwischen-AustauschdatenbankDie DSN der AustauschdatenbankPrü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.
Formular einer Verbindung mit Easy WMS in Odoo 20 mit dem Lager, der Verbindungsart, dem Transport und den Schaltflächen zum Testen und zum Laden der Befehle
Die Verbindung mit Easy WMS: Lager, Art, Transport und die Schaltflächen zum Testen, in Odoo 20 mit Demodaten.

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.

Geöffnete Nachricht in Odoo 20 mit dem an Easy WMS gesendeten Dokument, seinem Status und der Schaltfläche zum Odoo-Datensatz
Eine geöffnete Nachricht: was gesendet oder empfangen wurde, genau so, wie es übertragen wurde, in Odoo 20 mit Demodaten.

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

Easy WMS von Mecalux: was das LVS ist und wie es mit Odoo zusammenarbeitetEasy WMS ist das Lagerverwaltungssystem von Mecalux. Was seine Website sagt, wie es arbeitet und was Odoo und Easy WMS über den Konnektor austauschen.Nachrichten mit Easy WMS in Odoo: Status, Wiederholungen und FehlerDie Status einer Easy-WMS-Nachricht, wie Odoo erneut versucht, wer benachrichtigt wird und was bei jedem Fehler einer Bestätigung zu tun ist.
Geprüft im Quellcode des Connectors (Version 20.0) und in den verlinkten Quellen

Quellen