[PL] Magento 2.0

Poniżej znajduje się wtyczka oraz dokumentacja dot. naszej autorskiej wtyczki InPost dla systemu Magento 2.

Dokumentacja opisuję instalację modułu, konfigurację oraz omawia poszczególne funkcjonalności modułu takie jak: tworzenie przesyłek i generowanie etykiet.

Changelog:

Autoryzacja

Środowisko produkcyjne

Środowisko testowe (Sandbox)

Instalacja

Moduł należy najpierw zainstalować na instalacji developerskiej lub testowej a dopiero po przetestowaniu na sklepie produkcyjnym. Instalacji oraz włączenia modułu powinien dokonywać developer posiadający doświadczenie z systemem Magento 2

1. Pliki modułu należy skopiować do katalogu /app/code/Smartmage/Inpost

2. Następnie w konsoli, w głównym katalogu Magento należy uruchomić następujące komendy:

• php bin/magento module:enable Smartmage_Inpost

• php bin/magento setup:upgrade

• php bin/magento setup:di:compile

• php bin/magento setup:static-content:deploy pl_PL

• php bin/magento cache:flush

Konfiguracja

1. Konfiguracja modułu podzielona jest na dwie strefy widoczne w panelu administratora Magento:

• Sklepy → Konfiguracja → Sprzedaż → Ustawienia dostawy → sekcja InPost  - tutaj można skonfigurować wszystkie ogólne ustawienia modułu i domyślne wartości

• Sklepy → Konfiguracja → Sprzedaż → Metody dostawy → sekcja InPost - Paczkomaty oraz sekcja InPost - Przesyłka kurierska - tutaj można skonfigurować wszystkie dostępne metody dostawy

2. Po zainstalowaniu modułu konfigurację należy zacząć od:

→ Sklepy → Konfiguracja → Sprzedaż → Ustawienia dostawy → sekcja InPost

• Tutaj należy wypełnić pola “ID organizacji” oraz “Token dostępu” i zapisać konfigurację. Dopiero po wypełnieniu i zapisaniu danych do API można skonfigurować pozostałe pola z tej sekcji

Konfiguracja metod dostawy

W następnym kroku należy skonfigurować oraz włączyć wybrane metody dostawy w:

→ Sklepy → Konfiguracja → Sprzedaż → Metody dostawy → sekcja InPost - Paczkomaty oraz sekcja InPost - Przesyłka kurierska

Sekcja konfiguracji metody InPost Paczkomat

W panelu administratora Magento, w:

Sklepy → Konfiguracja → Sprzedaż → Metody dostawy → sekcja InPost - Paczkomaty → znajdują się następujące pola konfiguracji dotyczący metod dostaw do Paczkomatów

Włączone - pole pozwala na włączenie metod dostaw do Paczkomatów. Każda z metod dostaw do Paczkomatów posiada ponadto swoje pole do włączenia i aby była widoczna w procesie zamówienia muszą być one oba ustawione na Tak

Pokazuj tylko dostawę w weekend gdy aktywna - jeśli ustawione na Tak to w czasie gdy dostawa do Paczkomatu w weekend jest aktywna zwykła metoda dostawy do Paczkomatu nie jest widoczna w procesie zamówienia. Jeśli ustawione na Nie to w czasie gdy metoda dostawy do Paczkomatu jest aktywna to jest widoczna w procesie zamówienia razem ze zwykła metodą dostawy do Paczkomatu.

Tytuł - tytuł metody dostawy

Poniżej znajdują się grupy dla każdej z metod dostawy do Paczkomat:

InPost Paczkomat® 24/7

W tej sekcji znajdują się pola konfiguracji dla metody dostawy Paczkomaty (usługa w API to inpost_locker_standard):

InPost Paczkomat® 24/7 - płatność przy odbiorze

W tej sekcji znajdują się takie same pola jak w wyżej opisanej.

Dotyczą one metody dostawy do Paczkomatu za pobraniem (usługa w API to inpost_locker_standard).

