[PL] PrestaShop 8 International

[PL] PrestaShop 8 International

 

Poniżej znajduje się wtyczka oraz dokumentacja dot. naszej autorskiej wtyczki InPost International dla systemu PrestaShop 8

 

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

 

Dostępna dla: BE - Belgium / ES - Spain / FR - France / IT - Italy / LU - Luxembourg / NL - Netherlands / PT - Portugal

 

CHANGELOG

 


Autoryzacja

Środowisko produkcyjne / testowe

 

Skorzystanie z środowiska PRODUKCYJNEGO jest możliwe tylko po podpisaniu umowy na usługi INTERNATIONAL

 

Przed przystąpieniem do instalacji należy posiadać dane dostępowe do połączenia z API:

  • ClientID oraz ClientSecret


W celu otrzymania danych autoryzacyjnych należy skontaktować się z InPost poprzez formularz:
Udzielenie dostępu do API → API International → Środowisko: Produkcja lub Sandbox (wyłącznie do testów usługi)

https://inpost.pl/formularz-wsparcie

 

 


Instalacja

aloguj się do panelu administracyjnego Twojego sklepu na platformie PrestaShop

  1. Przejdź do zakładki Moduły

 

2. W zakładce Moduły wybierz Menedżer modułów

  1. Po prawej stronie ekranu pojawi się przycisk Załaduj Moduł

(Kliknij w przycisk i załaduj paczkę instalacyjną w postaci archiwum)


Konfiguracja

Wyszukiwanie modułu w celu dalszej konfiguracji następuje w zakładce Moduły > Menedżer modułów

W wyszukiwarkę wpisz InPost i kliknij przycisk Konfiguruj

 

Opis zakładek

 

image-20250630-131058.png

 

Ustawienia API

Opis

ClientID

ID potrzebne do autoryzacji - w powyższej zakładce AUTORYZACJA jest opisane jak te dane można otrzymać

ClientSecret

Klucz potrzebny do autoryzacji - w powyższej zakładce AUTORYZACJA jest opisane jak te dane można otrzymać

Aktywne środowisko

Tryb Produkcyjny - pozwala generować realne przesyłki, Tryb Sandbox - pozwala generowanie przesyłek, zleceń podjazdów i pobieranie etykiet bez opłat

Token produkcyjny Geowidget

Wymagane jest uzupełnienie tokenu do Geowidget w celu włączenia widoczności usług w checkout (tylko środowisko Produkcyjne).

Token należy wygenerować w https://manager.paczkomaty.pl/auth/login zakładka Moje konto - API - Geowidget

Token sandbox Geowidget

Wymagane jest uzupełnienie tokenu do Geowidget w celu włączenia widoczności usług w checkout (tylko środowisko Sandbox)

Token należy wygenerować w InPost - Manager paczek zakładka Moje konto - API - Geowidget

 

Usługi

 

Nowy przewoźnik

Dodawanie usług InPost International w checkoucie - opis znajduje się w części: [PL] PrestaShop 8 International | Tworzenie metod dostawy

 

Wysyłka

 

Dane nadawcy

Należy uzupełnić swoje dane nadawcy, które będą znajdować się w systemie

Domyślna metoda nadania

Określamy domyślny sposób nadania przesyłki (można go zmienić podczas tworzenia paczki) → Nadanie u kuriera lub w punktach

Domyślna referenca

Wskazujemy co ma się znajdować domyślnie w numerze referencyjnym przesyłki

Domyślny nr referencyjny klienta

 

Domyślne ubezpieczenie

Wartość ubezpieczenia, która będzie przypisywana do przesyłek (waluta EURO)

 

Szablony paczek

 

Nowy szablon paczki

Pozwala na tworzenie szablonów paczek, które będą możliwe do wybrania przy tworzeniu przesyłki do konkretnego zamówienia

Domyślny - ustawienie czy dany szablon ma być podstawiany domyślnie przy tworzeniu przesyłki

Nazwa - dowolna nazwa pozwalająca rozróżnić szablon

Rodzaj paczki - standard (na ten moment)

Wymiary - długość/szerokość/wysokość - jednostka CM/MM/M

Waga - dopuszczalna maks. 25kg

 

Zamówienia

 

Zarządzanie ustawieniami zamówień

Umożliwia:

  1. Status zamówienia: etykieta wydrukowana → zmiana statusu zamówienia po wydrukowaniu etykiety

  2. Status zamówienia: przesyłka dostarczona → zmiana statusu na doręczona (ZADANIE CRON)

  3. Modyfikuj e-mail z potwierdzeniem zamówienia → dodaje informację o wybranym punkcie odbioru i nazwie InPost

 

Adres odbioru przesyłki (tylko nadanie u kuriera)

 

Nowy adres odbioru

Umożliwia wskazanie punktu odbioru przesyłki

Domyślny - ustawienie czy dany szablon ma być podstawiany domyślnie przy tworzeniu przesyłki

Nazwa - dowolna nazwa pozwalająca rozróżnić szablon

 

Osoba kontaktowa:

Imię/Nazwisko/Email/Telefon - osoby do odbioru przesyłki

 

Adres:

