Grainsoft – integracja z InPost Paczkomaty

Panel konfiguracyjny znajduje się w WooCommerce -> Inpost Paczkomaty. Najszybciej trafisz tam klikając link “Ustawienia” przy wtyczce na liście zainstalowanych wtyczek (Wtyczki -> Zainstalowane wtyczki).

Pamiętaj, że to dwa różne miejsca: koszty i widoczność samej metody dostawy ustawiasz w strefach wysyłki (WooCommerce -> Ustawienia -> Wysyłka), a globalne opcje wtyczki (wersja mapy, limity wagi/wymiarów, logo, adres wysyłki) w WooCommerce -> Inpost Paczkomaty.

Po aktywowaniu wtyczki przejdź do WooCommerce -> Ustawienia -> Wysyłka -> wybierz odpowiednią strefę wysyłki i dodaj nową metodę dostawy typu “Inpost Paczkomaty”.

Wtyczka automatycznie wykrywa, czy Twój sklep korzysta z klasycznego koszyka/checkoutu (shortcode) czy z nowego, blokowego WooCommerce Blocks – nie trzeba nic przełączać ręcznie. Sprawdź w panelu WooCommerce -> Inpost Paczkomaty pole “Tryb checkout (wykryty automatycznie)”:

• Jeśli widnieje status “⚠️ Wykryto konflikt” (koszyk i checkout korzystają z różnych trybów), wybierz ręcznie odpowiedni tryb w tym samym panelu lub ujednolić obie strony (najlepiej obie na blokach albo obie na shortcode).
• Jeśli mimo poprawnie wykrytego trybu przycisk nadal się nie pojawia, upewnij się, że wybrana jest metoda dostawy “Inpost Paczkomaty”, a następnie wyłącz chwilowo inne wtyczki (patrz pytanie poniżej).

Nie. Wtyczka wykrywa to automatycznie na podstawie zawartości stron koszyka i checkoutu. Jeśli wcześniej zamieniłeś/aś te strony na bloki i chcesz wrócić do wersji shortcode, w panelu WooCommerce -> Inpost Paczkomaty znajdziesz przycisk “Przywróć” przy opcji “Przywróć klasyczny widok koszyka i kasy” (zalecana wcześniejsza kopia zapasowa).

Nie, selektor paczkomatu pojawi się automatycznie w sekcji wysyłki bloku koszyka/checkoutu po wybraniu formy dostawy Inpost Paczkomaty – nie trzeba nic dodawać ręcznie w edytorze strony.

W panelu WooCommerce -> Inpost Paczkomaty w polu “Wersja mapy (GeoWidget)” możesz wybrać jedną z dwóch map InPost:

• GeoWidget v4 – bez tokena (domyślnie) – działa od razu po instalacji, nie wymaga żadnej konfiguracji i pokazuje paczkomaty w Polsce. Jeśli sprzedajesz tylko w Polsce, zostaw tę opcję.
• GeoWidget v5 – z tokenem – nowa wersja mapy InPost. Wymaga podania tokena GeoWidget i pozwala wybrać, z jakich krajów punkty mają być widoczne na mapie.

Jeśli wybierzesz v5, ale nie wkleisz tokena, klienci nadal zobaczą mapę v4 – sklep nigdy nie zostanie bez działającej mapy.

Zaloguj się do Managera Paczek InPost (manager.paczkomaty.pl) na konto firmowe, przejdź do Moje konto -> API i w sekcji GeoWidget wygeneruj token dla domeny swojego sklepu. Skopiuj go i wklej w polu “Token GeoWidget” w ustawieniach wtyczki. Instrukcja jest też wyświetlana bezpośrednio pod polem tokena.

Token działa tylko na domenie, dla której został wygenerowany. Wklej tam wyłącznie token GeoWidget – nigdy token API ShipX, ponieważ token GeoWidget jest widoczny w kodzie strony sklepu.

Tak, w GeoWidget v5. Po wybraniu v5 zaznacz w polu “Kraje na mapie” kraje, z których punkty mają być widoczne. Gdy zaznaczona jest tylko Polska, używana jest polska mapa InPost; wybranie innego kraju przełącza na mapę międzynarodową (token musi obsługiwać InPost International).

