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.
| Transport | Czego wymaga połączenie | Co robi Test connection |
|---|---|---|
Easy WMS command API (OAuth2 + ExecuteCommand) | HostName, Tenant, UriToken i UriExecuteCommand, z ClientId i ClientSecret albo MAPUser i MAPPass | Pobiera token i wywołuje UriExecuteCommand |
SOAP web services | Host i adres usługi, z jej danymi logowania | Pobiera WSDL i sprawdza, czy odpowiedź nim jest |
File exchange over SFTP | Serwer, użytkownika i hasło, na porcie 22, oraz foldery | Loguje się przez FlexigoTech Cloud i wyświetla zawartość folderu wejściowego |
File exchange over a shared folder | Format plików oraz foldery wyjściowy, wejściowy i archiwum | Sprawdza, czy dociera do folderów |
Intermediate exchange database | Exchange database DSN | Sprawdza, 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.

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.

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
Sprawdzone w kodzie źródłowym konektora (wersja 20.0) i w podlinkowanych źródłach
Źródła
- 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/pl/integracja-mecalux-odoo.html
- Kod modułu: flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_backend.py
- Kod modułu: flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_transport.py
- Kod modułu: flexigo_mecalux_connector 20.0 (05a27c9c): static/description/index.html
- Kod modułu: flexigo_mecalux_connector 20.0 (05a27c9c): data/mecalux_data.xml
- Kod modułu: flexigo_mecalux_connector 20.0 (05a27c9c): models/mecalux_default_profile.py
