Integracja PrestaShop z InPost

Sprzedajesz przez PrestaShop i chcesz wygodnie obsługiwać Paczkomaty, kuriera, etykiety oraz dane przesyłek z poziomu sklepu? Integracja PrestaShop z InPost pozwala uprościć proces wysyłki, ograniczyć ręczne przepisywanie danych i zapewnić klientom wygodny wybór punktu odbioru.

Integracja PrestaShop z InPost jest jedną z najważniejszych integracji logistycznych dla sklepów internetowych działających w Polsce. Dla wielu klientów Paczkomat jest podstawową metodą dostawy, dlatego problem z wyborem punktu odbioru, generowaniem etykiety albo przekazywaniem danych przesyłki może bezpośrednio wpływać na sprzedaż i obsługę zamówień.

W praktyce integracja z InPost może obejmować kilka różnych elementów: wybór Paczkomatu w koszyku, obsługę kuriera, generowanie etykiet, przekazywanie danych odbiorcy, śledzenie przesyłek, automatyzację statusów oraz połączenie z BaseLinkerem lub innym systemem obsługi zamówień.

Samo zainstalowanie modułu nie zawsze wystarcza. Najważniejsze jest poprawne dopasowanie integracji do procesu sprzedaży: metod dostawy, płatności, statusów zamówień, gabarytów paczek, pobrań, punktów odbioru i sposobu generowania etykiet.

Co daje integracja PrestaShop z InPost?

Poprawnie skonfigurowana integracja pozwala ograniczyć ręczną pracę przy obsłudze wysyłek. Zamiast przepisywać dane klienta do Managera Paczek albo innego panelu, można generować przesyłki bezpośrednio na podstawie zamówień ze sklepu.

Integracja może obejmować między innymi:

• wybór Paczkomatu lub PaczkoPunktu przez klienta,
• aktualną mapę punktów odbioru,
• obsługę kuriera InPost,
• generowanie etykiet nadawczych,
• automatyczne przenoszenie danych odbiorcy z zamówienia,
• obsługę przesyłek za pobraniem,
• ustawianie gabarytów i wymiarów paczek,
• przekazywanie numeru przesyłki do zamówienia,
• zmianę statusu zamówienia po wygenerowaniu etykiety,
• integrację z BaseLinkerem,
• komunikację przez API ShipX,
• konfigurację usług dodatkowych, np. Paczka w Weekend,
• ograniczenie ręcznego przepisywania danych.

Największą korzyścią jest skrócenie procesu realizacji zamówienia. Jeżeli sklep wysyła kilkanaście, kilkadziesiąt albo kilkaset paczek miesięcznie, ręczne generowanie etykiet szybko staje się nieefektywne i podatne na błędy.

Kiedy warto wdrożyć integrację InPost w PrestaShop?

Integracja ma sens praktycznie w każdym sklepie, który regularnie wysyła zamówienia przez InPost. Szczególnie warto ją wdrożyć, gdy:

• klienci często wybierają Paczkomaty,
• ręcznie przepisujesz dane do Managera Paczek,
• obsługujesz dużą liczbę zamówień,
• chcesz generować etykiety z poziomu sklepu,
• chcesz ograniczyć błędy w danych adresowych,
• potrzebujesz obsługi pobrań,
• masz różne gabaryty paczek,
• korzystasz z kilku metod dostawy,
• sprzedajesz także przez Allegro lub marketplace,
• obsługujesz zamówienia przez BaseLinker,
• po aktualizacji PrestaShop moduł InPost przestał działać poprawnie.

Jeżeli sklep ma kilka zamówień miesięcznie, prosta konfiguracja może wystarczyć. Jeżeli jednak wysyłka jest codziennym procesem, warto zadbać o stabilną integrację, testy i prawidłowe powiązanie metod dostawy ze statusami zamówień.

Integracja przez moduł, BaseLinker czy API ShipX?

Nie zawsze najlepszym rozwiązaniem jest ten sam model integracji. Wybór zależy od tego, jak sklep obsługuje zamówienia i jak bardzo zautomatyzowany ma być proces wysyłki.

Gotowy moduł InPost do PrestaShop

Gotowy moduł jest dobrym wyborem, gdy sklep chce obsługiwać InPost bezpośrednio z panelu PrestaShop. Taki wariant sprawdza się przy prostszym procesie sprzedaży, w którym zamówienia są realizowane głównie z panelu sklepu.

Zalety:

