Jak działa integracja z ORLEN Paczką?

Integracja z ORLEN Paczką automatyzuje wybór punktu odbioru, tworzenie przesyłki, generowanie etykiety i tracking. Sklep lub ERP przekazuje dane paczki do przewoźnika i odbiera jej numer oraz status.

Integracja z firmą kurierską lub operatorem punktów odbioru nie polega wyłącznie na dodaniu kolejnej metody dostawy w koszyku. Pełna integracja powinna obsłużyć cały proces – od wyboru punktu przez klienta aż po informację, że przesyłka została odebrana.

W przypadku ORLEN Paczki przepływ może wyglądać następująco:

zamówienie → wybór punktu lub automatu → zapis danych dostawy → utworzenie przesyłki → etykieta → nadanie → tracking → doręczenie.

ORLEN Paczka udostępnia gotowe integracje dla popularnych platform sklepowych, a dla własnych systemów również API i widget mapy punktów. Obecnie oficjalna strona integracji wskazuje między innymi rozwiązania dla WooCommerce, PrestaShop i Magento. (ORLEN Paczka)

Co właściwie robi integracja z ORLEN Paczką?

Bez integracji sprzedawca może być zmuszony do wykonywania wielu czynności ręcznie:

Przy kilku paczkach dziennie jest to możliwe.

Przy kilkuset zamówieniach zaczyna być źródłem kosztów i błędów.

Integracja powoduje, że dane mogą przepływać automatycznie między systemami.

Przykładowo:

sklep → ERP → ORLEN Paczka

a później:

ORLEN Paczka → ERP → sklep → klient.

Integracja rozpoczyna się już w koszyku

Pierwszym widocznym dla klienta elementem jest metoda dostawy.

Klient kupuje produkt i wybiera:

ORLEN Paczka – dostawa do punktu lub automatu.

Samo zaznaczenie metody dostawy nie wystarcza.

System musi jeszcze wiedzieć:

do którego dokładnie miejsca paczka ma zostać wysłana.

Dlatego kolejnym elementem integracji jest wybór punktu odbioru.

Jak klient wybiera automat lub punkt odbioru?

Najwygodniejszym rozwiązaniem jest mapa.

Po wybraniu ORLEN Paczki klient może zobaczyć dostępne lokalizacje i wskazać odpowiedni automat albo punkt odbioru.

ORLEN Paczka udostępnia w tym celu własny widget mapy. Dla widgetu wykorzystywany jest indywidualny token dostępowy. Oficjalna dokumentacja API przewiduje również metody pozwalające pobierać informacje o lokalizacjach bezpośrednio do własnego systemu. (ORLEN Paczka)

Dzięki temu sklep może prezentować klientowi między innymi:

Najważniejszy jest kod punktu, a nie jego nazwa

Wyobraźmy sobie, że klient wybiera:

Automat ORLEN Paczka przy ul. Przykładowej 10.

Dla człowieka taka nazwa wystarczy.

System potrzebuje jednak jednoznacznego identyfikatora.

Dlatego wraz z zamówieniem powinien zostać zapisany przede wszystkim:

kod punktu odbioru.

Adres i nazwa mogą się zmienić albo być zapisane w różny sposób. Kod pozwala systemowi przekazać do przewoźnika właściwe miejsce docelowe.

Jakie dane powinny zostać zapisane przy zamówieniu?

Dobra integracja nie powinna zachowywać wyłącznie informacji:

Dostawa: ORLEN Paczka.

W zamówieniu warto posiadać przynajmniej:

Najważniejsze jest to, aby informacje te nie występowały wyłącznie w komentarzu do zamówienia.

Powinny być zapisane w polach, które może odczytać system.

Dlaczego nie warto zapisywać punktu w komentarzu?

Zły model wygląda tak:

Uwagi klienta: proszę wysłać do automatu ORLEN przy stacji na ul. X.

Pracownik rozumie wiadomość.

API nie.

Lepszy model:

carrier = ORLEN

destination_code = ABC123

