Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Poniżej znajduje się dokumentacja do autorskich wtyczek InPost PrestaShop. Zawiera informację o instalacji oraz konfiguracji wtyczek
Panel | ||||||
---|---|---|---|---|---|---|
| ||||||
1.7+Wtyczka jest kompatybilna z wersją PrestaShop od 1.7 wzwyż. Wersja 1.6 jak i niektóre wersje PHP mogą powodować błędy w działaniu wtyczki jak i sklepu Kompatybilność wersji PrestaShop z PHP: https://devdocs.prestashop-project.org/1.7/basics/installation/system-requirements/#php-compatibility-chart Wtyczkę należy wstępnie przetestować na wersji testowej sklepu Wtyczka: (najnowsza wersja 1.2122.20- 0109.0911.2023r) https://inpost.pl/sites/default/files/2023-0911/PrestaShop-1.7.0-1.7.8.5-ver-1.2122.20.zip |
Panel | ||||||
---|---|---|---|---|---|---|
| ||||||
8.0+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: (najnowsza wersja 2.67.20- 0109.0911.2023r) https://inpost.pl/sites/default/files/2023-0911/PrestaShop-8.%2Bver-ver-2.67.20.zip |
Changelog:
1.22.0 / 2.7.0:
FIX: drukowanie etykiet na przeglądarce SAFARI
FIX: poprawa działania zapytania CRON
1.21.2 / 2.6.2:
Funkcjonalność: pole dot. numeru telefonu i email nie pokazują się przy wybieraniu z Geowidget Paczkomat® (zaciągają się z danych adresowych podanych przez klienta)
Dodanie czyszczenie cache'u zarówno przed instalacją modułu jak i po jego deinstalacji
Na tej stronie
Table of Contents |
---|
Autoryzacja
Posiadamy dwa środowiska (Manager Paczek x API) - testowe i produkcyjne. Dane należy wygenerować dla tego środowiska, którego obecnie używamy.
Środowisko produkcyjne (Production)
Info |
---|
Przed przystąpieniem do instalacji należy posiadać dane dostępowe do połączenia z API ShipX:
oraz
Pobierz poradnik wyjaśniający jak szybko we własnym zakresie utworzyć dostęp do API ShipX oraz Geowidget: https://inpost.pl/sites/default/files/2022-03/instrukcja-konfiguracji-api-shipx.pdf https://manager.paczkomaty.pl/ > zakładka Moje konto > API |
Środowisko testowe (Sandbox)
Info |
---|
Generowanie dostępu https://sandbox-manager.paczkomaty.pl/ > zakładka Moje konto > API Aby wygenerować Token i ID organizacji należy uzupełnić wszystkie dane, łącznie z danymi do faktury w zakładce Moje konto > Dane. Do utworzenia przesyłki Paczkomat® niezbędne są środki na koncie, konto doładujesz wirtualnie w zakładce Płatności Geowidget:
|
Instalacja wtyczki
Zaloguj 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
3. Po prawej stronie ekranu pojawi się przycisk Załaduj Moduł
(Kliknij w przycisk i wrzuć paczkę instalacyjną w postaci archiwum)
Konfiguracja wtyczki
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
Zakładki
umożliwia konfigurację dostępu do API (Produkcyjnego i Sandboxowego) | |
GeoWidget | umożliwia dodanie Tokenu do Geowidget (do poprawnego działania mapy z punktami InPost należy wygenerować token Geowiedget) |
Dane nadawcy | dane można uzupełnić lub automatycznie pobrać z API |
Metody nadania | umożliwia konfigurację domyślnych Punktów Odbioru/Paczkomat® i ustawienia domyślnej wartości ubezpieczenia |
Usługi dostawy | miejsce do dodania i skonfigurowania usług Paczkomat® i Kurierskich |
Paczka w Weekend | pozwala na konfigurację usługi Paczka w Weekend (dni i godziny dostępności usługi) |
Punkty Odbioru | umożliwia dodanie/usuwanie/edycję Punktów Odbioru |
Checkout |
|
Zamówienia | znajdują się tu opcje dodatkowe do obsługi zamówień |
Szybkie Zwroty | umożliwia konfigurację usługi Szybkie Zwroty (mając utworzone konto w tym serwisie - Przedstawiciel Handlowy) |
Panel | ||||||
---|---|---|---|---|---|---|
| ||||||
Ważne! Gdy w koszyku w Geowidget pokazuje się błąd “Brak dostępu, sprawdź czy token został wygenerowany dla odpowiedniej witryny” należy ponownie wygenerować token do Geowidget w Manager Paczek ale podając poprawny adres witryny sklepu. Błąd dotyczy podania błędnego adresu url sklepu. |
Autoryzacja
W tym miejscu możesz uzupełnić dane dostępowe do API (Token, ID organizacji), która można wygenerować samemu w Managerze Paczek w zakładce „API”
Dostęp do środowisk znajduje się na początku tej dokumentacji
Możliwe jest użycie tylko trybu Sandbox po przełączeniu switch’a i uzupełnieniu danych sandboxowych
Geowidget
Do poprawnego działania mapy z punktami InPost w koszyku należy dodać token Geowidget do konfiguracji Produkcyjnej lub Sandboxowej
Token należy wygenerować w Manager Paczek w zakładce Moje konto → API → Geowidet(podając domenę sklepu)
Usługi dostaw
W tym miejscu możesz skonfigurować metody dostaw, jakie pojawią się w Twoim sklepie
Kliknij Dodaj nowy -> uzupełnij usługę, która jest importowana z API, domyślną metodę nadania, określ domyślne wymiary przesyłki lub gabaryt ( w zależności od użytego serwisu), następnie nadaj poprawną nazwę usługi zgodnie z wytycznymi zawartymi w „Poradniku skutecznej implementacji dostaw InPost w koszyku e-commerce” i kliknij Wyślij
Info |
---|
Poradnik implementacji dostaw znajdziesz pod adresem: |
Po dodaniu usługi masz możliwość dalszej konfiguracji metody dostawy. W tym celu kliknij Przejdź do ustawień przewoźnika
Zostaniesz przekierowany do wybranej usługi, gdzie możesz zmienić logo, ustawić koszty przesyłki, maksymalną wagę, rozmiary i dostępność dla gości lub klientów zalogowanych do sklepu
Info |
---|
Gdy usługa nie jest widoczna w koszyku należy zweryfikować czy w danym produkcie jest ta metoda dostawy włączona. Produkt - zakładka Wysyłka |
Pozycjonowanie usług dostawy w koszyku
Zakładka Ulepszenia -> Wysyłka -> Przewoźnicy
Tutaj możesz pozycjonować usługi InPost w koszyku klienta
Szybkie Zwroty
Usługa pozwala klientom na zwrot przesyłki zamówionej w sklepie poprzez Paczkomat®
W konfiguracji wtyczki należy podać skróconą nazwę do formularza Szybkich Zwrotów. Link tworzy się po założeniu konta w tej usłudze poprzez Przedstawiciela Handlowego
Klient, który jest zalogowania w sklepie w zakładce zamówienia widzi nowy przycisk Zwróć Towar to pozwala na przeniesienie się do Państwa formularza gdzie może dokonać zwrotu
Info |
---|
Zwroty dokonywane poprzez formularz posiadają dwie opcje akceptacji:
|
InPost Paczkomat® Paczka Ekonomiczna
Produkty zamówione w ramach udostępnianej usługi InPost Paczkomat® Paczka Ekonomiczna zyskują atrakcyjną cenę dostawy. Odbieranie przesyłek ekonomicznych z Paczkomat® InPost to najbezpieczniejszy sposób na realizację zamówień internetowych, zwłaszcza przy pomocy zdalnego otwierania skrytki poprzez aplikację InPost Mobile
Konfiguracja:
Do działania usługi należy dodać nową metodę wysyłki:
Przechodzimy do konfiguracji wtyczki Moduły → InPost Wysyłka → zakładka Usługi dostawy
Klikamy Dodaj nowy
Wybieramy usługę InPost Paczkomat® Paczka Ekonomiczna
Uzupełniamy standardowe dane dot. wysyłki i Kod wariantu , który został podany na umowie
Klikamy Wyślij
Po dodaniu usługi musimy ją dodatkowe skonfigurować przechodząc do Przejdź do ustawień przewoźnika