• szybkie wdrożenie,
• obsługa wyboru Paczkomatu,
• możliwość generowania etykiet,
• mniej ręcznego przepisywania danych,
• dobra opcja dla sklepów obsługujących zamówienia w PrestaShop.

Ograniczenia:

• zależność od kompatybilności modułu z wersją PrestaShop,
• możliwe konflikty z motywem lub koszykiem,
• problemy po aktualizacji PHP, PrestaShop albo modułu,
• ograniczona elastyczność przy nietypowych procesach,
• konieczność testowania z różnymi metodami płatności i dostawy.

InPost przez BaseLinker

BaseLinker może być lepszym rozwiązaniem, gdy sklep sprzedaje w wielu kanałach: PrestaShop, Allegro, Amazon, Ceneo albo innych marketplace’ach. W takim modelu PrestaShop nie musi być głównym miejscem obsługi wysyłek — zamówienia mogą być realizowane w BaseLinkerze.

Ten wariant ma sens, gdy:

• obsługujesz zamówienia z kilku źródeł,
• chcesz generować etykiety z jednego panelu,
• używasz automatycznych akcji,
• chcesz łatwo drukować etykiety zbiorczo,
• korzystasz z kilku kurierów,
• chcesz automatycznie zmieniać statusy zamówień.

Integracja przez API ShipX

Integracja przez API ShipX ma sens przy bardziej niestandardowych wdrożeniach. Dotyczy to sklepów, które mają własny proces realizacji zamówień, dedykowany panel, integrację z ERP, hurtownią, magazynem albo niestandardową logiką wysyłek.

Ten wariant daje największą kontrolę, ale wymaga większej analizy i testów. Nie jest potrzebny w każdym sklepie.

Co trzeba ustalić przed wdrożeniem?

Najczęstszy błąd przy integracji PrestaShop z InPost polega na tym, że moduł jest instalowany bez wcześniejszego ustalenia logiki wysyłki.

Przed wdrożeniem warto ustalić:

1. Jakie metody InPost mają być dostępne?
   Czy sklep ma obsługiwać tylko Paczkomaty, czy również kuriera, pobrania, PaczkoPunkty i usługi dodatkowe?
2. Gdzie klient wybiera punkt odbioru?
   Wybór Paczkomatu powinien być czytelny, działać na komputerze i telefonie oraz poprawnie zapisywać się w zamówieniu.
3. Jakie gabaryty paczek będą używane?
   Warto ustalić domyślny gabaryt, ale też przewidzieć sytuacje, w których produkty wymagają większej paczki albo wysyłki kurierskiej.
4. Czy sklep obsługuje pobrania?
   Pobranie wymaga poprawnego przekazania kwoty, metody płatności i danych przesyłki.
5. Kiedy ma powstawać etykieta?
   Etykieta może być generowana ręcznie, po zmianie statusu, po opłaceniu zamówienia albo w innym etapie procesu.
6. Czy status przesyłki ma zmieniać status zamówienia?
   Automatyzacja statusów jest wygodna, ale trzeba ją dobrze przetestować, żeby nie oznaczać zamówień jako wysłanych zbyt wcześnie.
7. Czy zamówienia są obsługiwane w PrestaShop czy poza sklepem?
   Jeżeli sklep korzysta z BaseLinkera lub ERP, integracja InPost może działać poza PrestaShop.
8. Czy motyw sklepu poprawnie obsłuży mapę punktów odbioru?
   Problemy z wyborem Paczkomatu często wynikają nie z samego InPostu, ale z konfliktu modułu z szablonem, koszykiem albo skryptami sklepu.

Najczęstsze problemy przy integracji PrestaShop z InPost

1. Mapa Paczkomatów nie wyświetla się w koszyku

To jeden z najczęstszych problemów. Klient wybiera dostawę do Paczkomatu, ale mapa się nie ładuje, nie można wybrać punktu albo wybrany punkt nie zapisuje się w zamówieniu.

Możliwe przyczyny:

• konflikt modułu z motywem,
• konflikt JavaScript w koszyku,
• problem z cache,
• niekompatybilna wersja modułu,
• błąd po aktualizacji PrestaShop,
• problem z trybem one page checkout,
• blokowanie zewnętrznych skryptów,
• nieprawidłowa konfiguracja metody dostawy.

W takiej sytuacji trzeba sprawdzić nie tylko ustawienia modułu, ale też konsolę przeglądarki, szablon koszyka i sposób ładowania skryptów.

2. Klient wybiera Paczkomat, ale punkt nie zapisuje się w zamówieniu