Jeśli w procesie zamówienia wybrano tą metodę dostawy to podczas tworzenia przesyłki automatycznie będzie ustawiana kwota pobrania równa sumie zamówienia

InPost Paczkomat® 24/7 - dostawa w weekend + płatność przy odbiorze

W tej sekcji znajdują się te same pola co w sekcji InPost Paczkomat® 24/7 oraz kilka dodatkowych opisanych poniżej. Można tutaj włączyć metodę dostawy do Paczkomaty z dostawą w weekend

Ta metoda może być widoczna w procesie zamówienia tylko w ustawionym przedziale czasowym ponieważ paczki zostaną dostarczone do klientów w weekend

Konfigurując przedział czasowy aktywności tej metody dostawy należy więc pamiętać że ważny jest moment nadania a nie złożenia zamówienia przez klienta

Pola pozwalające na konfigurację przedziału czasowego są następujące:

Dzień tygodnia startu dostawy w weekend - pozwala wybrać którego dnia tygodnia zacznie być aktywna metoda dostawy w weekend

Godzina startu dostawy w weekend - pozwala wybrać o której godzinie w dniu ustawionym we wcześniejszym polu metoda dostawy w weekend zacznie być aktywna

Dzień tygodnia końca dostawy w weekend - pozwala wybrać którego dnia tygodnie przestanie być aktywna metoda dostawy w weekend

Godzina końca dostawy w weekend - pozwala wybrać o której godzinie w dniu ustawionym we wcześniejszym polu metoda dostawy w weekend przestanie być aktywna

InPost Paczkomat® 24/7 - Paczka Ekonomiczna + płatność przy odbiorze

W tej sekcji znajdują się takie same pola jak w wyżej opisanej. Dotyczą one metody dostawy do Paczkomat w opcji “Paczka Ekonomiczna”

Włączając tą metodę dostawy w procesie zamówienia należy upewnić się że po jej wyborze będzie dostępna odpowiednia metoda płatności która nie jest częścią tego modułu

Sekcja konfiguracji metody InPost Kurier

W panelu administratora Magento, w:

Sklepy → Konfiguracja → Sprzedaż → Metody dostawy → sekcja InPost - Przesyłka kurierska znajdują się następujące pola konfiguracji dotyczący metod dostaw kurierem

Włączone - pole pozwala na włączenie metod dostaw kurierem. Każda z metod dostaw posiada ponadto swoje pole do włączenia i aby była widoczna w procesie zamówienia muszą być one oba ustawione na Tak

Tytuł - tytuł metody dostawy

Poniżej znajdują się grupy dla każdej z metod dostawy kurierem osobno. Można włączyć i skonfigurować wybrane z nich

InPost przesyłka kurierska standardowa

InPost przesyłka kurierska standardowa - za pobraniem

W tej sekcji znajdują się takie same pola jak w wyżej opisanej

Jeśli w procesie zamówienia wybrano tą metodę dostawy to podczas tworzenia przesyłki automatycznie będzie ustawiana kwota pobrania równa sumie zamówienia. Włączając tą metodę dostawy w procesie zamówienia należy upewnić się że po jej wyborze będzie dostępna odpowiednia metoda płatności która nie jest częścią tego modułu

InPost - Kurier C2C + za pobraniem

W tej sekcji znajdują się takie same pola jak w wyżej opisanej

Za pobraniem - Jeśli w procesie zamówienia wybrano tą metodę dostawy to podczas tworzenia przesyłki automatycznie będzie ustawiana kwota pobrania równa sumie zamówienia. Włączając tą metodę dostawy w procesie zamówienia należy upewnić się że po jej wyborze będzie dostępna odpowiednia metoda płatności która nie jest częścią tego modułu

InPost - Przesyłka kurierska 10:00/12:00/17:00

Usługa polegająca na dostawie przesyłek do podanej godziny

Znajdują się tutaj takie same pola jak opisano w sekcji InPost przesyłka kurierska standardowa oraz posiadają analogiczne przeznaczenie.

Proces zamówienia

Moduł jest dostosowany do standardowego procesu zamówienia dostępnego w domyślnym szablonie Magento 2 Luma.

