[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
Wtyczka: 30.06.2025r
Nowa wersja wtyczki kompatybilna z PrestaShop 8.X
Kompatybilność wersji PrestaShop z PHP: https://devdocs.prestashop-project.org/8/basics/installation/system-requirements/#php-compatibility-chart
Wtyczka:
https://inpost.pl/sites/default/files/2025-07/PrestaShop-8.International-ver.0.1.0-1.zip
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
- 1 CHANGELOG
- 1.1 Autoryzacja
- 1.2 Instalacja
- 1.3 Konfiguracja
- 1.3.1 Opis zakładek
- 1.3.1.1 Ustawienia API
- 1.3.1.2 Usługi
- 1.3.1.3 Wysyłka
- 1.3.1.4 Szablony paczek
- 1.3.1.5 Zamówienia
- 1.3.1.6 Adres odbioru przesyłki (tylko nadanie u kuriera)
- 1.3.1 Opis zakładek
- 1.4 Tworzenie metod dostawy
- 1.4.1 Ustawienia ogólne
- 1.4.1.1 Nazwa dostawcy
- 1.4.1.2 Czas doręczenia
- 1.4.1.3 Klasa prędkości
- 1.4.1.4 Logo
- 1.4.1.5 URL do śledzenia
- 1.4.2 Lokalizacje wysyłek i koszty
- 1.4.2.1 Dodaj koszty obsługi
- 1.4.2.2 Darmowa wysyłka
- 1.4.2.3 Rozliczenie
- 1.4.2.4 Podatek
- 1.4.2.5 Zachowanie/wynik poza zakresem
- 1.4.2.6 Zakresy
- 1.4.3 Rozmiar/waga i dostępność dla grup
- 1.4.1 Ustawienia ogólne
- 1.5 Konfiguracja metod dostawy w produktach
- 1.6 Obsługa zamówień/wysyłki
- 1.7 Utworzenie podjazdu kuriera
- 1.8 Kontakt
Instalacja
aloguj się do panelu administracyjnego Twojego sklepu na platformie PrestaShop
Przejdź do zakładki Moduły
2. W zakładce Moduły wybierz Menedżer modułów
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
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:
|
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
W module przechodzimy do zakładki Usługi
Wybieramy Nowy przewoźnik
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
KlikamyZapisz
Następne ustawienia dokonujemy bezpośrednio w PrestaShop:
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
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)
Wybieramy Nowa Przesyłka
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 |
Na koniec wybieramy Utwórz (tworzy przesyłkę) lub Utwórz i pobierz etykietę (tworzy przesyłkę i pobiera od razu etykietę w PDF)
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
W zamówieniach należy wybrać konkretne zamówienia
Kliknąć w Działania masowe - tam mamy wybór tworzenia przesyłek i pobierania etykiet
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
Następnie wybieramy dzień i godzinę:
Utworzone zlecania można sprawdzić w zakładce - Zlecenia odbioru
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