ORLEN Paczka - integracja ze sklepem internetowym krok po kroku

ORLEN Paczka jest obsługiwana szeroko - ma własne wtyczki na popularne platformy, jest w multi-integratorach i udostępnia API. Wybór między nimi to nie kwestia funkcji, tylko tego, kto utrzymuje połączenie i co się dzieje, gdy coś się zmieni.

Wtyczka jest najtańsza w starcie i najbardziej krucha przy aktualizacjach - o czym za chwilę. Multi-integrator kosztuje abonament, ale zdejmuje utrzymanie i daje jedno miejsce na wszystkich kurierów. Według cennika SellIntegro plan Standard to 99 zł netto miesięcznie do 500 zamówień, ceny sprawdzone u dostawcy 7 sierpnia 2026.

Własne API ma sens przy sklepie na autorskim silniku albo przy procesie, którego wtyczka nie obsłuży. Dokumentacja przewoźnika obejmuje generowanie etykiet, śledzenie przesyłki i zamawianie podjazdu kuriera, więc materiał do pracy jest.

To jest miejsce, w którym najwięcej wdrożeń staje, i prawie nikt nie pisze o tym wprost. Wtyczki przewoźnika mają twarde wymagania co do wersji sklepu.

Według dokumentacji ORLEN Paczka wtyczka dla WooCommerce wymaga wersji 10.0 lub nowszej, dla PrestaShopa obsługiwane są 1.7.8.x oraz 8.2.1-8.2.3 i 9.0.0, a dla Magento 2.4.7 i 2.4.8, z osobnym modułem dla Hyvä Checkout.

Konsekwencja jest prosta i kosztowna: jeśli sklep stoi na starszej wersji, integracja nie jest projektem na jedno popołudnie, tylko na aktualizację sklepu. A aktualizacja WooCommerce o kilka wersji w górę potrafi ruszyć motyw, płatności i szablon koszyka.

Kolejność jest więc odwrotna, niż zwykle zakłada klient. Najpierw sprawdź wersję sklepu i zgodność z wtyczką, potem planuj wdrożenie kuriera. Jeśli sklep jest za stary, a aktualizacja nie wchodzi w grę teraz, multi-integrator bywa jedyną sensowną drogą - działa po API, więc nie zależy od wersji platformy w takim stopniu.

Przy przesyłkach do punktów kluczowa jest mapa w koszyku i to, co dzieje się z wyborem klienta po jego stronie.

Trzy rzeczy do sprawdzenia przy odbiorze wdrożenia:

1. Czy identyfikator punktu zapisuje się w zamówieniu jako osobne pole. Jeśli ląduje tylko w komentarzu albo w treści adresu, przy nadawaniu trzeba go przepisywać ręcznie. To działa przy dziesięciu przesyłkach dziennie i przestaje przy pięćdziesięciu.
2. Czy mapa ładuje się na urządzeniach mobilnych. Widget mapy to zewnętrzny skrypt - przy agresywnym cache albo przy zgodach na pliki cookie potrafi się nie pokazać, a klient zostaje z pustym miejscem w koszyku.
3. Co się dzieje, gdy punkt zostanie zamknięty. Między złożeniem zamówienia a nadaniem mija czasem kilka dni.

Dane z naszych wdrożeń pokazują, że przy 500 przesyłkach miesięcznie ręczne przepisywanie punktu odbioru pochłania kilkanaście godzin pracy - przy stawce 50 zł za godzinę to kilkaset złotych miesięcznie wyrzucone na czynność, którą powinna wykonać integracja.

Większość integracji kurierskich odpytuje przewoźnika o statusy cyklicznie: co godzinę, co kilkanaście minut. Działa, ale generuje ruch i opóźnienie.

ORLEN Paczka udostępnia mechanizm, który warto znać, bo zmienia architekturę po Twojej stronie. Uniwersalny Pusher statusów to webhook - przewoźnik sam publikuje zdarzenie o zmianie statusu przesyłki, zamiast czekać, aż Twój system zapyta.

