[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.23.0- 08.04.2024r)

https://inpost.pl/sites/default/files/2024-04/PrestaShop-1.7.0-1.7.8-ver-1.23.0.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.8.0- 08.04.2024r)

https://inpost.pl/sites/default/files/2024-04/PrestaShop-8.ver-2.8.0.zip

Poprzednia wersja 2.7.1:

https://www.szybkiplik.pl/FZ4uU2Yu2B

 

Changelog:

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

> 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)

 


 

 

Usługi dostaw

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


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

 

 

 


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)

 

 


 

 

Częste problemy

 

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.

 


 

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