Integracja Paczkomaty InPost w WooCommerce krok po kroku (2026)

InPost obsłużył w 2025 roku blisko 1,4 miliarda przesyłek w całej Europie, a w Polsce działa ponad 28 000 maszyn Paczkomat. Dla sklepu WooCommerce brak tej metody dostawy to realna strata konwersji - klienci wybierają paczkomatyi przy ponad połowie zamówień e-commerce w Polsce. Problem w tym, że konfiguracja wcale nie jest tak prosta, jak pokazują tutoriale z YouTube.

Przez 13 lat wdrożeń WooCommerce widziałem ten sam scenariusz dziesiątki razy: plugin zainstalowany, klucz wklejony, a map paczkomatów na kasie nie ma. Albo mapa jest, ale etykiety się nie generują. Albo etykiety działają, ale statusy zamówień nie aktualizują się po dostarczeniu paczki. Ten przewodnik przeprowadza Cię przez pełną konfigurację - z realnymi pułapkami, nie tylko ze screenami z dokumentacji.

Co dostarcza oficjalna integracja InPost

InPost udostępnia dwa narzędzia do integracji z WooCommerce. Pierwsze to ShipX API - interfejs REST do tworzenia przesyłek, generowania etykiet i śledzenia statusów. Drugie to geowidget v5 - interaktywna mapa paczkomatów i punktów PUDO, którą osadzasz na stronie kasy, żeby klient mógł wybrać konkretny automat.

Oba narzędzia są darmowe w dostępie. Płacisz wyłącznie za nadane przesyłki - ceny zaczynają się od około 12-13 PLN netto za gabaryt A przy standardowym cenniku, a od 500 przesyłek miesięcznie warto negocjować stawki indywidualnie z opiekunem klienta InPost.

Do połączenia WooCommerce z InPost potrzebujesz:

1. Konta firmowego w Manager Paczek (manager.paczkomaty.pl)
2. Tokena ShipX API (ok. 300-330 znaków)
3. Osobnego tokena geowidgetu v5
4. Numeru ID organizacji (plugin pobiera go automatycznie po weryfikacji tokena)
5. Punktu nadania (adres lub paczkomat, przez który nadajesz)

Jeśli nie masz umowy z InPost, zacznij od rejestracji na manager.paczkomaty.pl. Rejestracja firmowego konta jest bezpłatna. Środowisko testowe dostępne jest pod adresem sandbox-manager.paczkomaty.pl - koniecznie przetestuj tam konfigurację zanim przejdziesz na produkcję.

Generowanie tokenów w Manager Paczek

To tutaj większość osób popełnia pierwszy błąd - mylą token ShipX z tokenem geowidgetu albo wklejają ten sam klucz w oba miejsca. To dwa osobne klucze, generowane w tej samej sekcji Manager Paczek, ale wyraźnie oddzielone.

Zaloguj się na manager.paczkomaty.pl. Przejdź do Moje konto - Dane i uzupełnij dane firmy razem z adresem do fakturowania (wymagane przed generowaniem API). Następnie otwórz zakładkę API.

W sekcji API ShipX kliknij "Generuj". Pojawi się okno z pytaniem o numer umowy kurierskiej - jeśli masz, zaznacz i wpisz. Jeśli nie masz, wygeneruj bez numeru umowy (działa dla przesyłek paczkomatowych). Klucz masz teraz - skopiuj go i zapisz, bo po odświeżeniu strony nie zobaczysz go ponownie.

Poniżej znajdziesz sekcję Geowidget - kliknij "Generuj token". To jest osobny klucz, znacznie krótszy niż token ShipX. Skopiuj go do innego miejsca - za chwilę będziesz go wklejał w inne pole w pluginie.

Instalacja i podstawowa konfiguracja pluginu

W WordPress przejdź do Wtyczki - Dodaj nową i wyszukaj "InPost for Shipping" lub "InPost PL". Zainstaluj oficjalny plugin wydany przez InPost S.A. (oznaczony weryfikacją WordPress.org). Wersja 4.6.29 z 20 stycznia 2026 dodała wsparcie dla WooCommerce 10.5 - jeśli działasz na najnowszym WooCommerce, sprawdź czy masz aktualną wersję pluginu.

