InPost w e-commerce 2026 – Paczkomaty, InPost Pay i integracją ze sklepem

Zanim cokolwiek zainstalujesz w sklepie, potrzebujesz konta w panelu InPost Manager (manager.paczkomaty.pl). To centralne miejsce zarządzania przesyłkami i generowania kluczy API.

Zakładanie konta firmowego

Przejdź na manager.paczkomaty.pl i wybierz rejestracje dla firm. Podaj NIP, dane firmy i adres nadawczy. Weryfikacja trwa zwykle 1–2 dni robocze. Po zatwierdzeniu dostajesz pełny dostęp do panelu.

Generowanie tokenów – ShipX API i GeoWidget to osobne tokeny

Tu wiele poradników myli się fundamentalnie. Do pełnej integracji potrzebujesz dwóch osobnych tokenów:

1. Token ShipX API – generujesz w panelu Manager w sekcji API > Tokeny. Typ: Organization. Służy do tworzenia przesyłek, generowania etykiet i śledzenia statusów. Wyświetla się tylko raz – zapisz go od razu.

2. Token GeoWidget – generujesz w osobnej zakładce. Służy wyłącznie do wyświetlania mapy paczkomatów w checkoucie. To NIE jest ten sam token co ShipX API. Pomylenie ich to najczęstszy błąd przy konfiguracji.

Cennik InPost 2026

Ceny zależą od wolumenu przesyłek. Przy ponad 500 paczkach miesięcznie można negocjować indywidualny cennik. Sklepy wysyłające 200+ paczek zwykle płacą 10–11 zl netto za gabaryt A.

Chcesz wdrożyć to w swoim biznesie? Skorzystaj z naszej usługi agencję tworzącą strony.

Instalacja wtyczki InPost for Shipping

Oficjalna wtyczka InPost for Shipping WooCommerce – darmowa, ponad 50 000 aktywnych instalacji. W panelu WordPress: Wtyczki > Dodaj nowa > wyszukaj "InPost for Shipping" > Zainstaluj > Aktywuj.

Alternatywy: WP Desk InPost (platna, rozszerzony support), Kodefix InPost i kilka mniejszych. Na start oficjalna wtyczka wystarczy.

Konfiguracja klucza API i środowiska

W ustawieniach wtyczki (WooCommerce > Ustawienia > Wysylka > InPost) wklej token ShipX API. Wybierz środowisko – produkcyjne (nie testowe, chyba ze dopiero testujesz). Podaj ID organizacji z panelu Manager.

Mapa paczkomatów w checkoucie (GeoWidget v5)

Po aktywacji wtyczki mapa paczkomatów pojawia się automatycznie w formularzu checkoutu. GeoWidget v5 wyświetla ponad 22 000 paczkomatów i punktów PUDO w Polsce. Klient wybiera paczkomat na mapie, a adres leci prosto do zamówienia.

Token GeoWidget wklejasz w osobnym polu w ustawieniach wtyczki – nie w tym samym co ShipX API.

Generowanie etykiet wysyłkowych

Z poziomu listy zamówień w WooCommerce: zaznaczasz zamówienia > akcja hurtowa "Generuj etykiety InPost". Etykiety PDF do pobrania w jednym pliku. Można też generować pojedynczo z widoku zamówienia.

Budujemy sklepy z gotowa integracja InPost – od feedu produktowego po skonfigurowana wysyłkę.

Jeśli oficjalna wtyczka nie wystarcza (niestandardową platforma, własny ERP, zaawansowana automatyzacja), możesz integrować się bezpośrednio przez ShipX API.

REST API – endpointy i autoryzacja

ShipX API to standardowe REST API. Autoryzacja przez Bearer token w nagłówku HTTP. Główne endpointy: tworzenie przesyłki (POST /v1/organizations/:id/shipments), generowanie etykiety (GET /v1/shipments/:id/label), śledzenie statusu (GET /v1/tracking/:tracking_number).

Webhooks do śledzenia statusów

Zamiast odpytywać API o statusy, ustaw webhook – InPost wywoła podany URL przy każdej zmianie statusu przesyłki. Twój serwer musi odpowiedzieć HTTP 200 w ciągu 5 sekund, inaczej InPost ponowi próbę.

Rate limits i batch processing

Limit: 1000 zapytań na minute. Przy hurtowym generowaniu etykiet użyj batch endpointu – jedno zapytanie obsługuje do 100 przesyłek naraz. Przy większym wolumenie rozłóż zapytania w czasie.

BaseLinker to szczegolny przypadek – nie zastępuje integracji na platformie, ale centralizuje zarządzanie wysyłkami z wielu kanałów. Jeśli sprzedajesz na WooCommerce + Allegro + eBay, BaseLinker obsługuje InPost ze wszystkich źródeł w jednym panelu.

Sama integracja to połowa roboty. Kilka zmian w konfiguracji potrafi podnieść konwersje.

Domyslna metoda wysyłki = paczkomat. 80% klientów i tak go wybiera. Ustaw paczkomat jako domyslna opcje – mniej kliknięć w checkoucie = mniej porzuconych koszyków.

Darmowa dostawa od progu 150–200 zl. Testuj różne progi. Przy AOV 120 zl próg darmowej dostawy na 150 zl podnosi srednia wartość zamówienia o 15–25%. Więcej o strategii darmowej dostawy w dedykowanym poradniku.

InPost Pay – nowa usługa, ktora łączy płatność i wybór paczkomatu w jednym kroku. Klient klika "Kup z InPost Pay", wybiera paczkomat z zapisanych adresów i płaci z portfela InPost. Mniej kroków = wyzsza konwersja. Na razie dostępne dla wybranych sklepów.

Wyświetlanie czasu dostawy. "Zamów do 14:00 – dostawa jutro do paczkomatu" działa lepiej niż "dostawa 1–3 dni". Konkretna obietnica zmniejsza niepewność.

Mapa paczkomatów nie wyświetla się

Najczęściej: konflikt z cache lub innymi wtyczkami JS. Wyłącz cache na stronie checkoutu. Sprawdź konsolę przeglądarki (F12 > Console) – szukaj błędów JavaScript. Upewnij się, ze GeoWidget ma poprawny token (osobny od ShipX API!). Jeśli motyw nadpisuje formularz checkout, sprawdź hooki WooCommerce.

Błędy przy generowaniu etykiet (kod 400)

Zwykle brakuje wymaganego pola – najczęściej numer telefonu odbiorcy albo nieprawidłowy gabaryt paczki. Sprawdź wymiary: gabaryt A maks. 8 x 38 x 64 cm, waga do 25 kg. Błąd 401 oznacza błędny lub wygasły token.

Synchronizacja statusów nie działa

Jeśli używasz webhooków – sprawdź czy URL callbacku jest dostępny z zewnątrz (nie localhost). Serwer musi odpowiadać HTTP 200 w ciągu 5 sekund. Timeout powoduje ponowienie próby, ale po kilku nieudanych InPost przestaje wysyłać powiadomienia.

Problemy z integracja? Skontaktuj się z nami – konfigurujemy InPost w sklepach na co dzień.