Jak dodać integrację z InPost w PrestaShop to jedno z najczęstszych pytań właścicieli sklepów, którzy chcą przyspieszyć wysyłkę, odciążyć obsługę zamówień i zaoferować klientom Paczkomaty oraz kuriera. Dobra wiadomość: dziś da się to zrobić szybko i bez pisania własnego kodu. Wystarczy poprawnie dobrać moduł, zdobyć klucz API i przejść przez kilka prostych kroków konfiguracyjnych. Poniżej znajdziesz przewodnik, który przeprowadzi Cię przez cały proces – z praktycznymi wskazówkami i pułapkami, o których rzadko mówi dokumentacja.

Jak dodać integrację z InPost w PrestaShop — krok po kroku

Zacznij od wyboru odpowiedniego modułu, przygotuj dane dostępowe z InPost i skonfiguruj metody dostawy tak, by działały płynnie od koszyka po nadanie paczki.

• Wybierz moduł InPost kompatybilny z Twoją wersją PrestaShop (najczęściej 1.7.x lub 8.x).
• Uzyskaj dostęp do panelu InPost (ShipX/Manager) i wygeneruj klucz API.
• Zainstaluj moduł i wprowadź dane uwierzytelniające.
• Dodaj przewoźników (Paczkomaty, Kurier InPost), skonfiguruj cenniki i mapę punktów.
• Przetestuj cały proces na środowisku sandbox, a dopiero potem przełącz na produkcję.

Dzięki temu unikniesz błędów w trakcie realnych zamówień i zyskasz pełną kontrolę nad logistyką.

Co przygotować przed instalacją

Dobra organizacja na starcie oszczędzi Ci nerwów przy konfiguracji i testach.

• Konto firmowe w panelu InPost (ShipX/Manager) wraz z aktywną umową.
• Klucz API (token) oraz – jeśli to dotyczy – ID organizacji/nadawcy.
• Informacje o paczkach: typowe wagi, gabaryty, wymiary opakowań.
• Politykę kosztów dostawy (np. próg darmowej wysyłki, stawki strefowe).
• Spis integracji w sklepie (checkout, płatności, one page checkout), aby sprawdzić kompatybilność.

Warto też przygotować testowe zamówienia i adresy, by szybko zweryfikować różne scenariusze dostaw.

Instalacja modułu InPost w PrestaShop

Najprościej skorzystać z oficjalnego modułu lub renomowanego dodatku ze sklepu PrestaShop Addons.

• W panelu PrestaShop przejdź do: Moduły > Menedżer modułów > Dodaj nowy.
• Wgraj paczkę ZIP modułu lub wyszukaj go w katalogu.
• Po instalacji wejdź w Ustawienia i przejdź do konfiguracji.

Jeżeli korzystasz z multi-store, zwróć uwagę, że każda witryna może wymagać osobnej konfiguracji przewoźników i kluczy.

Konfiguracja klucza API i środowiska

Wprowadź tokeny i wybierz środowisko testowe (sandbox) lub produkcyjne.

• Wklej klucz API oraz ewentualnie ID organizacji/nadawcy z panelu InPost.
• Ustaw środowisko: na start rekomendowane jest sandbox, by bezpiecznie testować.
• Zapisz ustawienia i sprawdź połączenie (większość modułów oferuje przycisk “Test połączenia”).

Jeżeli test wypada negatywnie, najczęściej problem leży w uprawnieniach tokena lub błędnym środowisku (sandbox vs prod).

Dodanie przewoźników i metod dostawy

Skonfiguruj Paczkomaty 24/7, kuriera oraz opcje specjalne, jeśli oferujesz weekendy czy pobranie.

• Włącz metody: Paczkomaty, Kurier InPost, ewentualnie Paczka w Weekend, COD (pobranie).
• Powiąż metody z krajami/strefami w PrestaShop (Międzynarodowe > Lokacje > Strefy).
• Zdefiniuj zakresy wagi/ceny i przypisz stawki.
• Ustal etykiety i opisy, które zobaczy klient przy checkout.

Dobrą praktyką jest rozróżnienie nazw: “Paczkomaty InPost” vs “Kurier InPost”, by uniknąć nieporozumień w koszyku.

Mapa Paczkomatów i checkout

Interaktywna mapa punktów odbioru to klucz do wysokiej konwersji.

• Włącz widget mapy, aby klient mógł wybrać konkretny Paczkomat.
• Sprawdź kompatybilność z Twoim checkoutem (np. One Page Checkout) i motywem.
• Zadbaj, aby wybrany punkt zapisywał się przy zamówieniu (pole statusu/log adresu).

Jeśli mapa nie wyświetla się lub nie zapisuje punktu, zwykle winny jest konflikt JS z innym modułem checkout lub brak klucza mapy w ustawieniach modułu.

Generowanie etykiet i nadawanie

Automatyczne tworzenie przesyłek z zamówienia oszczędza realnie czas przy kompletacji.

• Określ, kiedy tworzyć przesyłkę: po opłaceniu, ręcznie, czy zbiorczo.
• Skonfiguruj format etykiet (PDF/ZPL), domyślne wymiary i gabaryty.
• Wybierz metodę podjazdu kuriera lub zanoszenie do punktu.
• Zmapuj statusy PrestaShop na statusy InPost, by automaty zachowywały się przewidywalnie.