Po aktywacji przejdź do WooCommerce - Ustawienia - Wysyłka - InPost. Zobaczysz zakładki: Ogólne, Paczkomat, Kurier, Webhooki.

W zakładce Ogólne wklej token ShipX API. Plugin natychmiast weryfikuje go z serwerami InPost. Po pozytywnej weryfikacji pojawi się pole "Organizacja" - wybierz swoją firmę z listy. Ten krok jest krytyczny i najczęściej pomijany w tutorialach.

W tym samym ekranie wpisz token geowidgetu v5 w dedykowanym polu (nie w polu tokena ShipX!). Ustaw też domyślny punkt nadania - może to być konkretny paczkomat lub adres magazynu.

Konfiguracja metody dostawy Paczkomat

Sama instalacja pluginu nie tworzy automatycznie metody dostawy w kasie WooCommerce. Musisz ją dodać ręcznie w strefach wysyłki.

Przejdź do WooCommerce - Ustawienia - Wysyłka - Strefy wysyłki. Wybierz strefę dla Polski (lub utwórz nową). Kliknij "Dodaj metodę wysyłki" i z listy wybierz "InPost Paczkomat". Zapisz.

Teraz wróć do tej metody i otwórz jej ustawienia. Możesz tu:

• Ustawić cenę dostawy (stała kwota, darmowa od X PLN, lub dynamiczna z tabeli)
• Włączyć lub wyłączyć gabaryt A, B, C (rozmiary paczki)
• Skonfigurować minimalny i maksymalny rozmiar zamówienia kwalifikujący do tej metody
• Ustawić COD (za pobraniem) jeśli masz to w umowie z InPost

Po zapisaniu przejdź na stronę testową kasy swojego sklepu i sprawdź, czy mapa paczkomatów pojawia się po wybraniu tej metody dostawy. Geowidget v5 powinien wczytać się jako interaktywna mapa z wyszukiwarką.

Jak generować etykiety i przesyłać do InPost

Gdy masz już zamówienie z wybranym paczkomaem, wejdź w jego szczegóły w panelu WooCommerce. Zobaczysz nową sekcję "InPost" po prawej stronie. Tutaj wybierasz gabaryt paczki (A to max 8 cm grubości, B - 19 cm, C - 41 cm) i klikasz "Utwórz przesyłkę".

Plugin wysyła żądanie do ShipX API, a w odpowiedzi otrzymuje numer listu przewozowego. Pojawia się w polu "Śledzenie" w zamówieniu. Teraz możesz pobrać etykietę PDF i ją wydrukować.

Jeśli zamiast numeru śledzenia dostajesz komunikat "Status: oferta wybrana", problem leży najczęściej w jednym z trzech miejsc:

• Brak środków na koncie prepaid w Manager Paczek (dla klientów prepaid)
• Brak numeru konta bankowego w danych firmy w Manager Paczek
• Dla usług kurierskich - brak podpiętej umowy kurierskiej w Manager Paczek

Dla sklepów nadających więcej zamówień naraz warto skorzystać z akcji grupowych. Na liście zamówień WooCommerce zaznacz kilka pozycji, z menu "Działania zbiorcze" wybierz "Utwórz przesyłki InPost" i na koniec pobierz wszystkie etykiety jako jeden plik PDF.

Automatyzacja: tworzenie przesyłek i statusy zamówień

Ręczne klikanie "Utwórz przesyłkę" przy każdym zamówieniu przestaje mieć sens już przy kilkudziesięciu zamówieniach dziennie. Plugin InPost PL pozwala zautomatyzować ten krok.

W ustawieniach InPost (zakładka Ogólne) znajdź sekcję "Automatyczne generowanie przesyłek". Włącz ją i wybierz status zamówienia, który ma wyzwolić automatyczne tworzenie listu przewozowego. Najczęściej jest to status "Przetwarzanie" (Processing) - czyli zamówienie opłacone i potwierdzone.

