image_pdfimage_print

Integracja z sklepem Shoper

Integracja systemu Shoper pozwala na pobieranie materiałów i zamówień oraz na wysłanie stanów magazynowych, oraz statusów zamówień.

Konfiguracja w Sklepie

Żeby WMS miał dostęp, trzeba dodać użytkownika do grupy, w której jest przypisany typ dostępu webapi.

Edycja grypy administratorów

Konfiguracja w Weaver WMS

W systemie Weaver WMS należy przejść do zakładki Ustawienia oraz z listy ustawień E-commerce wybrać pozycję Shoper.

W pierwszej zakładce ustawień należy wpisać nazwę użytkownika i hasło, który jest przypisany do grupy z trybem dostępu webapi. Oraz poprawić adresy URL, aby były zgodne z adresem sklepu.

Uruchomienie integracji

W celu uruchomienia poszczególnych funkcji należy otworzyć zakładkę
„Shoper” w „Zadania cykliczne” i dodać stworzoną konfigurację.

Ustawienia zadań cyklicznych

Pobrane zamówienia trafiają do zakładki „Zamówienia od odbiorców” [ZO].

Z dokumentu ZO wystawiamy dokument wydania zewnętrznego [WZ]. Po jego realizacji do Shoper wysyłany jest status zamówienia oraz zmiana stanów magazynowych.

Z dokumentu WZ możemy bardzo szybko wystawić fakturę oraz wysyłkę kurierską.

Integracja – Inpost

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.

Usługa – wybieramy domyślną usługę dla wysyłek kurierskich:
– inpost_locker_standard – przesyłka paczkomatowa – standardowa,
– inpost_locker_allegro – przesyłka paczkomatowa – Allegro Paczkomaty Inpost,
– inpost_courier_standard – przesyłka kurierska – standardowa,
– inpost_courier_allegro – przesyłka kurierska – Allegro Kurier24 Inpost,
– inpost_letter_allegro – przesyłka kurierska – Allegro MiniKurier24 Inpost,

Należy pamiętać jeszcze o uzupełnieniu naszych danych w pierwszej zakładce „Dane podstawowe”.

Integracja z serwisem BaseLinker

Integracja systemu BaseLinker pozwala na automatyczne pobieranie informacji i aktualizowanie statusu zamówień.

Uzyskanie klucza dostępu

Żeby WMS miał dostęp do serwisu, potrzebny jest klucz dostępu, który jest odpowiednikiem loginu i hasła w serwisie. (Klucz dostępu daje dostęp do twojego konta, dlatego nie udostępniaj go nikomu!!)

W celu uzyskania klucza trzeba w serwisie z przejść do zakładki API w ustawieniach moje konto.

Klucz API w serwisie

Konfiguracja w Weaver WMS

W systemie Weaver WMS należy przejść do zakładki Ustawienia oraz z listy ustawień E-commerce wybrać pozycję BaseLinker.

W ustawieniach w pole „Token” wpisujemy klucz dostępu.

Ustawienia podstawowe

Na zakładce „Pobieranie zamówień” należy uzupełnić „Id folderu zamówień” (Po kliknięciu przycisku „Foldery” wyświetlą się wszystkie dostępne foldery i z przypisanymi do nich numerami Id).

Ustawienia zamówień

Na zakładce „Wysyłka statusów zamówień” przypisujemy odpowiednie Id statusów zamówień Baselinker do statusów ZO w WMS.

Ważne:

  • Status „Oczekuje” jest domyślnym statusem po ściągnięciu do systemu, dlatego zaleca się wpisanie Id folderu pobierania zamówień.
  • W serwisie BaseLinker status jest równoważny z folderami zamówień.
Ustawienia statusów

Uruchomienie integracji

W celu uruchomienia poszczególnych funkcji należy otworzyć zakładkę
„BaseLinker” w „Zadania cykliczne” i dodać stworzoną konfigurację.

Pobrane zamówienia trafiają do zakładki „Zamówienia od odbiorców” [ZO].

Z dokumentu ZO wystawiamy dokument wydania zewnętrznego [WZ]. Po jego realizacji do BaseLinkera wysyłany jest status zamówienia oraz zmiana stanów magazynowych.

Z dokumentu WZ możemy bardzo szybko wystawić fakturę oraz wysyłkę kurierską.