Dzięki temu przesyłkę można utworzyć automatycznie.

Co dzieje się po opłaceniu zamówienia?

Załóżmy, że klient:

System może zmienić status:

Nowe → Do realizacji.

W tym momencie nie musi jeszcze powstawać przesyłka.

W wielu sklepach lepiej tworzyć ją dopiero wtedy, gdy magazyn rzeczywiście przygotuje zamówienie.

Przykładowo:

Do realizacji → Spakowane → Utwórz przesyłkę.

Dzięki temu nie generujesz etykiet dla zamówień, które później zostaną anulowane.

Jak system tworzy przesyłkę?

W przypadku własnej integracji system wysyła do API ORLEN Paczki dane wymagane do awizacji.

Mogą one obejmować między innymi:

Aktualne API ORLEN Paczki działa jako webservice SOAP i obsługuje SOAP 1.1 oraz SOAP 1.2, przy czym operator rekomenduje SOAP 1.2. Dostęp produkcyjny wykorzystuje dane PartnerID i PartnerKey; dane środowiska testowego i produkcyjnego są oddzielne. (ORLEN Paczka)

Czy sklep musi komunikować się bezpośrednio z ORLEN Paczką?

Nie.

Możliwych architektur jest kilka.

Wariant 1. Sklep → ORLEN Paczka

Najprostszy układ.

Sklep:

Wariant 2. Sklep → ERP → ORLEN Paczka

Sklep przekazuje zamówienie do ERP.

Dopiero ERP tworzy przesyłkę.

To dobre rozwiązanie, gdy magazyn pracuje głównie w systemie ERP.

Wariant 3. Sklep → integrator → ORLEN Paczka

Pośredni system obsługuje wielu przewoźników.

Sklep komunikuje się z jednym integratorem, który następnie wysyła dane do odpowiedniego operatora.

Wariant 4. Marketplace → system zamówień → ORLEN Paczka

Zamówienie pochodzi np. z marketplace, następnie trafia do centralnego OMS lub ERP i dopiero stamtąd tworzona jest przesyłka.

Nie istnieje więc jedna prawidłowa architektura.

Kluczowe jest ustalenie:

który system odpowiada za tworzenie przesyłki?

Jeden system powinien być właścicielem procesu wysyłki

Bardzo łatwo stworzyć problem, jeśli paczkę można wygenerować jednocześnie:

Pracownik może wtedy nieświadomie utworzyć dwie przesyłki do jednego zamówienia.

Dlatego warto przyjąć zasadę:

jedno zamówienie → jedno źródło tworzenia przesyłki.

Na przykład:

Etykiety ORLEN Paczki zawsze generuje ERP.

Sklep jedynie odbiera numer przesyłki i status.

Co zwraca system po utworzeniu przesyłki?

Po prawidłowym awizowaniu system otrzymuje dane pozwalające dalej obsługiwać paczkę.

Najważniejszym elementem jest:

numer przesyłki.

Powinien zostać zapisany przy zamówieniu.

Przykład:

zamówienie: ZAM-2026-10542
przewoźnik: ORLEN Paczka
numer paczki: 21...
status: utworzona

Od tego momentu numer paczki staje się kluczowym identyfikatorem w komunikacji z przewoźnikiem.

Numer przesyłki powinien wrócić również do sklepu

Jeżeli przesyłka jest tworzona w ERP, nie wystarczy zapisać jej wyłącznie tam.

Warto wykonać synchronizację:

ERP → sklep

i dopisać do zamówienia:

Dzięki temu obsługa klienta nie musi przełączać się między systemami.

Automatyczne generowanie etykiet

Jedną z najważniejszych funkcji integracji jest generowanie etykiety.

ORLEN Paczka wskazuje generowanie etykiet jako jedną z funkcji swojego API. Gotowe moduły dla platform sklepowych również obsługują tworzenie etykiet pojedynczo oraz zbiorczo. (ORLEN Paczka)

Proces może wyglądać następująco:

pracownik zaznacza 40 zamówień → Utwórz przesyłki → Pobierz etykiety.

Nie trzeba otwierać każdego zamówienia osobno.

Etykieta może powstać automatycznie po zmianie statusu

Jeszcze większa automatyzacja:

Jeżeli zamówienie ma status „Spakowane” i metodę ORLEN Paczka, automatycznie utwórz przesyłkę.

Następnie:

Pobierz etykietę i wyślij ją do stanowiska pakowania.

Taki proces pozwala znacząco ograniczyć liczbę kliknięć.

Nie zawsze jednak pełna automatyzacja jest najlepsza.

Jeżeli w magazynie często zmienia się:

bezpieczniejszy może być etap ręcznego zatwierdzenia przesyłki.

Gabaryt S, M czy L?

Przy tworzeniu przesyłki trzeba prawidłowo określić jej rozmiar.

W aktualnej ofercie ORLEN Paczki dla przesyłek do automatów i punktów stosowane są trzy gabaryty:

Takie parametry wskazuje aktualna dokumentacja operatora. (ORLEN Paczka)

Skąd system powinien znać gabaryt?

Są trzy popularne rozwiązania.

Gabaryt przypisany do produktu

Przykład:

SKU ABC → S

Dobre dla sklepu sprzedającego produkty o przewidywalnym rozmiarze.

Gabaryt wyliczany z koszyka

System analizuje:

Następnie wybiera odpowiednią paczkę.

To rozwiązanie jest bardziej skomplikowane, ponieważ produkty nie zawsze dają się zapakować w sposób wynikający ze zwykłego dodawania wymiarów.

Gabaryt wybierany podczas pakowania

Pracownik fizycznie pakuje zamówienie i wybiera:

S / M / L.

W wielu magazynach jest to najbezpieczniejsze rozwiązanie.

Integracja może obsługiwać również wysyłki zbiorcze

Przy większej liczbie zamówień istotna jest obsługa masowa.

Pracownik powinien móc zaznaczyć:

zamówienia 101–150

i jednym procesem:

Oficjalna wtyczka dla WooCommerce obsługuje między innymi etykiety pojedyncze i zbiorcze oraz generowanie protokołów dla partii przesyłek. (ORLEN Paczka)

Czym jest protokół przekazania?

Przy większych wysyłkach można przygotować dokument obejmujący partię przesyłek przekazywanych przewoźnikowi.

API ORLEN Paczki udostępnia metodę generowania protokołu, a dokument zwracany jest w formacie PDF.

W praktyce proces magazynowy może wyglądać:

50 paczek → 50 etykiet → jeden protokół przekazania.

Czy można zamówić podjazd kuriera?

Taką możliwość przewidują oficjalne rozwiązania integracyjne ORLEN Paczki. Dokumentacja API zawiera obsługę zamówienia podjazdu, a oficjalna strona integracji wprost wymienia zamawianie kuriera wśród funkcji dostępnych przez API. (ORLEN Paczka)

Dzięki temu pracownik może wykonać operację z poziomu systemu, w którym obsługuje zamówienia.

Nie musi osobno logować się do kolejnego panelu.

Co dzieje się po nadaniu paczki?

Utworzenie etykiety nie kończy integracji.

Druga część procesu to:

tracking.

Przesyłka przechodzi przez kolejne etapy logistyczne.

System może pobierać statusy ORLEN Paczki i tłumaczyć je na własne statusy biznesowe.

Przykładowo:

Nie zawsze warto pokazywać klientowi wszystkie techniczne statusy operatora.

API pozwala pobierać aktualny status przesyłki

Aktualna dokumentacja udostępnia między innymi metodę zwracającą ostatni status konkretnej paczki oraz metodę historii statusów. W przypadku standardowego odpytywania system może więc sprawdzić:

Jaki jest obecny stan przesyłki 21...?

i zapisać odpowiedź przy zamówieniu.

Odpytywanie API nie jest jedynym rozwiązaniem

Najprostszy mechanizm:

co 30 minut sprawdź status wszystkich aktywnych paczek.

To działa, ale nie jest optymalne.

Załóżmy, że sklep ma 20 000 aktywnych przesyłek.

System może wykonywać ogromną liczbę zapytań, mimo że przez większość czasu status większości paczek się nie zmienił.

Lepszym rozwiązaniem może być webhook.

ORLEN Paczka udostępnia Pusher statusów

Oficjalnie dostępny jest mechanizm określany jako Uniwersalny Pusher.

Działa jak webhook:

status paczki się zmienił → ORLEN Paczka wysyła zdarzenie do systemu sprzedawcy.

Nie trzeba więc nieustannie pytać:

Czy coś się zmieniło?

Operator wskazuje, że rozwiązanie umożliwia przekazywanie zmian statusów w czasie rzeczywistym i ogranicza konieczność cyklicznego odpytywania API. (ORLEN Paczka)

Jak wygląda webhook w praktyce?

Przykładowy scenariusz:

Wszystko odbywa się automatycznie.

Nie zmieniaj statusu zamówienia na podstawie samej etykiety

To częsty błąd.

System generuje etykietę i natychmiast ustawia:

Wysłane.

Tymczasem paczka nadal leży na stole w magazynie.

Lepsze rozróżnienie:

Etykieta utworzona

i dopiero później:

Przyjęta przez przewoźnika.

Dzięki temu obsługa klienta widzi rzeczywisty stan realizacji.

Statusy techniczne trzeba mapować na statusy biznesowe

Przewoźnik może posiadać wiele technicznych kodów.

Sklep nie potrzebuje ich wszystkich.

Można stworzyć mapowanie:

statusy 1, 2, 3 → W przygotowaniu

statusy 4, 5 → W transporcie

status 6 → Do odbioru

status 7 → Doręczona

status 8 → Zwrot

Wtedy proces pozostaje czytelny.

Co zrobić z nieznanym statusem?

Integracja powinna być odporna na zmiany.

Zły kod:

jeśli status nie znajduje się na naszej liście, zgłoś błąd całej synchronizacji.

Lepszy:

zapisz oryginalny status, oznacz go jako nieznany i zgłoś administratorowi.

Dzięki temu pojawienie się nowego kodu u przewoźnika nie zatrzyma całego systemu.

Śledzenie paczki może być dostępne dla klienta

Po otrzymaniu numeru przesyłki sklep może udostępnić go:

ORLEN Paczka posiada własny serwis śledzenia przesyłek, a numer paczki jest używany do identyfikowania jej w trackingu.

Klient nie musi więc kontaktować się ze sklepem tylko po to, aby zapytać:

Gdzie jest moja paczka?

Co z powiadomieniami dla klienta?

Tutaj trzeba rozróżnić dwa rodzaje informacji.

Powiadomienia przewoźnika

Dotyczą obsługi samej dostawy.

Powiadomienia sklepu

Dotyczą zamówienia.

Sklep może przykładowo wysłać:

Zamówienie zostało wysłane.

Nie musi jednak powielać każdego komunikatu operatora.

Najważniejsze jest zachowanie spójności.

Nie powinno dojść do sytuacji, w której sklep wysyła:

Paczka została doręczona,

gdy według przewoźnika dopiero oczekuje na odbiór.

Czy ORLEN Paczka obsługuje przesyłki za pobraniem?

To miejsce, w którym szczególnie ważne jest sprawdzanie aktualnych zasad zamiast polegania wyłącznie na dawnych integracjach lub nazwach pól w API.

Obecny FAQ ORLEN Paczki informuje, że operator nie realizuje dostaw z metodą płatności za pobraniem. (ORLEN Paczka)

Dlatego w sklepie nie powinno się oferować kombinacji:

ORLEN Paczka + płatność przy odbiorze

tylko dlatego, że starszy kod integracji zawiera pole związane z COD.

Integracja powinna odzwierciedlać aktualną ofertę operatora.

Etykieta nie powinna być generowana zbyt wcześnie

