[PL] PrestaShop 1.7 / 8.X

 

 

 

Poniżej znajduje się dokumentacja do autorskich wtyczek InPost PrestaShop. Zawiera informację o instalacji oraz konfiguracji wtyczek

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.25.1- 06.08.2024r)

https://inpost.pl/sites/default/files/2024-08/PrestaShop1.7.0-1.7.8-ver-1.25.1.zip

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.11.2- 24.10.2024r)

https://inpost.pl/sites/default/files/2024-10/PrestaShop-8.-ver-2.11.2.zip

Changelog - rozwiń

2.11.2 (PS 8 ): 24.10.2024

  • FIX: zniesiono ograniczenie instalacji modułu na PrestaShop 8.2

2.11.1 (PS 8 ): 24.10.2024

  • FIX: poprawiono błąd mogący uniemożliwiać utworzenie zamówienia przez API PrestaShop

2.11.0 (PS 8 ): 22.08.2024

  • New: wyświetlanie najbliższego dostępnego punktu odbioru przesyłki w checkoucie (dodatek do mapy Geowidget)

1.25.1 / 2.10.1: 06.08.2024

  • FIX: usunięty błąd przy tworzeniu przesyłki dot. adresu

1.25.0 / 2.10.0: 18.07.2024

  • New: nowa metoda dostawy “Smart Courier”

1.24.0 / 2.9.0: 26.04.2024

  • New: dodana integracja z modułem onepagecheckoutps

  • FIX: usunięty błąd uniemożliwiający wyświetlenie strony zamówienia w panelu administracyjnym w przypadku obecności powiązanych z zamówieniem przesyłek o statusie confirmed lub wcześniejszym

1.23.0 / 2.8.0: 29.03.2024

  • New: dodana na stronie zamówienia w panelu administracyjnym możliwość utworzenia przesyłek, gdy wybrana dla zamówienia metoda dostawy nie jest powiązana z modułem

  • New: dodanie wyświetlanie informacji o wybranym Paczkomat na stronie szczegółów zamówienia na FO

  • New: dodana możliwość usunięcia z PS danych przesyłki poprzez listę przesyłek procesowanych oraz stronę zamówienia w panelu administracyjnym

  • FIX: poprawiona walidacja numeru telefonu w checkoucie modułu thecheckout w przypadku, gdy w module przewoźnika wyłączona jest możliwość podania osobnego numeru telefonu

  • FIX: poprawiony przypadek, gdzie na stronie konfiguracji modułu podnoszony był warning przy włączonej w konfiguracji PHP opcji open_basedir

  • FIX: zaktualizowane tłumaczenia nazw usług

1.22.1 / 2.7.1:

  • FIX: poprawka kompatybilności z TheCheckout

  • New: zabezpieczenie przed błędami, które uniemożliwiają uruchomienie modułu

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:

  • New: pole dot. numeru telefonu i email nie pokazują się przy wybieraniu z Geowidget Paczkomat® (zaciągają się z danych adresowych podanych przez klienta)

  • New: Dodanie czyszczenie cache'u zarówno przed instalacją modułu jak i po jego deinstalacji

 


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)

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

  • Access Token (klucz)

  • ID organizacji

oraz

  • Access Token do Geowidget

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)


 

Instalacja wtyczki

Zaloguj 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

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

Autoryzacja

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

  • Sklep używa niestandardowego checkoutu → włącz gdy używasz niestandardowego checkout’u w swoim sklepie (do wyboru są moduły)

  • Pokaż pole na adres email i nr telefonu → dane dot. nr tel i email zaciągają się z danych adresowych, w razie potrzeby wykorzystania pól przy wyborze Paczkomat® można je włączyć w tym miejscu

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)

 


 

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 kontoAPI Geowidet (podając domenę sklepu)

 


 

 

Dane nadawcy

Formularz służy do zbierania informacji potrzebnych do wysyłki paczek. Gromadzi on podstawowe dane nadawcy

 

