Sklepy internetowe · Integracja dostaw

InPost i WooCommerce: Paczkomaty, kurier oraz testy dostawy

Konfiguracja InPost w WooCommerce obejmuje więcej niż dodanie dwóch metod dostawy. Trzeba połączyć konto, ustawić strefy i ceny, zapisać punkt odbioru w zamówieniu oraz sprawdzić wyjątki przed pierwszą wysyłką.

Szybka odpowiedź

Aby uruchomić InPost w WooCommerce, przygotuj firmowe konto i dostęp ShipX, dobierz aktualną wtyczkę oraz skonfiguruj osobno dostawę do automatu i kurierem w odpowiednich strefach. Ustal ceny, warunek darmowej dostawy, ograniczenia gabarytu i dane wymagane do etykiety. W checkoutcie klient musi wybrać punkt, a jego identyfikator powinien pozostać przy zamówieniu. Przed publikacją przetestuj zmianę metody, koszyk za duży dla automatu, próg cenowy, błąd pobierania punktów i utworzenie etykiety. Nie uznawaj samego widoku mapy za zakończoną integrację.

Paczka połączona świetlnymi ścieżkami z koszykiem sklepu, automatem paczkowym i samochodem kurierskim
Unikalna ilustracja redakcyjna IT-Make przygotowana do tego poradnika.

Potrzebujesz pomocy przy wdrożeniu? Zobacz: Tworzenie sklepów internetowych — zakres usługi.

Macierz odbioru: siedem koszyków, które wykrywają błędy dostawy

Przygotuj próbne produkty o znanej masie i wymiarach, a następnie siedem osobnych zamówień. Dla każdego zapisz skład koszyka, kod pocztowy, metodę, koszt pokazany przed płatnością, identyfikator punktu oraz wynik w panelu zamówienia. Nie używaj danych rzeczywistych klientów na środowisku testowym.

Poniższe wartości progów i gabarytów mają pochodzić z konfiguracji konkretnego sklepu oraz aktualnych warunków usługi. Tabela wskazuje zachowanie do sprawdzenia, nie uniwersalny cennik InPost. Jeśli metoda nie powinna być dostępna, lepszy jest jasny komunikat i poprawna alternatywa niż błąd dopiero przy tworzeniu etykiety.

Wynik odbioru porównaj w trzech miejscach: na ekranie klienta, w zamówieniu WooCommerce i w systemie nadawczym. Ta sama nazwa metody bez poprawnego punktu albo adresu nie wystarcza do wysłania paczki.

PróbaOczekiwane zachowanieCo sprawdzić w zamówieniu
Produkt mieszczący się w wybranym gabarycieAutomat jest dostępny, mapa pozwala wybrać punktMetoda, identyfikator punktu, cena i dane odbiorcy są zapisane
Produkt przekraczający dopuszczalny gabaryt lub masęNiedozwolona metoda znika albo wyjaśnia ograniczenie; kurier pozostaje, jeśli spełnia warunkiNie da się przypadkiem utworzyć etykiety do automatu
Koszyk tuż poniżej i tuż powyżej proguKoszt zmienia się tylko według jawnej reguły sklepuSuma zamówienia oraz wybrana metoda są zgodne z checkoutem
Zmiana automatu na kuriera i z powrotemAdres i punkt są wymagane tylko dla właściwej metodyNie pozostał stary identyfikator punktu ani niekompletny adres
Zmiana kodu pocztowego lub strefyWooCommerce pokazuje metody dostępne w dopasowanej strefieCena i strefa odpowiadają nowemu adresowi
Brak odpowiedzi mapy lub APIKlient widzi zrozumiały błąd i nie kończy zamówienia bez wymaganego punktuObsługa ma ślad błędu bez ujawnienia tokenu
Ponowienie tworzenia etykiety po niepewnym wynikuNajpierw sprawdzany jest stan pierwszej próbyJedno zamówienie nie otrzymuje dwóch przesyłek przez ślepe ponowienie

Przygotuj konto InPost, dostęp ShipX i sklep testowy

Konto nadawcze powinno należeć do firmy sprzedającej. Przed wdrożeniem potwierdź dostęp do panelu, usługi wynikające z umowy, sposób rozliczenia oraz osobę odpowiedzialną za przesyłki i reklamacje logistyczne. Oficjalny poradnik InPost o WooCommerce opisuje połączenie przez wtyczkę i API ShipX.