Ulica/Numer budynku/Nr mieszkania/Kod pocztowy/Miasto/Kraj/Opis - dane dla kuriera do odbioru przesyłki


Tworzenie metod dostawy

 

Do poprawnego działania usługi InPost International należy dodać metodę dostawy do ustawień PrestaShop

 

  1. W module przechodzimy do zakładki Usługi

  2. Wybieramy Nowy przewoźnik

image-20250617-073556.png

 

  1. Należy wybrać strefę dla konkretnego kraju lub utworzyć jedną z kilkoma krajami i dodać metodę wysyłki

Dostępna dla: BE - Belgium / ES - Spain / FR - France / IT - Italy / LU - Luxembourg / NL - Netherlands / PT - Portugal

  1. KlikamyZapisz

 

  1. Następne ustawienia dokonujemy bezpośrednio w PrestaShop:

image-20250617-073844.png

Ustawienia ogólne

 

Nazwa dostawcy

Domyślnie nadana nazwa z wtyczki InPost

Czas doręczenia

Wskazujemy czas doręczenia przesyłki per kraj

Klasa prędkości

Można pominąć

Logo

Domyślnie wgrane - nie trzeba zmieniać

URL do śledzenia

Domyślnie ustawione - nie trzeba zmieniać

Lokalizacje wysyłek i koszty

 

Dodaj koszty obsługi

Dodatkowy koszt obsługi przesyłki

Darmowa wysyłka

Wysyłka darmowa lub nie

Rozliczenie

Według wagi bądź ceny całkowitej

Podatek

Względem prefrencji

Zachowanie/wynik poza zakresem

Działanie po przekroczeniu np. maksymalnej wagi zamówienia

Zakresy

Określenie kg i ceny od do = cena przesyłki w zależności od wybranego kraju

Rozmiar/waga i dostępność dla grup

Określamy maksymalne wymiary przesyłki + dla jakich grupa dana forma wysyłki ma być dostępna

 


Konfiguracja metod dostawy w produktach

W konfiguracji produktów można określać czy dana forma dostawy (w tym przypadku InPost International) będzie dostępna dla konkretnego produktu

 

image-20250618-133146.png


Obsługa zamówień/wysyłki

Tworzenie przesyłki i pobieranie etykiety

Umożliwia generowanie przesyłek i pobieranie etykiet

Przechodząc do konkretnego zamówienia po wybraniu przez klienta usługi InPost International pojawia się okno dot. wysyłki InPost (poniżej statusu płatności)

image-20250627-113131.png

 

  1. Wybieramy Nowa Przesyłka

  2. Określamy dane

Tworzenie przesyłki

Opis

Odbiorca

Dane, która klient uzupełnił tworząc zamówienie w sklepie

Usługa

Metoda dostawy

Punkt docelowy

Punkt odbioru, który wybrał klient z Geowidget

Metoda nadania

Nadanie w punkcie lub u kuriera

Szablon paczki

Wybieramy szablon, który wcześniej określiliśmy w konfiguracji modułu

Wymiary

Podstawiane przez szablon - można je edytować w tym miejscu

Waga

Waga wskazana przez szablon - można edytować w tym miejscu

Nr referencyjny klienta

Numer zamówienia lub własny tekst na etykiecie

Ubezpieczenie

Wartość domyślna przypisana w konfiguracji modułu

Reference

Dodatkowe odniesienia dotyczące przesyłki, możliwość dynamicznego tworzenia par klucz-wartość dostosowanych do indywidualnych potrzeb klienta

 

  1. Na koniec wybieramy Utwórz (tworzy przesyłkę) lub Utwórz i pobierz etykietę (tworzy przesyłkę i pobiera od razu etykietę w PDF)

image-20250627-105005.png

Masowe tworzenie przesyłek i pobieranie etykiet

Jest możliwe tworzenie masowo przesyłek (tych, które nie mają jeszcze numeru śledzenia) poprzez wejście w zamówienia

  1. W zamówieniach należy wybrać konkretne zamówienia

  2. Kliknąć w Działania masowe - tam mamy wybór tworzenia przesyłek i pobierania etykiet

image-20250627-105213.png

 


Utworzenie podjazdu kuriera

Zlecanie podjazdu kuriera jest możliwe w konfiguracji wtyczki w zakładce Wysyłka → Przesyłki InPost International

We wtyczce International w podjeździe kuriera określamy przesyłki datę i dzień ich odbioru:

najpóźniejszy czas odbioru jest określany przez kod pocztowy i godzinę graniczną nadania przesyłki, którą można sprawdzić w tej zakładce

image-20250627-112544.png

 

Następnie wybieramy dzień i godzinę:

 

image-20250627-112610.png

 

Utworzone zlecania można sprawdzić w zakładce - Zlecenia odbioru

 

image-20250627-110037.png

 

 


Kontakt

W przypadku pytań zapraszamy do skorzystania z naszego formularza kontaktowego dostępnego pod linkiem  https://inpost.pl/formularz-wsparcie . Po wejściu w formularz wystarczy wybrać z listy opcję   Wsparcie Klienta, w kategorii wybrać:  Moduł InPost International, a w polu  Proszę podać nazwę modułu  podajemy: PrestaShop