[PL] PrestaShop 1.7 / 8.X
- Michał Machowski
- Paweł Milewski
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ń
Na tej stronie
- 1 1.7+
- 2 8.0+
- 3 Changelog - rozwiń
- 4 Autoryzacja
- 5 Instalacja wtyczki
- 6 Konfiguracja wtyczki
- 6.1 Zakładki
- 6.1.1 Autoryzacja
- 6.1.2 Geowidget
- 6.1.3 Dane nadawcy
- 6.1.4 Metody nadania / Ubezpieczenie
- 6.1.5 Usługi dostaw - tworzenie metod dostawy
- 6.1.6 Pozycjonowanie usług dostawy w koszyku
- 6.1.7 Szybkie Zwroty
- 6.1.8 Paczka w Weekend
- 6.1.9 Punkty odbioru
- 6.1.10 Checkout
- 6.1.11 Zamówienia
- 6.2 InPost Paczkomat® Paczka Ekonomiczna
- 6.1 Zakładki
- 7 Obsługa zamówień/wysyłki
- 8 Produkty - szablony
- 9 Rozwiązania problemów
- 10 Kontakt
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
InPost - Manager paczek > zakładka Moje konto > API
Środowisko testowe (Sandbox)
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) |
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)
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
|
Usługi dostaw - tworzenie metod dostawy
W tym miejscu możesz skonfigurować metody dostaw, jakie pojawią się w Twoim sklepie
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®
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
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 |
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ń
Dodaje informację o wybranym punkcie odbioru w wiadomości email
Zmienia status zamówienia po wydrukowaniu przesyłki (otwiera się lista z dostępnymi statusami)
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:
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
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