ORLEN Paczka: integracja z WooCommerce krok po kroku

Integracja ORLEN Paczki ma połączyć wybór dostawy przez klienta z pracą osoby pakującej zamówienie. Zanim pobierzesz moduł, ustal, gdzie mają powstawać etykiety: w panelu WooCommerce, w zewnętrznym systemie czy w osobnej aplikacji. Od tej decyzji zależy zakres konfiguracji oraz odpowiedzialność za błędy.

Oficjalna strona integracji ORLEN Paczki udostępnia rozwiązania dla platform sklepowych i dokumentację techniczną. Ten poradnik opisuje oficjalną wtyczkę WooCommerce. Rozszerzenie innego producenta może mieć podobną nazwę, ale inne ustawienia, licencję i sposób obsługi. Nie przenoś do niego bez sprawdzenia instrukcji menu z tego modułu.

Integrator nie zastępuje automatycznie całej konfiguracji sklepu. Klient nadal musi zobaczyć odpowiednią metodę oraz wybrać punkt, a ta informacja musi trafić do systemu nadawczego. Przy kilku magazynach lub kanałach sprzedaży rozpisz przepływ jednego zamówienia. Ogólne zasady znajdziesz w poradniku o wysyłce w sklepie internetowym.

Według instrukcji oficjalnego modułu WooCommerce, wersja dokumentu 25.02 wymagania obejmują WooCommerce 10 lub nowszy, WordPress 6.8 lub nowszy i PHP 8.1 lub nowszy. Dokument wymienia również rozszerzenia cURL, JSON i SOAP oraz możliwość zapisu w katalogu uploads. To wymagania opisanego modułu, nie uniwersalna specyfikacja wszystkich sposobów połączenia z ORLEN Paczką.

Minimalna wersja PHP podana przez producenta nie jest zaleceniem pozostawienia starego środowiska bez aktualizacji. Administrator powinien osobno sprawdzić wsparcie bezpieczeństwa oraz zgodność wszystkich składników sklepu. Numer wersji WooCommerce nie odpowie też na pytanie, czy konkretny motyw i zmieniony checkout poprawnie wyświetlą mapę.

Przed instalacją przygotuj kopię plików i bazy oraz sprawdź możliwość odtworzenia sklepu. Moduł instalowany z paczki ZIP pobieraj ze źródła wskazanego przez przewoźnika. Na kopii testowej zweryfikuj aktywację i zapisz komunikaty błędów. Jeśli sklep nie spełnia wymagań, najpierw oceń zakres aktualizacji; nie każda różnica wersji oznacza przebudowę całego serwisu.

W planie prac uwzględnij także dotychczasowe metody dostawy. Nowe rozszerzenie powinno przejść test współpracy z nimi, zanim stanie się dostępne klientom. W przypadku sklepu działającego już produkcyjnie ustal okno wdrożenia i osobę, która sprawdzi pierwsze zamówienia po zmianie.

PartnerID i PartnerKey służą do połączenia z usługą przewoźnika, natomiast widget mapy korzysta z osobnego tokenu. Poprawna autoryzacja jednej części nie dowodzi, że druga również działa. Jeżeli panel potwierdza połączenie, lecz klient widzi puste miejsce zamiast punktów odbioru, sprawdź konfigurację mapy i błędy przeglądarki, zamiast od razu zmieniać klucz API.

Instrukcja ORLEN rozróżnia środowisko testowe i produkcyjne oraz odpowiadające im dane dostępowe. Nie mieszaj kluczy między środowiskami. Opisz w dokumentacji wdrożenia, którego zestawu użyto, lecz same sekrety przechowuj w uzgodnionym bezpiecznym miejscu. Zrzut ustawień wysyłany do wykonawcy powinien mieć zamazane klucze i dane klientów.

Uzupełnij również nadawcę. Konto z prawidłową autoryzacją, ale z niepoprawnym adresem nadania nie przechodzi jeszcze pełnego odbioru. Osoba obsługująca przesyłki powinna wiedzieć, który nadawca jest domyślny i co zrobić, gdy zamówienie realizuje inny magazyn.

Sprawdzenie konfiguracji rozbij na trzy wyniki: autoryzacja usługi, wyświetlenie mapy i poprawne dane nadawcy. Taki zapis pozwala szybko ustalić, co faktycznie zostało przetestowane. Ogólne potwierdzenie, że integracja działa, zaciera różnicę między dostępem do API a gotowością do realizacji zamówień.

Oficjalną metodę ORLEN Paczki trzeba skonfigurować w odpowiedniej strefie wysyłki WooCommerce. Samo włączenie wtyczki nie oznacza, że opcja pojawi się dla każdego adresu. Jeśli metody brakuje, odtwórz problem z konkretnym krajem, kodem pocztowym i zawartością koszyka. Następnie sprawdź dopasowaną strefę oraz aktywność metody.

Dokumentacja opisuje naliczanie ceny według gabarytu albo wartości zamówienia. Reguły powinny odpowiadać ofercie sklepu i rzeczywistemu sposobowi pakowania. Cena prezentowana klientowi jest decyzją handlową sklepu; nie zakładaj, że musi być identyczna z rozliczeniem przewoźnika. Warunki darmowej dostawy sprawdzaj razem z kuponami i pozostałymi metodami, jeżeli sklep ich używa.