Aktualna dokumentacja API wskazuje, że etykiety wygenerowane przez API są ważne przez 14 dni. Jeżeli przesyłka w tym czasie nie zostanie przyjęta do sieci, awizo jest automatycznie anulowane.

To kolejny argument, aby nie generować etykiet:

natychmiast po złożeniu każdego zamówienia,

jeżeli magazyn realizuje zamówienia dopiero za kilka dni.

Co z anulowaniem zamówienia?

Wyobraźmy sobie:

Nie wystarczy zmienić statusu zamówienia w sklepie.

System powinien również wiedzieć, że istnieje utworzona przesyłka.

W zależności od możliwości API i etapu procesu trzeba:

Najgorszy model to usunięcie numeru przesyłki z zamówienia i udawanie, że paczka nigdy nie istniała.

Nie usuwaj historii przesyłek

Jeżeli pracownik utworzył przesyłkę błędnie, system powinien zachować ślad.

Przykład:

10:15 – utworzono paczkę 21...

10:18 – anulowano

10:20 – utworzono paczkę 21...

Dzięki temu można później ustalić:

Integracja powinna obsługiwać błędy

API może odrzucić przesyłkę.

Powodem może być przykładowo:

System nie powinien wtedy pokazać jedynie:

Error 500.

Dobra integracja przetłumaczy problem na komunikat:

Nie można utworzyć przesyłki – brakuje numeru telefonu odbiorcy.

Nie oznaczaj zamówienia jako wysłane, jeżeli API zwróciło błąd

Proces powinien być transakcyjny:

wyślij dane → odbierz prawidłową odpowiedź → zapisz numer paczki → dopiero zmień status.

Nie odwrotnie.

Jeżeli API przestanie odpowiadać w połowie operacji, system musi wiedzieć, co rzeczywiście się wydarzyło.

Bardzo ważna jest ochrona przed duplikatami

Wyobraźmy sobie:

Może powstać druga paczka.

Dlatego system powinien stosować własny identyfikator referencyjny i kontrolować, czy zamówienie posiada już przesyłkę.

Przed wygenerowaniem kolejnej powinien odpowiedzieć na pytanie:

Czy dla tego zamówienia nie utworzyliśmy już paczki?

Dane referencyjne pomagają powiązać paczkę z zamówieniem

W integracji warto przekazywać numer własnego zamówienia.

Przykład:

ZAM-2026-14521

Dzięki temu później łatwiej powiązać:

zamówienie ↔ przesyłkę ↔ etykietę ↔ tracking.

Numer referencyjny nie zastępuje numeru przewozowego, ale pomaga w diagnostyce.

Co z przesyłkami tworzonymi przez API i panel operatora?

To istotne ograniczenie techniczne.

Aktualna dokumentacja ORLEN Paczki wskazuje, że przesyłki awizowane przez API nie są widoczne w systemie WebTrucker i odwrotnie. Operator informuje również, że oba kanały wykorzystują odrębne numeracje i historię przesyłek API należy przechowywać po stronie integracji. (ORLEN Paczka)

To oznacza, że nie należy projektować rozwiązania z założeniem:

jeśli czegoś zabraknie w ERP, zawsze znajdziemy to w panelu.

System korzystający z API powinien sam przechowywać historię.

Dlaczego własna baza przesyłek jest potrzebna?

Warto przechowywać przynajmniej:

Nie wystarczy pole:

numer listu przewozowego.

Logi integracji są bardzo ważne

Jeżeli klient zgłasza:

wybrałem inny automat,

trzeba móc sprawdzić:

Bez logów każda reklamacja zamienia się w zgadywanie.

Czy zapisywać pełne requesty i response'y API?

Tak, ale z odpowiednią ochroną.

Żądania mogą zawierać:

Nie powinny więc trafiać bez ograniczeń do publicznych logów aplikacji.

Dobrą praktyką jest:

Dostęp do API powinien być przechowywany bezpiecznie

PartnerID i PartnerKey nie powinny znajdować się:

Komunikacja z API powinna odbywać się po stronie serwera.

Przeglądarka klienta nie powinna otrzymywać danych autoryzacyjnych do systemu wysyłkowego.

Środowisko testowe jest niezbędne

ORLEN Paczka posiada osobne środowisko testowe i produkcyjne, a dane uwierzytelniające dla obu środowisk są różne. (ORLEN Paczka)

Przed uruchomieniem integracji produkcyjnej warto sprawdzić cały scenariusz:

punkt → zamówienie → API → etykieta → tracking.

Nie należy rozpoczynać testów od prawdziwych klientów.

Co dokładnie należy przetestować?

Nie tylko:

Czy udało się wygenerować jedną etykietę?

Pełny test powinien obejmować:

Integracja nie powinna blokować sklepu podczas awarii przewoźnika

To szczególnie ważne w checkout.

Jeżeli API operatora chwilowo nie odpowiada, klient nadal powinien móc w rozsądnym zakresie korzystać ze sklepu.

W zależności od architektury można:

Awaria zewnętrznego API nie powinna automatycznie oznaczać awarii całej sprzedaży.

Lista punktów powinna być aktualizowana

Nie warto raz pobrać punktów i korzystać z tej bazy przez rok.

Lokalizacje mogą:

Jeżeli korzystasz z własnej bazy punktów zamiast aktualnego widgetu, potrzebujesz mechanizmu regularnej synchronizacji.

Co zrobić, gdy punkt wybrany przez klienta stanie się niedostępny?

Taki przypadek musi być obsłużony.

System może:

Nie powinien samodzielnie wysyłać paczki do przypadkowego punktu tylko dlatego, że znajduje się blisko.

Czy integracja może obsługiwać zwroty?

API ORLEN Paczki zawiera również operacje związane z przesyłkami zwrotnymi. Własny system może więc rozbudować proces o tworzenie zwrotu i powiązanie go z wcześniejszym zamówieniem. (api.orlenpaczka.pl)

Dobry model danych:

zamówienie → przesyłka wychodząca → ewentualna przesyłka zwrotna.

Zwrot nie powinien być traktowany jako niezależna paczka bez informacji, czego dotyczy.

Jak wygląda integracja ORLEN Paczki krok po kroku?

Krok 1. Podłącz konto

Skonfiguruj dane dostępu wymagane przez wybrane rozwiązanie.

Krok 2. Uruchom mapę punktów

Klient powinien móc wybrać właściwe miejsce odbioru.

Krok 3. Zapisuj kod punktu przy zamówieniu

Nie tylko jego nazwę.

Krok 4. Ustal sposób wyboru gabarytu

Automatycznie lub podczas pakowania.

Krok 5. Ustal system nadrzędny

Zdecyduj, czy przesyłki tworzy sklep, ERP, WMS czy integrator.

Krok 6. Przekaż dane do ORLEN Paczki

System awizuje paczkę.

Krok 7. Zapisz numer przesyłki

Powinien zostać powiązany z zamówieniem.

Krok 8. Pobierz etykietę

Można ją wydrukować bezpośrednio na stanowisku pakowania.

Krok 9. Nadaj paczkę

W punkcie lub zgodnie z ustaloną logistyką odbioru.

Krok 10. Aktualizuj tracking

Przez API lub webhook.

Krok 11. Aktualizuj zamówienie

Status przewoźnika powinien być mapowany na status sklepu lub ERP.

Krok 12. Zachowaj historię

Numery, statusy, błędy i wykonane operacje powinny być możliwe do odtworzenia.

Przykład działania integracji

Klient składa zamówienie:

ZAM-10542.

Wybiera:

ORLEN Paczka

oraz automat:

punkt ABC123.

System zapisuje:

ZAM-10542 → ORLEN Paczka → ABC123.

Magazyn pakuje produkt i wybiera:

gabaryt M.

ERP wysyła do operatora:

API zwraca:

numer paczki 21...

ERP zapisuje numer i pobiera etykietę.

Pracownik ją drukuje.

