# Integracja WMS z kurierami - zamówienie kuriera z kolektora Android > Integracja WMS z kurierami od strony operatora i działu IT - pytanie o kuriera po zatwierdzeniu wydania, parametry przesyłki, typy palet i obsługa odrzuceń. Adres strony: https://magazyn.softwarestudio.com.pl/integracja-wms-z-kurierami-zamowienie-z-kolektora/ --- Zamówienie kuriera w Studio WMS.net odbywa się na tym samym ekranie kolektora, na którym operator zatwierdził wydanie. System pyta, czy zamówić kuriera, operator podaje parametry przesyłki, a dane trafiają do systemu przewoźnika przez API. W opisywanym wdrożeniu adres odbiorcy pochodzi z ERP, więc nikt nie przepisuje go ręcznie. ## Dlaczego zamówienie kuriera należy do WMS W wielu firmach pakowanie kończy się przepisywaniem. Magazynier zamyka paletę, idzie do komputera, loguje się na stronie przewoźnika i wpisuje adres odbiorcy oraz parametry przesyłki. Dopiero potem drukuje list przewozowy. Każdy z tych kroków zabiera czas i daje szansę na pomyłkę. WMS zna już zamówienie i jego odbiorcę, a także zawartość przesyłki i operatora, który ją spakował. Dane o przesyłce powstają więc na magazynie i tam powinny trafić do przewoźnika. Taki układ opisujemy na przykładzie producenta wyrobów wielkogabarytowych, który wysyła palety i paczki, w [case study wdrożenia](/wdrozenie-wms-producent-wyrobow-wielkogabarytowych/). Sam dokument wydania i kontrolę przed załadunkiem omawia strona o [wydaniu magazynowym](/wydanie-magazynowe/). Efekt dla magazynu jest prosty. Parametry przesyłki wpisuje operator, który ma paletę przed sobą, a adres z ERP trafia do przewoźnika bez przepisywania. Zamówienie następuje na tym samym ekranie, na którym zatwierdzono wydanie, więc nikt nie wraca później do osobnego narzędzia. ## Przebieg po zatwierdzeniu wydania Po zeskanowaniu ostatniej pozycji na palecie system pyta, czy zatwierdzić wydanie. Jeżeli zamówienie ma sposób wydania wymagający przewoźnika, po zatwierdzeniu pojawia się pytanie, czy zamówić kuriera. Operator odpowiada TAK albo NIE. Po odpowiedzi TAK otwiera się formatka z parametrami przesyłki. Zakres pól zależy od przewoźnika, a wymiary wymagane są tylko u niektórych z nich. W opisywanym wdrożeniu formatka składa się z czterech części: - zawartość transportu wybierana z listy, - wysokość i waga przesyłki, - liczba sztuk i zawartość paczki, - typ paczki albo palety z listy rozwijanej. Po zatwierdzeniu dane trafiają do systemu przewoźnika przez usługę integracyjną. Odpowiedź API zapisuje się w WMS, a etykieta i list przewozowy pojawiają się w aplikacji, o ile dany przewoźnik je zwraca. ## Różne reguły przewoźników w jednej formatce Każdy operator ma własne wymagania, co widać w typowych wzorcach. Zestawienie pokazuje, co z nich wynika dla formatki. | Wzorzec przewoźnika | Co wymaga formatka | | --- | --- | | Stała waga ustalona w umowie | Wymiary nie są wymagane | | Typ palety z zamkniętej listy | Wybór typu z wymiarami przypisanymi do pozycji słownika | | Rozróżnienie palet przemysłowych i półpalet | Osobne pozycje słownika, wybierane zależnie od nośnika | Najwygodniej zdefiniować w systemie kilka typów palet zgodnych z nośnikami, które naprawdę stoją w magazynie. Do każdego typu przypisuje się wymiary oraz nazwę akceptowaną przez przewoźnika. Operator wybiera typ jednym kliknięciem, a system wysyła do API właściwe dane. Mniej pól do ręcznego uzupełniania oznacza mniej pomyłek w wymiarach. ## Skąd system bierze adres odbiorcy W opisywanym wdrożeniu adres pochodzi z systemu ERP, a kolejność ustalania zależy od rodzaju zamówienia. Operator niczego nie przepisuje, bo formatka kuriera nie ma pól adresowych do ręcznego uzupełnienia. | Rodzaj zamówienia | Źródło adresu | | --- | --- | | Zamówienie hurtowe | Kartoteka odbiorców | | Zamówienie indywidualne | Dane zamówienia | | Zamówienie z dodatkowym adresem dostawy | Adres dodatkowy, na przykład klienta końcowego, który ma pierwszeństwo | Ta zasada ma bezpośrednie znaczenie dla etykiet i listów przewozowych. W zamówieniu z ERP występują trzy poziomy danych adresowych. Pierwszy to kontrahent, drugi odbiorca, a trzeci dodatkowy adres dostawy. Wymianę tych danych opisujemy w tekście o [integracji ERP z WMS](/integracja-erp-z-wms-webapi/). ## Co ustala dział IT z przewoźnikiem przed startem Integracja kurierska jest projektem po stronie dwóch firm, więc część prac dzieje się poza magazynem. Poniższe zestawienie pokazuje, co trzeba mieć uzgodnione, zanim pierwsza przesyłka wyjdzie z kolektora. | Temat | Co ustalić | Gdzie trafia w systemie | | --- | --- | --- | | Dostęp | Konto techniczne i klucze do interfejsu przewoźnika | Konfiguracja usługi integracyjnej | | Pola przesyłki | Które pola są wymagane i czy przewoźnik oczekuje wymiarów | Formatka parametrów na kolektorze | | Nośniki | Nazwy i wymiary typów palet akceptowanych przez przewoźnika | Słownik typów palet | | Dokumenty zwrotne | Czy odpowiedź zawiera etykietę oraz list przewozowy | Zapis odpowiedzi w aplikacji | Osobne pytanie dotyczy tego, które zamówienia w ogóle powinny wywoływać pytanie o kuriera. System pomija je, gdy w zamówieniu nie ma spedytora, więc o zakresie decyduje sposób, w jaki ERP opisuje wysyłkę. Ten element trzeba ująć w analizie, bo zmienia się go w danych zamówień, a nie w programie. ## Gdy przewoźnik odrzuci zlecenie Interfejs przewoźnika potrafi odrzucić zlecenie, na przykład przez niepoprawny kod pocztowy albo niezgodną nazwę miejscowości. Aplikacja pokazuje wtedy przyczynę odrzucenia, a operator poprawia dane i ponawia zamówienie. Wydanie jest już zatwierdzone, więc towar nie wisi w systemie, a problem dotyczy wyłącznie zlecenia transportowego. Dobrym zwyczajem jest lista otwartych tematów integracyjnych. W opisywanym projekcie znalazły się na niej ujednolicenie typów palet między przewoźnikami oraz przygotowanie zleceń testowych. Taka lista pozwala rozwijać integrację bez przerywania pracy magazynu, jeden przewoźnik po drugim. ## Miejsce integracji w całej architekturze Zamówienie kuriera to jeden z kilku punktów styku Studio WMS.net ze światem zewnętrznym. Wszystkie opisuje się już w analizie przedwdrożeniowej, żeby w dniu startu nie zaskoczyły ani klienta, ani wdrożeniowców. Zakres takiego dokumentu pokazuje artykuł o tym, [co powinna zawierać analiza przedwdrożeniowa WMS](/analiza-przedwdrozeniowa-wms-co-zawiera/). - System ERP przekazuje zlecenia i kartoteki, a odbiera wynik realizacji. - Wydruki i etykiety powstają z szablonów dokumentów i etykiet. - Operatorzy kurierscy i spedycyjni przyjmują zamówienie transportu. - Produkcja zasila magazyn wyrobami z linii i przemianowaniem. Wyrób z linii wchodzi do magazynu własną ścieżką, którą opisaliśmy w tekście o [magazynie produkcji w WMS](/magazyn-produkcji-w-wms/). Weryfikację skanem tuż przed zamówieniem kuriera pokazuje artykuł o [pakowaniu w WMS z weryfikacją skanem](https://system.wms.net.pl/pakowanie-w-wms-z-weryfikacja-skanem/). Przesyłki ze sklepów internetowych mają inny przebieg, opisany na stronie o [integracji WMS z e-commerce](/integracja-wms-e-commerce/). ## Pytania i odpowiedzi o integracji WMS z kurierami ## Słownik pojęć o integracji WMS z kurierami Terminy, które pojawiają się w rozmowach z przewoźnikiem i działem IT przed uruchomieniem integracji.