Integracja z serwisem Inpost pozwala na szybkie tworzenie wysyłek kurierskich oraz wysyłek do paczkomatu z poziomu systemu Weaver WMS. Dzięki temu możemy zaoszczędzić czas oraz zoptymalizować proces realizacji zamówień.
Konfiguracja integracji
W celu konfiguracji należy przejść do zakładki Inpost w oknie ustawień wysyłek kurierskich (Ustawienia > Wysyłki kurierskie). Następnie uzupełniamy pola odpowiednimi wartościami.
Identyfikator Organizacji – Numer otrzymamy po skontaktowaniu się z opiekunem handlowym Inpost,
Token – Numer otrzymamy po skontaktowaniu się z opiekunem handlowym Inpost,
Adres nadawcy z umowy – Zaznaczmy, jeśli adres nadawcy ma być pobierany z umowy z Inpostem,
Metoda wysłania: – parcel_locker – nadanie w paczkomacie, – pok – nadanie w Punkcie Obsługi Klienta, – courier_pok – nadanie w Punkcie Obsługi Klienta obsługującym nadawanie przesyłek kurierskich, – branch – nadanie w Oddziale, – dispatch_order – Zlecenie odbioru – zamówienie kuriera, – pop – nadanie w Punkcie Obsługi Przesyłek.
Kod paczkomatu nadawczego – pole uzupełniamy tylko, jeśli w sposobie wysłania wybraliśmy pok, courier_pok, parcel_locker.
Analiza pozwala na kontrolę ilości zleceń produkcyjnych na poszczególnych stanowiskach. Dzięki niej jesteśmy w stanie sprawdzić ich efektywność oraz nakład pracy.
Tworzenie analizy
W pierwszym oknie kreatora definiujemy ogólne ustawienia pobieranych dokumentów. W pierwszej części definiujemy daty, z których system ma pobierać dokumenty Zleceń Produkcyjnych. W drugiej części ustawiamy statusy dla pozycji, które mają być wyświetlane po stworzeniu analizy. W trzeciej części możemy doprecyzować daty dla poszczególnych statusów.
W kolejnym oknie wybieramy stanowiska, dla których chcemy przeprowadzić analizę.
Na ostatnim etapie kreatora wybieramy dokumenty, które system ma wziąć pod uwagę, tworząc analizę. Na tym widoku pokazywane są dokumenty spełniające warunek czasowy określany w pierwszej sekcji pierwszego okna.
Opis analizy
W głównym wierszu analizy widzimy wybrane w kreatorze stanowiska oraz podsumowanie wartości pozycji przypisanych do danego stanowiska.
Po rozwinięciu stanowiska pokazuje się lista pozycji zleceń produkcyjnych przypisanych do danego stanowiska oraz informacji o nich.
Przykładowa konfiguracja
W wyniku stworzenia analizy z powyższą konfiguracją otrzymamy pozycje z dokumentów utworzonych między 16.09.2020, a 16.10.2020 o statusach „Oczekujące na realizację” oraz „W trakcie realizacji”. Dodatkowo zawęzimy pozycje o statusie „Oczekujące na realizację” po planowanej dacie od 01.10.2020 do 16.10.2020.
Weaver WMS działa w
oparciu o API w architekturze REST, które wykorzystuje protokół HTTP i jego
metody, takie jak:
– GET – służy do
pobierania danych (np. wyświetlania listy materiałów),
– POST – tworzy
nowe dane (np. dodaje nowego odbiorcę),
– PUT – aktualizuje
wcześniej dodane zasoby (np. wprowadza
zmiany do materiału),
– DELETE – służy
do usuwania danych.
Dane wchodzące i wychodzące z API są w formacie JSON. Każdy
obiekt zawarty jest pomiędzy nawiasami klamrowymi, a jego poszczególne elementy
oddzielane są przecinkami. Wartości elementów wpisywane są po ich nazwach oraz
dwukropku.
Podczas wysyłania zapytań do lokalnego API, program Weaver WMS musi być uruchomiony.
Swagger
Sprawdzenie działania poszczególnych adresów URI (endpoints) przy
pomocy swaggera zawartego w programie Weaver WMS.
W tym celu należy postępować zgodnie z instrukcją zawartą na
poniższym zdjęciu.
Następnie, żeby uzyskać pełny dostęp, należy przejść do zakładki Authentication i nacisnąć przycisk Try it out. Teraz w miejsca, gdzie wpisany jest „string”, należy odpowiednio wpisać login oraz hasło użytkownika WMS’a w cudzysłowie.
Po wypełnieniu pól należy wykonać zapytanie przyciskiem Execute, kod 200 świadczy o prawidłowym wykonaniu polecenia.
Strukturę API w swaggerze można również sprawdzić w testowym panelu, do którego link znajduje się poniżej.
Po autoryzacji jesteśmy w stanie wykonywać pozostałe zapytania, odpowiednio uzupełniając wartości elementów.
Poniżej znajduje się przykład dodawania odbiorcy (elementy, których nie uzupełniamy, należy usunąć, w tym przypadku uzupełniliśmy tylko wymagane dane).
Postman
Kolejnym sposobem sprawdzenia działania zapytań jest program
Postman.
Na początek należy zaimportować kolekcję z zapytaniami. 1. Wejdź do swaggera. 2. Przejdź do strony w formacie JSON.
3. Zaznacz cały tekst (Ctrl + A) i skopiuj go (Ctrl + C). 4. W głównym oknie Postman kliknij przycisk Import w lewym górnym rogu. 5. Przejdź do zakładki Raw text i wklej wcześniej skopiowany tekst.
Po wykonaniu powyższych kroków w menu po lewej stronie w
zakładce Collections powinna pojawić się kolekcja „WMS API”.
Pozostaje jeszcze skonfigurowanie środowiska. 1. Kliknij w ikonę Manage Environments w prawym, górnym rogu.
2. Kliknij przycisk Add, a następnie wypełnij pola według poniższego zrzutu ekranu i ponownie kliknij przycisk Add.
3. W prawym górnym rogu wybierz z listy dodane środowisko.
W programie Postman również trzeba wykonać autoryzację przed wykonywaniem
kolejnych zapytań. W tym celu należy z dodanej kolekcji wybrać /auth/sign-in,
przejść do sekcji Body i zastąpić domyślnie wpisane wartości, loginem oraz
hasłem użytkownika WMS.
Podczas wykonywania poszczególnych zapytań należy usuwać elementy, w których nie uzupełniamy wartości, ponieważ może to skutkować powstawaniem błędów.
W celu przekazania awizacji przyjęcia trzeba najpierw pobrać metodą GET dane z odpowiednich adresów. Pierwszą z nich jest dostawca, pobierany z adresu „suppliers”.
Kolejną potrzebną informacją jest numeracja, pobierana z adresu „document-numbers”. Dodatkowo możemy zastosować parametr „IncludeAllTypes” oraz „Types”.
Parametr "Types" dla przyjęć może przyjmować wartości:
- 0 - Zamówienie do dostawcy,
- 1 - Przyjęcie zewnętrzne,
- 2 - Przychód wewnętrzny.
Kolejnymi danymi są materiały oraz stawki VAT, pobierane z adresów odpowiednio „materials” oraz „tax-rates”. W przypadku stawek VAT nie jesteśmy w stanie filtrować widoku, dlatego pobrać trzeba wszystkie stawki znajdujące się w systemie.
Po pobraniu wszystkich danych możemy przejść do przesłania metodą POST awizacji przyjęcia poprzez adres „delivery-documents”.
W poniższym przykładzie dla większej przejrzystości zostały wpisane dane, które nie muszą być uzupełniane. Dla sekcji, takich jak: supplier, material, unit, taxrate, document-number, currency wystarczy jedynie podanie id.
W celu pobrania dokładnych danych dotyczących zrealizowanych dokumentów PZ należy najpierw pobrać dane z adresu „delivery-documents”.
Dzięki tej operacji uzyskamy listę dokumentów przyjęć wraz z ich statusami.
O statusie mówi nam parametr "documentStatus" i wyróżniamy w nim wartości:
- 0 - Oczekujący na realizację,
- 15 - Anulowany,
- 20 - W trakcie realizacji,
- 30 - Zrealizowany.
W tej chwili znamy już ID zrealizowanych dokumentów przyjęć, dlatego możemy przejść do adresu „delivery-documents/position-items” i filtrować go parametrami „IncludeAllDocuments” oraz „Documents”, w których wpisujemy odpowiednio „false” oraz ID dokumentu.
Przekazanie awizacji wydania
W celu przekazania awizacji wydania schemat różni się jedynie tym, że zamiast dostawcy, pobrać należy odbiorcę z adresu „recipients”.
Podczas pobierania numeracji dla dokumentów wydania użyjemy dla parametru „Types” inne wartości.
Parametr "Types" dla wydań przyjmuje wartości:
- 3 - Zamówienia od odbiorców,
- 4 - Wydania zewnętrzne,
- 5 - Rozchody wewnętrzne.
Na poniższym przykładzie pobieramy dokumenty WZ z zaznaczonym filtrem (utworzone po dacie 01.09.2020r.) oraz podzielone na 2 elementy na stronę.
Pobieranie jednostek logistycznych dla właściciela
Żeby pobrać wszystkich dostawców, którzy mogą być właścicielami, trzeba użyć adresu „suppliers” z parametrem „IsOwner”.
W celu pobrania jednostek logistycznych przypisanych do konkretnego właściciela należy użyć adresu „logistic-units” z parametrami „IncludeAllOwners” oraz „Owners”, w których wpisujemy odpowiednio „false” i ID właściciela.