Przejdź do głównej zawartości

ORLEN Paczka API

Globe Pickup Points integruje się z ORLEN Paczka, polskim przewoźnikiem, który doręcza do własnych punktów odbioru i automatów paczkowych. Dzięki tej integracji możesz:

  • Eksportować zamówienia do ORLEN Paczki bezpośrednio z Shopify
  • Drukować etykiety wysyłkowe w Shopify
  • Wysyłać do punktów odbioru i automatów paczkowych ORLEN Paczka w Polsce
  • Śledzić przesyłki na stronie śledzenia ORLEN Paczka

Potrzebujesz konta ORLEN Paczka z podpisaną umową: z konta PREPAID nie można nadawać przesyłek.

  1. W panelu administracyjnym Shopify otwórz Globe Pickup Points i przejdź do sekcji Etykiety wysyłkowe. Kliknij Dodaj integrację przewoźnika i wybierz ORLEN Paczka.
  2. Wprowadź Partner ID i Partner Key. ORLEN Paczka wysyła obie wartości e-mailem po aktywacji umowy. Jeśli ich nie masz, poproś o nie swojego opiekuna handlowego ORLEN Paczka. Partner Key jest taki sam jak hasło do WebTruckera, więc jeśli zmienisz hasło w WebTruckerze, zaktualizuj je też w Globe.
  3. Wybierz Środowisko: Produkcyjne dla prawdziwych przesyłek albo Programistyczne dla testowego API ORLEN Paczka.
  4. Wypełnij dane nadawcy: Nazwa firmy nadawcy, Ulica nadawcy, Numer domu nadawcy, Miasto nadawcy, Kod pocztowy nadawcy, Telefon nadawcy i Email nadawcy. Adres nadawcy jest drukowany na każdej etykiecie.
    • Kod pocztowy nadawcy to pięciocyfrowy polski kod pocztowy (NN-NNN, myślnik jest opcjonalny).
    • Telefon nadawcy to 9-cyfrowy polski numer, z prefiksem +48 lub bez niego.
    • Numer lokalu nadawcy jest opcjonalny. Na etykiecie pojawia się po numerze domu (12/4) i może mieć do 10 znaków.
    • Globe skraca dłuższe wartości: nazwę firmy do 70 znaków, ulicę i miasto do 30, a numer domu do 10.
  5. Skonfiguruj opcje realizacji i tagowania według potrzeb:
    • Automatycznie realizuj zamówienia: Nigdy, Tak, wyślij email z numerem śledzenia lub Tak, nie wysyłaj emaila. Po włączeniu tej opcji Globe po eksporcie realizuje zamówienie z numerem paczki jako numerem śledzenia, przewoźnikiem ORLEN Paczka i linkiem do strony śledzenia.
    • Automatycznie oznaczaj zamówienia numerem śledzenia dodaje numer paczki jako tag zamówienia.
    • Własny tag po eksporcie i Własny tag po druku dodają wybrany przez Ciebie tag po każdym udanym eksporcie lub wydruku.
  6. W sekcji Metody wysyłki przypisz swoje metody wysyłki z punktem odbioru do gabarytów paczek ORLEN Paczka. Gabaryt możesz zmienić dla każdego zamówienia podczas tworzenia etykiety.

Możesz eksportować zamówienia do ORLEN Paczki i drukować etykiety wysyłkowe bezpośrednio z Shopify, masowo lub pojedynczo. Cały proces tworzenia etykiet opisujemy w artykule Tworzenie etykiet wysyłkowych.

Eksport zamówienia tworzy jedną paczkę w ORLEN Paczce. Jej numer jest numerem śledzenia, a przesyłki można śledzić pod adresem https://www.orlenpaczka.pl/sledz-paczke/?numer=<parcel number>. Na każdej etykiecie widnieje numer zamówienia Shopify.

Globe pobiera etykiety z ORLEN Paczki przy każdym drukowaniu, w wybranym przez Ciebie formacie, więc możesz je później wydrukować ponownie.

Integracja nie synchronizuje statusów dostawy z powrotem do Shopify.


Podczas przypisywania metody wysyłki lub tworzenia etykiety wybierz gabaryt, który pasuje do paczki:

GabarytNazwa w Globe
SS (8 x 38 x 60 cm)
MM (19 x 38 x 60 cm)
LL (41 x 38 x 60 cm)

W każdym gabarycie paczka może ważyć do 20 kg. Globe sprawdza wagę przesyłki i nie eksportuje zamówienia powyżej 20 kg.


ORLEN Paczka doręcza tylko do własnych punktów odbioru i automatów paczkowych, bez dostawy do domu. Każde zamówienie wymaga punktu odbioru ORLEN Paczka, który klient wybiera w kasie. Jak udostępnić te punkty w kasie, opisujemy w artykule Dodawanie przewoźników z punktami odbioru.

Globe przekazuje punkt jako jego numeryczne ID w ORLEN Paczce, w formacie kodu uniwersalnego XX-<point ID>-00-00. Po tym kodzie ORLEN Paczka rozpoznaje punkt nawet wtedy, gdy zmieni się jego pełny kod (na przykład WS-116263-C3-01).

