InPost w e-commerce 2026 - Paczkomaty, InPost Pay i integracja ze sklepem

Ustal, gdzie będzie powstawać przesyłka: w WooCommerce, panelu przewoźnika czy systemie obsługującym wiele kanałów. To ważniejsze niż wybór przycisku generowania etykiety. Jeżeli sklep WooCommerce i integrator jednocześnie automatycznie utworzą przesyłkę dla tego samego zamówienia, obsługa otrzyma dwa różne zlecenia zamiast jednego.

Przygotuj konto z dostępem do właściwej organizacji, dane nadawcy i uzgodniony sposób rozliczania usług. Dostępność opcji zależy od konta i zakresu współpracy. Nie zakładaj uniwersalnego czasu weryfikacji ani stawki wynegocjowanej dla każdego sklepu o określonej liczbie paczek.

Sprawdź, czy potrzebujesz dostawy do punktu, pod adres, pobrania oraz odbioru przez kuriera. Koszt modułu, praca przy wdrożeniu i opłata za przewóz to różne pozycje. Aktualne taryfy i warunki przewoźnik publikuje w cennikach InPost; szersze porównanie modeli znajdziesz w rozwiązaniach InPost dla e-commerce. Ten poradnik dotyczy konfiguracji, a nie wyceny umowy kurierskiej.

Korzystaj z rozszerzenia wskazanego w oficjalnej dokumentacji InPost PL. Dokumentacja prowadzi do wtyczki InPost PL autorstwa iLabs w katalogu WordPress. Nie wybieraj wyłącznie po podobnej nazwie, ponieważ różne rozszerzenia mają inne pola, licencje i obsługiwane funkcje.

Według dokumentacji sprawdzonej 12 września 2026 opisana aktualizacja 1.9.6 pochodzi z 21 sierpnia 2026. Przed instalacją porównaj wymagania bieżącego wydania z wersjami WordPress, WooCommerce oraz PHP w swoim sklepie. Sprawdź również obsługę używanego checkoutu i dodatków modyfikujących formularz zamówienia.

Na kopii sklepu przygotuj możliwość odtworzenia danych i zainstaluj właściwe rozszerzenie przez Wtyczki > Dodaj nową wtyczkę. Po aktywacji otwórz InPost > Ustawienia, zgodnie z instrukcją konfiguracji. Nie podmieniaj działającej integracji w środku obsługi zamówień bez ustalenia, jak zostaną zachowane numery przesyłek i dane punktów odbioru.

Jeżeli sklep ma już inny moduł InPost, najpierw sprawdź jego zakres. Dwie integracje oferujące podobne metody mogą utrudniać rozpoznanie, która zapisuje dane i generuje etykiety.

Instrukcja InPost wskazuje dane ShipX w Managerze Paczek > Moje Konto > API oraz token mapy w obszarze API > Geowidget. Do konfiguracji potrzebne jest również ID organizacji. Sprawdź nazwy pól w swoim panelu, zamiast kopiować jeden token do wszystkich ustawień.

Token ShipX jest sekretem. Nie wklejaj go do treści strony, kodu JavaScript dostępnego w przeglądarce, zrzutu ekranu ani zgłoszenia pomocy. Token Geowidget jest przeznaczony do użycia w przeglądarce, ale zgodnie z dokumentacją mapy powinien mieć ograniczone dozwolone domeny.

Produkcja i sandbox mają osobne dane. Dokumentacja przypomina: "Dane należy wygenerować dla tego środowiska, którego obecnie używamy". Opis środowisk wyjaśnia także istotną granicę: sandbox pozwala sprawdzać integrację, ale nie symuluje rzeczywistego transportu i zmian statusu wynikających z drogi paczki. Brak takiej zmiany nie dowodzi błędu działającej konfiguracji.

Otwórz WooCommerce > Ustawienia > Wysyłka > Strefy wysyłki i wybierz strefę obsługującą adres kupującego. Dodaj właściwą metodę udostępnianą przez InPost PL. Zgodnie z instrukcją metody wysyłki ustaw usługę, nazwę widoczną dla klienta i sposób naliczania kosztu. Stawka w koszyku jest Twoją konfiguracją sprzedaży; nie musi automatycznie odpowiadać fakturze przewoźnika.