Token i identyfikator organizacji konfiguruj w przeznaczonych polach wtyczki. Nie wklejaj ich do zlecenia, zrzutu ekranu, kodu strony ani repozytorium. Zapisz właściciela dostępu i procedurę jego zmiany. Na kopii sklepu wyłącz prawdziwe powiadomienia i produkcyjne akcje nadawcze, jeśli test nie wymaga rzeczywistej przesyłki.

Przed instalacją zanotuj wersje WordPressa, WooCommerce, PHP, motywu i typu checkoutu. Zrób kopię oraz sprawdź, czy aktualnie używana wtyczka obsługuje te wersje i checkout blokowy, jeśli sklep go stosuje. Sam fakt, że ekran ustawień się otwiera, nie potwierdza zgodności całej ścieżki zakupu.

Ustaw Paczkomaty i kuriera jako odrębne metody

W WooCommerce dostawy przypisuje się do stref. Klient widzi metody z pierwszej strefy pasującej do adresu, co wyjaśnia część pozornych awarii wtyczki. Dokumentacja stref wysyłki WooCommerce zaleca ustawienie bardziej szczegółowych stref przed ogólnymi. Sprawdź też zachowanie dla adresu poza obsługiwanym obszarem.

Dostawa do automatu potrzebuje wyboru właściwego punktu. Kurier wymaga poprawnego adresu doręczenia. Nie traktuj ich jako jednej opcji o dwóch etykietach: mają inne pola, ograniczenia i komunikaty dla klienta. W sklepie z wysyłką zagraniczną ustal osobne strefy oraz usługi dostępne dla danego kraju.

W formularzu punkt odbioru powinien pozostać widoczny po odświeżeniu, zmianie płatności lub powrocie do koszyka. Po złożeniu zamówienia jego identyfikator i czytelna nazwa muszą trafić do widoku obsługi. Jeżeli klient zmieni metodę na kuriera, stary punkt nie może sterować późniejszą etykietą.

Połącz ceny i progi z rzeczywistymi warunkami dostawy

Cena w checkoutcie powinna wynikać z umowy, kosztu opakowania oraz polityki sklepu. Zapisz osobno cenę dla automatu, kuriera, ewentualnego pobrania i wysyłki bezpłatnej. Nie kopiuj przykładowego cennika z poradnika, ponieważ warunki operatora i umowy mogą się zmieniać.

Próg darmowej dostawy określ jednoznacznie: czy dotyczy wartości przed czy po kuponie, jak działa z produktami przecenionymi i czy obejmuje wszystkie metody. Porównaj tę samą regułę na karcie produktu, w koszyku, checkoutcie i informacji o dostawach. Przy zmianie zawartości koszyka cena powinna zostać przeliczona przed zatwierdzeniem zamówienia.

Dla produktów ciężkich, długich i wielopakowych zapisz sposób określania gabarytu. Sama waga produktu może nie opisywać paczki po zapakowaniu. Jeśli sklep nie potrafi automatycznie ocenić ograniczenia, oznacz asortyment wymagający kuriera lub ręcznej wyceny. Nie pozwalaj klientowi wybrać metody, której magazyn nie zrealizuje.

Odbierz wybór punktu na telefonie i w checkoutcie blokowym

Mapę lub listę punktów sprawdź na telefonie, klawiaturą i myszą. Punkt powinien mieć nazwę oraz adres wystarczający do rozpoznania lokalizacji. Wybór musi być powiązany z bieżącym koszykiem, a błąd pobrania punktów powinien pozwolić spróbować ponownie bez utraty pozostałych danych.

Nie zakładaj, że widget poprawnie działa w każdym układzie checkoutu. WooCommerce ma klasyczny formularz i bloki checkoutu; rozszerzenie musi obsługiwać wariant używany przez sklep. Sprawdź kupon, zmianę adresu, płatności, wariantu produktu i powrót po przerwanej płatności. Każda z tych akcji może ponownie przeliczyć wysyłkę.

Przejdź zamówienie jako gość i zalogowany klient. Następnie otwórz je w panelu: czy obsługa widzi metodę, punkt, dane kontaktowe, kwotę dostawy i status płatności? Jeśli magazyn musi dopowiadać numer automatu z notatki klienta, integracja nie przekazuje kluczowej informacji.

Sprawdź etykietę i reakcję na błąd API

Po poprawnym zamówieniu wykonaj próbę nadania w używanej wtyczce. Porównaj usługę, gabaryt, nadawcę, odbiorcę, punkt albo adres, pobranie i numer przesyłki. Zweryfikuj, czy etykieta i numer wracają do właściwego zamówienia. Oficjalna strona integracji InPost jest właściwym miejscem do pobrania aktualnego modułu i dokumentacji.

