Naar hoofdinhoud
Mecalux Easy WMS

Easy WMS API: zo verbindt Odoo met het WMS van Mecalux

Odoo praat met Easy WMS via de interface die Mecalux in jouw installatie heeft geactiveerd, en Mecalux publiceert zijn API en het formaat van zijn documenten niet. Daarom biedt de connector van FlexigoTech vijf transporten, waaronder de commando-API van Easy WMS, en twee verbindingstypen: Active, waarbij Odoo Easy WMS aanroept, en Passive, waarbij Easy WMS Odoo aanroept.

FlexigoTech · Verantwoordelijk: Víctor Gómez · Bijgewerkt op 17 november 2026

In het kort

Versies
Odoo 17, 18, 19 en 20
Gecontroleerd
in de broncode van de connector, versie 20.0 · in de bronnen onderaan
Leestijd
5 min

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.

TransportWat de verbinding vraagtWat Test connection doet
Easy WMS command API (OAuth2 + ExecuteCommand)HostName, Tenant, UriToken en UriExecuteCommand, met ClientId en ClientSecret, of MAPUser en MAPPassVraagt het token op en roept UriExecuteCommand aan
SOAP web servicesDe host en het adres van de dienst, met de inloggegevensDownloadt de WSDL en controleert of het antwoord er een is
File exchange over SFTPDe server, de gebruiker en het wachtwoord, op poort 22, en de mappenLogt in via FlexigoTech Cloud en toont de inhoud van de inkomende map
File exchange over a shared folderHet bestandsformaat en de mappen voor uitgaand, inkomend en archiefControleert of hij de mappen bereikt
Intermediate exchange databaseDe Exchange database DSNControleert 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.
Formulier van een verbinding met Easy WMS in Odoo 20 met het magazijn, het verbindingstype, het transport en de knoppen om te testen en de commando's te laden
De verbinding met Easy WMS: het magazijn, het type, het transport en de knoppen om te testen, in Odoo 20 met demogegevens.

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.

Geopend bericht in Odoo 20 met het document dat naar Easy WMS is gestuurd, de status en de knop om het Odoo-record te openen
Een geopend bericht: wat er is verstuurd of ontvangen, precies zoals het reisde, in Odoo 20 met demogegevens.

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

Easy WMS van Mecalux: wat dit WMS is en hoe het met Odoo samenwerktEasy WMS is het WMS van Mecalux. Wat de website erover zegt, hoe het werkt en wat Odoo en Easy WMS uitwisselen via de connector van FlexigoTech.Berichten met Easy WMS in Odoo: statussen, nieuwe pogingen en foutenDe statussen van een bericht met Easy WMS, hoe Odoo opnieuw probeert, wie de melding krijgt en wat je doet met elke fout van een bevestiging.
Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen

Bronnen