Dla dostawy do punktu wybór na mapie powinien być dostępny po wybraniu odpowiedniej metody. Sprawdź, czy wybrany punkt pozostaje zapisany po zmianie danych adresowych, kuponu lub sposobu płatności. Samo pokazanie mapy nie wystarcza, jeżeli zamówienie nie przechowuje identyfikatora punktu potrzebnego do nadania.

Jeżeli oferujesz dostawę bez opłaty, użyj pola Kwota darmowej dostawy w metodzie integracji. Ustawienie Rabat dla kuponów wpływa na sposób uwzględniania kuponu przy progu, opisany w dokumentacji. Sprawdź oba koszyki: przed rabatem i po jego zastosowaniu. Nie zastępuj metody z mapą zwykłą metodą Darmowa wysyłka przemianowaną na Paczkomat.

Przy niewidocznej metodzie najpierw przejdź przez diagnozę braku wysyłki w WooCommerce. Przy wyborze modelu promocji skorzystaj z porównania darmowej dostawy.

Pracuj na kopii sklepu połączonej z sandboxem, z wyłączonymi rzeczywistymi płatnościami i wysyłką powiadomień do klientów. Sprawdź zwykły produkt fizyczny oraz adres z właściwej strefy. Przy testach korzystaj z danych przeznaczonych do środowiska testowego, bez kopiowania danych klientów do dodatkowych narzędzi.

Przejdź następujące przypadki:

1. Wybierz metodę InPost i punkt na komputerze oraz telefonie. Potwierdź, że mapa daje się zamknąć, a wybór pozostaje widoczny.
2. Zmień ilość produktów lub kupon. Sprawdź cenę i zachowanie wybranego punktu.
3. Zmień metodę na kuriera. Sprawdź, czy formularz wymaga teraz właściwych danych i nie używa przypadkowo punktu z poprzedniego wyboru.
4. W scenariuszu zamówienia testowego potwierdź zapis danych odbioru w panelu oraz przekazanie ich do integracji.
5. Dopiero w sandboxie sprawdź utworzenie przesyłki i dostępny dokument etykiety, zgodnie z obsługą bieżącej wersji modułu.

Nie używaj produkcyjnego tworzenia etykiety jako testu połączenia. Może ono utworzyć rzeczywistą usługę lub obciążenie zależne od rozliczenia. Przed włączeniem automatycznego tworzenia przesyłek po opłaceniu zamówienia ustal, który system ma to robić i jakie zamówienia ma obejmować. Sam dostęp do PDF nie potwierdza poprawnej ceny ani gotowości całego procesu.

Własna integracja ma sens, gdy gotowy moduł nie obsługuje potrzebnego procesu: niestandardowego systemu sklepowego, ERP lub konkretnego obiegu zamówień. Rozdziel funkcje odczytu, tworzenia przesyłek i odbierania zmian statusu. Sam podgląd statusu nie powinien uruchamiać ponownego nadania.

Połączenia wymagające tokenu ShipX wykonuj z serwera. Przeglądarka klienta powinna otrzymywać tylko dane potrzebne do zakupu, na przykład publiczną konfigurację mapy. Operacje tworzące przesyłkę powinny zapamiętywać wynik i identyfikator powiązany z zamówieniem, aby ponowienie żądania przez własną aplikację nie tworzyło bez kontroli kolejnego zlecenia.

Dokumentacja webhooków InPost wymaga publicznie dostępnego adresu odbierającego powiadomienia. Opisuje weryfikację adresu przez żądanie GET z odpowiedzią HTTP 200. Nie oznacza to, że każde powiadomienie przychodzi metodą GET. Sprawdź osobno weryfikację adresu, format właściwego zdarzenia i zapis jego przetworzenia w swojej aplikacji.

Użyj HTTPS i dopuść potrzebną komunikację na konkretnym adresie integracji, bez wyłączania ochrony całej witryny. W logach ukrywaj tokeny i dane osobowe. Przy problemach porównaj udokumentowaną odpowiedź API z żądaniem po usunięciu sekretów. Limity zapytań i warunki ponawiania sprawdź w aktualnej dokumentacji używanego interfejsu, zanim dobierzesz częstotliwość pracy aplikacji.

