Integracja InPost WooCommerce pozwala dodać Paczkomaty i usługi kurierskie do koszyka, przekazać wybrany punkt odbioru do zamówienia oraz nadawać przesyłki z panelu sklepu. Potrzebujesz konta biznesowego InPost, danych API i bezpłatnej wtyczki InPost PL.
Po poprawnej konfiguracji klient wybiera dostawę oraz punkt na mapie. Ty generujesz przesyłkę, numer śledzenia i etykietę bez przepisywania danych do Managera Paczek.
Jak działa integracja InPost WooCommerce
Integracja InPost WooCommerce opiera się na oficjalnej wtyczce InPost PL, która łączy sklep z usługami InPost i przenosi obsługę przesyłek do panelu WordPressa. Klient wybiera dostawę w koszyku, a sprzedawca może utworzyć paczkę i pobrać etykietę przy zamówieniu.
Wtyczkę znajdziesz w katalogu WordPressa. Jej autorem jest iLabs, partner integracyjny InPost. Obsługuje między innymi usługi InPost Paczkomat 24/7, Kurier InPost, Paczka w Weekend oraz Szybkie Zwroty.
Przy dostawie do punktu klient otwiera mapę Geowidget. Widzi na niej urządzenia Paczkomat oraz PaczkoPunkty, sprawdza ich adresy i wybiera dogodną lokalizację. Dane punktu zapisują się przy zamówieniu razem z danymi odbiorcy.
Po zakupie nie musisz ponownie wpisywać adresu ani numeru Paczkomatu. W oknie wysyłki InPost utworzysz przesyłkę, pobierzesz etykietę, zamówisz podjazd kuriera lub rozpoczniesz obsługę zwrotu.
Wtyczka pozwala również wyłączyć dostawę InPost dla konkretnych produktów. Przydaje się to wtedy, gdy część asortymentu nie mieści się w skrytkach albo wymaga innego sposobu transportu.
Zanim zaczniesz – konto InPost i dane z Managera Paczek
Integrację InPost z WooCommerce zaczynasz od biznesowego konta InPost oraz dostępu do Managera Paczek. Dane integracyjne znajdziesz w sekcji Moje konto → API.
Przygotuj cztery pozycje: ID organizacji, token API, produkcyjny token Geowidget oraz token Geowidget dla środowiska testowego. ID organizacji ma od 0 do 6 cyfr. Skopiuj je dokładnie, łącznie z ewentualnym zerem na początku.
Token Geowidget odpowiada za wyświetlanie mapy punktów w sklepie. Musi być wygenerowany dla właściwego adresu witryny. Gdy tokenu brakuje albo został przypisany do innej domeny, klient nie zobaczy poprawnie mapy Paczkomatów.
Produkcja i sandbox działają jako osobne środowiska. Każde z nich ma własne ID organizacji i tokeny. Mieszanie tych danych jest częstą przyczyną błędu połączenia z API.
Do uruchomienia usługi Kurier Standard potrzebujesz podpisanej umowy kurierskiej. Bez niej możesz korzystać z dostawy do Paczkomatu. Dostępność pozostałych usług zależy od warunków Twojego konta i zawartej umowy.
Sprawdź też serwer sklepu. Wtyczka wymaga WordPressa w wersji co najmniej 5.3 oraz PHP 7.4 lub nowszego. Nowsza, wspierana wersja PHP będzie rozsądniejszym wyborem pod względem bezpieczeństwa i zgodności z WooCommerce. Jeśli Twój sklep dopiero powstaje, przejdź najpierw przez nasz przewodnik jak założyć sklep internetowy na WordPressie.
Konfiguracja InPost w WooCommerce krok po kroku
Konfiguracja InPost WooCommerce obejmuje instalację wtyczki, wpisanie danych API, dodanie metod wysyłki i wykonanie próbnego zamówienia. Przejdź przez kroki po kolei, ponieważ część ustawień pojawi się dopiero po poprawnym połączeniu z InPost.
Krok 1. Zainstaluj wtyczkę InPost PL z katalogu WordPressa
W panelu WordPressa przejdź do sekcji Wtyczki i wybierz opcję dodawania nowej. W wyszukiwarce wpisz „InPost PL”, czyli oficjalny moduł InPost w katalogu WordPressa.
Przed instalacją sprawdź nazwę autora. Powinien nim być iLabs. To prosty sposób, żeby uniknąć pomylenia oficjalnego rozwiązania z innymi wtyczkami o podobnych nazwach.
Kliknij „Zainstaluj”, a po zakończeniu instalacji włącz wtyczkę. W menu administracyjnym pojawi się zakładka InPost, z której przejdziesz do konfiguracji konta, produktów i przesyłek.
Krok 2. Wpisz dane API w ustawieniach wtyczki
Otwórz InPost → Ustawienia, a następnie sekcję Dane logowania lub Autoryzacja. Uzupełnij ID organizacji, token API oraz tokeny Geowidget.
W polu „Typ API” wybierz środowisko odpowiadające użytym danym. Przy testach będzie to Sandbox. Dane pobrane z konta produkcyjnego wymagają ustawienia „Produkcyjne”.
Wtyczka weryfikuje połączenie dopiero podczas zapisywania ustawień. Po każdej zmianie kliknij przycisk zapisu i sprawdź komunikat. Samo wklejenie nowego tokenu do pola nie uruchomi ponownej weryfikacji. Znaczenie wszystkich pól opisuje oficjalna dokumentacja wtyczki InPost.
Jeśli zaczynasz od sandboxa, trzymaj cały zestaw danych z tego samego środowiska. Po zakończeniu testów podmień ID organizacji, token API i token Geowidget na produkcyjne, a potem zmień Typ API.
Krok 3. Dodaj metody dostawy InPost w strefach wysyłki
Przejdź do WooCommerce → Ustawienia → Wysyłka i otwórz strefę obejmującą Polskę. Kliknij „Dodaj metodę wysyłki” i wybierz usługę InPost.
Każdą usługę dodaje się osobno. W zależności od konfiguracji konta możesz zobaczyć między innymi:
- InPost Paczkomat 24/7 oraz wariant COD,
- InPost Kurier Standard oraz wariant COD,
- Kurier C2C oraz wariant COD,
- Paczkę w Weekend,
- SmartCourier.
Dla każdej metody ustaw nazwę widoczną dla klienta, cenę i deklarowany czas dostawy. Nazwa powinna jasno mówić, gdzie trafi przesyłka. „Paczkomat InPost 24/7” będzie czytelniejszy niż wewnętrzna nazwa usługi.
Paczka w Weekend pojawia się w określonym przedziale czasowym: od czwartku od godziny 20:00 do piątku do godziny 18:00. Uwzględnij to podczas testów, jeśli metoda znika poza tym oknem.
Krok 4. Ustaw gabaryty, format etykiet i domyślny Paczkomat nadawczy
W ustawieniach wtyczki wybierz domyślny gabaryt przesyłki Paczkomat: A, B albo C. Dobierz go do wymiarów najczęściej wysyłanych zamówień. Przy zróżnicowanym asortymencie gabaryt możesz później zmieniać podczas tworzenia poszczególnych paczek.
Ustaw też format etykiety. A4 sprawdzi się przy zwykłej drukarce biurowej, a A6 przy drukarce termicznej przeznaczonej do etykiet kurierskich.
Jeśli nadajesz paczki w urządzeniu lub punkcie, wskaż domyślny Paczkomat nadawczy. Przy wysyłce kurierskiej uzupełnij standardowe wymiary przesyłki w milimetrach i wagę w kilogramach. Możesz też wskazać punkt, z którego kurier ma odbierać paczki.
Te wartości przyspieszają codzienną obsługę zamówień. Nadal trzeba sprawdzać je przy paczkach wyraźnie większych lub cięższych od typowego zamówienia.
Krok 5. Złóż zamówienie testowe i sprawdź mapę w koszyku
Dodaj produkt do koszyka, wpisz adres objęty polską strefą wysyłki i wybierz metodę InPost. Następnie otwórz mapę Geowidget, wskaż punkt odbioru i sfinalizuj zamówienie.
W panelu sprawdź, czy przy zamówieniu zapisały się nazwa i adres wybranego punktu. Powinno być też widoczne okno wysyłki InPost służące do utworzenia przesyłki.
Test obejmuje całą ścieżkę: koszyk, checkout, zapis punktu, utworzenie paczki, numer śledzenia i pobranie etykiety. Dzięki temu wykryjesz błędny token lub ustawienie strefy przed pierwszym prawdziwym zakupem.
Sandbox ma własne dane dostępowe. Po udanych testach wprowadź pełny zestaw produkcyjny, przełącz Typ API i ponownie zapisz ustawienia. Na końcu wykonaj jeszcze jedno zamówienie próbne na produkcji, bez tworzenia zbędnej płatnej przesyłki.
Nadawanie paczek i etykiety z panelu zamówień
Przesyłkę utworzysz bezpośrednio w zamówieniu WooCommerce. Po jej poprawnym zapisaniu otrzymasz numer śledzenia i możliwość pobrania etykiety.
Otwórz zamówienie i znajdź okno wysyłki InPost. Przycisk „Wyślij przesyłkę” tworzy paczkę na podstawie danych klienta, wybranej metody oraz wskazanego punktu odbioru. Po przyjęciu przesyłki przez system użyj opcji „Pobierz etykietę”.
Większą liczbę zamówień możesz obsłużyć zbiorczo. Przejdź do listy zamówień, zaznacz właściwe pozycje i wybierz z działań zbiorczych „InPost PL tworzenie przesyłek”. Podczas operacji możesz od razu wskazać gabaryt.
Kurier Standard obsługuje przesyłki wielopaczkowe, co przydaje się przy zamówieniach rozdzielonych na kilka kartonów. Parametry każdej paczki powinny odpowiadać jej rzeczywistym wymiarom i wadze.
Po skonfigurowaniu webhooka w Managerze Paczek informacje o przesyłkach mogą aktualizować się w widoku zamówień. Webhook przekazuje do sklepu kolejne statusy, dzięki czemu łatwiej sprawdzisz, czy paczka została nadana, odebrana i doręczona.
Rozmiaru przesyłki nie można zmienić po jej utworzeniu. Jeśli wybierzesz zły gabaryt lub wpiszesz niewłaściwe wymiary, utwórz nową przesyłkę z poprawnymi parametrami.
Pobranie (COD) w metodach InPost
Pobranie działa w metodach dostawy oznaczonych skrótem COD. Taki wariant przekazuje kwotę zamówienia do przesyłki i informuje przewoźnika o konieczności pobrania pieniędzy.
Sama wtyczka InPost nie dodaje ani nie konfiguruje sposobów płatności w checkoucie. Płatność za pobraniem ustawiasz osobno w WooCommerce. Następnie łączysz ją z odpowiednią metodą wysyłki, na przykład InPost Paczkomat 24/7 COD. Jeśli przy okazji porządkujesz płatności online, konfigurację bramek opisaliśmy w przewodnikach po integracji Przelewy24 z WooCommerce i integracji PayU.
Sprawdź to na próbnym zamówieniu. Przy płatności za pobraniem w zamówieniu powinna znaleźć się metoda COD, a w danych tworzonej przesyłki właściwa kwota. Zwykły wariant Paczkomatu lub kuriera nie zapisze pobrania, więc przewoźnik nie odbierze pieniędzy od klienta.
Typowe błędy przy integracji InPost i jak je naprawić
Większość problemów z InPost WooCommerce wynika z pomieszania danych produkcyjnych i testowych, błędnego tokenu Geowidget albo ustawień metod wysyłki. Zacznij od zapisania konfiguracji i sprawdzenia, czy wszystkie dane pochodzą z jednego środowiska.
Komunikat „Wystąpił błąd podczas łączenia z API” zwykle wskazuje na błędne ID organizacji, token lub niezgodny Typ API. Dane z sandboxa wymagają ustawienia Sandbox, a produkcyjne ustawienia Produkcyjne. Jeżeli dane są poprawne, sprawdź, czy serwer sklepu może nawiązać połączenie z API InPost.
Status „Oferta wybrana” oznacza, że przesyłka nie została skutecznie utworzona i nie otrzymała numeru śledzenia. Przyczyną może być brak środków na koncie prepaid, brak numeru rachunku bankowego w Managerze Paczek, brak umowy dla Kuriera Standard albo błędny kod pocztowy odbiorcy.
Komunikat Geowidgetu „Brak dostępu, sprawdź czy token został wygenerowany dla odpowiedniej witryny” dotyczy adresu przypisanego do tokenu. Wygeneruj nowy token dla dokładnego adresu sklepu i wpisz go w odpowiednim środowisku.
Gdy metody InPost nie pojawiają się w koszyku, sprawdź produkty w sekcji InPost → Ustawienia produktów. Usługi można tam włączać masowo. Zajrzyj także do stref wysyłki.
Problem może powodować standardowa metoda „Darmowa dostawa” WooCommerce, jeśli po osiągnięciu progu ukrywa pozostałe opcje. Usuń ją ze strefy i skonfiguruj darmową wysyłkę od określonej kwoty bezpośrednio w metodach InPost.
Paczkomat, kurier czy Paczka w Weekend – co udostępnić w koszyku
Na początek wybierz dwie lub trzy metody odpowiadające rozmiarom produktów i sposobowi robienia zakupów przez Twoich klientów. Długa lista dostaw zajmuje dużo miejsca, szczególnie w koszyku na telefonie.
Paczkomat 24/7 jest naturalnym punktem startu dla sklepów sprzedających produkty mieszczące się w skrytkach. Klient sam wybiera miejsce odbioru i może odebrać przesyłkę bez oczekiwania pod wskazanym adresem.
Kurier przydaje się przy większych gabarytach, cięższych paczkach i zakupach dostarczanych bezpośrednio do domu lub firmy. Kurier Standard wymaga podpisanej umowy, dlatego sprawdź dostępność usługi przed dodaniem jej do koszyka.
Paczka w Weekend pasuje do produktów kupowanych z myślą o szybkim użyciu, na przykład prezentów, akcesoriów na wyjazd lub artykułów potrzebnych na konkretną okazję. Uwzględnij ograniczone okno działania tej metody.
Dobry zestaw na start to Paczkomat 24/7, jego wariant COD, jeśli oferujesz pobranie, oraz kurier. Kolejne opcje dodaj po sprawdzeniu, jak klienci korzystają z dostaw.
Cena usług zależy od umowy, wolumenu przesyłek i warunków przypisanych do konta. Aktualne stawki sprawdzisz w Managerze Paczek lub u opiekuna handlowego InPost. Koszty dostaw i prowizje płatności to stałe pozycje w budżecie sklepu – pełne zestawienie znajdziesz w artykule ile kosztuje sklep internetowy.
FAQ
-
Tak. Wtyczka InPost PL jest dostępna bezpłatnie w katalogu WordPressa. Opłaty dotyczą nadawanych przesyłek i wynikają z cennika lub umowy zawartej z InPost.
-
Sprawdź token Geowidget w ustawieniach wtyczki. Mapa nie zadziała, gdy tokenu brakuje albo został wygenerowany dla innego adresu witryny. Osobne tokeny obowiązują także dla produkcji i sandboxa.
-
Tak, jeśli w strefie wysyłki udostępnisz metodę InPost Paczkomat 24/7 COD. Oznaczenie COD sprawia, że kwota pobrania trafia do danych przesyłki. Samą płatność za pobraniem skonfiguruj wcześniej w WooCommerce.
-
Do testów integracji InPost WooCommerce użyj środowiska sandbox i przypisanego do niego ID organizacji oraz tokenów. W ustawieniach wtyczki wybierz Typ API „Sandbox”, zapisz dane i przeprowadź pełne zamówienie testowe. Przed uruchomieniem sprzedaży wprowadź komplet danych produkcyjnych.
-
Możesz nadawać przesyłki do Paczkomatów zgodnie z warunkami swojego konta. Usługa Kurier Standard wymaga podpisanej umowy kurierskiej z InPost. Jej warunki ustalisz z opiekunem handlowym.