W związku z powyższym, jeśli na Państwa sklepie zastosowano inny szablon sklepu lub proces zamówienia, może wymagać dostosowania tak aby funkcjonował poprawnie.

Należy przede wszystkim zwrócić uwagę na zapewnienie walidacji wyboru Paczkomatu dla metod dostawy Paczkomatowych oraz na poprawnym działaniu zapisu wybranego Paczkomatu.

W procesie zamówienia, po skonfigurowaniu modułu oraz włączeniu wybranych usług, pojawią się metody dostawy które aktualnie są aktywne.

W zależności od konfiguracji metody dostawy do Paczkomat mogą być widoczne zarówno w wersji zwykłej jak i z dostawą w weekend lub zamiennie - albo zwykłe albo z dostawą w weekend. Przy każdej metodzie dostawy do Paczkomat widoczny jest przycisk który pozwala na otwarcie mapy (Geowidget) do wyszukiwania wybranego punktu.

• Metody dostawy kurierem nie posiadają żadnych dodatkowych opcji - są po prostu dostępne jeśli w konfiguracji je włączono. 

• Każda z metod dostawy wyświetla ponadto odpowiadające rodzajowi usługi logo

Maile transakcyjne

Po złożeniu zamówienia klient otrzymuje w standardowym szablonie mailowym z potwierdzeniem zamówienia jedynie nazwę wybranej metody dostawy, np. “InPost Paczkomat® 24/7”. Można jednak do szablonu mailowego dodać informację o wybranym Paczkomacie używając następującego kodu w treści szablonu:

{{trans "Numer Paczkomatu: %paczkomat" paczkomat=$order.inpost_locker_id}}

Należy jednak pamiętać aby dodać warunki sprawdzające czy wybrano odpowiednią metodę dostawy w której wybrano Paczkomat.

Podgląd zamówienia w panelu administratora

W panelu administratora, w podglądzie zamówienia dostępna jest nowa sekcja “Przesyłki InPost” która wyświetla listę rozwijalną z dostępnymi usługami InPost oraz przycisk przenoszący do formularza generowania przesyłki.

Na liście rozwijalnej domyślnie zaznaczona jest ta usługa która została wybrana w procesie zamówienia przez klienta (o ile była to usługa dostarczona przez niniejszy moduł)

Jeśli dla danego zamówienia istnieją już wygenerowane przesyłki to w sekcji “Przesyłki InPost” pojawi się tabela z listą oraz szczegółami przesyłek

Tuż po wygenerowaniu przesyłek dane w tej tabeli mogą być niepełne ze względu na asynchroniczny proces nadawania numerów trackingowych w API ShipX

Przez to numery trackingowe pojawią się z opóźnieniem. Lista przesyłek w Magento jest odświeżana cyklicznie co 30 minut lub może być ręcznie odświeżona poprzez kliknięcie przycisku “Odśwież listę” w panelu administratora w Sprzedaż → Lista Przesyłek InPost

Dla przesyłek z dostawą do Paczkomatu tabela pozwala na podgląd wybranego Paczkomatu lub punktu POP na mapie po kliknięciu w link “Pokaż na mapie”

Dodatkowo dla każdej przesyłki możliwe jest pobranie etykiety przesyłki poprzez kliknięcie przycisku “Wydrukuj etykietę” - zostanie wówczas pobrana wygenerowana dla danej przesyłki etykieta w rozmiarze i formacie ustawionym w konfiguracji

W ostatniej kolumnie widoczny jest również przycisk “Zwrot” - dla przesyłek kurierskich powoduje on wygenerowanie etykiety zwrotnej która zostanie pobrana po jego kliknięciu. Dla przesyłek paczkomatowych jego kliknięcie powoduje przekierowanie do serwisu https://szybkiezwroty.pl/

Przycisk jest niedostępny dla usług “Przesyłka kurierska standardowa dla klientów indywidualnych” (inpost_courier_c2c oraz inpost_courier_c2ccod)