Istnieje możliwość automatycznego wypełnienia pól formularza danymi, które zostały wcześniej zdefiniowane jako dane organizacji w konfiguracji sklepu. W tym celu należy kliknąć w przycisk „Uzupełnij na podstawie danych organizacji”


 

Metody nadania / Ubezpieczenie

Pozwala na konfigurację domyślnych Punktów Odbioru/Paczkomat® i ustawienia domyślnej wartości ubezpieczenia

 

Pole formularza

Opis

Domyślny punkt odbioru

Wybór domyślnego punktu odbioru, z którego będą nadawane przesyłki

Domyślny Paczkomat

Ustawienie domyślnego Paczkomatu, do którego będą kierowane przesyłki

Domyślny POP

Wprowadzenie domyślnego Punktu Obsługi Paczek (POP), z którego będą nadawane przesyłki

Domyślny numer referencyjny przesyłki

Automatyczne przypisanie numeru referencyjnego do przesyłki, zwykle numer zamówienia

Domyślna wartość ubezpieczenia

Ustawienie domyślnej kwoty ubezpieczenia dla każdej przesyłki

  • Ustawiając kwotę 0 - paczki nie będą ubezpieczone

  • Ustawiając puste pole - w ubezpieczeniu będzie pojawiać się kwota pobierana z wartości zamówienia

  • Ustawiając konkretną kwotę - przypisujemy ją do każdej z przesyłek


 

Usługi dostaw - tworzenie metod dostawy

W tym miejscu możesz skonfigurować metody dostaw, jakie pojawią się w Twoim sklepie

 

Metody dostawy

Opis

Metody dostawy

Opis

InPost Paczkomat® 24/7

Dostawa przesyłki do punktów odbioru Paczkomat®/PaczkoPunkt

InPost Kurier Standard

Dostawa przesyłki na adres podany przez klienta

Usługa dostępna tylko dla klienta biznesowego (umowa)

InPost Kurier C2C

Dostawa przesyłki na adres podany przez klienta