Czasem mapa działa, klient wybiera punkt odbioru, ale informacja nie trafia do zamówienia. To szczególnie problematyczne, bo zamówienie wygląda na poprawne, ale nie da się wygenerować przesyłki bez dodatkowego kontaktu z klientem.

Przyczyny mogą obejmować:

• konflikt z niestandardowym koszykiem,
• problem z walidacją formularza,
• modyfikacje w motywie,
• błędne hooki w PrestaShop,
• problem z modułem dostawy,
• niestandardowy proces składania zamówienia.

To jeden z problemów, których nie warto ignorować. Jeżeli punkt nie zapisuje się poprawnie, sklep może generować zamówienia wymagające ręcznej poprawy.

3. Nie można wygenerować etykiety

Problemy z etykietą mogą wynikać z błędnych danych odbiorcy, niepoprawnej konfiguracji konta InPost, tokena API, gabarytu, pobrania albo metody dostawy.

W diagnostyce trzeba sprawdzić:

• czy dane nadawcy są poprawne,
• czy konto InPost jest aktywne,
• czy token API działa,
• czy wybrana usługa jest dostępna,
• czy numer telefonu odbiorcy jest poprawny,
• czy wybrany Paczkomat istnieje i jest aktywny,
• czy gabaryt przesyłki jest zgodny z usługą,
• czy pobranie ma prawidłową kwotę,
• czy w logach modułu są komunikaty błędów.

Najczęściej problem nie leży w samej etykiecie, tylko w danych przekazywanych do InPostu.

4. Błędne metody dostawy w koszyku

W PrestaShop metody dostawy zależą od stref, wag, cen, grup klientów, przewoźników i konfiguracji koszyka. Jeżeli InPost pojawia się tam, gdzie nie powinien, albo nie pojawia się tam, gdzie powinien, trzeba sprawdzić konfigurację przewoźników.

Typowe problemy:

• InPost nie pokazuje się dla wybranej strefy,
• kurier pokazuje się zamiast Paczkomatu,
• metoda dostawy znika po dodaniu produktu,
• dostawa nie działa dla produktów o określonej wadze,
• koszyk pokazuje błędną cenę wysyłki,
• pobranie nie jest dostępne dla właściwej metody.

W takich przypadkach problem może wynikać z konfiguracji PrestaShop, a nie z samego modułu InPost.

5. Problemy po aktualizacji PrestaShop, PHP lub modułu

Integracje logistyczne są wrażliwe na aktualizacje. Po zmianie wersji PrestaShop, PHP, motywu albo modułu może przestać działać mapa, generowanie etykiet albo przekazywanie danych zamówienia.

Najczęstsze przyczyny:

• niezgodność wersji modułu,
• zmiana w szablonie koszyka,
• konflikt z cache,
• nieaktualne override’y,
• błędy JavaScript,
• inny sposób ładowania formularza zamówienia,
• zmiana w strukturze danych zamówienia.

Przed aktualizacją sklepu warto sprawdzić, czy integracja InPost jest zgodna z nową wersją i przetestować koszyk na kopii sklepu.

6. Konflikt z BaseLinkerem lub innym systemem wysyłkowym

Jeżeli sklep korzysta z BaseLinkera, ERP albo zewnętrznego systemu magazynowego, trzeba ustalić, gdzie faktycznie powstaje przesyłka. Błąd pojawia się wtedy, gdy kilka systemów próbuje obsługiwać tę samą wysyłkę.

Przykładowe konflikty:

• etykieta tworzona jest w PrestaShop i w BaseLinkerze,
• status zamówienia zmieniają dwa systemy,
• numer przesyłki zapisuje się w niewłaściwym miejscu,
• metoda dostawy w PrestaShop nie odpowiada metodzie w BaseLinkerze,
• klient wybrał Paczkomat w sklepie, ale dane nie trafiają do systemu realizacji.

Przy sprzedaży wielokanałowej często lepiej ustalić jeden system odpowiedzialny za generowanie etykiet, a pozostałe systemy traktować jako źródło danych lub miejsce prezentacji statusu.

Jak wygląda wdrożenie integracji PrestaShop z InPost?

Poprawne wdrożenie powinno obejmować konfigurację i testy, a nie tylko instalację modułu.

Najczęściej proces wygląda tak:

1. Analiza obecnej konfiguracji sklepu
   Sprawdzenie wersji PrestaShop, motywu, koszyka, metod dostawy, płatności i obecnych modułów logistycznych.
2. Wybór modelu integracji
   Decyzja, czy InPost ma działać bezpośrednio w PrestaShop, przez BaseLinker, czy przez API.