Uzupełnij wymiary oraz wagę produktów. Zgodnie z instrukcją brak wymiarów może uruchomić domyślny gabaryt, a brak wagi skutkować przyjęciem wartości 0,1 kg. Taka wartość zastępcza nie potwierdza rzeczywistej masy paczki. Nie używaj jej jako sposobu obejścia brakujących danych katalogowych.

Po przekroczeniu skonfigurowanych progów metoda może zostać ukryta albo otrzymać stałą stawkę, zależnie od ustawień. Przetestuj koszyk tuż przed progiem, dokładnie na nim i po przekroczeniu. Dla zestawu produktów sprawdź także przyjęty sposób pakowania. Pomocny jest osobny poradnik: brak metod wysyłki w koszyku WooCommerce.

Mapa to dopiero początek procesu. Wybrany punkt musi zostać zapisany w zamówieniu, a osoba przygotowująca paczkę powinna go odnaleźć bez przepisywania danych z wiadomości klienta. Sprawdź, czy wybór pozostaje poprawny po zmianie metody dostawy, powrocie do formularza i odświeżeniu podsumowania.

Test odbiorczy powinien wykazać, co dzieje się przy próbie kontynuowania zakupu bez wybranego punktu. Sklep ma jasno wskazać brakującą informację. Nie zakładaj, że widoczny przycisk mapy zapewnia walidację. Zmieniony checkout, skrypt optymalizacyjny lub rozszerzenie formularza mogą wymagać osobnego sprawdzenia. Więcej o samym formularzu opisuje optymalizacja checkoutu.

Kolejne kroki to przygotowanie przesyłki oraz pobranie etykiety. Oficjalna instrukcja opisuje historię nadań, etykiety i logi. Porównaj identyfikator punktu oraz parametry przesyłki z zatwierdzonym scenariuszem. Sam zapis zamówienia w WooCommerce nie jest dowodem utworzenia nadania u przewoźnika.

Próby wykonuj z danymi testowymi i dostępem przeznaczonym do testów, bez przekazywania prawdziwej przesyłki do realizacji. Jeśli dane narzędzie wymaga innego sposobu bezpiecznego sprawdzenia etykiet, uzgodnij go z dostawcą. Po wdrożeniu odróżniaj status zamówienia od statusu przesyłki; ich zmiana nie musi oznaczać tego samego zdarzenia.

Zapisz dokładny objaw oraz etap, na którym się pojawia. Pusta mapa, niewidoczna metoda i błąd etykiety mają inne możliwe przyczyny. Usuwanie całej konfiguracji przed zebraniem informacji utrudnia porównanie i może stworzyć kolejny problem.

Przed ponowieniem operacji nadania sprawdź historię. Jeżeli odpowiedź została przerwana, brak potwierdzenia w przeglądarce nie przesądza, że operacja nie doszła do skutku. Ustal jej wynik, aby nie tworzyć niepotrzebnie kolejnej przesyłki.

ORLEN publikuje także dokumentację Pushera. Jej obecność nie oznacza, że każdy sklep musi mieć własny webhook ani że zainstalowana wtyczka wykorzystuje wszystkie możliwości API. Sposób aktualizacji statusów potwierdź dla wybranego modułu lub integratora. Przy zgłoszeniu podaj wersje, czas błędu, etap procesu i oczekiwany wynik, bez kluczy oraz pełnych danych odbiorcy.

Odbiór integracji obejmuje panel administratora oraz drogę klienta na telefonie. Otwórz mapę na wąskim ekranie, wybierz punkt, zamknij okno i sprawdź podsumowanie. Nazwa oraz adres punktu powinny być czytelne. Sprawdź również zmianę wyboru, przewijanie mapy i możliwość powrotu do pozostałych pól formularza.

Osobie obsługującej sklep przekaż krótką instrukcję: gdzie sprawdzić punkt, jak pobrać etykietę, gdzie znaleźć historię i kiedy przekazać błąd do pomocy technicznej. Ustal odpowiedzialność za aktualizacje modułu, dane nadawcy i reguły cenowe. Dzięki temu zmiana cennika dostawy nie pozostanie wyłącznie w wiedzy wykonawcy.

Po wdrożeniu można objąć sklep opieką w uzgodnionych pakietach godzinowych. Zakres powinien określać, jakie zmiany i kontrole obejmuje obsługa, jak zgłaszać awarie oraz jakie warunki reakcji zapisano w umowie. Samo określenie SLA nie wyznacza liczby godzin ani dostępności wsparcia.

Jeżeli potrzebujesz wdrożenia lub uporządkowania integracji, opisz obecny proces w formularzu kontaktowym. Dołącz nazwę modułu, wersje środowiska i objaw bez danych dostępowych. Zakres prac nad sklepami internetowymi dobierzemy do istniejącej konfiguracji, sposobu pakowania i planowanej obsługi po uruchomieniu.