Paczkomat wybrany, ale niezapisany w zamówieniu PrestaShop: gdzie szukać problemu?

Gdy wybrany Paczkomat nie pojawia się w zamówieniu PrestaShop, prześledź ten sam identyfikator punktu od mapy aż do odczytu zamówienia. Samo wyświetlenie nazwy obok przycisku oznacza tylko, że interfejs odebrał wybór. Trzeba jeszcze potwierdzić zapis po stronie sklepu, zachowanie po zmianie dostawy oraz powiązanie danych z właściwym koszykiem.

Poradnik jest przeznaczony dla osób obsługujących zamówienia i wdrażających dostawy InPost. Pomaga zebrać konkretny materiał do diagnozy. Rozdziela problem mapy, zapisu danych i integracji checkoutu; nie zakłada, że każdy brak punktu wynika z błędu tego samego modułu.

1. Zapisz identyfikator, nie tylko adres punktu

Ulica, miasto i opis lokalizacji pomagają klientowi, ale integracja potrzebuje jednoznacznego identyfikatora. W danych Geowidgetu służy do tego pole name; osobno występują adres, typ i współrzędne. Strukturę tych danych opisuje oficjalna dokumentacja PointInterface.

W przykładzie użyjemy oznaczenia TEST-PUNKT-A. To celowo fikcyjny identyfikator do opisu przepływu, nie działający Paczkomat. W rzeczywistej próbie wybierz dostępny punkt z mapy i zanotuj jego prawdziwe oznaczenie. Nie wpisuj przykładowego kodu do produkcyjnej etykiety.

W zgłoszeniu problemu zapisz też wersję PrestaShop, motywu, modułu InPost i checkoutu. Ważna jest konkretna wersja oraz ewentualne modyfikacje. Nazwa „one page checkout” opisuje rodzaj procesu, ale nie wskazuje jednego interfejsu integracji.

2. Sprawdź kolejne etapy zapisu

Oczekiwany przepływ można zapisać prosto:

wybór punktu na mapie → odebranie danych przez stronę → żądanie zapisu → zapis przy koszyku → utworzenie zamówienia → odczyt punktu przez obsługę.

Każda strzałka oznacza osobne zdarzenie. Dokumentacja API Geowidgetu opisuje wybór punktu i przekazanie danych do funkcji obsługującej wybór. To aplikacja sklepu musi następnie prawidłowo wykorzystać otrzymane informacje.

3. Dlaczego nazwa na ekranie i HTTP 200 nie wystarczą

W przeglądarce otwórz kartę Network, wybierz punkt i odszukaj żądanie zapisu. Sprawdź odpowiedź aplikacji, a nie wyłącznie kolor wiersza. Serwer może prawidłowo dostarczyć dokument JSON, w którym znajduje się informacja o nieudanym zapisie. Status HTTP dotyczy odpowiedzi transportowej; jej treść wyjaśnia wynik operacji.

W źródłach InPost Paczkomaty Pro 2.8.7 dane punktu są zapisywane w tabeli modułu powiązanej z id_cart. Informacja dla zamówienia jest odczytywana przez jego koszyk. Nie należy więc diagnozować braku punktu wyłącznie przez szukanie osobnej kolumny z Paczkomatem w głównej tabeli zamówień.

W przejrzanej obsłudze Geowidgetu v5 interfejs pokazuje wybrany punkt jeszcze przed zakończeniem zapisu. Dlatego przy odbiorze integracji sprawdź również odpowiedź success, wartość machine oraz późniejszy odczyt. Nie traktuj samego odblokowania przycisku zakupu jako dowodu, że baza przyjęła wybór.

Do diagnozy można zachować zanonimizowany fragment odpowiedzi i godzinę operacji. Pełne pliki HAR często zawierają cookies, adresy i dane formularzy; nie udostępniaj ich publicznie. Osoba techniczna powinna otrzymać materiał z usuniętymi sekretami i danymi osobowymi.

4. Powtórz próbę po zmianie przewoźnika i adresu

Przepływ „wybrałem punkt i od razu kupiłem” to tylko jeden scenariusz. Klient może zmienić przewoźnika, wrócić do adresu, zalogować się albo ponownie przeliczyć dostawę. Każdy taki krok może przebudować fragment strony i zmienić dane koszyka.

W wersji 2.8.7 przejrzany hook zmiany adresu nie wykonuje automatycznego czyszczenia punktu. Obsługa zmiany przewoźnika usuwa zapis przy jawnym przejściu na innego przewoźnika spoza InPost; przejściowa wartość zero nie jest traktowana identycznie. To powód do sprawdzenia konkretnych przejść, a nie założenia, że każda zmiana miasta wymusi nowy wybór.

Tabela określa oczekiwany przebieg próby. Nie jest raportem z wysłanej paczki ani wynikiem testu wszystkich checkoutów. W prawdziwym odbiorze zastąp fikcyjne oznaczenia punktem z usługi i zapisz wynik każdego kroku.

5. Wskaż warstwę do naprawy, zanim zmienisz moduł

Jeśli mapa nie oddaje danych, zacznij od jej konfiguracji i błędów skryptów. Gdy żądanie zapisu powstaje, ale kończy się błędem, sprawdź endpoint, sesję koszyka i odpowiedź serwera. Jeżeli zapis jest poprawny, a znika dopiero przy zakupie, skup się na przejściu koszyk–zamówienie oraz integracji końcowego formularza.

Jeśli panel pokazuje punkt poprawnie, lecz inne narzędzie wysyłkowe go nie widzi, sprawdź sposób pobierania danych przez to narzędzie. Nie kopiuj ręcznie przypadkowego ID do zamówienia bez potwierdzenia, który punkt wskazał klient.

Przy planowanej zmianie koszyka wykorzystaj również listę kontroli one page checkout w PrestaShop. Punkt odbioru powinien być jednym z jawnych kryteriów odbioru, obok płatności, adresów i zakupów mobilnych.

Następny krok: porównaj wymagania swojej dostawy z InPost Paczkomaty Pro. Do zgłoszenia integracyjnego dołącz wersje, kroki zmiany dostawy i informację, na którym etapie identyfikator przestaje się zgadzać.

Sprawdzono 13.09.2026. Podstawa: źródła InPost Paczkomaty Pro 2.8.7 oraz dokumentacja Geowidgetu. Scenariusz i oznaczenia są demonstracyjne; nie wykonano produkcyjnego nadania ani testu zgodności każdego checkoutu.