3. Konfiguracja konta i dostępów
   Przygotowanie danych potrzebnych do połączenia, w tym tokenów API, danych nadawcy i usług dostępnych na koncie.
4. Konfiguracja metod dostawy
   Ustawienie Paczkomatów, kuriera, pobrań, stref, cen, wag i reguł dostępności.
5. Konfiguracja wyboru punktu odbioru
   Sprawdzenie działania mapy i zapisu wybranego punktu w zamówieniu.
6. Konfiguracja etykiet
   Ustawienie gabarytów, danych nadawcy, sposobu generowania etykiet i obsługi przesyłek.
7. Testy koszyka
   Sprawdzenie różnych scenariuszy: komputer, telefon, płatność online, pobranie, produkty o różnych wagach i kilka metod dostawy.
8. Testy zamówień
   Sprawdzenie, czy punkt odbioru, dane klienta, numer telefonu, metoda dostawy i kwota pobrania poprawnie zapisują się w zamówieniu.
9. Test generowania etykiety
   Weryfikacja, czy przesyłka tworzy się poprawnie i czy etykieta zawiera prawidłowe dane.
10. Monitoring po wdrożeniu
    Sprawdzenie pierwszych realnych zamówień i ewentualna korekta ustawień.

Najważniejszy etap to test koszyka i realnego przepływu zamówienia. Integracja może wyglądać poprawnie w panelu, ale problem może pojawić się dopiero przy konkretnym motywie, telefonie, metodzie płatności albo produkcie.

Co warto przygotować przed zleceniem integracji?

Żeby szybciej ocenić zakres prac, warto przygotować:

• adres sklepu,
• wersję PrestaShop,
• informację, czy sklep działa na standardowym czy niestandardowym koszyku,
• informację, z jakiego modułu InPost korzystasz,
• informację, czy masz konto w Managerze Paczek,
• listę metod dostawy, które mają działać,
• informację, czy obsługujesz pobrania,
• przykładowe zamówienia problematyczne,
• informację, czy korzystasz z BaseLinkera,
• informację, czy etykiety mają być generowane w PrestaShop czy poza sklepem,
• opis problemu, jeśli integracja już działa, ale niepoprawnie.

Przy problemach z koszykiem pomocne są też zrzuty ekranu lub opis konkretnego scenariusza: co klient wybiera, na którym etapie pojawia się błąd i czy problem dotyczy wszystkich urządzeń.

Ile kosztuje integracja PrestaShop z InPost?

Koszt zależy od zakresu prac. Prosta konfiguracja metody dostawy i modułu zwykle jest znacznie mniej czasochłonna niż naprawa integracji w sklepie z niestandardowym koszykiem, wieloma modułami i sprzedażą wielokanałową.

Na koszt wpływają głównie:

• wersja PrestaShop,
• rodzaj motywu i koszyka,
• liczba metod dostawy,
• obsługa pobrań,
• potrzeba generowania etykiet,
• integracja z BaseLinkerem,
• niestandardowe statusy zamówień,
• konflikty z innymi modułami,
• potrzeba prac przez API,
• zakres testów.

W praktyce najwięcej czasu zajmują sytuacje, w których mapa Paczkomatów lub zapis punktu odbioru koliduje z niestandardowym koszykiem albo modułem one page checkout.

Kiedy integrację trzeba naprawić?

Warto zlecić analizę integracji, jeżeli:

• mapa Paczkomatów się nie ładuje,
• klient nie może wybrać punktu odbioru,
• wybrany Paczkomat nie zapisuje się w zamówieniu,
• nie można wygenerować etykiety,
• pojawia się błąd tokena API,
• InPost nie pojawia się jako metoda dostawy,
• cena wysyłki jest błędna,
• pobranie nie działa poprawnie,
• dane klienta nie przenoszą się do etykiety,
• integracja przestała działać po aktualizacji,
• BaseLinker i PrestaShop dublują obsługę wysyłki,
• statusy zamówień zmieniają się nieprawidłowo.

Nie zawsze trzeba wdrażać integrację od nowa. Często wystarczy poprawić konfigurację, zaktualizować moduł, naprawić konflikt w koszyku, zmienić reguły dostaw albo poprawić komunikację z API.

InPost Pay a integracja z PrestaShop

Osobnym tematem jest InPost Pay, czyli rozwiązanie łączące płatność i dostawę w jednym procesie zakupowym. Nie należy mylić go ze standardową integracją dostaw InPost w PrestaShop.

