InPost dla PrestaShop kompatybliny z wersjami: 1.5, 1.6 Instrukcja obsługi
1 Spis treści 1. Konto InPost... 2 2. Instalacja wtyczki... 2 2.1 Aktualizacja modułu... 2 3. Konfiguracja... 3 3.1 Informacje o koncie... 3 3.2 Wybierz dostępne funkcje... 4 3.3 Domyślny rozmiar paczki... 4 3.4 Statusy... 5 3.5 Wysyłanie paczek... 5 4. Reguły cenowe... 6 4.1 Paczkomaty InPost... 7 4.2 Paczkomaty InPost (za pobraniem)... 8 4.3 InPost Cross Border... 8 5. Interakcja z klientem e-sklepu... 9 6. Generowanie przesyłek w edycji zamówień... 10 6.1 Paczki... 11 6.2 Etykiety... 11 7. Odbiór przesyłek... 12 7.1 Zamawianie kuriera... 12 7.2 Manifesty... 12 7.3 Punkty odbioru... 13
2 1. Konto InPost Jeśli są Państwo klientem firmy InPost prosimy o kontakt z Państwa Opiekunem Handlowym w celu pozyskania odpowiednich danych pozwalających na aktywację wtyczki. Jeśli są Państwo zainteresowani ofertą firmy InPost prosimy o kontakt na stronie https://inpost.pl/pl/kontakt/skontaktuj-sie-z-nami Skontaktujemy się z Państwem w celu przestawienia oferty. Jeśli posiadają Państwo login oraz token, ale aktywacja wtyczki jest niemożliwa, prosimy o kontakt pod adresem plugin@inpost.pl. Dziękujemy za wybranie naszej oferty, Zespół InPost 2. Instalacja wtyczki Moduł dostępny jest do pobrania na stronie https://inpost.pl/pl/oferta-dla-biznesu/przesylki/paczkomaty/moduly-integracyjne. Po pobraniu należy w panelu administracyjnym e-sklepu wejść do zakładki Moduły i usługi. Na stronie tej musimy wgrać nasz moduł przy użyciu Dodaj nowy moduł - pojawi nam się pole Plik modułu, w którym możemy wybrać pobrany moduł z naszego dysku. Po wgraniu moduł będzie na widoczny na liście jako niezainstalowany. Aby zainstalować moduł klikamy w Instaluj. 2.1 Aktualizacja modułu Dla zainstalowanych oficjalnych modułów dla PrestaShop, aktualizacje przebiegają w prosty dla użytkownika sposób. Z poziomu zakładki Moduły i usługi należy zalogować się do serwisu Addons PrestaShop. Będąc zalogowanym zostaniemy poinformowani o aktualizacjach, który pojawiły się w ramach Addons dla naszych modułów.
3 3. Konfiguracja Moduł pozwala na zintegrowanie sklepu z firmą kurierską InPost dla jednego z trzech rynków: Polska, Francja, Włochy. W zależności od rynku, w zakresie funkcjonalności modułu pojawiają się pewne różnice, o których można przeczytać w tej instrukcji. Konfigurację modułu przeprowadzamy na stronie InPost > Konfiguracja 3.1 Informacje o koncie Konfigurację modułu należy rozpocząć od wybrania rynku, dla którego chcemy zintegrować nasz e-sklep z usługami firmy InPost. Po wybraniu rynku pojawia się dodatkowe pole zawierające adres API. UWAGA: rekomendujemy, aby nie zmieniać wartości w tym polu, zawiera ono adresy aktualne w momencie publikacji modułu. W celu dokończenia konfiguracji połączenia z wybranym API, należy podać dane dostępowe w polach E-mail oraz Token. Dane dostępowe można uzyskać bezpośrednio od firmy InPost na danym rynku. W momencie zapisywania danych wykonywana jest próba połączenia z wybranym API, w celu zweryfikowania poprawności podanych danych dostępowych. Jeśli wszystkie dane są poprawne, otrzymujemy dostęp do pozostałych elementów w zakładce Konfiguracja oraz dostęp do pozostałych zakładek modułu.
4 3.2 Wybierz dostępne funkcje W tym miejscu możemy wybrać, jakie elementy integracji chcemy mieć aktywne w naszym e-sklepie. Dostępne elementy zależą od rynku, który aktywowaliśmy. Dodatkowo rekomendujemy kontakt z firmą InPost, w celu upewnienia się czy zawarta umowa, obejmuje zakres usług, z jakich chcemy skorzystać. Do wyboru w ramach modułu mamy następujące usługi: a. Paczkomaty InPost b. Paczkomaty InPost za pobraniem (tylko dla rynku: Polska, Włochy) c. Zwroty (tylko dla rynku: Polska) d. Cross Border - Paczkomaty InPost oraz Kurier InPost (tylko dla rynku: Polska) W przypadku wybrania usługi Paczkomaty InPost i/lub Paczkomaty InPost (za pobraniem) pojawią się dodatkowe pola przedstawiające aktualnie zainstalowane w systemie PrestaShop moduły płatności. Poprzez zaznaczenie tych pól określamy, jakie metody płatności mają być dostępne dla klienta e-sklepu w procesie zamawiania, po wybraniu jako formy wysyłki Paczkomaty InPost lub Paczkomaty InPost (za pobraniem). Np. przy wyborze Paczkomaty InPost (za pobraniem) zaznaczoną formą płatności powinna być metoda gotówka przy odbiorze. 3.3 Domyślny rozmiar paczki W tym miejscu określamy jaki rozmiar paczki dla usług Paczkomaty InPost oraz Paczkomaty InPost (za pobraniem) ma być rozmiarem domyślnym, czyli stosowanym przy tworzeniu przesyłek.
5 3.4 Statusy W tej sekcji definiujemy jaki status ma uzyskać zamówienie klienta w systemie PrestaShop, w dwóch określonych przypadkach: Status zamówienia po wygenerowaniu etykiety - status zamówienia po wygenerowaniu etykiety dla paczki Status zamówienia po dostarczeniu przesyłki - status zamówienia po otrzymaniu poprzez API informacji o dostarczeniu przesyłki do klienta 3.5 Wysyłanie paczek W tej sekcji definiujemy dane nadawcy w systemie InPost. Po zainstalowaniu modułu dane te są automatycznie pobierane poprzez API do systemu PrestaShop. Zapisanie danych w tym miejscu powoduje także ich aktualizację poprzez API w systemie InPost. Dane z tej sekcji są wykorzystywane w procesie tworzenia przesyłek.
6 4. Reguły cenowe W tej sekcji definiujemy koszty przesyłek w ramach poszczególnych usług InPost. Usługi dostępne w tej sekcji wynikają z wybranych usług w zakładce Konfiguracja. Dodatkowo możemy ustawić za pomocą Wybierz stawkę podatku dla metod dostawy podatek VAT, jaki ma być uwzględniany we wszystkich wysyłkach realizowanych w ramach modułu.
7 Wszystkie wartości dotyczące kosztów wysyłek definiujemy jako wartości brutto, w walucie domyślnej naszego e-sklepu. W zależności od wybranego podatku oraz ustawień PrestaShop dotyczących uwzględniania podatku VAT w pokazywanych cenach (Klienci > Grupy > [Grupa] Edycja > Metoda wyświetlania cen) moduł wylicza cenę końcową prezentowaną klientowi w procesie zamawiania. 4.1 Paczkomaty InPost Konfiguracja dotyczy wysyłek nadawanych metodą Paczkomaty InPost. Opcja Darmowa dostawa od pozwala zdefiniować nam kwotę, od której wysyłka będzie darmowa. Uwaga: Jeśli ustawimy w tym polu wartość, to jest ona traktowana priorytetowo w stosunku do pozostałych ustawień kosztów wysyłek w tej sekcji. Następnie do wyboru mamy jeden z trzech sposobów obliczania kosztów wysyłek dla klienta w procesie zamawiania: Stała cena - stała cena dla wszystkich wysyłek w ramach tej metody Zakresy cenowe - koszt wysyłki wyliczany jest na podstawie wartości koszyka klienta Zakresy wagowe - koszt wysyłki wyliczany jest na podstawie wagi koszyka klienta. UWAGA: wybierając tą metodę wyliczania kosztu wysyłki, miejmy pewność, że produkty w naszym sklepie mają zdefiniowane wartości w polu [Katalog > Produkty > [Produkt] > Edycja > Wysyłka > Waga opakowania
8 4.2 Paczkomaty InPost (za pobraniem) W ramach tej metody definiowanie cen odbywa się na tych samych zasadach co dla metody Paczkomaty InPost, z wyjątkiem sposobu Zakresy wagowe - w ramach metody Paczkomaty InPost (za pobraniem) dodatkowo definiujemy wartość dla pola % wartości koszyka, wartość ta definiuje jaki % wartości koszyka klienta będzie dodatkowo doliczony do ceny wysyłki. 4.3 InPost Cross Border Konfiguracja dotyczy wysyłek nadawanych metodami InPost Cross Border Kurier oraz Cross Border Paczkomaty. Konfiguracja odbywa się przy użyciu tabelki zestawiającej dostępne ścieżki wysyłek. Ścieżka wysyłki składa się z: kraju nadania, kraju odbioru, formy nadania (FromDoor, FromParcelMachine), formy odbioru (ToDoor, ToParcelMachine). Zdefiniowanie kosztu wysyłki dla danej ścieżki oraz progu wagowego jest wymagane, aby klient mógł skorzystać z danej formy wysyłki. UWAGA: konfiguracja kosztów wysyłek w ramach Cross Border bazuje tylko na wagach produktów, miejmy pewność, że produkty w naszym sklepie mają zdefiniowane wartości w polu Katalog > Produkty > [Produkt] Edycja > Wysyłka > Waga opakowania
9 5. Interakcja z klientem e-sklepu W procesie składania zamówienia klient e-sklepu ma możliwość wyboru jednej ze skonfigurowanych w ramach modułu form wysyłki. Dostępne formy wysyłki wynikają z dostępności danej usługi na aktualnie skonfigurowanym w ramach modułu rynku oraz aktywacji usługi w ramach modułu oraz poprawnej konfiguracji kosztów wysyłek dla danej formy wysyłki. Potencjalne formy wysyłki to: InPost Paczkomaty oraz InPost Paczkomaty (za pobraniem) - dostępna tylko jeśli dostępna na aktualnie skonfigurowanym rynku oraz kraj dostawy do klienta pokrywa się z aktualnie skonfigurowanym rynkiem w ramach modułu. InPost Cross Border Kurier oraz InPost Cross Border Paczkomaty - dostępna tylko jeśli dostępna na aktualnie skonfigurowanym rynku, aktualnie skonfigurowany rynek posiada aktywną usługę przesyłek zagranicznych oraz dla usługi tej istnieje ścieżka kraj wysyłki (aktualnie skonfigurowany rynek) - kraj dostawy W przypadku wybrania formy wysyłki do Paczkomatu użytkownik dodatkowo wybiera docelową maszynę, przy użyciu widgetu InPost GeoWidget.
10 6. Generowanie przesyłek w edycji zamówień W panelu administracyjnym e-sklepu, dla zarejestrowanych zamówień pojawia się sekcja InPost zawierająca: a. informacje o aktualnie już wygenerowanych poprzez API dla danego zamówienia przesyłkach b. formularz dodawania/edycji przesyłki Formularz dodawania przesyłki składa się z sekcji danych nadawcy, odbiorcy przesyłki, pól dotyczących ubezpieczenia, gabarytów wysyłki oraz komentarza do przesyłki. Dla rynku Polska użytkownik może wybrać sposób nadania w polu Metoda nadania. Dostępne metody to: Z paczkomatu - przesyłka nadawana z Paczkomatu wybranego w polu Paczkomat nadawczy
11 Z punktu wysyłkowego - przesyłka odbierana przez kuriera z wybranego w polu Punkt wysyłkowy punktu odbioru. 6.1 Paczki Sekcja InPost > Paczki zawiera informacje o wygenerowanych w e-sklepie przy użyciu API InPost - przesyłkach. Zanim przesyłki będą mogły być wysłane, należy wygenerować dla nich etykiety. Aby wygenerować etykiet, należy oznaczyć przesyłki przy użyciu checkboxów, a następnie użyć przycisku Wygeneruj etykiety dla zaznaczonych paczek. Akcja ta powoduje wygenerowanie etykiety za pomocą API InPost oraz obciążenie konta klienta w systemie InPost. 6.2 Etykiety Sekcja InPost > Etykiety zawiera informacje o wygenerowanych w e-sklepie przy użyciu API Inpost etykiet do przesyłek. Z poziomu tej sekcji pobrać możemy wcześniej wygenerowane etykiety.
12 7. Odbiór przesyłek 7.1 Zamawianie kuriera Na rynku Polska dla przesyłek wygenerowanych z metodą nadania Z punktu wysyłkowego należy dokonać zamówienia odbioru przez kuriera. Po zaznaczeniu etykiet za pomocą checkboxów pojawia się przycisk Zamów kuriera, po kliknięciu którego pojawia się formularz do wypełnienia danych: Data odbioru - dzień, w którym chcemy aby przesyłki były odebrane z punktu odbioru Wybierz godzinę odbioru Od, Wybierz godzinę odbioru Do - zakres godzin, w jakich chcemy, aby danego dnia przesyłki były odebrane z punktu Referencja - dodatkowe pole dla administratora, można w nim podać np. informację o numerze zamówienia Komentarz - komentarz, który zostanie umieszczony na protokole odbioru Zatwierdzenie formularza poprzez Potwierdź zamówienie kuriera powoduje utworzenie poprzez API InPost żądania zamówienia kuriera. Dla wygenerowanego żądania możemy z poziomu sekcji Manifesty wygenerować protokół odborczy dla kuriera lub serię protokołów. 7.2 Manifesty Sekcja InPost > Manifesty dostępna jest w zależności od wybranego rynku oraz aktywnych usług. Z tego poziomu wygenerować możemy protokół odbiorczy dla kuriera lub serię protokołów.
13 7.3 Punkty odbioru Sekcja InPost > Punkty odbioru dostępna jest w zależności od wybranego rynku oraz aktywnych usług. W sekcji tej definiować możemy punkt odbioru paczek przez kuriera dla usług InPost Paczkomaty oraz InPost Cross Border. Raz dziennie odbywa się synchronizacja punktów odbioru z punktami zdefiniowanymi w zewnętrznym narzędziu Manager Paczek InPost.