Jak skonfigurować InPost w PrestaShop

Ten poradnik przeprowadzi cię krok po kroku przez pełną konfigurację usług InPost w sklepie PrestaShop – od przygotowań i instalacji modułu, przez ustawienie metod dostawy i mapy Paczkomaty, po generowanie etykiety, śledzenie przesyłek i skuteczną automatyzacja. Dowiesz się, jak zdobyć klucze API, wybrać środowisko sandbox, włączyć metody płatności i wagowe progi cen, skonfigurować przewoźnik oraz wykorzystać webhooki do szybkiej integracja statusów i powiadomień dla klientów.

Wymagania i przygotowanie do pracy

Konto i dostęp do systemów

Aby rozpocząć, potrzebujesz dwóch zestawów dostępów: administracyjnego logowania do panelu sklepu PrestaShop oraz konta w menedżerze nadawczym InPost (np. Manager/ShipX). W panelu InPost utwórz organizację lub potwierdź, że jesteś przypisany do właściwej organizacji firmowej. Zadbaj o pełne dane wysyłkowe: nazwa firmy, NIP, adres nadawczy, numery kontaktowe, adres e-mail do powiadomień.

Klucze dostępowe i środowisko

W panelu InPost wygeneruj dane do komunikacji przez API: token dostępu/klucz, ewentualny identyfikator organizacji oraz sekret. Na początek wybierz środowisko sandbox do testów – pozwala ono tworzyć próbne zlecenia bez realnych nadawczych kosztów. Zanotuj: adresy endpointów, format nagłówków autoryzacyjnych i ograniczenia stawek (często testowe etykiety mają ograniczone scenariusze).

Konfiguracja firmy i adresów

Sprawdź, czy adres nadawczy jest poprawny i zgodny z umową (ulica, kod pocztowy, miejscowość). Dodaj alternatywny adres nadania, jeżeli korzystasz z wielu magazynów. Włącz powiadomienia e-mail/SMS dla klientów – to ułatwia komunikację o zmianach statusów przesyłek i odbiorze w Paczkomacie.

Uprawnienia i bezpieczeństwo

W panelu InPost przejrzyj role użytkowników i nadaj tylko niezbędne uprawnienia. Włącz logowanie zmian (audit log) i – jeśli to możliwe – ogranicz dostęp do kluczy na poziomie IP albo generuj osobne klucze per środowisko. W sklepie ustaw silne hasła i dwuetapową weryfikację dla konta administratora.

Plan taryfowy i typy usług

Upewnij się, że twój plan obejmuje interesujące cię usługi: Odbiór w Paczkomacie, Kurier do drzwi, pobranie (COD), przesyłki weekendowe, ubezpieczenie. Gdy znasz asortyment i gabaryty, przygotuj matrycę wymiarów, wag i cen – te parametry przydadzą się do konfiguracji metod dostawy i progów kosztów w koszyku.

Instalacja i podłączenie modułu InPost

Wybór modułu i zgodność wersji

Najpewniejszym rozwiązaniem jest oficjalny moduł od InPost lub uznanego dostawcy na PrestaShop Addons. Sprawdź kompatybilność z wersją sklepu (np. 1.7.x, 8.x), wsparcie dla wielu magazynów i wielosklepowości, a także listę funkcji: generowanie etykiet, mapa Paczkomatów, wysyłki kurierem, zwroty, przesyłki międzynarodowe i webhooki statusów.

Instalacja z poziomu panelu

• Wejdź w Moduły i Usługi → Dodaj nowy moduł.
• Wgraj paczkę ZIP z modułem lub zainstaluj bezpośrednio z marketplace.
• Po instalacji kliknij Konfiguruj i przejdź do ustawień połączenia z InPost.

Łączenie z API InPost

Wprowadź tokeny/klucze API, identyfikator organizacji i wybierz środowisko: testowe sandbox lub produkcyjne. Włącz logowanie błędów (debug), aby w razie problemów szybko zidentyfikować niepoprawne nagłówki, brak uprawnień lub błędy walidacji paczek. Zapisz ustawienia i wykonaj test połączenia z endpointem zdrowia (healthcheck).

Ustawienia globalne modułu

• Waluty i jednostki: potwierdź format waluty sklepu i jednostkę wagi (kg) – to wpływa na walidację gabarytów.
• Domyślne wymiary paczek: zdefiniuj rozmiary używane przy produktach bez indywidualnych wymiarów.
• Strefy i kraje: przypisz kraje obsługiwane przez InPost i odpowiednie strefy geograficzne PrestaShop.
• Dzienny cutoff: ustaw godzinę graniczną nadania, by komunikować realne terminy dostawy.