Integracja PrestaShop

Integracja systemu Weaver WMS z platformą PrestaShop pozwala na znaczne usprawnienie pracy.
Dzięki niej możesz szybko realizować zamówienia, wysyłać ich statusy klientom oraz kontrolować dostępność towarów w sklepie internetowym.

Konfiguracja w panelu PrestaShop

Żeby zintegrować sklep z system Weaver WMS, trzeba wygenerować klucz API i nadać mu odpowiednie uprawnienia. W tym celu w panelu PrestaShop należy wejść w „API” znajdujące się w zakładce „Zaawansowane”.

W tym oknie należy potwierdzić obie opcje w polu „Konfiguracja” oraz dodać nowy klucz API.

Następnie trzeba wygenerować klucz i nadać uprawnienia zasobom.

Uprawnienia wymagane do prawidłowego działania integracji

Po tych czynnościach możemy zapisać utworzony klucz.

Konfiguracja w systemie Weaver WMS

W systemie Weaver WMS należy przejść do zakładki Ustawienia oraz z listy ustawień E-commerce wybrać pozycję PrestaShop.

W podstawowych ustawieniach trzeba uzupełnić „Adres API” oraz „Token”.

Adres API to „http://adres-sklepu.pl/api/”. W naszym przypadku adres to http://shop.hdwr.eu dlatego w konfigurację wpisujemy „http://shop.hdwr.eu/api/”.

Token to klucz, który wygenerowaliśmy wcześniej podczas konfiguracji po stronie PrestaShop.

Po uzupełnieniu tych pól można sprawdzić połączenie klikając „Test połączenia”.

Pobieranie zamówień

W zakładce „Pobieranie zamówień możemy określić:

  • Okres, z którego chcemy pobierać zamówienia,
  • Definicję dokumentu,
  • Nazwę płatności pobraniowej,
  • Czy chcemy tworzyć automatycznie awizo wysyłki kurierskiej,
  • Czy chcemy używać nazwy odbiorcy z PrestaShop, jako pole Odbiorca(kod) dla nowych klientów

Wysyłka statusów zamówień

W tej zakładce podpisujemy odpowiednie Id statusów zamówień PrestaShop do statusów ZO w WMS.

Po użyciu przycisku „Pobierz statusy PrestaShop” pokaże się lista statusów ze sklepu i ich Id. Każdy status jest oddzielony nawiasami {}.

Np. Chcemy, żeby po zrealizowaniu ZO dla zamówienia na PrestaShop zmieniał się status na „Wysłane”. Dlatego sprawdzamy Id dla statusu „Wysłane” i wpisujemy je w pole „Id dla statusu ‚Zrealizowane'”.

Wysyłanie stanów magazynowych

Gdy uruchomimy wysyłanie stanów magazynowych do sklepu PrestaShop, to każda zmiana ilości w systemie WMS będzie również wprowadzana do stanu magazynowego na panelu PrestaShop.

Uruchomienie integracji

W celu uruchomienia poszczególnych funkcji należy otworzyć zakładkę „PrestaShop” w „Zadania cykliczne” i dodać stworzoną konfigurację.

Działanie integracji

Zamówienia z PrestaShop pobiera się do systemu jako zamówienia od odbiorców [ZO]. Wszystkie dane dokumentu pobierane są ze sklepu.

Materiały w systemie Weaver WMS muszą posiadać taki sam kod lub kod zewnętrzny jak indeksy materiałów w PrestaShop.

Podgląd zamówienie pobrane ze sklepu

Z dokumentu ZO wystawiamy dokument wydania zewnętrznego [WZ]. Po jego realizacji do PrestaShop wysyłany jest status zamówienia oraz zmiana stanów magazynowych.

Z dokumentu WZ możemy bardzo szybko wystawić fakturę oraz wysyłkę kurierską.

REST API – Weaver WMS

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.

Ustawienia -> Konfiguracja bazy danych > Konfiguracja API > /swagger

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.

https://weaversoft.pl/api-demo/

Zrzut ekranu po prawidłowym wykonaniu autoryzacji.

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 + V).
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.
6.

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.

Pobieranie dokumentów WZ