Błąd API nie powinien znikać po odświeżeniu panelu. Zapisz kod lub opis potrzebny do diagnozy, czas i numer zamówienia, ale bez tokenu oraz nadmiarowych danych osobowych. Jeśli odpowiedź jest niepewna, najpierw sprawdź listę przesyłek. Automatyczne ponowienie bez kontroli może utworzyć duplikat.

Ustal ręczną ścieżkę awaryjną: kto weryfikuje punkt, kto tworzy przesyłkę w panelu operatora, jak numer trafia z powrotem do sklepu oraz kiedy informowany jest klient. Procedura powinna działać również wtedy, gdy połączenie z operatorem wraca po kilku godzinach.

Próbka odbioru dla jednego zamówienia

W karcie testu zapisz: numer testowego zamówienia, wersję wtyczki, typ checkoutu, czas próby, metodę dostawy, wybrany punkt albo adres, koszt pokazany klientowi, gabaryt po spakowaniu i oczekiwany status. Dane kontaktowe zastąp identyfikatorami testowymi.

Przykład: koszyk zawiera niewielki produkt i kupon, który obniża wartość poniżej progu darmowej dostawy. Klient wybiera automat, zmienia go na kuriera, a potem wraca do automatu. Po płatności obsługa porównuje końcowy koszt i punkt z zamówieniem oraz z danymi etykiety. Scenariusz jest wzorem próby, a nie opisem wyniku klienta IT-Make.

Druga próba używa produktu, którego paczka przekracza ograniczenie wybranej usługi. Oczekiwany wynik to zablokowanie automatu i pokazanie dostępnej alternatywy przed płatnością. Jeśli ograniczenie wychodzi dopiero przy etykiecie, reguła powinna wrócić do konfiguracji koszyka.

Zamknij odbiór po kontroli jednej przesyłki w warunkach produkcyjnych uzgodnionych z firmą. Zachowaj numery techniczne, wynik i osobę sprawdzającą. Nie publikuj zrzutów z danymi kupujących ani tokenami.

Checklista przed wdrożeniem

  • konto firmowe i dostęp do ShipX pod kontrolą sprzedawcy
  • kopia sklepu i zgodna wersja wtyczki
  • strefy WooCommerce oraz osobne metody dla automatu i kuriera
  • ceny, kupony i próg bezpłatnej wysyłki sprawdzone w koszyku
  • ograniczenia gabarytu i wagi oparte na paczce po zapakowaniu
  • punkt odbioru zapisany w zamówieniu i etykiecie
  • checkout sprawdzony na telefonie oraz w używanym typie formularza
  • błąd API i niepewne ponowienie mają procedurę obsługi
  • jedna kontrolowana próba nadania po uruchomieniu

Po przejściu listy porównaj wymagania z zakresem na stronie Tworzenie sklepów internetowych — zakres usługi. Jeśli projekt obejmuje wyjątki lub integracje, opisz je w briefie przed wyceną.

Najczęstsze pytania

Czy wtyczka InPost wystarczy do uruchomienia dostaw?

Nie. Wtyczka wymaga poprawnego konta, dostępu API, metod w strefach WooCommerce, cen i ograniczeń. Odbiór obejmuje punkt w zamówieniu oraz próbę etykiety.

Dlaczego Paczkomaty nie pojawiają się w koszyku?

Sprawdź adres klienta i kolejność stref wysyłki, przypisanie metody, warunki koszyka oraz zgodność wtyczki z używanym checkoutem. Dopiero potem analizuj log API.

Czy klient może wybrać automat bez wskazania punktu?

Zamówienie do automatu powinno zawierać konkretny punkt. Jeśli mapa nie działa, checkout ma pokazać błąd lub umożliwić inną dostawę, zamiast przyjąć niekompletne zamówienie.

Jak ustawić darmową dostawę InPost?

Najpierw określ metodę i próg oraz wpływ kuponów. Następnie ustaw regułę w sklepie i sprawdź koszyk tuż poniżej oraz powyżej progu, także po zmianie adresu i metody.

Powiązane materiały

Źródło uzupełniające: InPost: oficjalny poradnik integracji WooCommerce. Materiał ma charakter projektowy; kwestie prawne, podatkowe i indywidualne obowiązki firmy wymagają odrębnej weryfikacji.