Elbuz tworzy paczkę ORLEN Paczka z zamówienia: kod automatu lub punktu jest brany z zamówienia, etykietę PDF drukujesz z karty, a o status paczki program pyta co 10 minut.
Kiedy to się przyda:
- Klienci odbierają paczki w automatach i na stacjach ORLEN — punkt z zamówienia jest już w formularzu listu przewozowego.
- W zamówieniu nie ma kodu punktu — pod polem pojawia się lista punktów w mieście odbiorcy.
- Dziennie wysyłasz dużo paczek — kuriera ORLEN Paczka zamawiasz z podglądu listu przewozowego.
Od czego zacząć: uzyskaj PartnerID i PartnerKey → wpisz je w Elbuz razem z adresem nadawcy.
Co potrafi ORLEN Paczka w Elbuz
- Paczka z zamówienia — do automatu, na stację ORLEN lub do punktu partnera.
- Podpowiedź punktów — lista punktów w mieście odbiorcy prosto pod polem kodu.
- Etykieta PDF — z karty zamówienia i z rejestru „Przesyłki”.
- Zamawianie kuriera — w przedziale godzin, który ORLEN Paczka proponuje dla Twojego kodu pocztowego.
- Statusy paczek — co 10 minut; zamówienie w wybranych statusach samo przechodzi na Twój status.
Jak podłączyć ORLEN Paczka: PartnerID i PartnerKey
Skąd wziąć PartnerID i PartnerKey
ORLEN Paczka udostępnia API klientom biznesowym na podstawie umowy. Wypełnij formularz na stronie Integracja z ORLEN Paczka — skontaktuje się z Tobą przedstawiciel.
- Dane do pracy przychodzą e-mailem przy aktywacji umowy.
- Dane do środowiska testowego są osobne, wydaje je Twój opiekun handlowy.
- PartnerKey jest taki sam jak hasło do WebTruckera: po zmianie hasła zaktualizuj je też w Elbuz.
Gdzie wpisać dostęp w Elbuz
Gdzie: „Usługi zewnętrzne i integracje” → grupa „Dostawa” → „ORLEN Paczka”.
- Włącz „Aktywność”.
- PartnerID wpisz w „Użytkownik”, PartnerKey — w „Hasło”.
- Wybierz „Domyślny gabaryt (S, M, L)”.
- Wypełnij blok „Nadawca”: nazwę firmy, kod pocztowy, miasto, ulicę, numer domu, telefon i e-mail. Wszystkie siedem pól jest obowiązkowych, adres drukuje się na etykiecie.
1
Użytkownik (PartnerID) i Hasło (PartnerKey)2
Domyślny gabaryt (S, M, L)3
Blok Nadawca- Użytkownik i Hasło zawierają PartnerID i PartnerKey wydane przez opiekuna handlowego ORLEN Paczka.
- Domyślny gabaryt ustala gabaryt paczki (S, M lub L), od którego zaczynają się nowe listy przewozowe.
- Blok Nadawca zawiera nazwę firmy, adres, telefon i e-mail drukowane jako nadawca na listach.
Formularz zapisuje się sam przy każdej zmianie pola. Dostęp nie jest sprawdzany przy zapisie: błąd pokaże dopiero pierwszy list przewozowy.
„Środowisko testowe (sandbox)” przełącza Elbuz na serwer testowy ORLEN Paczka; paczki stamtąd nigdzie nie jadą i nie da się ich śledzić na stronie ORLEN. Słownik punktów Elbuz pobiera sam co noc — to wiersz „Punkty ORLEN Paczka” w tabeli „Słowniki przewoźnika”.
Gabaryt paczki
| Gabaryt | Wymiary | Waga |
|---|---|---|
| S | 8 × 38 × 60 cm | do 20 kg |
| M (domyślnie) | 19 × 38 × 60 cm | do 20 kg |
| L | 41 × 38 × 60 cm | do 20 kg |
Gabaryt z rekordu przewoźnika formularz listu uzupełnia sam. Dla paczki innego rozmiaru wybierz go w formularzu w polu „Gabaryt (maks. wymiary, cm)” — rekordu przewoźnika nie trzeba zmieniać.
Jak wysłać zamówienie do punktu ORLEN Paczka
Gdzie: karta zamówienia → „Sposób dostawy” = „ORLEN Paczka” → sekcja „Dostawa” → „Utwórz list przewozowy” („Edytuj list przewozowy”, jeśli formularz był już otwierany).
Formularz bierze odbiorcę i punkt z zamówienia. ORLEN Paczka dostarcza tylko do punktów, więc bez kodu punktu list się nie utworzy.
1
Punkt ORLEN Paczka (kod)2
Gabaryt (maks. wymiary, cm)3
Utwórz list przewozowy- Kod punktu odbioru, do którego jedzie paczka, wzięty z zamówienia.
- Gabaryt tej paczki; domyślnie pochodzi z rekordu połączenia przewoźnika.
- Utwórz list przewozowy wysyła żądanie do ORLEN Paczka.
Punkt odbioru
Jeśli klient wybrał punkt na stronie, jego kod jest już w polu „Punkt ORLEN Paczka (kod)”. Jeśli nie, a w zamówieniu podano miasto — zacznij wpisywać: pod polem pojawi się lista punktów w tym mieście z kodem, typem i adresem.
Punkty są czterech typów: automat (APM), stacja ORLEN (PKN), punkt z obsługą (PPP) i punkt partnera PointPack (PPK). Łącznie jest ich ponad 15 000, w tym 8 000 automatów.
Odbiorca
Obowiązkowe są imię, nazwisko i telefon. Elbuz usuwa z telefonu spacje i znaki i odrzuca 48 na początku 11-cyfrowego numeru — ma zostać 9 cyfr. Imię i nazwisko — do 30 znaków.
Kod odbioru ORLEN Paczka wysyła SMS-em lub e-mailem, więc lepiej nie usuwać e-maila.
ORLEN Paczka od 2 stycznia 2025 roku nie przyjmuje pobrań, a od 4 grudnia 2024 roku — ubezpieczenia paczek. Dlatego w formularzu nie ma „Dostawa zwrotna (odbiorca)”, a zamówienia płatne przy odbiorze idą bez pobrania — zarówno pojedynczo, jak i zbiorczo.
Co się dzieje po kliknięciu „Utwórz list przewozowy”
- Elbuz sprawdza, czy w zamówieniu nie ma jeszcze numeru i czy wypełniono dostęp, nadawcę i punkt.
- Tworzy paczkę w ORLEN Paczka z gabarytem z formularza i numerem zamówienia.
- Zapisuje numer paczki w polu „Numer listu przewozowego”.
Wagi i opisu z formularza ORLEN Paczka nie dostaje. Jeśli wybrany punkt jest zamknięty, ORLEN sam zastępuje go aktualnym: list się utworzy, a w oknie „Utworzono list przewozowy” pojawi się kod nowego punktu.
Paczkę trzeba nadać w sieci ORLEN Paczka w ciągu 14 dni, inaczej etykieta zostanie automatycznie anulowana.
Druk etykiety i anulowanie
„Drukuj” przy numerze w podglądzie listu przewozowego albo „Drukuj list przewozowy” w „Przesyłkach” otwiera etykietę PDF. Elbuz pobiera ją z ORLEN Paczka sam, dane dostępu nie trafiają do przeglądarki.
Paczkę nadajesz w punkcie ORLEN Paczka w godzinach jego pracy albo przekazujesz kurierowi. Punkty PointPack tylko wydają paczki.
Anulować paczki z Elbuz nie można — tylko na koncie ORLEN Paczka, dopóki nie została nadana. Po anulowaniu wyczyść numer w polu „Numer listu przewozowego”, aby utworzyć list ponownie.
Jak zamówić kuriera ORLEN Paczka
Gdzie: karta zamówienia → „Podgląd listu przewozowego” → blok „Zamówienie kuriera”.
- Sprawdź „Data odbioru” — domyślnie najbliższy dzień roboczy.
- Godzin „Odbiór od” i „do” można nie podawać: Elbuz weźmie przedział, który ORLEN Paczka proponuje na ten dzień dla kodu pocztowego nadawcy.
- Kliknij „Zamów kuriera”.
Adres odbioru to blok „Nadawca” rekordu przewoźnika. ORLEN Paczka zwraca numer zlecenia: pojawia się w komunikacie i trafia do zamówienia; wynik zapisuje się w dzienniku zamówienia. Jeśli na ten dzień nie ma przedziału — „no courier pickup for ‹data›”, wybierz inną datę.
Jak Elbuz śledzi paczkę
Co 10 minut Elbuz pyta ORLEN Paczka o stan paczek, po jednej. ORLEN zwraca kod statusu i nazwę po polsku.
Kody ORLEN Paczka z tabeli poniżej Elbuz sam wpisuje w oknie „Statusy dostawy” rekordu „ORLEN Paczka” — na ich podstawie „Przesyłki” pokazują stan paczki. Kod spoza tabeli daje stan „Nieznany”. Jak działają okna kodów, opisuje artykuł o statusach przewoźnika.
| Status dostawy Elbuz | Kody ORLEN Paczka | Co oznacza |
|---|---|---|
| Zebrane | 210, 240 | nadana w punkcie lub automacie; odebrana przez kuriera |
| W miejscu docelowym | 620, 690, 695 | gotowa do odbioru; w punkcie; wysłano SMS do odbiorcy |
| Dostarczono | 1000 | odebrana przez klienta |
| Odrzucenie | 709, 750, 900 | nieodebrana w terminie; zwrot do nadawcy |
Kod 201 oznacza anulowaną paczkę. Te same kody ORLEN Paczka nadaje również przy zwrocie, a Elbuz bierze tylko kod — więc podczas zwrotu stan w „Przesyłkach” może powtarzać drogę paczki. Historii starszej niż 90 dni ORLEN nie udostępnia.
Paczka czeka na odbiorcę 3 dni robocze, w automacie — 72 godziny. Potem wraca do nadawcy na jego koszt.
„Śledź na stronie przewoźnika” w „Przesyłkach” otwiera orlenpaczka.pl/sledz-paczke z numerem paczki — ten sam link możesz dać klientowi.
Scenariusze
Klient wybrał automat na stronie
Kod automatu przychodzi w zamówieniu. Otwórz „Utwórz list przewozowy”, sprawdź odbiorcę, kliknij „Utwórz list przewozowy” i wydrukuj etykietę. Paczkę nadaj w punkcie ORLEN Paczka.
Wieczorny odbiór przez kuriera
Utwórz listy przewozowe do wszystkich paczek dnia. W jednym z nich otwórz „Podgląd listu przewozowego” i zamów kuriera na jutro bez godzin — ORLEN Paczka sam zaproponuje przedział.
Co zrobić, gdy coś pójdzie nie tak
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Firma kurierska nie jest podłączona: uzupełnij ustawienia API tej firmy…” | W rekordzie nie ma hasła (PartnerKey) albo „Aktywność” jest wyłączona | Wpisz dostęp i włącz rekord (gdzie wpisać) |
| „Error: sender address, phone and email are required (API settings)” | W bloku „Nadawca” puste jest choć jedno pole | Wypełnij wszystkie siedem pól nadawcy (nadawca) |
| „Error: ORLEN Paczka pickup point is required for recipient” | Nie podano kodu punktu | Wybierz punkt z listy pod polem (punkt odbioru) |
| „Error: name is required for recipient” lub „phone is required for recipient” | W zamówieniu nie ma imienia lub telefonu odbiorcy | Uzupełnij je w formularzu (odbiorca) |
| „Error: ORLEN Paczka: ‹kod› ‹opis›” | ORLEN Paczka nie przyjęła paczki; przyczyna jest w opisie | Popraw dane według treści błędu i utwórz list ponownie |
| W „Przesyłkach” stan „Nieznany” | Kody ORLEN Paczka nie są wpisane w „Statusy dostawy” | Wpisz kody (statusy) |
Najczęstsze pytania
Ile kosztuje integracja z ORLEN Paczka?
Elbuz nie pobiera opłat za paczki, etykiety ani statusy. Za paczki płacisz ORLEN Paczka zgodnie z umową.
Czy można wysłać paczkę ORLEN Paczka na adres klienta?
Nie, ORLEN Paczka dostarcza tylko do punktów: automatów, stacji ORLEN i punktów partnerów.
Czy można wybrać gabaryt dla pojedynczej paczki?
Tak: w formularzu listu przewozowego — pole „Gabaryt (maks. wymiary, cm)”. Domyślnie jest tam gabaryt z rekordu przewoźnika (gabaryt).
Jak długo paczka czeka w punkcie?
Kilka dni, potem ORLEN Paczka zwraca ją do nadawcy (terminy przechowywania).
Jak klient może śledzić paczkę?
Na stronie orlenpaczka.pl/sledz-paczke, po numerze paczki z pola „Numer listu przewozowego”.
Gdzie to jest i kto ma dostęp
- Menu
- Panel klienta → Ustawienia systemu → Inne ustawienia → Usługi zewnętrzne i integracje → Dostawa → ORLEN Paczka
- Inne wejścia
- Słowniki → Dokumenty → Przesyłki → „Przewoźnicy”; karta zamówienia → sekcja „Dostawa”
- Uprawnienia
- podłączenie — „API i tokeny dostępu”; list przewozowy i kurier — „Tworzenie listu przewozowego”; paczki — „Przesyłki”
- Przygotuj
- umowę z ORLEN Paczka, PartnerID i PartnerKey, adres nadawcy z telefonem i e-mailem
- Uzyskaj PartnerID i PartnerKeyORLEN Paczka, umowa
- Wpisz dostęp, gabaryt i nadawcęUsługi zewnętrzne i integracje → ORLEN Paczka
- Utwórz paczkęKarta zamówienia, sekcja „Dostawa”
- Wydrukuj etykietę, zamów kurieraPodgląd listu przewozowego
Powiązane tematy
- Jeśli chcesz widzieć paczki wszystkich przewoźników na jednej liście — rejestr „Przesyłki”.
- Jeśli klient potrzebuje pobrania — InPost w Elbuz lub Poczta Polska w Elbuz.
- Jeśli status zamówienia ma się zmieniać sam według statusu paczki — statusy przewoźnika.
- Jeśli listy przewozowe trzeba utworzyć do dziesiątek zamówień — listy przewozowe zbiorczo.
- Jeśli klient ma wybrać ORLEN Paczka w koszyku Twojego sklepu — to dostawa w sklepie Elbuz CMS.
