Integracja z Baselinkerem
Przegląd obiegu zamówień - od wprowadzenia w Baselinker do realizacji w systemie WMS
Omówienie drogi zamówienia – od wprowadzenia do Baselinkera po realizację w systemie WMS.
W przypadku integracji zamówień omówionej w tej instrukcji, gdzie zamówienia wprowadzane są za pomocą systemu Baselinker a realizowane są w systemie WMS, każde z zamówień musi przejść następującą drogę.
-
Zamówienie zostaje wprowadzone do systemu Baselinker poprzez okno dodawania zamówienia.
-
Po wprowadzeniu danych zamówienia, należy nacisnąć przycisk „Potwierdź zamówienie”. Potwierdzone zamówienie trafi następnie do statusu „Tworzenie etykiety” gdzie zostanie wygenerowana etykieta kurierska dla wybranego przez nas przewoźnika. Jeśli w trakcie tworzenia etykiety wystąpi błąd, zamówienie pozostanie w statusie „Tworzenie etykiety”
-
W przypadku poprawnego wygenerowania przesyłki, zamówienie następnie trafi do statusu „Import do WMS” gdzie system WMS pobierze zamówienie do swojego systemu. Proces realizacji zamówieni zostanie przeprowadzony w systemie WMS.
-
Zamówienie zaimportowane do WMS zostanie przeniesione do statusu „Oczekujące na realizacje” w systemie Baselinker. W systemie WMS będzie znajdywać się w statusie „Oczekujące na realizację”
-
W momencie rozpoczęcia realizacji zamówienia w systemie WMS, zamówienie zostanie automatycznie przeniesione do statusu „W trakcie realizacji” (opcjonalne) w systemie Baselinker i „W trakcie” w systemie WMS.
-
Jeśli zamówienie zostanie zrealizowane, zostanie przeniesione do statusu „Zakończone” w systemie Baselinker i statusu „Zakończone” w systemie WMS. W tym statusie również są drukowane wcześniej utworzone etykiety kurierskie. Etykieta zostanie wydrukowana na domyślnej drukarce przypisanej do danego profilu w systemie Baselinker.
Konfiguracja Baselinker’a
1. Statusy zamówień
Ten rozdział poświęcony jest przygotowaniu statusów zamówień w systemie Baselinker.
1.1. Menu statusów Pierwszym krokiem będzie przygotowanie statusów zamówienia, pozwoli to na późniejszą konfigurację akcji automatycznych po stronie Baselinker’a a także WMS’a.
Aby przygotować statusy zamówień, po zalogowaniu do systemu Baselinker należy z menu po lewej stronie:
- Zamówienia
- Statusy zamówień
Następnie należy rozwinąć listę statusów.
Po rozwinięciu listy statusów, na samym dole listy pojawi się przycisk „Nowy status”. Po jego kliknięciu otworzy się okno konfiguracji nowego statusu.
1.2. Okno kreatora statusu Po naciśnięciu przycisku „Nowy status” zostanie otwarte okno kreatora
W tym miejscu mamy możliwość skonfigurować takie informacje jak
- Kolor statusu
- Nazwa podstawowa (nazwa ta będzie wyświetlana np. na liście zamówień)
- Nazwa skrócona
- Nazwa pełna (opis statusu)
Dodatkowo mamy możliwość przypisania statusu do grupy. W celu przygotowania Baselinker’a do współpracy z systemem WMS należy przygotować następujące statusy:
- Nowe zamówienia
- Potwierdzenie zamówienia
- Tworzenie etykiety
- Oczekujące na realizację
- W trakcie realizacji
- Zakończone
- Anulowane
1.3. Opis statusów Poniżej znajduje się wyjaśnienie poszczególnych statusów
-
Nowe zamówienia – jest to status podstawowy, w tym statusie znajdują się wszystkie nowe zamówienia, które są aktualnie w trakcie przygotowania (tworzenia).
-
Tworzenie etykiety – status przejściowy – jeżeli dane w zamówieniu zostały wprowadzone poprawnie, Baselinker wygeneruje etykietę kurierską dla zamówienia. UWAGA: W przypadku błędu (np. niepoprawny adres, błąd po stronie przewoźnika etc.) zamówienie pozostanie w statusie „Tworzenie etykiety”.
-
Import do WMS –status przejściowy – zamówienia z tego statusu są importowane do systemu WMS.
-
Oczekujące na realizację – Zamówienia w tym statusie zostały zaimportowane do systemu WMS i aktualnie oczekują na realizację.
-
W trakcie realizacji – status informacyjny – w tym statusie znajdują się zamówienia w trakcie realizacji. Zamówienia są do niego przenoszone automatycznie po rozpoczęciu realizacji w systemie WMS.
-
Zakończone – w tym statusie znajdują się zamówienia zrealizowane. Zamówienia są do niego przenoszone automatycznie po zrealizowaniu zamówienia w systemie WMS.
-
Anulowane – w tym statusie znajdują się zamówienia anulowane. Zamówienia są do niego przenoszone automatycznie po anulowaniu zamówienia w systemie WMS.
2. Integracje
W tym rozdziale omówione zostanie m.in. jak dodać integrację kurierską i drukarkę etykiet. Integracja z przewoźnikiem a także z drukarką etykiet jest wymagana.
2.1. Menu integracji
Aby przejść do zarządzania integracjami, po zalogowaniu do systemu Baselinker należy z menu po lewej stronie wybrać przycisk „Integracje”
2.2. Dodawanie integracji
Aby dodać nową integrację, będąc w menu integracji należy nacisnąć przycisk Dodaj integrację
2.3. Integracja przewoźnika
Po naciśnięciu przycisku dodawania integracji, wybierz odpowiednią integrację z listy. Dla przykładu posłużymy się integracją z przewoźnikiem DPD PL.
Po wybraniu przewoźnika, należy wypełnić formularz odpowiednimi danymi. Formularz zawiera między innymi takie informacje jak: • Nazwa konta (dowolna) • Login i hasło API • Numkat • Dane firmy
Po zapisaniu integracji, generowanie etykiet będzie możliwe z poziomu tworzenia zamówienia.
2.4. Integracja drukarki
Po naciśnięciu przycisku dodawania integracji, wybierz odpowiednią integrację z listy. W oknie konfiguracji mamy dostęp do klucza drukowania a także możemy pobrać aplikację „Baselinker Printer”, która jest wymagana do wydruków etykiet.
Przed dalszą konfiguracją integracji pobierz i zainstaluj aplikację.
Po pobraniu oprogramowania i jego instalacji, uruchom aplikację w celu dalszej konfiguracji.
Po jej uruchomieniu naciśnij przycisk ustawień.
W tym miejscu mamy możliwość wprowadzenia klucza drukowania dostępnego na stronie konfiguracji.
Skopiuj klucz drukowania i wklej go w aplikacji „BaseLinker Printer”
Wybierz również domyślną drukarkę dla swojego komputera/stanowiska pracy.
Dodatkowo zalecamy ustawienie automatycznego uruchamiania przy starcie systemu
Ostatnim krokiem jest ustawienie aktywnej drukarki w panelu integracji
Po skończonej konfiguracji naciśnij przycisk „Zapisz”
UWAGA: W przypadku gdy mamy wiele stanowisk i drukarek, Oprogramowanie „BaseLinker Printer” musi zostać zainstalowane na serwerze z zainstalowanymi wszystkimi wykorzystywanymi drukarkami! Na liście aktywnych drukarek, należy wtedy oznaczyć wszystkie drukarki używane do procesu kompletacji zamówień.
2. Akcje automatyczne
Ten rozdział poświęcony jest przygotowaniu akcji automatycznych w systemie BaseLinker.
3.1. Menu akcji automatycznych
Aby przygotować statusy zamówień, po zalogowaniu do systemu Baselinker należy z menu po lewej stronie:
- Zamówienia
- Statusy zamówień
W tym widoku dostępna jest lista aktualnie utworzonych (aktywnych i nieaktywnych) akcji automatycznych.
W celu dodania nowej akcji automatycznej należy nacisnąć przycisk „Dodaj automatyczną akcję”.
3.2. Okno kreatora akcji automatycznych Po naciśnięciu powyższego przycisku ukaże nam się okno kreatora automatycznych akcji.
W tym oknie mamy możliwość konfiguracji automatycznych akcji. Okno podzielone jest na dwie części:
- lewą zawierającą warunek
- prawą zawierającą akcje jeśli warunek zostanie spełniony
3.3. Lista wymaganych akcji automatycznych w celu przygotowania podstawowej integracji systemów Baselinker i WMS
Na kolejnych stronach została przedstawiona lista wymaganych akcji automatycznych do konfiguracji integracji systemu Baselinker i WMS. Akcje zostaną przedstawione w formie tekstowej, podzielone na warunki i akcję wywoływane a także zrzuty ekranu przedstawiające jak każda z akcji powinna być przedstawiona w oknie kreatora.
- Potwierdzenie zamówienia
Warunki
Akcje do wykonania
- Utworzenie etykiety i import zamówienia do systemu WMS
Warunki
Akcje do wykonania
3. Zakończenie realizacji i wydrukowanie etykiety
Warunki
Akcje do wykonania
3.1. Akcje automatyczne wymagane w przypadku wykorzystania wielu drukarek: W przypadku gdy wykorzystujemy różne drukarki do drukowania etykiet (np. gdy każdy komputer ma własną drukarkę etykiet) akcja automatyczna drukowania etykiety (ze statusu „Zakończone”) powinna zostać zmodyfikowana i wyglądać następująco:
Warunki
Pole dodatkowe – „Pole dodatkowe 2”
Akcje do wykonania
UWAGA: Powyższa akcja automatyczna powinna zostać powielona dla każdej drukarki!
Konfiguracja WMS’a
1. Ustawienia e-commerce
1.1. Uruchomienie okna ustawień integracji e-commerce Aby przejść do konfiguracji integracji z systemem Baselinker należy wykonać następujące kroki:
Z górnego paska menu wybrać pozycję „Ustawienia” a następnie nacisnąć przycisk „Ustawienia e-commerce oznaczone ikoną niebieskiego koszyka sklepowego
Następnym krokiem jest naciśnięcie przycisku odpowiadającego za konfigurację integracji z systemem Baselinker.
1.2. Okno konfiguracji integracji Baselinker Po wykonaniu powyższych kroków ukaże nam się następujące okno
Aby dodać nową integrację naciskamy przycisk Dodaj
Następnym krokiem jest wpisanie podstawowej konfiguracji wprowadzanej integracji
Do działania integracji wymagane jest wpisanie tokenu API Baselinker. Ten token można znaleźć w ustawieniach konta. Poniżej znajdują się kroki, które należy wykonać aby przejść do odpowiedniego menu.
1.3. Importowanie zamówień do systemu WMS
Aby WMS pobierał odpowiednio zamówienia z systemu Baselinker należy ustalić podstawowy folder zamówień. W tym celu w zakładce „Pobieranie zamówień” w polu tekstowym „Id folderu zamówień” należy wprowadzić ID folderu, z którego mają być importowane zamówienia do systemu WMS. W naszym przykładzie wykorzystamy folder o nazwie „Import do WMS” o ID 218603. Do tego statusu zostają przeniesione wszystkie zamówienia, które w systemie Baselinker trafią do folderu „Import do WMS”. Jeśli Twoja konfiguracja przebiegła tak jak w poprzednich krokach tej instrukcji to import do systemu WMS będzie możliwy tylko jeśli etykieta kurierska zostanie poprawnie utworzona. ID folderów/statusów znajdziesz w pasku adresowym:
Oknie konfiguracji statusu:
Lub poprzez pobranie listy folderów w systemie WMS klikając na przycisk „Foldery” w oknie konfiguracji pobierania zamówień:
Dodatkowo zalecamy wybranie opcji „Pobieraj tylko zamówienia opłacone i płatne przy odbiorze” jeśli nie chcemy aby były importowane puste lub błędne zamówienia.
1.4. Statusy zamówień W tym oknie mamy możliwość konfiguracji statusów zamówień a także automatycznego przenoszenia do odpowiednich folderów w systemie Baselinker. Możemy wykorzystać wiele reguł lecz dla naszego przykładu wykorzystamy tylko jedną lub dwie reguły.
W przykładach zostały wykorzystane nasze ID folderów z systemu Baselinker.
Status "Oczekuje"Do tego statusu zostają przeniesione zamówienia już zaimportowane do systemu WMS.
W polu „Z” nie należy wpisywać żadnej wartości, w ten sposób wybrane zostaną wszystkie zamówienia bez statusu. W polu „Do” należy wybrać status w systemie Baselinker, z którego następnie będą realizowane zamówienia. W naszym przypadku będzie to folder „Oczekujące na realizację” o ID 216885.
Jest to status przejściowy, który informuje nas o tym, że zamówienie jest właśnie realizowane. Do tego statusu przenoszą się zamówienia „Oczekujące” po wybraniu opcji „Utwórz wydanie bez potwierdzenia” w systemie WMS.
W polu „Z” należy wprowadzić ID folderu takich jak w „Oczekujące na realizację”. W naszym przypadku jest do ID 216885.
W polu „Do” należy wprowadzić ID folderu „W trakcie realizacji”, który w naszym przypadku ma ID 216886.
UWAGA: Status „W trakcie” nie jest wymagany w systemie Baselinker i można go pominąć. W tym celu należy ID folderów powinny być takie same jak w statusie „Oczekuje”!
W tym statusie znajdują się zamówienia zrealizowane.
W polu „Z” należy wprowadzić ID folderu „Zakończony”, który w naszym przypadku ma ID 216887. Pole „Do” nie potrzebuje dodatkowej wartości.
W tym statusie znajdują się zamówienia anulowane.
Aby uniknąć błędów integracji, zalecamy wykorzystanie dwóch reguł: „Z” folderu „Oczekujące na realizacje” (ID: 216885) „Do” folderu „Anulowane” (ID: 216895) „Z” folderu „W trakcie realizacji” (ID: 216886) „Do” folderu „Anulowane” (ID: 216895)
UWAGA: Aby Baselinker poprawnie dobierał drukarkę względem stanowiska należy dodatkowo zaznaczyć poniższą opcję.
Opcja ta sprawi, że w wybrane „Pole dodatkowe” zostanie wprowadzona nazwa drukarki. Dzięki temu będziemy w stanie wykorzystać akcję automatyczną opisaną w punkcie 3.4. konfiguracji Baselinkera. Do wyboru mamy następujące opcje: • Pole dodatkowe 1 • Pole dodatkowe 2 • Komentarz do zamówienia/Uwagi Zalecamy wykorzystanie „Pola dodatkowego 2” dla większości użytkowników.
1.5. Ustalenie katalogów i ID magazynu Ostatnim krokiem konfiguracji integracji jest ustawienie ID katalogu produktów i magazynu.
ID katalogu znajdziesz w ustawieniach produktów w systemie Baselinker.
Następnie wybieramy z górnego menu „Katalogi”
I klikamy na menu „trzech kropek” a następnie „Edytuj katalog” obok interesującego nas katalogu. W tym przykładzie wykorzystamy katalog domyślny.
ID katalogu znajduje się w lewym dolnym rogu okna edycji.
ID magazynu znajdziesz w ustawieniach produktów w systemie Baselinker.
Następnie wybieramy z górnego menu „Magazyny”
I klikamy na menu „trzech kropek” a następnie „Edytuj magazyn” obok interesującego nas magazynu. W tym przykładzie wykorzystamy katalog domyślny.
ID magazynu znajduje się w lewym dolnym rogu okna edycji.
2. Ustawienia wydruku WMS
2.1. Dodawanie drukarki zewnętrznej
W przypadku gdy zastosujemy wiele drukarek w systemie Baselinker, konieczne jest również dodanie drukarki zewnętrznej w systemie WMS. Aby to zrobić należy wykonać następujące kroki.
Z menu WMS znajdującego się po lewej stronie należy wybrać opcję „Ustawienia” a następnie „Inne”.
W „Inne” należy następnie przejść do „Serwery wydruku”
Następnie z górnego menu, z zakładki „Operacje” wybieramy „Dodaj serwer wydruku”
Po naciśnięciu przycisku dodawania serwera wydruku, ukaże nam się następujące okno
W polu „Nazwa” należy wprowadzić nazwę drukarki. Drukarki powinny mieć łatwe do zapamiętania nazwy, które ułatwią identyfikację na stanowiskach do pakowania. Nazwy drukarek powinny być takie same jak te przygotowane w punkcie 3.4. konfiguracji Baselinker’a.
UWAGA: Aby integracja działała poprawnie, należy zaznaczyć opcję „Zewnętrzna”.
2.2. Ustawienia serwera wydruku WMS
Uwaga: Serwer wydruku WMS działa jedynie przy wydaniu zamówienia poprzez opcję „Weryfikacja dokumentu”
2.2.1. Aby przygotować system WMS i serwer wydruku WMS do poprawnego działa należy wykonać poniższe kroki.
2.2.2. Pobranie serwera wydruku WMS - https://weaverwms.com/downloads/wmsall/ - należy wybrać wersję odpowiadającą aktualnie zainstalowanej wersji systemu WMS Pliki serwera wydruku należy wypakować do wybranej przez siebie lokalizacji.
2.2.3. Kolejnym krokiem jest pobranie oprogramowania Foxit PDF Reader - https://www.foxit.com/downloads/ - i jego instalacja. Instalacja tego oprogramowania jest wymagana aby pobieranie etykiet działało prawidłowo. Oprogramowanie Foxit nie musi być uruchomione aby serwer wydruku działał poprawnie
2.2.4. Następnym krokiem jest konfiguracja serwera wydruku. W tym celu należy otworzyć plik „appsettings.json” zlokalizowany w folderze z serwerem wydruku WMS (patrz punkt 1). Plik należy otworzyć np. w notatniku.
- Za pomocą klawiszy CTRL+F odszukać linijkę "Setting"
- Wprowadzić dane użytkownika WMS w odpowiednich linijkach (dane muszą znajdywać się w cudzysłowach "")
- "ApiURL": "adres API", dostępny u twojego administratora WMS
- "User": "Login użytkownika WMS"
- "Password": "Hasło użytkownika WMS"
UWAGA: Zalecamy przygotowanie osobnego konta WMS dla serwera wydruku.
- Za pomocą klawiszy CTRL+F odszukać linijkę "FoxitReader", po dwukropku należy wprowadzić śieżkę do programu Foxit PDF Reader - plik domyślnie znajduje się w następującej lokalizacji "C:\Program Files (x86)\Foxit Software\Foxit PDF Reader\FoxitPDFReader.exe"
Ścieżka musi zostać wprowadzona z cudzysłowami "". Dodatkowo wszystkie 'backslashe' ("") w ścieżce należy zamienić na 'ukośniki' ("/"). Ścieżka powinna więc wyglądać następująco - "C:/Program Files (x86)/Foxit Software/Foxit PDF Reader/FoxitPDFReader.exe"
- Za pomocą klawiszy CTRL+F odszukać linijkę "Printers".
- "Name": "nazwa drukarki w WMS" - patrz rozdizał 2. Ustawienia wydruku WMS, punkt 2.1.
- "SystemName": "nazwa drukarki w systemie Windows" – Nazwę drukarki odnajdziemy wykonując następujące kroki:
• Ustawienia systemu Windows
• Bluetooth i Urządzenia
• Drukarki i skanery.
- Następnie należy zmienić wartość w linijce "Enabled" z „false” na „true”
Plik appsettings.json po wprowadzeniu powyższych zmian należy zapisać (kombinacja klawiszy CTRL+S).
2.2.5. W oprogramowaniu WMS (po zalogowaniu się na konto z uprawnieniami administratora) należy przejść do ustawień integracji Baselinker: Z górnego menu nawigacji:
- Ustawienia
- Ustawienia e-commmerce
3. Baselinker
Następnie należy edytować wprowadzoną integracje naciskając przycisk "Edytuj"
W zakładce "Pobieranie zamówień" należy zaznaczyć opcję "Pobierz etykiety opakowań do załączników"
Następnie należy zapisać wprowadzone zmiany naciskając przycisk "Zapisz"
2.2.6. W oprogramowaniu WMS (po zalogowaniu się na konto z uprawnieniami administratora) należy przejść do ustawień integracji. Z górnego menu nawigacji:
- Ustawienia
- Ustawienia aplikacji
W oknie "Ustawień aplikacji" należy przejść do zakładki "Wydawanie towaru" i zaznaczyć opcję "Validation - printout of attachments from the order"
Następnie należy zapisać wprowadzone zmiany naciskając przycisk "Zapisz"
2.2.7. W oprogramowaniu WMS (po zalogowaniu się na konto z uprawnieniami administratora) należy przejść do ustawień integracji.
Serwer wydruku WMS może zostać uruchomiony na dwa sposoby - jako okno terminala lub jako usługę systemu Windows:
- Aby uruchomić serwer wydruku w wierszu poleceń, należy uruchomić aplikację "Weaver.Wms.PrintServer" (patrz punkt 1)
- Aby uruchomić serwer wydruku jako usługę systemu Windows należy wykonać następujące kroki:
- Uruchomić wiersz poleceń PowerShell w systemie Windows
- Wprowadzić następującą komendę:
New-Service -Name "Weaver WMS - Serwer Wydruku" -BinaryPathName "Ścieżka do pliku Weaver.Wms.PrintServer.exe"
- Nacisnąć kombinację klawiszy Windows+R a następnie wprowadzić "services.msc" aby otworzyć okno usług systemu Windows
- W oknie usług systemu Windows wyszukać usługę serwera wydruku "Weaver WMS - Serwer Wydruku"
- Zaznaczyć usługę serwera wydruku, nacisnąć prawym przyciskiem myszy a następnie nacisnąć opcję "Uruchom"
Serwer wydruku będzie teraz uruchamiany automatycznie bez wiersza poleceń.