Tam ustalmy cenę za usługę, czy cena powinna zawierać podatek i dla jakich grup ma być dostępna
Po zapisaniu ustawień w koszyku pojawia nam się nowe usługa:
Utworzenie przesyłki:
Po dokonaniu zamówienia przez klienta w zamówieniu zakładka Przewoźnicy pojawi się informacja o tym jaki serwis wybrał klient i będzie można utworzyć nową przesyłkę.
W miejscu Kod wariantu automatycznie przypiszę się wartość dodana podczas dodawania nowej usługi dostawy.
Obsługa zamówień/wysyłki
Obsługa zamówienia
Zakładka - Zamówienia
Umożliwia generowanie etykiet, tworzenie przesyłek, drukowanie zleceń odbioru
W zamówieniu pojawia się tabelka z usługami InPost gdzie możemy utworzyć przesyłkę
Po kliknięciu na przycisk Nowa przesyłka otwiera się panel do edycji danych podanych przez klienta jak i ich akceptacji

Drukowanie i format etykiet
Po utworzeniu przesyłki można pobrać etykietę klikając Akcje → Drukuj etykietę

Mamy do wyboru formaty etykiet:
Obsługa wysyłki
Zakładka - Wysyłka > Przesyłki InPost
W tym miejscu możliwa jest obsługa i podgląd zleceń podjazdu, aktualnie procesowanych oraz nadanych przesyłek, generowanie etykiet, tworzenie i drukowanie zleceń odbioru
Przy tworzeniu zlecenia odbioru mamy możliwość wyboru punktu odbioru
Produkty - szablony
W każdym z produktów jest możliwość określenia dostępności dla konkretnego przewoźnika i domyślnego wymiaru przesyłki
Dotyczy to przesyłek Kurierskich (wymiary w cm) i przesyłek Paczkomat® (Gabaryty)
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: PrestaShop