Przejdź do głównej treści
Mecalux Easy WMS

Easy WMS API: jak Odoo łączy się z systemem WMS firmy Mecalux

Odoo rozmawia z Easy WMS przez interfejs, który Mecalux uruchomił w twojej instalacji, a Mecalux nie publikuje ani swojego API, ani formatu swoich dokumentów. Dlatego konektor FlexigoTech oferuje pięć transportów, w tym API poleceń Easy WMS, i dwa typy połączenia: Active, w którym Odoo wywołuje Easy WMS, oraz Passive, w którym Easy WMS wywołuje Odoo.

FlexigoTech · Odpowiada: Víctor Gómez · Aktualizacja: 17 listopada 2026

Najważniejsze

Wersje
Odoo 17, 18, 19 i 20
Sprawdzone
w kodzie źródłowym konektora, wersja 20.0 · w źródłach podanych na końcu
Czas czytania
4 min

Jaki interfejs Easy WMS otwiera dla systemu ERP

Mecalux pisze: «Easy WMS może być łączony z głównymi systemami ERP na rynku». Konkretny interfejs ustala się jednak z Mecalux dla każdej instalacji. Potrzebujesz własnego Easy WMS z interfejsem uruchomionym przez Mecalux: API, SOAP, plikami albo bazą danych. W Odoo wybierasz swój w polu Transport połączenia, w Easy WMS › Configuration › Easy WMS connections. Każde połączenie używa jednego transportu.

TransportCzego wymaga połączenieCo robi Test connection
Easy WMS command API (OAuth2 + ExecuteCommand)HostName, Tenant, UriToken i UriExecuteCommand, z ClientId i ClientSecret albo MAPUser i MAPPassPobiera token i wywołuje UriExecuteCommand
SOAP web servicesHost i adres usługi, z jej danymi logowaniaPobiera WSDL i sprawdza, czy odpowiedź nim jest
File exchange over SFTPSerwer, użytkownika i hasło, na porcie 22, oraz folderyLoguje się przez FlexigoTech Cloud i wyświetla zawartość folderu wejściowego
File exchange over a shared folderFormat plików oraz foldery wyjściowy, wejściowy i archiwumSprawdza, czy dociera do folderów
Intermediate exchange databaseExchange database DSNSprawdza, czy dociera do bazy

API poleceń, SOAP i SFTP przechodzą przez FlexigoTech Cloud, który przekazuje każde wywołanie do twojego serwera Easy WMS z twoimi danymi logowania.

API poleceń: pola kreatora Mecalux

Dla API poleceń połączenie wymaga ośmiu pól kreatora połączenia Mecalux. Dostajesz je od Mecalux, bo każda instalacja ma własne.

  • HostName to korzeń twojej własnej instalacji. Nie ma wspólnego serwera Mecalux: Easy WMS instaluje się dla każdego klienta osobno.
  • UriToken to adres usługi tokenów OAuth2. Według pomocy pola przykład Mecalux to {HostName}/EasySTS/OAuth/Token, ale każda instalacja może mieć inny.
  • UriExecuteCommand to jedyny adres poleceń. Zrzut ekranu Mecalux go ucina, więc dokładną ścieżkę trzeba uzyskać od Mecalux.
  • Tenant identyfikuje twoją instalację. Konektor wysyła go przy każdym wywołaniu i przy prośbie o token.
  • ClientId i ClientSecret albo MAPUser i MAPPass, jeśli twoja instalacja wymaga przyznania przez hasło. Jeśli usługa tokenów odrzuci dane logowania, ostrzeżenie wskaże drugie przyznanie.
Formularz połączenia z Easy WMS w Odoo 20 z magazynem, typem połączenia, transportem i przyciskami do testu i wczytania poleceń
Połączenie z Easy WMS: magazyn, typ, transport i przyciski do testu, w Odoo 20 z danymi demonstracyjnymi.

Active czy Passive: kto kogo wywołuje

W typie Active prowadzi Odoo. Wysyła dokumenty i pyta o odpowiedzi dwiema zaplanowanymi akcjami: Easy WMS: send queued documents, co 5 minut, i Easy WMS: poll for answers, co 10 minut.

W typie Passive prowadzi Easy WMS i wywołuje twoje Odoo. Administrator systemu klika Generate credential for Mecalux i przekazuje Mecalux Inbound Url oraz te dane. Twoje Odoo musi wtedy być dostępne z internetu.

Dane logowania i bezpieczeństwo połączenia