Usługa dostępna dla klienta detalicznego - prepaid (stawki zgodnie z cennikiem na stronie InPost.pl

InPost Paczka w Weekend (do wybrania w usłudze (InPost Paczkomat® 24/7)

Dostawa przesyłki do punkt odbioru Paczkomat® w weekend dostępnego 24/7

InPost SmartCourier

Dostawa przesyłki na adres podany przez klienta. Usługa dedykowana dostawom towarów wymagających doręczenia osobistego z potwierdzeniem danych odbiorcy. Proces doręczenia wymaga weryfikacji adresata za pomocą takich danych jak imię, nazwisko, pełnoletniość, a w przypadku, gdy doręczenie danej kategorii towarów wymaga trzeźwości odbiorcy przesyłki, zostanie to również zweryfikowane.


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

 

 

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

 

 

 

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®

  1. 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

  2. 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

 

 


Paczka w Weekend

W celu udostępniania usługi Paczka w Weekend należy dodać nową metodę dostawy.

Należy wejść do konfiguracji modułu i wybrać Usługi Dostawy → Dodaj nowy

 

Konfigurujemy metodę (zaznaczając Paczka w Weekend):

 

Następnie ustawiamy dostępność usługi w checkoucie w konkretne dni i godziny:

Usługa pojawia się automatycznie w checkoucie w dniach ustawionych powyżej


Punkty odbioru

Pozwala na dodanie/usuwanie/edycję Punktów Odbioru

 

 

Pole formularza

Opis

Nazwa

Wprowadź nazwę punktu odbioru, która będzie wyświetlana w systemie

Godziny funkcjonowania

Wprowadź godziny, w których punkt odbioru jest dostępny dla nadawania i odbierania przesyłek

E-mail

Podaj adres e-mail przypisany do punktu odbioru, na który będą wysyłane powiadomienia i inne istotne informacje

Telefon

Wprowadź numer telefonu kontaktowego do punktu odbioru

Ulica

Wprowadź nazwę ulicy, na której znajduje się punkt odbioru

Numer budynku

Wprowadź numer budynku, w którym znajduje się punkt odbioru

Kod pocztowy

Wprowadź kod pocztowy dla lokalizacji punktu odbioru

Miejscowość

Wprowadź nazwę miejscowości, w której zlokalizowany jest punkt odbioru.


Checkout

Pozwala na dostosowanie widoczności i funkcji niektórych pól w procesie zamówienia (checkout)

 

 

Pole formularza

Opis

Sklep używa niestandardowego checkoutu

Włącz gdy używasz niestandardowego checkout’u w swoim sklepie (do wyboru są moduły)

Pokaż pole na adres e-mail

Pozwala włączyć pole do wprowadzenia adresu e-mail w procesie checkoutu. Dane dotyczące adresu e-mail są domyślnie zaciągane z danych adresowych, jednak w przypadku wyboru Paczkomatu® możesz włączyć to pole tutaj, jeśli jest potrzebne

Pokaż pole na numer telefonu

Umożliwia wyświetlenie pola do wprowadzenia numeru telefonu podczas składania zamówienia. Dane dotyczące numeru telefonu są domyślnie pobierane z danych adresowych, ale możesz aktywować to pole w tym miejscu, jeśli jest konieczne przy wyborze Paczkomatu®


 

Zamówienia

 

Zakładka pozwala na dodatkowe ustawienia dotyczące złożonych zamówień

 

  1. Dodaje informację o wybranym punkcie odbioru w wiadomości email

  2. Zmienia status zamówienia po wydrukowaniu przesyłki (otwiera się lista z dostępnymi statusami)

  3. Zmienia status zamówienia po zmianie statusu przesyłki na dostarczony. Po włączeniu tej opcji należy wybrać z listy status zamówienia. Lista zależna jest od indywidualnej konfiguracji sklepu

CRON - aktualizacji statusów przesyłek w module
  • Wymaga utworzenia zadania CRON, które będzie aktualizować status przesyłek (hosting)

 

 

 


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:

  1. Przechodzimy do konfiguracji wtyczki Moduły → InPost Wysyłka → zakładka Usługi dostawy

  2. Klikamy Dodaj nowy

  3. Wybieramy usługę InPost Paczkomat® Paczka Ekonomiczna

 

  1. Uzupełniamy standardowe dane dot. wysyłki i Kod wariantu , który został podany na umowie

  2. 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

 

Tworzenie przesyłki w zamówieniu

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:

 


 

Tworzenie zlecenia podjazdu kuriera

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

 

W zakładce Przesyłki procesowane pokazują się przesyłki z metodą nadania Kurier

Przy każdej przesyłce na końcu jest możliwość wydrukowania etykiety, etykiety zwrotnej czy utworzenie zlecenia odbioru przesyłki

 

 

Przy tworzeniu zlecenia odbioru mamy możliwość wyboru punktu odbioru


Usuwanie przesyłek z Przesyłki Procesowane

Jest możliwość usunięcia przesyłek, które nie zostały nadane z widoku w panelu Przesyłki Procesowane. Pomoże to uporządkować widok na aktualne zamówienia.

Klikając w akcje na końcu każdej przesyłki pojawia się opcja Usuń

 

 


 

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)

 

 


 

 

Rozwiązania problemów

Błąd SSL certificate problem: certificate has expired

→ cURL error 60: SSL certificate problem: certificate has expired

Po stronie hostingu należy zaktualizować ca-certificates (komenda ca-certificates curl openssl)
Niekiedy może też wystarczyć restart php'a na serwerze - php może trzymać w cache'u stary certyfikat przed zmiany.


Nie działa przycisk “Wybierz Paczkomat”

Powodem może być błędnie podany URL do sklepu podczas tworzenia tokenu do Geowidget w Manager Paczek. W momencie gdy URL jest błędny mapa się nie otworzy.


Geowidget - brak dostępu

 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 niepoprawnego adresu URL sklepu.

 

 


 

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