Jeśli w konfiguracji ustawiono link do tego serwisu to zostanie on użyty do przekierowania

Generowanie przesyłki InPost

W podglądzie zamówienia w panelu administratora klikając w przycisk “Wyślij” w sekcji “Przesyłki InPost” zostaniemy przekierowani do formularza generowania przesyłki który będzie wyglądał inaczej w zależności od wybranej usługi.

Dla usług kurierskich będzie wyglądał następująco:

Znajdują się tutaj następujące pola:

Po wypełnieniu wszystkich danych należy kliknąć przycisk “Utwórz dostawę” który przekieruje na podgląd zamówienia z odpowiednim komunikatem.

Jeśli podczas generowania przesyłki wystąpią jakieś błędy to operator zostanie cofnięty do formularza generowania przesyłki z zachowaniem podanych informacji oraz z komunikatem opisującym błąd:

Jeśli w konfiguracji modułu zaznaczono pole “Automatycznie twórz przesyłkę do zamówienia” na “Tak” to po utworzeniu przesyłki InPost oraz po pobraniu numer śledzenia (trackingowego) do niej zostanie utworzona przesyłka do zamówienia dla odpowiadającego zamówienia.

Generowanie Przesyłki InPost dla wielu zamówień

Na liście zamówień w panelu administratora istnieje możliwość wygenerowania przesyłek dla wielu zamówień jednocześnie. Można to zrobić zaznaczając wybrane zamówienia oraz z listy rozwijalnej “Operacje” wybierając “Stwórz przesyłki InPost” lub “Stwórz przesyłki InPost i wydrukuj” (co spowoduje od razu druk etykiet).

Mechanizm generowania wielu przesyłek jednocześnie opiera się na następujących założeniach:

• generowane są przesyłki InPost tylko dla zamówień które mają wybraną jedną z metod dostawy dostarczonych przez niniejszy moduł (jeśli operator chciałby wygenerować przesyłkę InPost dla zamówienia które ma wybraną inną metodę dostawy to nadal istnieje taka możliwość pojedynczo, w podglądzie zamówienia)

• dla każdego zamówienia generowana jest przesyłka w takiej usłudze jaka została wybrana przez klienta

• wszystkie dane potrzebne do wygenerowania przesyłki są pobierane z zamówienia lub z ustawień domyślnych modułu więc należy najpierw skonfigurować wszystkie domyślne ustawienia modułu oraz metod dostawy

• jeśli dla któregoś z zamówień wystąpią błędy podczas tworzenia przesyłki to to konkretne zamówienie zostanie pominięte ale kolejne zamówienia będą miały nadal tworzone przesyłki

• jeśli wystąpią błędy podczas generowania przesyłki to zostaną one wszystkie wypisane w komunikatach po zakończeniu procesu

Po zakończeniu procesu generowania przesyłek pojawią się odpowiednie komunikaty z informacjami na temat wygenerowanych przesyłek oraz powodami dla których inne nie zostały wygenerowane:

Lista przesyłek

W panelu administratora dostępna jest lista przesyłek, które są dostępne dla operatora po skonfigurowaniu danych dostępowych do API w konfiguracji modułu.

Lista dostępna jest w menu Sprzedaż → Lista Przesyłek InPost

Widoczna w tym widoku tabela jest odświeżana przez zadanie crona (który powinien być prawidłowo skonfigurowany dla systemu Magento) co 30 minut. Dodatkowo można użyć przycisku “Odśwież listę” w celu jej zaktualizowania.

Tabela zawiera następujące kolumny:

Po zaznaczeniu odpowiednich przesyłek checkboxem w pierwszej kolumnie dostępne będą również następujące operacje:

Kontakt

W przypadku pytań zapraszamy do skorzystania z formularza kontaktowego Działu integracji, który dostępny jest tu: https://inpost.pl/formularz-wsparcie  

 Po wejściu w formularz wystarczy z listy wybrać opcję "Wsparcie Klienta”, w kategorii wybrać: Moduł InPost, a w polu "Proszę podać nazwę modułu” podajemy: Magento