Po przyjęciu przesyłki przez operatora status zostaje zaktualizowany:

wysłana.

Później:

w drodze.

Następnie:

gotowa do odbioru.

Na końcu:

odebrana.

Cały proces może odbywać się bez ręcznego przepisywania danych.

Co daje integracja przy 20 przesyłkach dziennie?

Załóżmy, że ręczne przygotowanie jednej przesyłki zajmuje dwie minuty.

20 paczek:

40 minut dziennie.

Przy 22 dniach roboczych:

około 15 godzin miesięcznie.

Jeżeli integracja skróci pracę do masowego zaznaczenia zamówień i wydruku etykiet, oszczędność może być znacząca.

Przy 200 przesyłkach dziennie różnica jest już znacznie większa.

Największą korzyścią nie zawsze jest jednak czas

Równie ważne jest ograniczenie błędów.

Ręczne przepisywanie może spowodować:

Automatyczne przenoszenie danych zmniejsza liczbę miejsc, w których człowiek musi je ponownie wpisywać.

Jakie funkcje powinna mieć dobra integracja z ORLEN Paczką?

Warto szukać rozwiązania, które obsługuje:

Nie każda firma potrzebuje wszystkich funkcji.

Sklep wysyłający 30 paczek miesięcznie ma inne wymagania niż magazyn realizujący kilka tysięcy przesyłek dziennie.

Gotowa wtyczka czy własne API?

Gotowa wtyczka

Najlepsza, gdy korzystasz ze standardowej platformy.

Zalety:

Własna integracja API

Lepsza, gdy:

ORLEN Paczka oficjalnie udostępnia zarówno gotowe rozwiązania dla wybranych platform, jak i API do integracji własnych systemów. (ORLEN Paczka)

Najczęstsze błędy przy integracji z ORLEN Paczką

Zapisywanie tylko nazwy punktu

Zamiast jego jednoznacznego kodu.

Tworzenie paczki od razu po wejściu zamówienia

Mimo że zamówienie może zostać anulowane.

Brak rozróżnienia „etykieta utworzona” i „paczka wysłana”

Prowadzi do błędnej informacji dla klienta.

Brak zabezpieczenia przed duplikatami

Jedno zamówienie może otrzymać kilka przesyłek.

Brak historii API

Później nie wiadomo, dlaczego powstała dana etykieta.

Ręczna zmiana punktu w kilku systemach

Dane zaczynają się rozjeżdżać.

Brak aktualizacji punktów

Klient może wybrać lokalizację, która nie jest już dostępna.

Brak webhooka lub synchronizacji statusów

Numer paczki istnieje, ale system nie wie, co dalej się z nią dzieje.

Udostępnienie danych API w frontendzie

Stwarza ryzyko bezpieczeństwa.

Założenie, że API i panel mają tę samą historię

W przypadku ORLEN Paczki dokumentacja wyraźnie rozróżnia przesyłki awizowane przez API i przez WebTrucker. (ORLEN Paczka)

Podsumowanie

Integracja z ORLEN Paczką powinna automatyzować znacznie więcej niż samo generowanie etykiety.

Pełny proces wygląda najczęściej tak:

klient wybiera ORLEN Paczkę → wskazuje punkt → sklep zapisuje kod lokalizacji → zamówienie trafia do realizacji → system tworzy przesyłkę → otrzymuje numer → pobiera etykietę → paczka zostaje nadana → statusy wracają do sklepu lub ERP.

Największą wartość daje połączenie wszystkich etapów.

Jeżeli punkt jest wybierany automatycznie, ale później pracownik przepisuje go ręcznie do panelu przewoźnika, mamy jedynie częściową integrację.

Jeżeli natomiast dane zamówienia, etykieta, numer przesyłki i tracking przepływają pomiędzy systemami bez ręcznego przepisywania, proces może działać niemal całkowicie automatycznie.

Właśnie na tym polega dobrze zaprojektowana integracja logistyczna.

FAQ – integracja z ORLEN Paczką