Ustaw też domyślny gabaryt. Jeśli masz produkty o bardzo różnych rozmiarach, lepiej zostawić wybór gabarytów ręczny lub skonfigurować reguły wagowe w zakładce Paczkomat.

Druga część automatyzacji to webhooks - czyli aktualizacje statusu paczki z systemu InPost z powrotem do WooCommerce. Od wersji 1.7.6 pluginu (listopad 2025) jest do tego osobna zakładka "Webhooki". Skopiuj adres URL webhooka widoczny w tej zakładce, zaloguj się do Manager Paczek i wklej go w sekcji Webhooki. Od tej chwili gdy paczka trafi do paczkomatu lub zostanie odebrana, status zamówienia w WooCommerce zmieni się automatycznie.

U klienta z Poznania, który prowadzi sklep z odzieżą dziecięcą, wdrożyłem automatyzację w grudniu 2024. Przed nią pracownik przez 1,5 godziny dziennie ręcznie tworzył przesyłki. Po konfiguracji automatycznego tworzenia przy statusie "Processing" i webhooków do zmiany statusu na "Completed" po odbiorze - czas obsługi zamówień InPost skurczył się do zera operacyjnego. Cały flow działa bez dotykania panelu WP.

Najczęstsze pułapki i jak je omijać

Po kilkudziesięciu wdrożeniach widzę te same problemy w kółko. Zapisuję je tu żeby Cię oszczędzić godzin debugowania.

Pułapka 1 - Brak organizacji. Już o tym pisałem, ale powtórzę, bo to najczęstszy błąd: po wklejeniu tokena ShipX wybierz organizację z listy. Bez tego żadna etykieta nie powstanie.

Pułapka 2 - Zły token w polu geowidgetu. Token ShipX to ciąg ok. 300+ znaków. Token geowidgetu jest znacznie krótszy. Jeśli wkleiłeś ShipX token do obu pól, geowidget nie zadziała - plugin nie zgłosi błędu, mapa po prostu się nie wczyta.

Pułapka 3 - SSL i serwer. Plugin InPost PL komunikuje się z API przez HTTPS. Na serwerach ze starą konfiguracją cURL lub nieaktualnymi certyfikatami CA pojawia się błąd połączenia w ustawieniach pluginu. Sprawdź wersję OpenSSL na serwerze.

Pułapka 4 - Wagi produktów. Automatyczne gabarytowanie działa tylko jeśli każdy produkt ma uzupełnioną wagę w WooCommerce. Sklepy importowane z CSV często mają wagę = 0. W efekcie plugin wybiera gabaryt A dla 10-kilogramowego zestawu mebli.

Pułapka 5 - Brak aktywnego ShipX. Niektóre konta InPost mają dostęp do Manager Paczek, ale ShipX API nie jest aktywowane. Token generuje się bez błędu, ale przy próbie stworzenia przesyłki dostajesz 401 lub 403. Rozwiązanie: kontakt z opiekunem klienta InPost z prośbą o aktywację ShipX na koncie.

Pułapka 6 - Cache checkout. Jeśli używasz LiteSpeed Cache, WP Rocket lub innego cache'a pełnostronicowego, strona kasy może być serwowana z cache'a bez załadowania mapy. Upewnij się, że /checkout/ jest wykluczona z cache'owania.

Integracja z BaseLinker dla większych wolumenów

Plugin InPost PL sprawdza się dobrze do około 50 zamówień dziennie. Powyżej tej liczby, zwłaszcza gdy nadajesz przez kilku kurierów, warto rozważyć BaseLinker jako warstwę zarządzania wysyłkami.

BaseLinker łączy się z WooCommerce jako magazyn zamówień i z InPost jako nadawcą. Całość działa tak: zamówienie wpada z WooCommerce do BaseLinker, automatyzacja BaseLinker tworzy przesyłkę InPost (lub DPD, DHL, GLS - wedle reguł), drukujesz etykiety jednym kliknięciem na wielu zamówieniach naraz. Synchronizacja statusów z powrotem do WooCommerce działa bez konfiguracji webhooków po stronie WP.