Na poniższym przykładzie pobieramy dokumenty WZ z zaznaczonym filtrem (utworzone po dacie 01.09.2020r.) oraz podzielone na 2 elementy na stronę.

Dodawanie materiału

{"Selected":false,
"Type":3,
"Reference":" HD2285",
"Name":"Bezprzewodowy skaner 22Bluetooth HD85",
"DefaultQuantityInContainer":0.0,
"Removed":false,
"Inactive":false,
"SingleUnitPrice":0.0,
"Unit":
{
    "Description":"szt.",
    "DescriptionEng":"pcs",
    "DescriptionDe":"psc",
    "DescriptionRu":"psc",
    "Details":"sztuka",
    "IsLenght":false,
    "Precision":4,
    "IsDefault":false,
    "Id":1
    },
    "TaxRate":{
        "Value":0.23000,
        "Name":"23%",
        "IsDefault":false,
        "TaxRateLegalType":0,
        "Id":1
        },
        "SuggestedPlace":{
            "Selected":false,
            "Reference":"MAG_S1_0_0",
            "Level":0,
            "Number":0,
            "QuantityOfMaterial":0.0,
            "Id":1
            },
            "PercantageProfit":0.0,
            "InitialQuantity":0.0,
            "HasChildren":false,
            "IsOnMachines":false,
            "IsDangerous":false,
            "CountSeparately":false,
            "AdvisingQuantity":0.0,
            "Length":0.0,"Width":0.0,
            "Height":0.0,
            "PackageRequireReference":false,
            "PackageDoNotAddToShippingDocument":false,
            "PackageIsTemporary":false,
            "PackageType":0,
            "RequiredQuantity":0.0,
            "OnCustomOrder":false,
            "LengthIsWidth":false,
            "AbcClass":0,
            "XyzClass":0,
            "MaterialTradeInfo":{
                "IsEcommerceShopPosition":true,
                "IsEcommerceAuctionPosition":false,
                "Id":0},"LengthStrategy":0,
                "WidthStrategy":0,
                "HeightStrategy":0,
                    "SplitPayment":false,
                    "RequireLotNumber":false,
                    "RequireLotExpiration":false,
                    "Id":0
                    }
Podgląd materiału dodanego przez program Postman

Dodanie odbiorcy

{
    "reference": "HDWR",
            "nameLine1": "HDWR",
            "nameLine2": "Hardware for business",
            "removed": false,
            "address": {
                "street": "Os. Piastowskie 53",
                "postalCode": "63-000",
                "city": "Środa Wlkp",
                "id": 0
            },
            "companyDetail": {
                "nip": "786-165-45-57",
                "nipCleaned": "7861654557",
                "ueVatPayer": false,
                "id": 481
            },
            "mail": "alenkowski@weaversoft.pl",
            "shippingAddressesCount": 0,
            "multiplyQuantityWhileImportEdi": false,
            "notificationSetting": {
                "newOrderEmailSend": false,
                "newOrderEmailJoinAttachement": false,
                "id": 3737
            },
            "currency": {
                "symbol": "PLN",
                "name": "PLN",
                "id": 1
            },
            "paymentWay": 0,
            "paymentDays": 0,
            "salesBlockade": false,
            "creditLimit": false,
            "creditLimitAmout": 0.00000,
            "nip": "786-165-45-57",
            "name": "Waever Software Andrzej Lenkowski",
            "id": 473
}
Podgląd odbiorcy dodanego w programie Postman

Inwentaryzacja – przykład realizacji wraz z integracją z systemem ERP Soneta Enova

System Weaver WMS umożliwia przeprowadzenie procesu inwentaryzacji zasadniczo na dwa sposoby:

Niniejszy wpis dotyczy realizacji procesu Inwentaryzacji klasycznej wraz z opcjonalnym eksportem wynikowych danych do systemu nadrzędnego (w tym przypadku systemu ERP Soneta Enova).

Aby rozpocząć proces przeprowadzania inwentaryzacji należy skorzystać z kreatora otwierania inwentaryzacji. W tym celu należy wybrać opcję Dokumenty wewnętrzne -> Inwentaryzacja -> Dodaj inwentaryzację. Kreator poprowadzi poprzez proces otwierania inwentaryzacji.