Standardowa integracja InPost dotyczy głównie metod dostawy, wyboru Paczkomatu, generowania przesyłek i etykiet. InPost Pay ingeruje głębiej w ścieżkę zakupową, dlatego wymaga osobnej analizy, dokumentacji i testów.

Jeżeli sklep ma już uporządkowaną logistykę i chce poprawić wygodę zakupów, można rozważyć InPost Pay jako kolejny etap. Najpierw jednak warto upewnić się, że podstawowa obsługa dostaw i zamówień działa stabilnie.

Pomoc przy integracji PrestaShop z InPost

Pomagam przy wdrożeniu i naprawie integracji PrestaShop z InPost — od podstawowej konfiguracji Paczkomatów i kuriera, przez problemy z mapą punktów odbioru, po generowanie etykiet, API ShipX, BaseLinker i konflikty z modułami koszyka.

Jeżeli chcesz wdrożyć InPost w sklepie albo obecna integracja nie działa poprawnie, prześlij krótki opis sytuacji:

• jakiej wersji PrestaShop używasz,
• czy problem dotyczy koszyka, mapy, etykiet czy statusów,
• czy korzystasz z BaseLinkera,
• czy etykiety generujesz w PrestaShop czy poza sklepem,
• czy problem pojawił się po aktualizacji,
• czy sklep używa niestandardowego motywu lub one page checkout.

Na tej podstawie można ocenić, czy wystarczy konfiguracja, czy potrzebna jest analiza modułu, koszyka, JavaScript, API lub całego procesu wysyłki.

Najczęstsze pytania

Czy PrestaShop można zintegrować z InPost?

Tak. PrestaShop można połączyć z InPost przez gotowy moduł, BaseLinker albo niestandardową integrację API. Zakres zależy od tego, czy sklep ma obsługiwać tylko wybór Paczkomatu, czy również etykiety, pobrania, statusy i automatyzację wysyłek.

Czy klient może wybrać Paczkomat w koszyku PrestaShop?

Tak, ale wybór punktu odbioru musi być poprawnie zintegrowany z koszykiem i metodą dostawy. Przy niestandardowych motywach lub modułach one page checkout mogą pojawić się problemy z mapą albo zapisem wybranego punktu.

Dlaczego mapa Paczkomatów nie działa w PrestaShop?

Najczęściej przyczyną jest konflikt JavaScript, problem z motywem, cache, niezgodność modułu z wersją PrestaShop albo błędna konfiguracja metody dostawy. Trzeba sprawdzić zarówno ustawienia modułu, jak i błędy w konsoli przeglądarki.

Czy można generować etykiety InPost z panelu PrestaShop?

Tak, w zależności od użytego modułu i konfiguracji. Etykiety mogą być generowane z poziomu PrestaShop, BaseLinkera albo innego systemu obsługi zamówień.

Czy InPost można obsługiwać przez BaseLinker zamiast PrestaShop?

Tak. To częsty model przy sprzedaży wielokanałowej. Wtedy PrestaShop może być źródłem zamówienia, a BaseLinker miejscem generowania etykiet, obsługi kurierów i automatyzacji wysyłek.

Czy integracja obsługuje pobrania?

Może obsługiwać pobrania, ale trzeba poprawnie skonfigurować metodę płatności, kwotę pobrania, usługę InPost i dane przekazywane do przesyłki.

Dlaczego nie mogę wygenerować etykiety?

Przyczyną może być błędny token API, brak aktywnej usługi, niepoprawne dane odbiorcy, zły numer telefonu, błędny gabaryt, problem z pobraniem, brak wybranego punktu odbioru albo błąd po stronie modułu.

Czy aktualizacja PrestaShop może zepsuć integrację InPost?

Tak, szczególnie jeśli aktualizacja zmienia koszyk, motyw, wersję PHP albo sposób działania modułów. Przed aktualizacją sklepu warto przetestować integrację InPost na kopii roboczej.

Czy InPost Pay to to samo co standardowa integracja dostawy InPost?

Nie. Standardowa integracja dotyczy głównie metod dostawy, Paczkomatów, kuriera i etykiet. InPost Pay to osobne rozwiązanie łączące płatność i dostawę w procesie zakupowym.

Czy można naprawić istniejącą integrację bez wdrażania jej od nowa?

Często tak. W wielu przypadkach problem dotyczy konfiguracji, konfliktu z motywem, cache, JavaScript, tokena API, metody dostawy albo nieprawidłowego zapisu punktu odbioru.