Koszt BaseLinker zaczyna się od 79 PLN netto miesięcznie. Przy wolumenie 100+ zamówień dziennie to inwestycja, która zwraca się w czasie zaoszczędzonym przez pracownika magazynu. Przy mniejszych sklepach oficjalny plugin InPost PL jest wystarczający.

Jeśli Twój sklep sprzedaje też na Allegro lub innych marketplace, BaseLinker jest niemal obowiązkowy - konsoliduje zamówienia z wielu kanałów w jednym miejscu i pozwala nadawać paczki bez logowania do każdego panelu oddzielnie. Pisałem o tym szerzej w artykule o budowie sklepu WooCommerce 2026.

Porównanie z innymi kurierami

InPost nie jest jedyną sensowną opcją dostawy w WooCommerce. W sklepach, które prowadzę, standardem jest co najmniej dwóch kurierów - InPost Paczkomaty plus jedna firma kurierska do drzwi (DPD, DHL lub GLS).

Konfiguracja DPD czy DHL w WooCommerce wygląda podobnie: plugin WP Desk lub dedykowany plugin kuriera, token API, metoda dostawy w strefie. Szczegółowe różnice w integracji opisałem w osobnym tekście InPost vs DPD vs DHL - porównanie integracji z WooCommerce.

Dla konfiguracji darmowej dostawy od określonej kwoty zamówienia - co bezpośrednio wpływa na konwersję przy metodzie InPost - przeczytaj artykuł o konfiguracji tabeli wysyłki i darmowej dostawy w WooCommerce.

Jeśli budujemy dla klienta sklep internetowy WooCommerce od podstaw, integracja InPost wchodzi w standardowy zakres wdrożenia. Stawka za przesyłki zależy od wolumenu, ale samo podłączenie geowidgetu i ShipX API powinno zająć doświadczonemu developerowi 1-2 godziny łącznie z testami.

Testowanie przed wdrożeniem produkcyjnym

Zawsze testuję integrację InPost w środowisku sandbox przed deployem na produkcję. InPost udostępnia środowisko testowe pod adresem sandbox-manager.paczkomaty.pl - rejestrujesz tam osobne konto testowe, generujesz testowe tokeny i możesz tworzyć przesyłki bez żadnych realnych kosztów ani nadanych paczek.

W pluginie przełącz tryb testowy (w ustawieniach jest przełącznik). Plugin automatycznie zmieni endpoint z api.inpost.pl na sandbox-api.paczkomaty.pl. Przetestuj cały flow:

• Wybór paczkomatu na kasie
• Tworzenie zamówienia testowego
• Generowanie etykiety (sprawdź czy zawiera poprawne dane)
• Śledzenie statusów przez webhook (jeśli konfigurujesz automatyzację)

U klienta z Trójmiasta podczas wdrożenia sklepu z elektroniką odkryłem w trybie testowym błąd w konfiguracji punktu nadania - adres był wpisany z literówką, co blokowało tworzenie etykiet. Na produkcji byłoby to widoczne dopiero przy pierwszej realnej sprzedaży. Tryb sandbox oszczędził kilka niekomfortowych chwil.

Po przejściu na produkcję pamiętaj o zmianie tokenów na produkcyjne (sandbox-owe nie działają na api.inpost.pl) i wyłączeniu trybu testowego w pluginie.

Podsumowanie: co robić w jakiej kolejności

Integracja Paczkomaty InPost WooCommerce w 2026 roku jest dobrze udokumentowana i plugin InPost PL działa solidnie - jeśli znasz pułapki. Większość problemów wynika nie z błędów technicznych, ale z niekompletnej konfiguracji pierwszego uruchomienia.

Najkrótsza droga do działającej integracji to: załóż konto w Manager Paczek, wygeneruj dwa osobne tokeny (ShipX i geowidget), zainstaluj oficjalny plugin InPost PL, wklej tokeny w odpowiednie pola, wybierz organizację, dodaj metodę dostawy w strefie wysyłki, przetestuj na sandbox. Na koniec skonfiguruj automatyczne tworzenie etykiet i webhooks jeśli potrzebujesz aktualizacji statusów.