Webhooki i powiadomienia

Skonfiguruj webhooki w panelu InPost, wskazując adres URL w sklepie (generowany zwykle przez moduł). Włącz nasłuchiwanie zmian statusów: utworzenie, nadanie, w doręczeniu, awizacja, odbiór z Paczkomatu, doręczono, zwrot do nadawcy. Zabezpiecz endpoint podpisem lub sekretem i sprawdź, czy serwer przyjmuje połączenia HTTPS oraz zwraca kod 200.

Konfiguracja metod dostawy i mapy Paczkomatów

Definiowanie przewoźnika i usług

W PrestaShop każda metoda dostawy to osobny przewoźnik. Upewnij się, że moduł utworzył podstawowe typy: Odbiór w Paczkomaty, Kurier InPost, Kurier z pobraniem, Odbiór w punkcie partnerskim (jeśli dostępny). Nazwy powinny być zrozumiałe i krótkie, z ikoną InPost w miniaturze dla spójności z koszykiem.

Cenniki, progi i reguły koszyka

• Ustal progi darmowej dostawy według wartości koszyka lub kategorii produktów.
• Skonfiguruj przedziały wagowe i gabarytowe – określ, które gabaryty są dostępne przy danej metodzie.
• Zdefiniuj różne ceny dla stref (np. Polska, UE) oraz dopłaty dla obszarów trudno dostępnych.
• Połącz metody dostawy z formami płatności: włącz COD tylko przy Kurier/Paczkomat z pobraniem.

Widget mapy Paczkomatów

Włącz mapę wyboru punktu – widget zwykle ładowany w kroku dostawy koszyka. Sprawdź, czy:

• Mapa wyświetla się poprawnie, język i waluta są zgodne z ustawieniami sklepu.
• Kliknięty Paczkomat zapisuje się w zamówieniu (ID punktu + adres) i jest widoczny w podsumowaniu.
• Widget działa na urządzeniach mobilnych i nie koliduje z innymi skryptami (np. optymalizacją RUM).

Rozważ ustawienie domyślnej lokalizacji mapy na podstawie geolokalizacji IP lub ostatniego adresu klienta. Dla SEO i szybkości wczytywania użyj lazy loading oraz skompresowanych zasobów JS/CSS modułu.

Parametry paczek i ograniczenia

Przypisz produktom wymiary i wagi, aby moduł mógł obliczyć dopuszczalny gabaryt. Zdefiniuj zasady łączenia produktów w jedną paczkę oraz maksymalną liczbę paczek na zamówienie. Jeżeli sprzedajesz produkty delikatne lub długie, dodaj reguły wykluczające Paczkomat i wymuszające kuriera.

Dodatkowe opcje: ubezpieczenie, weekend, pobranie

Włącz ubezpieczenie przesyłki powyżej określonej wartości, a koszt dolicz jako stały lub procentowy. Dla sobót i niedziel aktywuj usługę weekendową, jeśli jest dostępna w twojej umowie. Płatność przy odbiorze powiąż tylko z wybranymi metodami płatniczymi i ustaw limity kwot pobrania zgodnie z regulaminem InPost.

Obsługa zamówień, etykiety, automatyzacja i testy

Przepływ pracy od zamówienia do nadania

Standardowy proces obejmuje: złożenie zamówienia, przypisanie metody dostawy, weryfikację danych paczki, utworzenie zlecenia wysyłki w InPost, generowanie etykiety, ewentualny manifest, przekazanie paczek kurierowi lub do Paczkomatu nadawczego. Zadbaj o spójność statusów – w PrestaShop oznacz zamówienie jako Przygotowanie w toku w momencie wygenerowania etykiety i Nadane po zleceniu odbioru/umieszczeniu w skrytce.

Generowanie i drukowanie etykiet

• W zamówieniu kliknij Generuj etykietę – moduł utworzy przesyłkę i zwróci PDF/ZPL.
• Skonfiguruj format (A4/A6) zgodny z drukarką etykiet lub biurową.
• Włącz masowe generowanie dla wielu zamówień i pobieranie paczki zbiorczej PDF.
• Sprawdź, czy numer śledzenia zapisuje się w zamówieniu i wysyła do klienta.

Manifesty i odbiory

Jeżeli korzystasz z odbioru kuriera, skonfiguruj harmonogram odbiorów lub zamawiaj odbiór ad hoc z panelu. Manifest (zestawienie przesyłek) drukuj raz dziennie i przekazuj kurierowi. Dla nadania w Paczkomacie upewnij się, że kody nadawcze/QR są czytelne i że gabaryt mieści się w wybranej skrytce.

Śledzenie, statusy i powiadomienia