Dane logowania są tylko do zapisu. Przechowuje je FlexigoTech Cloud, na serwerach w Niemczech, a Odoo ich nie zatrzymuje. Zanim je zapisze, administrator systemu zaznacza I accept that my Easy WMS credentials are kept by FlexigoTech Cloud and that the calls to Easy WMS go through it.

To, dokąd idą dane, też jest chronione. Host, UriToken, UriExecuteCommand, transport i foldery zmienia tylko administrator systemu, czyli osoba, która widzi dane logowania, więc nikt inny nie może przenieść ClientId i ClientSecret na inny serwer.

Połączenie robi więcej sprawdzeń. Wymaga adresów https, a jeśli wpiszesz adres IP zamiast nazwy, odrzuca adresy prywatne. FlexigoTech dodaje twój host do zamkniętej listy przed pierwszym wywołaniem. Nie podąża za żadnym przekierowaniem z Easy WMS. Jeśli Easy WMS ogranicza tempo kodem HTTP 429, wiadomość zostaje w kolejce i jest ponawiana. Przez SFTP plik, który wciąż czeka w folderze wyjściowym, nigdy nie jest nadpisywany.

Dokumenty: zestaw startowy, który dopasowujesz do instalacji

Mecalux nie publikuje słownika swoich poleceń. Dlatego Load starting command set tworzy dokumenty startowe z tymczasowymi nazwami, takimi jak SetItem, SetEntryOrder, SetExitOrder czy GetEntryConfirmations. Istniejące zostają bez zmian, więc możesz kliknąć dwa razy. Potem zmieniasz ich nazwy w zakładce Commands zgodnie z tym, co ustaliłeś z Mecalux.

Każdy dokument, który wychodzi lub przychodzi, zostaje w Odoo jako wiadomość, z treścią dokładnie taką, jaka przeszła. To pierwsze miejsce, do którego warto zajrzeć, gdy coś się nie zgadza, a piszemy o tym w artykule wiadomości i błędy z Easy WMS.

Otwarta wiadomość w Odoo 20 z dokumentem wysłanym do Easy WMS, jej statusem i przyciskiem otwierającym rekord Odoo
Otwarta wiadomość: to, co wysłano lub odebrano, dokładnie tak, jak przeszło, w Odoo 20 z danymi demonstracyjnymi.

Co trzeba jeszcze potwierdzić z prawdziwym Easy WMS

Testy automatyczne (255 w wersji dla Odoo 20 i 252 w wersjach dla 17, 18 i 19) działają na symulatorze Easy WMS, który odwzorowuje opublikowany zrzut ekranu własnego konektora Mecalux i startowy profil dokumentów. FlexigoTech nie ma instalacji Easy WMS do testów, a Mecalux nie publikuje formatu swoich dokumentów, więc konektor nie był jeszcze testowany z prawdziwym Easy WMS. Pierwsza prawdziwa instalacja musi potwierdzić, jakiego przyznania OAuth wymaga, gdzie przesyłany jest Tenant, dokładną ścieżkę UriExecuteCommand, jak polecenie niesie dokument, usługę SOAP i SFTP.

Najczęstsze pytania o API Easy WMS i Odoo

Czy potrzebna jest subskrypcja FlexigoTech Cloud?

Tak. Wywołania przez API poleceń, SOAP i SFTP przechodzą przez FlexigoTech Cloud, który przechowuje twoje dane logowania zaszyfrowane. Konektor znajdziesz w Odoo Apps, a wszystkie szczegóły na stronie konektora Mecalux Easy WMS.

Czy muszę zmieniać kod, aby dopasować dokumenty?

Nie. Konektor ma profil startowy, który dopasowujesz na ekranie, w zakładce Commands połączenia, bez zmian w kodzie.

Czym dokładnie jest Easy WMS?

To system zarządzania magazynem firmy Mecalux. Co mówi o nim jego strona i jak działa z Odoo, opisujemy w artykule Easy WMS firmy Mecalux.

Czytaj dalej

Easy WMS firmy Mecalux: czym jest ten WMS i jak współpracuje z OdooEasy WMS to system WMS firmy Mecalux. Co mówi o nim jego strona, jak działa i co Odoo i Easy WMS wymieniają przez konektor FlexigoTech.Wiadomości z Easy WMS w Odoo: statusy, ponowne próby i błędyStatusy wiadomości z Easy WMS, jak Odoo ponawia próby, kto dostaje powiadomienie i co zrobić z każdym błędem, który może dać potwierdzenie.
Sprawdzone w kodzie źródłowym konektora (wersja 20.0) i w podlinkowanych źródłach

Źródła