Welke interface Easy WMS voor een ERP openzet
Mecalux schrijft: «Easy WMS kan worden geïntegreerd met de belangrijkste ERP's op de markt». De concrete interface spreek je echter per installatie met Mecalux af. Je hebt je eigen Easy WMS nodig met de interface die Mecalux heeft geactiveerd: de API, SOAP, bestanden of een database. In Odoo kies je de jouwe in het veld Transport van de verbinding, onder Easy WMS › Configuration › Easy WMS connections. Elke verbinding gebruikt één transport.
| Transport | Wat de verbinding vraagt | Wat Test connection doet |
|---|---|---|
Easy WMS command API (OAuth2 + ExecuteCommand) | HostName, Tenant, UriToken en UriExecuteCommand, met ClientId en ClientSecret, of MAPUser en MAPPass | Vraagt het token op en roept UriExecuteCommand aan |
SOAP web services | De host en het adres van de dienst, met de inloggegevens | Downloadt de WSDL en controleert of het antwoord er een is |
File exchange over SFTP | De server, de gebruiker en het wachtwoord, op poort 22, en de mappen | Logt in via FlexigoTech Cloud en toont de inhoud van de inkomende map |
File exchange over a shared folder | Het bestandsformaat en de mappen voor uitgaand, inkomend en archief | Controleert of hij de mappen bereikt |
Intermediate exchange database | De Exchange database DSN | Controleert of hij de database bereikt |
De commando-API, SOAP en SFTP lopen via FlexigoTech Cloud, dat elke aanroep met je inloggegevens naar je Easy WMS-server brengt.
De commando-API: de velden van de wizard van Mecalux
Voor de commando-API vraagt de verbinding de acht velden van de verbindingswizard van Mecalux. Je krijgt ze van Mecalux, omdat elke installatie haar eigen velden heeft.
- HostName is de basis van je eigen installatie. Er is geen gedeelde server van Mecalux: Easy WMS wordt per klant geïnstalleerd.
- UriToken is het adres van de OAuth2-tokendienst. Volgens de helptekst van het veld is het voorbeeld van Mecalux {HostName}/EasySTS/OAuth/Token, maar elke installatie kan een ander adres hebben.
- UriExecuteCommand is het enige adres voor commando's. De schermafbeelding van Mecalux snijdt het af, dus het exacte pad vraag je aan Mecalux.
- Tenant identificeert je installatie. De connector stuurt hem mee met elke aanroep en met het tokenverzoek.
- ClientId en ClientSecret, of MAPUser en MAPPass als je installatie de toekenning met wachtwoord vraagt. Als de tokendienst de inloggegevens weigert, noemt de waarschuwing de andere toekenning.

Active of Passive: wie roept wie aan
Bij het type Active heeft Odoo de leiding. Het stuurt de documenten en vraagt de antwoorden op met twee geplande acties: Easy WMS: send queued documents, elke 5 minuten, en Easy WMS: poll for answers, elke 10 minuten.
Bij het type Passive heeft Easy WMS de leiding en roept het je Odoo aan. Een systeembeheerder klikt op Generate credential for Mecalux en geeft Mecalux de Inbound Url en die inloggegevens. Je Odoo moet dan vanaf internet bereikbaar zijn.
Inloggegevens en beveiliging van de verbinding
De inloggegevens zijn alleen-schrijven. Ze worden bewaard in FlexigoTech Cloud, op servers in Duitsland, en Odoo houdt ze niet bij. Voordat hij ze opslaat, vinkt een systeembeheerder I accept that my Easy WMS credentials are kept by FlexigoTech Cloud and that the calls to Easy WMS go through it aan.
Waar de gegevens heen gaan, is ook afgeschermd. Alleen een systeembeheerder, de persoon die de inloggegevens kan zien, wijzigt host, UriToken, UriExecuteCommand, transport en mappen, zodat niemand anders de ClientId en de ClientSecret naar een andere server kan sturen.
De verbinding controleert nog meer. Ze vraagt https-adressen en weigert privéadressen als je een IP-adres invult in plaats van een naam. FlexigoTech zet je host vóór de eerste aanroep op een gesloten lijst. Ze volgt geen enkele omleiding van Easy WMS. Als Easy WMS het tempo beperkt met een HTTP 429, blijft het bericht in de wachtrij en wordt het opnieuw geprobeerd. Via SFTP wordt een bestand dat nog in de uitgaande map wacht nooit overschreven.
De documenten: een startset die je aan je installatie aanpast
Mecalux publiceert zijn commandovocabulaire niet. Daarom maakt Load starting command set de startdocumenten aan met voorlopige namen, zoals SetItem, SetEntryOrder, SetExitOrder of GetEntryConfirmations. Bestaande documenten blijven ongemoeid, dus je kunt twee keer klikken. Daarna geef je ze in het tabblad Commands de namen die je met Mecalux hebt afgesproken.
Elk document dat uitgaat of binnenkomt, blijft in Odoo staan als bericht, met de inhoud precies zoals die is verstuurd. Daar kijk je eerst als iets niet klopt, en daarover gaat berichten en fouten met Easy WMS.

Wat er met een echte Easy WMS nog te bevestigen is
De automatische tests (255 in de versie voor Odoo 20 en 252 in de versies voor 17, 18 en 19) draaien tegen een simulator van Easy WMS die de gepubliceerde schermafbeelding van de eigen connector van Mecalux en het startprofiel van de documenten volgt. FlexigoTech heeft geen Easy WMS-installatie om mee te testen, en Mecalux publiceert het formaat van zijn documenten niet, dus de connector is nog niet getest met een echte Easy WMS. De eerste echte installatie moet bevestigen welke OAuth-toekenning ze vraagt, waar de Tenant meereist, het exacte pad van UriExecuteCommand, hoe het commando het document draagt, de SOAP-dienst en SFTP.
Veelgestelde vragen over de Easy WMS API en Odoo
Is het abonnement op FlexigoTech Cloud nodig?
Ja. Aanroepen via de commando-API, SOAP en SFTP lopen via FlexigoTech Cloud, dat je inloggegevens versleuteld bewaart. De connector staat op Odoo Apps en alle details op de pagina van de Mecalux Easy WMS-connector.
Moet ik code aanpassen om de documenten af te stemmen?
Nee. De connector levert een startprofiel dat je op het scherm aanpast, in het tabblad Commands van de verbinding, zonder code.
Wat is Easy WMS precies?
Het magazijnbeheersysteem van Mecalux. Wat de website erover zegt, en hoe het met Odoo werkt, staat in Easy WMS van Mecalux.
Lees verder
Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen
Bronnen
- 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/nl/mecalux-koppeling-odoo.html
- Broncode van de module: flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_backend.py
- Broncode van de module: flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_transport.py
- Broncode van de module: flexigo_mecalux_connector 20.0 (05a27c9c): static/description/index.html
- Broncode van de module: flexigo_mecalux_connector 20.0 (05a27c9c): data/mecalux_data.xml
- Broncode van de module: flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_default_profile.py
