InPost udostępnia oficjalną integrację dla WooCommerce, która pozwala obsługiwać między innymi Paczkomaty, przesyłki kurierskie, mapę punktów odbioru, etykiety i wybrane procesy logistyczne bez wychodzenia z ekosystemu sklepu.
Szybka odpowiedź
Typowe wdrożenie obejmuje: instalację aktualnej wtyczki InPost, dodanie danych autoryzacyjnych do ShipX, utworzenie metod dostawy w odpowiednich strefach WooCommerce, konfigurację GeoWidgetu, cen oraz test pełnego zamówienia.
1. Przygotuj konto InPost
Do pełnej integracji wysyłkowej potrzebujesz danych dostępowych zgodnych z aktualną dokumentacją InPost. Nie wklejaj tokenów do ticketów ani publicznych zrzutów ekranu.
2. Zainstaluj oficjalną wtyczkę
Przed instalacją sprawdź wymagania i kompatybilność z Twoim WordPressem oraz WooCommerce. Po większej aktualizacji przetestuj checkout na stagingu.
3. Autoryzacja ShipX
W konfiguracji podajesz token lub inne dane potrzebne do komunikacji z API. Błędne dane mogą sprawić, że mapka będzie działać, ale generowanie przesyłek już nie.
4. Strefy wysyłki WooCommerce
Dodaj odpowiednie metody InPost do strefy Polska lub innych stref, które obsługujesz. Zwróć uwagę na kolejność i warunki metod.
5. GeoWidget
Mapa punktów odbioru powinna działać na wersji checkoutu używanej w sklepie. WooCommerce rozwija checkout blokowy, dlatego kompatybilność wtyczki i motywu ma znaczenie.
6. Ceny
Ustal, czy cena jest stała, zależna od progu koszyka, klasy wysyłkowej, wagi lub innych warunków. Sprawdź przypadki graniczne, np. produkt, który nie powinien być wysyłany do Paczkomatu.
7. Gabaryty i dane produktów
Jeśli proces wykorzystuje wagę lub rozmiar, zadbaj o kompletne dane produktu. Brak wagi potrafi powodować błędy w automatyzacji logistycznej.
8. Etykiety i nadawanie
Wykonaj test utworzenia przesyłki i etykiety. Sprawdź poprawność danych odbiorcy, numer telefonu, e-mail i wybrany punkt.
9. Webhooki i statusy
Jeśli integracja aktualizuje statusy przesyłki, upewnij się, że endpoint jest dostępny i nie blokuje go firewall.
10. Test checkoutu
Zrób zamówienie na desktopie i telefonie. Wybierz Paczkomat, zmień go, wróć do koszyka, odśwież checkout i sprawdź, czy wybrany punkt zostaje przypisany do zamówienia.
Najczęstszy błąd
Testowanie wyłącznie mapki. Klient może poprawnie wybrać Paczkomat, a administrator później nie być w stanie utworzyć przesyłki. Test integracji kończy się dopiero po wygenerowaniu prawidłowej etykiety.
Test integracji przed uruchomieniem na produkcji
Przy integracjach e-commerce sam komunikat „połączono” nie jest jeszcze dowodem, że cały proces działa. Dla tematu InPost WooCommerce przygotuj mały scenariusz testowy obejmujący produkt, zamówienie i sytuację wyjątkową. Sprawdź, czy dane po obu stronach są identyczne, czy status nie zmienia się dwukrotnie i czy po błędzie system potrafi wrócić do poprawnego stanu.
Dobrą praktyką jest rozpoczęcie od kilku produktów i jednego kontrolowanego zamówienia zamiast natychmiastowej synchronizacji całego katalogu. Zapisz identyfikatory produktów, SKU, statusy, czas synchronizacji i komunikaty błędów. Jeśli integracja ma webhooki, upewnij się, że odpowiedzi HTTP są poprawne i nie blokuje ich firewall.
Minimalna checklista wdrożenia
- kopia konfiguracji sklepu przed zmianą,
- test na stagingu lub koncie testowym, jeśli dostawca na to pozwala,
- jednoznaczne źródło prawdy dla cen i stanów,
- kontrola SKU/EAN i wariantów,
- test zamówienia udanego oraz anulowanego,
- test połączenia po restarcie lub chwilowej niedostępności API,
- monitoring błędów po uruchomieniu.
Właśnie takie testy odróżniają działającą integrację od konfiguracji, która wygląda dobrze tylko w panelu administratora.
Powiązane poradniki HeatLogic
Potrzebujesz pomocy?
HeatLogic może skonfigurować InPost w WooCommerce, przetestować checkout, etykiety i statusy oraz utrzymywać integrację przy późniejszych aktualizacjach.
Najczęściej zadawane pytania
Czy InPost ma oficjalną wtyczkę WooCommerce?
Tak. InPost publikuje własną integrację WooCommerce i dokumentację konfiguracji.
Czy potrzebuję API ShipX?
Do pełnej integracji wysyłkowej wykorzystywane są dane autoryzacyjne ShipX zgodnie z dokumentacją InPost.
Czy mapka Paczkomatów wystarczy do działania integracji?
Nie. Trzeba także przetestować zapis punktu, utworzenie przesyłki i etykiety.
Czy InPost działa z nowym checkoutem WooCommerce?
Aktualne wersje oficjalnej wtyczki rozwijają obsługę współczesnego WooCommerce. Przed wdrożeniem zawsze sprawdź bieżącą kompatybilność konkretnej wersji.