Dane dokumentu inwentaryzacji.
Wybór magazynów. W przypadku integracji z systemem nadrzędnym ERP należy wybrać magazyn zewnętrzny.
Wybór miejsca magazynowych
Wybór materiałów.
Podsumowanie inwentaryzacji.
Blokowanie jednostek przez system.

Po otwarciu dokumentu inwentaryzacji można rozpocząć proces liczenia oraz realizacji inwentaryzacji na urządzeniu mobilnym. W tym celu należy upewnić się, że użytkownik mobilny posiada odpowiednie uprawnienie. 

Uprawnienia do inwentaryzacji.

Jeśli użytkownik przypisany jest do roli, wówczas uprawnienia należy przypisać do roli.

Na urządzeniu mobilnym inwentaryzacja dostępna jest w Menu główne – Inwentaryzacja.

Lista dokumentów inwentaryzacji.
Możliwe jest wyszukiwanie pozycji z listy.
Realizacja pozycji inwentaryzacji.
Zrealizowane pozycje zmieniają kolor (status).

W czasie rzeczywistym, podczas realizacji procesu inwentaryzacji dostępny jest podgląd zinwentaryzowanych oraz oczekujących pozycji w aplikacji Desktop. 

Realizacja inwentaryzacji Desktop.

Zrealizowaną inwentaryzację należy zaksięgować oraz przenieść do archiwum. Księgowanie powoduje zasadniczo dwie rzeczy:

  1. Zmianę ilości towaru w jednostkach logistycznych na miejscach w systemie.
  2. Odblokowanie jednostek logistycznych.

Po przeniesieniu do archiwum możliwe jest wyeskportowanie dokumentu do systemu nadrzędnego ERP. Proces księgowania oraz archiwizacji przedstawiony jest poniżej.

Księgowanie inwentarazycji – podsumowanie.
Księgowanie inwentaryzacji – ostrzeżenie.
Księgowanie inwentaryzacji – postęp.
Przenoszenie inwentaryzacji do archiwum.

Po przeniesieniu inwentaryzacji do archiwum jest ona dostępna w Dokumenty wewnętrzne – Inwentaryzacja archiwum.

Z tego poziomu możliwy jest eksport dokumentu do systemu nadrzędnego, jeśli serwis integracji został wdrożony. Na liście zarchiwizowanych inwentaryzacji dostępne są kolumny:

  • Kod magazynu (system zewnętrzny) – na tym magazynie systemu utworzy dokumentu inwetaryzacji.
  • Numer dokumentu (system zewnętrzny) – numer poprawnie utworzonego dokumentu inwentaryzacji w systemie nadrzędnym.
  • Błąd integracji. Treść błędu podczas dodawania dokumentu w ERP. Najczęściej będzie to brak materiału.
Archiwum inwentaryzacji – kolumny odpowiadające za integrację z ERP.

W systemie Enova dokument trafi do bufora inwentaryzacji. Należy zweryfikować ceny oraz zatwierdzić dokument.

Inwentaryzacja w systemie Enova.

Integracja ze sklepem internetowym Shoplo

Program magazynowy Weaver WMS posiada wbudowaną funkcjonalność integracji z platformą sklepu internetowego Shoplo. Integracja umożliwia pobieranie zamówień z Shoplo do WMS’a, aktualizację statusów zamówień w Shoplo – po realizacji w WMS oraz aktualizację stanów magazynowych w Shoplo z WMS’a.

Aby skorzystać z integracji należy odwiedzić stronę shoplo.weaversoft.pl i zalogować się na platformę Shoplo.

Integracja Shoplo z WMS
Integracja Shoplo z WMS

Po zalogowaniu do sklepu system wyświetli parę tokenów.

Token oraz token prywatny
Token oraz token prywatny

Tokeny należy wprowadzić do systemu Weaver WMS. Należy wejść w zakładkę Ustawienia -> Ustawienia e-comerce -> Shoplo. Po wybraniu opcji Test połączenia, system wyświetli parametry sklepu, jeśli połączenie zostało poprawnie ustanowione.

Ustawienia Shoplo w Weaver WMS
Ustawienia Shoplo w Weaver WMS

Na zakładkach „Pobierania zamówień”, „Wysyłka statusów zamówień” oraz „Wysyłka stanów magazynowych” można dostosować parametry wymiany danych pomiędzy platformami.