Pamiętaj też, aby dodać metodę dostawy “Inpost Paczkomaty” w strefach wysyłki obejmujących te kraje oraz aby mieć z InPost umowę pozwalającą nadawać przesyłki do punktów za granicą – sama mapa nie wystarczy do realizacji wysyłki.

Najczęstsze przyczyny to: nieprawidłowy lub niepełny token (sprawdź, czy został skopiowany w całości), token wygenerowany dla innej domeny niż domena sklepu (np. bez/z “www” lub dla wersji testowej sklepu) albo token, który nie obsługuje mapy międzynarodowej, gdy zaznaczono kraje spoza Polski. Aby szybko przywrócić działanie sklepu, przełącz wersję mapy z powrotem na GeoWidget v4.

W panelu administracyjnym przejdź do WooCommerce -> Inpost Paczkomaty i ustaw na “Tak” pole “Zapisz wybrany paczkomat jako adres wysyłki”.

Dodaj dwie osobne metody wysyłki “Inpost Paczkomaty” w tej samej strefie. Pierwszej ustaw np. koszt 20 zł i regułę “Pokaż tę metodę wysyłki, gdy… maksymalna wartość zamówienia 60 zł”, a drugiej koszt 0 zł i regułę “…minimalna wartość zamówienia 60 zł”. Kwoty 20 zł i 60 zł są tylko przykładem – dobierz je do swojego sklepu.

W panelu WooCommerce -> Inpost Paczkomaty ustaw pole “Limit wagowy” na “Tak” oraz podaj wartość w polu “Maksymalna waga (kg)”. Następnie wybierz, co ma się dziać po przekroczeniu limitu: “Ukryj metodę wysyłki” po prostu ukryje wysyłkę Paczkomatem, a “Podziel na kilka paczek” automatycznie przeliczy i pomnoży koszt wysyłki proporcjonalnie do liczby paczek.

W panelu WooCommerce -> Inpost Paczkomaty ustaw pole “Ograniczenie wymiarów” na “Tak” oraz uzupełnij pola “Maksymalna szerokość (cm)”, “Maksymalna wysokość (cm)” i “Maksymalna długość (cm)”. Gdy którykolwiek produkt w koszyku przekroczy podane wymiary, metoda wysyłki Inpost Paczkomaty zostanie automatycznie ukryta.

W panelu WooCommerce -> Inpost Paczkomaty ustaw pole “Pokaż logo w koszyku i kasie” na “Tak”, a następnie wybierz logo z biblioteki mediów. Maksymalna szerokość wyświetlanego logo to 100 px.

Tak – wtyczka jest na bieżąco testowana z aktualnymi wersjami WordPressa i WooCommerce (patrz pole “Tested up to” na górze tej strony) oraz regularnie aktualizowana pod kątem bezpieczeństwa i zgodności (m.in. pełna obsługa HPOS).

Wyłącz chwilowo wszystkie wtyczki poza WooCommerce i Inpost Paczkomaty, a następnie sprawdź, czy problem nadal występuje. Jeśli tak, spróbuj przełączyć się na domyślny motyw WordPress (np. Twenty Twenty-Four), aby wykluczyć konflikt z szablonem. Błąd nadal występuje? Napisz w zakładce Support – chętnie pomogę.

Tak, rozwój wtyczki jest kontynuowany, a rozszerzenie o kolejne formy dostawy InPost jest na liście planów. Jeśli zależy Ci na konkretnej integracji szybciej, zobacz pytanie poniżej o zlecenia indywidualne.

Realizuję płatne wdrożenia i modyfikacje szyte na miarę – dodatkowe pola, integracje z zewnętrznymi systemami (np. kurierskimi, ERP, hurtowniami) czy zmiany wyglądu selektora paczkomatu. Opisz swoją potrzebę przez formularz kontaktowy na grainsoft.pl .

Najprościej zostawiając ocenę ⭐⭐⭐⭐⭐ w zakładce Reviews – to bezpośrednio pomaga innym właścicielom sklepów trafić na tę wtyczkę. Możesz też postawić mi kawę ☕ albo zlecić płatne wsparcie/rozwój przez grainsoft.pl .