Poza WooCommerce wybór modułu zależy od platformy i jej wersji. Punktem wyjścia jest katalog dokumentacji integracyjnej InPost, a następnie dokumentacja konkretnego rozszerzenia. Nie przenoś nazw pól z InPost PL do innej aplikacji, nawet jeżeli oba rozwiązania korzystają z ShipX.

Base, wcześniej BaseLinker, może przejąć obsługę nadawania po pobraniu zamówienia. Nadal trzeba zapewnić wybór punktu w sklepie i przeniesienie jego identyfikatora, zamiast samej tekstowej nazwy dostawy. Ten przepływ opisujemy w integracji Base z WooCommerce.

Przed zmianą sprawdź jednoznaczne przypisanie metody sklepowej do usługi przewoźnika. Jeżeli automatyzacja działa w Base, porównaj ją z opcjami automatycznego nadawania w sklepie. Koszt oraz zakres modułu sprawdzaj dla konkretnego produktu, bez założenia, że każda aplikacja i każde wdrożenie są bezpłatne.

InPost Pay łączy zakupy z procesem obsługiwanym przez usługę InPost, ale nie uruchamia się przez samo wpisanie tokenu ShipX do wtyczki wysyłkowej. Potrzebny jest osobny proces dla sprzedawcy oraz właściwe dane konfiguracji. Nie należy opisywać tej usługi jako zwykłego portfela InPost.

Oficjalna instrukcja dla WordPress z 8 września 2026 opisuje panel sprzedawcy, dane aplikacji i konfigurację wtyczki InPost Pay. Rozróżnia między innymi Client ID, Client Secret oraz POS, a dla widżetu 2.0 również Merchant Client ID. Sekret aplikacji pozostaje po stronie serwera. Nie przesyłaj go pocztą ani nie wstawiaj w publiczne materiały podczas konsultacji.

Najpierw wykonuje się wymagane scenariusze środowiska testowego, a następnie uzgadnia uruchomienie produkcyjne. Sprawdź zgodność z wersją sklepu, metodami płatności i sposobem przekazywania zamówień do magazynu. Dostępność konta oraz przejście procesu wdrożenia trzeba potwierdzić dla danego sprzedawcy.

Oceń również zwykły checkout, który nadal powinien działać. Mniejsza liczba kroków nie uzasadnia obietnicy konkretnego wzrostu konwersji. Po wdrożeniu można obserwować wyniki, lecz najpierw trzeba potwierdzić poprawność ceny, dostawy i statusu zamówienia.

Mapa nie pojawia się: sprawdź token Geowidget, środowisko i dozwoloną domenę, w tym używany adres kopii sklepu. Następnie sprawdź błędy JavaScript i żądania mapy w narzędziach przeglądarki. Konflikt optymalizacji skryptów badaj pojedynczą, odwracalną zmianą na kopii, zamiast wyłączać wszystkie zabezpieczenia oraz pamięć podręczną.

Nie można utworzyć etykiety: przeczytaj pełny komunikat walidacji. Zweryfikuj wymagane dane odbiorcy, wybraną usługę, punkt oraz gabaryt. Kod błędu bez treści odpowiedzi nie wskazuje automatycznie jednego pola. Przy problemie autoryzacji porównaj konto, środowisko, organizację i uprawnienia; nie zakładaj od razu, że token wygasł.

Status nie wraca do sklepu: sprawdź system odpowiedzialny za synchronizację i zapis błędów. Dla webhooka potwierdź dostępność konkretnego adresu, weryfikację i przetwarzanie zdarzenia. Pamiętaj, że sandbox nie odtwarza drogi rzeczywistej paczki. Nie testuj synchronizacji przez wielokrotne tworzenie produkcyjnych przesyłek.

Jeżeli problem wymaga dopasowania sklepu lub połączenia z innym systemem, sprawdź zakres integracji WooCommerce. Napisz do nas: wystarczy adres sklepu lub platforma i objaw, na przykład brak mapy albo błąd etykiety. Nazwa wtyczki i wersja są pomocne, jeśli je znasz. Usuń z załączników tokeny, dane kupujących oraz pełne zrzuty żądań zawierające sekrety.

• Integracja InPost Kurier i Paczkomaty ze Streamsoft Prestiż: jak ją zaplanować
• Integracja InPost Paczkomaty z SAP ERP: warianty i plan wdrożenia
• System ticketowy z InPost - jak połączyć obsługę zgłoszeń z wysyłką?