Dzięki poprawnie ustawionym webhooki statusy przesyłek zsynchronizują się automatycznie. Wysyłaj e-maile/SMS do klientów w kluczowych momentach: utworzenie etykiety, doręczenie do Paczkomatu, awizacja, doręczono. W PrestaShop mapuj każdy status z InPost na odpowiadający mu status zamówienia, aby panel obsługi klienta odzwierciedlał realny stan.

Zwroty i wymiany

Włącz proces zwrotów RMA w sklepie i powiąż go z etykietą zwrotną InPost (jeśli moduł wspiera generowanie zwrotów). Udostępnij klientowi link do wyboru Paczkomatu zwrotnego, automatycznie uzupełniając dane paczki. W polityce zwrotów zaznacz terminy, wyłączenia (np. produkty personalizowane) i koszty zwrotu.

Automatyzacja i reguły

Ustaw reguły automatyczne: generowanie etykiet po opłaceniu (dla płatności online), przypisanie konkretnego Paczkomatu dla zamówień click&collect, rozdzielanie paczek przy przekroczeniu gabarytu. Zaplanuj cron do synchronizacji statusów, czyszczenia logów i rekonstrukcji stawek dostawy po zmianie cennika. Zadbaj o mechanizmy retry dla nieudanych połączeń i alerty e-mail.

Testy w środowisku sandbox

• Sprawdź każdy wariant: Paczkomat, Kurier, COD, ubezpieczenie, weekend.
• Zweryfikuj poprawność widgetu mapy, zapis ID punktu oraz prezentację danych w e-mailach.
• Wygeneruj etykiety, przetestuj anulowanie i ponowne tworzenie wysyłki.
• Uruchom testowe webhooki – czy sklep zwraca 200 i zmienia statusy zamówień.

Najczęstsze problemy i jak je rozwiązać

• Błąd autoryzacji: sprawdź token, środowisko (test/produkcja), nagłówki i uprawnienia organizacji.
• Mapa Paczkomatów nie działa: konflikt JS/CSS, brak klucza widgetu, błędny region lub blokada cookies.
• Brak stawek w koszyku: niedopasowane progi wagowe/cenowe lub nieprzypisana strefa do przewoźnika.
• Etykieta odrzucona: gabaryt poza zakresem, brak numeru telefonu odbiorcy, niepoprawny kod pocztowy.
• Webhook nie przychodzi: firewall, brak HTTPS, błąd certyfikatu, niepoprawny sekret podpisu.

Wydajność i skalowanie

Przy większych wolumenach zastosuj kolejkowanie żądań do API i masową obsługę etykiet. Zadbaj o caching konfiguracji (listy punktów, cenniki), ogranicz liczbę zapytań w koszyku i monitoruj czas odpowiedzi. W raportach logów śledź współczynnik błędów oraz powtórne próby nadania.

Przeniesienie na produkcję

Po pomyślnych testach w sandbox przełącz moduł na środowisko produkcyjne, wprowadź produkcyjne klucze i wykonaj testowe zamówienie z realną płatnością. Zablokuj dostęp do środowiska testowego, aby uniknąć przypadkowych etykiet. Przeszkol zespół, przygotuj checklistę dzienną: generowanie etykiet, manifest, odbiór, monitoring statusów.

Dobre praktyki operacyjne

• Waliduj numer telefonu i e-mail odbiorcy już w koszyku.
• Komunikuj ETA i cutoff zamówień na kartach produktowych i w koszyku.
• Używaj jasnych nazw usług, ikon i krótkich opisów korzyści.
• Wdrażaj wersjonowanie modułu i testuj aktualizacje na kopii sklepu.
• Regularnie eksportuj raporty nadawcze, reklamacje i wskaźniki doręczeń.

Integracje poboczne i rozszerzenia

Jeżeli korzystasz z ERP/WMS, połącz je z modułem przez natywne wtyczki lub webhooki. Rozszerz koszyk o reguły marketingowe: darmowa dostawa przy określonej wartości zamówienia, cross-sell akcesoriów zwiększających gabaryt (z ostrzeżeniem o zmianie kosztu), dynamiczne rekomendacje najbliższego Paczkomatu na podstawie kodu pocztowego.

Aspekty prawne i doświadczenie klienta

Upewnij się, że regulamin, polityka zwrotów i koszty dostawy są czytelne i łatwo dostępne. W e-mailach transakcyjnych umieszczaj link do śledzenia przesyłki, adres Paczkomatu i instrukcje odbioru. W razie opóźnień automatycznie oferuj przeprosiny lub kupon rabatowy, aby zmniejszyć liczbę zgłoszeń do BOK.