Jeśli chcesz żeby konfiguracja była zrobiona raz a dobrze - bez godzin debugowania błędów tokenów i stref wysyłki - napisz do mnie. Robię to od lat i wiem gdzie szukać.

Najczęstsze pytania

Czy integracja InPost z WooCommerce jest darmowa?

Plugin InPost PL dostępny na WordPress.org jest całkowicie darmowy. Darmowy jest też dostęp do ShipX API. Płacisz wyłącznie za nadane przesyłki według cennika wynegocjowanego z InPost lub standardowych stawek. Dla sklepów nadających 500+ paczek miesięcznie warto wynegocjować umowę z dedykowanym opiekunem klienta.

Dlaczego mapa paczkomatów nie wyświetla się na stronie kasy?

Najczęstszy powód to brak tokena geowidgetu v5 lub wpisanie go w złe pole w ustawieniach pluginu. Token geowidgetu to osobny klucz generowany w Manager Paczek w sekcji API, inny niż token ShipX. Sprawdź też, czy w WooCommerce jako metoda dostawy jest aktywna opcja Paczkomat, bo bez wybranej metody mapa się nie pojawi.

Co oznacza błąd 'No route matches POST v1/organizations/shipments'?

Ten błąd pojawia się, gdy w ustawieniach pluginu nie wybrano organizacji. Po wpisaniu tokena ShipX API trzeba przejść do pola 'Organizacja' i wybrać właściwą z listy - plugin pobiera ją automatycznie po weryfikacji tokena. Jeśli lista jest pusta, poproś InPost o aktywację dostępu ShipX i wygenerowanie nowego tokena.

Jak automatycznie zmieniać status zamówienia po dostarczeniu paczki?

Od wersji 1.7.6 plugin WP Desk dla InPost obsługuje webhooks, które odbierają zdarzenia z systemu InPost i aktualizują status zamówień w WooCommerce. W ustawieniach pluginu (zakładka Webhooki) należy wkleić URL webhooka do panelu Manager Paczek. Pamiętaj, że adres webhooka musi być dostępny publicznie, a nie pod localhost.

Czy mogę nadawać paczki w paczkomacie bez podpisanej umowy z InPost?

Tak - jako klient prywatny przez aplikację InPost Mobile. Jednak do integracji z WooCommerce i ShipX API konieczna jest umowa biznesowa z InPost, bo dopiero wtedy masz dostęp do Manager Paczek i możesz generować tokeny API. Rejestracja firmowego konta na manager.paczkomaty.pl jest bezpłatna.

Jak drukować etykiety dla wielu zamówień jednocześnie?

W standardowym pluginie InPost PL możesz zaznaczyć wiele zamówień w liście WooCommerce i wybrać akcję grupową 'Utwórz przesyłki InPost', a następnie wydrukować wygenerowane etykiety. Dla sklepów z dużym wolumenem bardziej praktycznym rozwiązaniem jest integracja z BaseLinker, który drukuje etykiety jednym kliknięciem i obsługuje wiele kurierów naraz.

Jak skonfigurować automatyczne tworzenie przesyłki po opłaceniu zamówienia?

W ustawieniach pluginu InPost znajdź sekcję 'Automatyczne generowanie przesyłek' i wybierz status zamówienia, który ma wyzwolić tworzenie listu przewozowego - np. 'Processing' (zamówienie opłacone). Ustaw też domyślny gabaryt paczki i punkt nadania. Sprawdź wyniki po kilku zamówieniach testowych, bo automatyzacja działa tylko dla zamówień z produktami o uzupełnionych wagach.

Plugin InPost PL czy WP Desk Paczkomaty WooCommerce - który wybrać?

Plugin InPost PL (oficjalny, darmowy, na WordPress.org) wystarczy dla zdecydowanej większości sklepów - ma geowidget, automatyzację i webhooks. Plugin WP Desk w wersji premium (płatny, ok. 149-199 PLN rocznie) przyda się jeśli potrzebujesz zaawansowanej konfiguracji reguł cenowych wysyłki w powiązaniu z Flexible Shipping lub specyficznych integracji. Zacznij od oficjalnego pluginu.