Praktyczne różnice są trzy: status u klienta pojawia się od razu zamiast po kolejnym cyklu odpytania, znika ruch generowany przez ciągłe zapytania, a przy większej liczbie przesyłek nie trzeba skalować samego odpytywania.

Warunek jest jeden i bywa przeoczony: webhook wymaga adresu, pod który przewoźnik może wysłać zdarzenie. Sklep musi być dostępny publicznie, z poprawnym certyfikatem i endpointem, który przyjmie zgłoszenie także wtedy, gdy przyjdzie kilka naraz. Przy sklepach za VPN-em albo w środowisku testowym to nie zadziała.

Etykieta wygląda na najprostszą część i bywa źródłem najbardziej upierdliwych problemów, bo błąd wychodzi dopiero przy nadaniu paczki.

Jeśli korzystasz z gotowej wtyczki albo integratora, etykieta powstaje po ich stronie i temat znika. Problem zaczyna się przy własnej integracji: przewoźnik publikuje instrukcję składania etykiety i własny wydruk trzeba do niej dostosować. Nie chodzi o estetykę, tylko o to, żeby sortownia odczytała kod.

Do sprawdzenia przed startem produkcyjnym:

Test na jednej paczce nadanej fizycznie jest wart więcej niż godzina czytania dokumentacji. Zrób go przed uruchomieniem, nie po pierwszej reklamacji.

Katalogi integracji wymieniają, co się synchronizuje. Milczą o rzeczach, które decydują o tym, ile pracy zostaje po wdrożeniu.

Pobranie. Kwota pobrania musi trafić do przewoźnika i wrócić w rozliczeniu. Rozjazd między kwotą zamówienia a kwotą pobrania to typowe źródło ręcznej roboty w księgowości.

Gabaryty i wagi. Jeśli w kartotece produktów nie ma wymiarów, integracja podstawi wartości domyślne. Przy paczkach nietypowych kończy się to dopłatą po stronie przewoźnika.

Zwroty. Etykieta zwrotna to osobny proces, a w e-commerce zwrot jest normą.

Wiele punktów nadania. Przy dwóch magazynach dane nadawcy muszą się przełączać automatycznie.

Dane z naszych wdrożeń pokazują, że sama wtyczka albo abonament rzadko przekracza 10% kosztu takiego projektu - reszta to mapowanie danych, testy i obsługa wyjątków.

Jeśli równolegle wdrażasz innego przewoźnika, mechanika jest podobna - opisaliśmy ją przy konfiguracji DHL w WooCommerce.

Rzadziej, niż się wydaje. Gotowa wtyczka albo integrator obsługują większość sklepów i są tańsze w utrzymaniu, bo ktoś inny reaguje na zmiany po stronie przewoźnika.

Własne API ma sens przy trzech warunkach: sklep stoi na autorskim silniku, proces nadawania jest nietypowy (przesyłki łączone, nadania z kilku lokalizacji, warunkowy wybór kuriera), albo wolumen jest na tyle duży, że abonament integratora przestaje się opłacać wobec kosztu utrzymania własnego kodu.

Warto wiedzieć, że nie wszystkie narzędzia obsługują tego przewoźnika. Przy teście integratora open source sprawdziliśmy listę gotowych adapterów nadawczych - były tam InPost i DPD Polska, ale ORLEN Paczki ani DHL już nie. W rozwiązaniach otwartych brakujący moduł da się dopisać, tylko trzeba to policzyć jako osobną pozycję w projekcie.

Spinamy sklepy z kurierami w ramach wdrożeń e-commerce. Jeśli nie wiesz, czy w Twoim przypadku wystarczy wtyczka, napisz przez formularz kontaktowy - podaj platformę sklepu z wersją, liczbę przesyłek miesięcznie i to, czy nadajesz z jednego magazynu, czy z kilku.