Czy ORLEN Paczka posiada API?

Tak. ORLEN Paczka udostępnia API przeznaczone między innymi do tworzenia przesyłek, generowania etykiet, śledzenia paczek i obsługi wybranych procesów logistycznych. (ORLEN Paczka)

Czy ORLEN Paczka posiada gotowe wtyczki do sklepów?

Tak. Aktualnie oficjalna strona integracji udostępnia rozwiązania między innymi dla WooCommerce, PrestaShop i Magento. (ORLEN Paczka)

Czy klient może wybrać punkt ORLEN Paczki na mapie?

Tak. Operator udostępnia widget mapy, który można wykorzystać podczas wyboru metody dostawy. (ORLEN Paczka)

Czy trzeba zapisywać kod punktu?

Tak. Kod lokalizacji powinien być zapisany razem z zamówieniem, ponieważ umożliwia jednoznaczne przekazanie miejsca dostawy do systemu operatora.

Czy można automatycznie generować etykiety?

Tak. Generowanie etykiet jest jedną z podstawowych funkcji integracji API oraz gotowych modułów ORLEN Paczki. (ORLEN Paczka)

Czy można drukować etykiety zbiorczo?

Taką funkcję posiadają między innymi oficjalne rozwiązania integracyjne dla sklepów internetowych. (ORLEN Paczka)

Czy ORLEN Paczka obsługuje gabaryty S, M i L?

Tak. Dla przesyłek do automatów i punktów stosowane są gabaryty S, M i L, z maksymalną wagą 20 kg. (ORLEN Paczka)

Czy ORLEN Paczka obsługuje pobranie?

Według aktualnego FAQ operatora ORLEN Paczka nie realizuje obecnie dostaw z płatnością za pobraniem. (ORLEN Paczka)

Czy można śledzić paczkę przez API?

Tak. Dokumentacja przewiduje metody pobierania aktualnego statusu oraz historii statusów przesyłki.

Czy statusy mogą być przesyłane automatycznie?

Tak. ORLEN Paczka udostępnia Uniwersalny Pusher – mechanizm webhook przekazujący zdarzenia o zmianie statusu przesyłki. (ORLEN Paczka)

Czy webhook jest lepszy od ciągłego sprawdzania statusów?

Przy większej liczbie przesyłek zazwyczaj tak. System otrzymuje informację po zmianie statusu, zamiast cyklicznie odpytywać API o tysiące paczek.

Czy można zamówić kuriera przez integrację?

Taką możliwość przewiduje API ORLEN Paczki oraz oficjalne rozwiązania integracyjne. (ORLEN Paczka)

Czy można obsłużyć zwroty?

API zawiera również operacje związane z tworzeniem przesyłek zwrotnych. (api.orlenpaczka.pl)

Jak długo ważna jest etykieta wygenerowana przez API?

Aktualna dokumentacja ORLEN Paczki wskazuje okres 14 dni od wygenerowania. Jeżeli przesyłka w tym czasie nie zostanie przyjęta do sieci, awizo zostaje automatycznie anulowane.

Czy przesyłki utworzone przez API są widoczne w WebTruckerze?

Nie należy tego zakładać. Aktualna dokumentacja wskazuje, że przesyłki awizowane w API i w WebTruckerze funkcjonują w dwóch różnych systemach, a historia przesyłek API powinna być przechowywana po stronie integracji. (ORLEN Paczka)

Czy do integracji potrzebne są dane dostępowe?

Tak. Własna integracja API korzysta z danych PartnerID i PartnerKey. ORLEN Paczka rozdziela dane środowiska testowego i produkcyjnego. (ORLEN Paczka)

Czy warto integrować ORLEN Paczkę przy małej liczbie zamówień?

Tak, jeżeli zależy Ci na ograniczeniu ręcznego przepisywania danych i błędów. Największe oszczędności pojawiają się jednak przy większej liczbie paczek, gdy można wykorzystać masowe generowanie przesyłek, etykiet i automatyczną synchronizację statusów.