Warto włączyć powiadomienia e-mail/SMS z InPost – klienci docenią jasną informację o śledzeniu paczki.

Testy, automatyzacja i webhooks

Zanim przełączysz sklep na produkcję, przetestuj pełną ścieżkę – od koszyka po śledzenie.

• Złóż testowe zamówienie, wybierz różne metody (Paczkomat, Kurier, pobranie).
• Wygeneruj przesyłkę i etykietę, sprawdź numer śledzenia i powiadomienia.
• Sprawdź automaty: tworzenie przesyłek, masowe generowanie, zmiana statusów.
• Jeżeli moduł obsługuje webhooks (aktualizacje statusów z InPost), włącz je i zweryfikuj.

Najczęstszy błąd testów to mieszanie środowisk: zamówienie powstało na produkcji, a moduł działa w sandbox. Trzymaj się jednej ścieżki i czyść cache.

Cenniki, strefy i logika kosztów wysyłki

Przemyśl koszty, bo to one często decydują o porzuceniu koszyka.

• Zdefiniuj strefy i kraje, w których dostępne będą poszczególne metody.
• Ustal progi darmowej dostawy, np. od 199 zł Paczkomat gratis.
• Wprowadź reguły zależne od wagi lub wartości koszyka.
• Pamiętaj o gabarytach: zbyt duże paczki nie przejdą do Paczkomatów – wtedy wyświetlaj tylko kuriera.

Dobrą praktyką jest transparentny komunikat przy wyborze metody: “Limit wymiarów dla Paczkomatów: …”. To ograniczy błędy i reklamacje.

Zwroty i paczkomaty zwrotne

Zadbaj o prosty proces zwrotu – to buduje zaufanie i zwiększa powracalność klientów.

• Sprawdź, czy moduł wspiera generowanie etykiet zwrotnych.
• Rozważ włączenie automatycznego linku do zwrotu w mailach posprzedażowych.
• Ustal jasny regulamin zwrotów i terminy.

Możliwość nadania zwrotu w Paczkomacie to często “mały wielki” czynnik przewagi konkurencyjnej.

Najczęstsze problemy i szybkie rozwiązania

Większość kłopotów wynika z błędnych ustawień lub konfliktów modułów.

• Nie działa mapa Paczkomatów: sprawdź klucz API mapy/Google i konflikt JS w checkout.
• Brak numeru punktu w zamówieniu: upewnij się, że pole jest mapowane i zapisywane przez moduł.
• Błąd 401/403 przy tworzeniu przesyłki: najczęściej token, uprawnienia lub złe środowisko.
• Etykieta się nie generuje: brak wymiarów/wagi lub niepoprawny typ usługi.
• Podwójne metody w koszyku: wyłącz duplikaty przewoźników lub stare moduły wysyłkowe.

Jeśli masz cache/CCC aktywne, po każdej większej zmianie czyść pamięć podręczną – to naprawdę rozwiązuje wiele pozornie “magicznych” problemów.

Bezpieczeństwo, dane i zgodność z RODO

Przetwarzanie adresów i telefonów klientów wymaga dbałości o bezpieczeństwo.

• Korzystaj wyłącznie z połączeń szyfrowanych i trzymaj tokeny poza repozytoriami.
• Ogranicz dostęp do modułu tylko dla zaufanych ról w panelu.
• Informuj w polityce prywatności o przekazaniu danych do przewoźnika.

W razie audytu dobrze mieć spisaną procedurę usuwania danych i retencji etykiet.

Dobre praktyki i optymalizacja procesu

Małe usprawnienia potrafią znacząco skrócić czas obsługi paczek.

• Predefiniowane paczki: zrób zestaw gabarytów, by jednym kliknięciem wybierać rozmiar.
• Skanery i ZPL: drukuj etykiety na żywo, bez pobierania PDF.
• Reguły automatyczne: zamówienia powyżej X zł → kurier, poniżej → Paczkomat.
• Batch processing: generuj etykiety zbiorczo dla całej listy zamówień.
• SLA i cut-off: komunikuj godzinę graniczną nadania, np. “Zamów do 15:00 – wyślemy dziś”.

Klienci kochają przewidywalność. Jasna informacja o czasie dostawy i formie nadania podnosi konwersję.

Podsumowanie

Integracja z InPost w PrestaShop nie musi być skomplikowana – kluczem jest właściwy moduł, poprawna konfiguracja i testy.

Zacznij od przygotowania danych (konto InPost, token, gabaryty), zainstaluj moduł i dokładnie skonfiguruj przewoźników oraz mapę Paczkomatów. Przetestuj pełny przepływ w sandbox, sprawdź automaty i powiadomienia, a dopiero potem przełącz się na produkcję. Zadbaj o przejrzyste cenniki, proste zwroty i bezpieczeństwo danych. Dzięki temu całe doświadczenie – od wyboru punktu odbioru po śledzenie przesyłki – będzie dla klienta intuicyjne, a dla Twojego zespołu szybkie i bezbłędne.

Najważniejsze? Stawiaj na prostotę i konsekwencję: jedna mapa, jasne nazwy metod, dobrze opisane ograniczenia gabarytów i logicznie ułożone cenniki. Z takim zestawem integracja z InPost po prostu działa – i zaczyna realnie oszczędzać Twój czas już od pierwszego dnia.