Paczkomaty i punkty odbioru w sklepie - widget mapy i typowe błędy

Droga kodu punktu od koszyka do etykiety

Kod punktu przechodzi przez kilka miejsc, zanim trafi na etykietę. Każde z nich może go zgubić, dlatego warto znać całą ścieżkę i sprawdzać ją w testach od początku do końca, a nie tylko to, czy mapa się wyświetla.

[#chart:wpr68b]

Ostatni krok wymaga szczególnej uwagi. W API InPost ShipX dla usług paczkomatowych punkt docelowy przekazuje się w atrybutach przesyłki jako target_point, a dokumentacja wskazuje go jako wymagany dla tych usług. Jeśli integracja wysyłkowa nie odczyta kodu z zamówienia, bo sklep zapisał go w innym polu niż to, którego szuka wtyczka, przesyłka nie powstanie albo powstanie z błędem. Dlatego przy wymianie widgetu lub wtyczki trzeba sprawdzić, w jakim polu zamówienia zapisywany jest kod i kto go później czyta. Sam proces tworzenia przesyłek przez API opisaliśmy we wpisie integracja z kurierami przez API.

Tabelę warto traktować jako stały scenariusz testowy, powtarzany po każdej aktualizacji motywu, wtyczki wysyłkowej, bramki płatności albo integratora. Właśnie takie zmiany najczęściej psują zapis punktu, choć same nie dotyczą mapy. Dobrze też zapisywać w zamówieniu nie tylko kod, ale i adres punktu w momencie wyboru. Gdy klient zgłosi, że paczka trafiła w inne miejsce, obsługa od razu zobaczy, co wybrał, a programista szybciej ustali, na którym etapie kod się zmienił.

Zmiana punktu po złożeniu zamówienia

Klienci regularnie proszą o zmianę punktu odbioru już po złożeniu zamówienia, np. dlatego, że wybrali paczkomat przy starym adresie. Jeśli przesyłka jeszcze nie powstała, wystarczy zmienić kod w zamówieniu, ale tylko w polu, z którego czyta go integracja wysyłkowa. Poprawka wpisana w notatce do zamówienia albo w polu adresu nic nie zmieni na etykiecie. Jeśli przesyłka już istnieje, trzeba ją anulować i utworzyć nową, o ile przewoźnik na to pozwala, albo skorzystać z jego usług przekierowania paczki. Dlatego panel obsługi powinien mieć prostą funkcję zmiany punktu z wyborem na tej samej mapie, a nie ręczne wpisywanie kodu, w którym łatwo o literówkę.

Paczkomaty w zamówieniach z marketplace'ów

Przy zamówieniach z marketplace'ów sklep nie wyświetla własnej mapy. Kupujący wybiera punkt odbioru na platformie, a kod punktu przychodzi razem z danymi zamówienia pobieranymi przez API marketplace'u lub przez integrator. Zadanie integracji jest wtedy prostsze, ale błędy wyglądają podobnie: kod musi zostać przeniesiony do właściwego pola zamówienia w sklepie lub ERP i przekazany do przesyłki. Warto też sprawdzić, czy przy imporcie zamówienia sklep nie nadpisuje punktu domyślnymi ustawieniami metody dostawy. Taki błąd jest trudny do wychwycenia, bo dotyczy tylko jednego kanału, a pozostałe zamówienia wychodzą poprawnie.

Typowe błędy widgetu mapy paczkomatów w sklepie

Poniżej błędy, które najczęściej znajdujemy przy przeglądach koszyków z dostawą do punktów odbioru. Większość z nich nie daje komunikatu o błędzie - zamówienie wygląda poprawnie aż do momentu tworzenia przesyłki.

1. Brak walidacji punktu - klient wybiera metodę „Paczkomat”, nie wybiera punktu i składa zamówienie. Obsługa musi dzwonić do klienta albo zgadywać punkt.

2. Punkt zapisany tylko w przeglądarce - kod jest przechowywany w skrypcie strony i znika po odświeżeniu, przejściu do płatności albo zalogowaniu.

3. Punkt niepasujący do metody - klient wybrał punkt z mapy dla przesyłek opłaconych, a potem zmienił metodę na pobranie. Punkt może nie obsługiwać pobrania.

4. Mapa nie działa na telefonie - kontener widgetu ma zerową wysokość, mapa otwiera się pod innymi elementami albo przycisk wyboru jest poza ekranem.

5. Token przypisany do innej domeny - mapa działa na produkcji, ale nie na wersji testowej, albo odwrotnie po migracji sklepu na nową domenę.

6. Optymalizacja skryptów psuje widget - wtyczka do łączenia i opóźniania skryptów zmienia kolejność ładowania i mapa nie inicjuje się na części stron.

7. Kod nie trafia do integratora - zamówienie ma punkt w sklepie, ale po imporcie do integratora lub ERP pole jest puste, więc etykieta powstaje bez punktu.

[#chart:wpr68c]

[#uwaga] Punkt odbioru może stać się niedostępny między złożeniem zamówienia a nadaniem paczki, np. z powodu awarii lub zamknięcia. Integracja powinna obsłużyć błąd przewoźnika przy tworzeniu przesyłki i zgłosić zamówienie do obsługi, która skontaktuje się z klientem w sprawie zmiany punktu, zamiast ponawiać próbę w nieskończoność.

Gotowa wtyczka czy własna integracja mapy punktów odbioru

Dla popularnych platform sklepowych przewoźnicy i agregatorzy udostępniają gotowe wtyczki, które łączą mapę z metodą dostawy i z tworzeniem przesyłek. To zwykle najlepszy wybór dla sklepu z jednym lub dwoma przewoźnikami i standardowym koszykiem. Własna integracja mapy ma sens w kilku sytuacjach:

• sklep ma niestandardowy koszyk albo działa w architekturze headless, w której wtyczki platformy nie wyświetlają się na froncie,

• klient ma wybierać punkty kilku sieci na jednej mapie, a nie w kilku osobnych oknach,

• kod punktu musi trafić do własnego ERP, WMS lub middleware w określonym formacie,

• gotowa wtyczka koliduje z motywem, wtyczkami płatności lub optymalizacją strony i nie da się tego rozwiązać konfiguracją.

Warto też pamiętać o rozwiązaniach, w których klient wybiera punkt poza koszykiem sklepu, np. w aplikacji przewoźnika przy szybkim zakupie. Wtedy sklep nie wyświetla własnej mapy, ale nadal musi poprawnie odebrać kod punktu z zamówienia. Przykład takiego wdrożenia opisujemy w artykule InPost Pay w WooCommerce - wdrożenie szybkiego zakupu.

Wydajność i dostępność mapy w koszyku

Mapa z tysiącami punktów to ciężki element strony. Skrypt widgetu warto ładować tylko na stronie koszyka lub zamówienia i dopiero wtedy, gdy klient wybierze metodę punktową, a nie na każdej podstronie sklepu. Dobrze też mieć plan na sytuację, w której mapa się nie załaduje: komunikat z prośbą o odświeżenie albo alternatywną wyszukiwarkę punktu po adresie lub kodzie. Klient, który nie może wybrać punktu, zwykle nie zmienia metody dostawy, tylko porzuca koszyk. Warto również sprawdzić, czy okno mapy da się zamknąć i obsłużyć z klawiatury oraz czy przycisk wyboru punktu jest widoczny na małych ekranach bez przewijania wewnątrz mapy.

Jak testować widget mapy przed wdrożeniem

Testy widgetu warto prowadzić na kopii sklepu, z tokenem wygenerowanym dla domeny testowej. Dokumentacja Geowidgetu InPost wspomina, że dla środowiska testowego uruchamianego lokalnie przy generowaniu tokenu nie podaje się domeny. Scenariusze powinny obejmować wybór punktu na komputerze i telefonie, zmianę metody dostawy po wyborze punktu, odświeżenie strony, logowanie w trakcie zamówienia, płatność z przekierowaniem do bramki i powrót oraz utworzenie przesyłki w środowisku testowym przewoźnika. Dopiero przejście całej ścieżki, aż do etykiety z właściwym kodem, oznacza, że integracja działa.

[#checklista] Przed uruchomieniem mapy punktów odbioru sprawdź: czy każda metoda punktowa ma własną konfigurację mapy; czy zamówienia bez punktu są blokowane; czy punkt zostaje po odświeżeniu i powrocie z płatności; czy kod jest widoczny w panelu, w mailu i w integratorze; czy mapa działa na telefonie; czy token obejmuje domenę produkcyjną i testową; czy błąd przewoźnika przy niedostępnym punkcie trafia do obsługi.

Jak Vinson pomaga z paczkomatami i punktami odbioru w sklepie

Programiści Vinson wdrażają mapy punktów odbioru w sklepach na WooCommerce, Shoperze, PrestaShop i Shopify oraz w sklepach headless. Konfigurujemy gotowe wtyczki przewoźników, a tam, gdzie nie wystarczają, osadzamy widgety bezpośrednio, dodajemy walidację punktu, zapis kodu w zamówieniu i jego przekazanie do integratora, ERP i API przewoźnika. Naprawiamy też koszyki, w których punkt znika po płatności albo nie trafia na etykietę. Więcej znajdziesz na stronie Wsparcie programistyczne dla e-commerce.

Najczęściej zadawane pytania

Jak dodać mapę paczkomatów InPost do sklepu internetowego?

Najprościej przez gotową wtyczkę InPost lub agregatora dla Twojej platformy. Przy własnej integracji dołącza się skrypt i style Geowidgetu z domeny geowidget.inpost.pl, wstawia element mapy z publicznym tokenem z Managera Paczek i obsługuje zdarzenie wyboru punktu, zapisując jego kod w zamówieniu.

Dlaczego wybrany paczkomat nie zapisuje się w zamówieniu?

Najczęściej kod punktu jest trzymany tylko w przeglądarce i ginie po odświeżeniu lub przekierowaniu do płatności albo sklep zapisuje go w innym polu, niż odczytuje wtyczka wysyłkowa. Trzeba sprawdzić, gdzie zapisywany jest wybór i czy zamówienie bez punktu jest blokowane.

Jak pokazać na mapie tylko punkty obsługujące pobranie?

Widgety przewoźników pozwalają filtrować typy punktów. W Geowidgecie InPost służy do tego atrybut config z wartością przeznaczoną dla przesyłek pobraniowych. Metoda dostawy z pobraniem powinna otwierać mapę z taką konfiguracją, a zmiana metody powinna czyścić wcześniej wybrany punkt.

Czy jedna mapa może pokazywać punkty kilku przewoźników?

Tak, takie mapy udostępniają m.in. agregatorzy przesyłek, a można też zbudować własną integrację łączącą dane kilku sieci. Trzeba wtedy pilnować, żeby razem z kodem punktu zapisywał się przewoźnik i żeby metoda dostawy w zamówieniu odpowiadała wybranej sieci.

Co zrobić, gdy wybrany punkt odbioru jest niedostępny przy nadaniu?

Przewoźnik zwykle zwraca wtedy błąd przy tworzeniu przesyłki. Integracja powinna przekazać zamówienie do obsługi, która ustali z klientem nowy punkt, i dopiero potem ponowić utworzenie przesyłki z nowym kodem.

Mapa paczkomatów to tylko początek ścieżki - o poprawnej dostawie decyduje to, czy kod punktu bezpiecznie dotrze do etykiety. Dlatego testuj całą ścieżkę, od kliknięcia na mapie aż po wydruk, po każdej większej zmianie w sklepie i w integracjach. Jeśli punkt odbioru w Twoim sklepie gubi się po drodze, sprawdź wsparcie programistyczne Vinson.