Zamówienie bez punktu ORLEN Paczka, także zamówienie z punktem z sieci innego przewoźnika, nie zostanie wyeksportowane.


ORLEN Paczka nie obsługuje płatności za pobraniem. ORLEN Paczka wyłączyła pobranie 2 stycznia 2025 r., a Globe nigdy nie wysyła kwoty pobrania. Panel tworzenia etykiety oznacza zamówienie z kwotą pobrania w sekcji Sprawdź przed eksportem, a eksport je odrzuca, bo paczka zostałaby wydana bez pobrania pieniędzy. Ustaw w panelu tworzenia etykiety pole Kwota pobrania na 0 albo wyślij zamówienie innym przewoźnikiem.

Ubezpieczenie też nie jest dostępne: ORLEN Paczka wyłączyła je 4 grudnia 2024 r., a Globe nie wysyła ubezpieczenia ani wartości paczki.


Etykiety ORLEN Paczka można drukować w następujących formatach:

FormatEtykiet na arkuszu
10x14 cm1
10x10 cm1

Domyślny format to 10x14 cm. Pasuje do arkuszy A6 i etykiet termicznych 100x150 mm. Format A4 nie jest dostępny. Format domyślny możesz zmienić w polu Domyślna opcja druku w ustawieniach przewoźnika.

Etykiety dla kilku zamówień są łączone w jeden plik PDF. Paczka, której nie da się wydrukować, na przykład dlatego, że została anulowana, jest pomijana, a pozostałe etykiety drukują się normalnie.


ProblemRozwiązanie
ORLEN Paczka Partner ID and Partner Key are not setWprowadź oba w ustawieniach przewoźnika.
ORLEN Paczka sender address is incompleteKomunikat wymienia brakujące lub nieprawidłowe wartości. Żadne zamówienie z partii nie zostanie wyeksportowane, dopóki nie poprawisz ich w ustawieniach przewoźnika. Kod pocztowy nadawcy wymaga pięciu cyfr, a Telefon nadawcy 9-cyfrowego polskiego numeru.
Order … has no ORLEN Paczka pickup pointZamówienie nie ma punktu odbioru albo jego punkt należy do sieci innego przewoźnika. Sprawdź punkt odbioru zamówienia (zobacz, gdzie jest zapisany), poproś klienta o punkt ORLEN Paczka albo wybierz go samodzielnie, a potem wyeksportuj zamówienie ponownie.
ORLEN Paczka has no cash on deliveryUstaw w panelu tworzenia etykiety pole Kwota pobrania na 0 albo użyj innego przewoźnika. Zobacz Płatność za pobraniem (COD).
ORLEN Paczka takes parcels up to 20 kg in every sizeJeśli waga jest błędna, popraw pole Waga przesyłki (kg) w panelu tworzenia etykiety. W przeciwnym razie wyślij zamówienie innym przewoźnikiem.
ORLEN Paczka needs the recipient's Polish phone number (9 digits)ORLEN Paczka wysyła powiadomienie o paczce gotowej do odbioru na polski numer telefonu. Dodaj polski numer klienta (9 cyfr, z +48 lub bez) do adresu wysyłki zamówienia i wyeksportuj je ponownie.
this account has no signed agreement (PREPAID)Z konta ORLEN Paczka bez podpisanej umowy nie można nadawać przesyłek. Skontaktuj się ze swoim opiekunem handlowym ORLEN Paczka. Globe próbuje anulować paczkę, którą ORLEN Paczka utworzyła dla zamówienia.
… the parcel may already existORLEN Paczka nie potwierdziła paczki, na przykład po przekroczeniu limitu czasu lub zerwaniu połączenia, ale mogła ją utworzyć. Globe nie ponawia próby automatycznie. Zanim ponownie wyeksportujesz zamówienie, sprawdź swoje konto ORLEN Paczka.
ORLEN Paczka created parcel … but Globe could not save itPaczka istnieje w ORLEN Paczce, ale Globe nie może wydrukować jej etykiety, a zamówienie nie zostało zrealizowane ani otagowane. Nie eksportuj zamówienia ponownie, bo ORLEN Paczka utworzyłaby drugą paczkę. Pobierz etykietę z ORLEN Paczki albo najpierw poproś ORLEN Paczkę o anulowanie paczki.
ORLEN Paczka: z inną przyczynąORLEN Paczka odrzuciła paczkę, a tekst po dwukropku podaje przyczynę. Usuń przyczynę i wyeksportuj zamówienie ponownie.
Etykiety się nie drukująORLEN Paczka nie zwróciła etykiety, na przykład z powodu problemu z danymi dostępowymi lub chwilowego błędu po swojej stronie. Sprawdź Partner ID i Partner Key albo wydrukuj ponownie później.
Brak etykiety w pliku PDFPaczka została anulowana, ORLEN Paczka jej nie znajduje albo należy ona do innego konta ORLEN Paczka. Globe ją pomija i drukuje pozostałe etykiety.