Orlen Paczka w sklepie internetowym - moduły i API
W sklepie internetowym integracja Orlen Paczka działa na podstawie Twojego konta i danych dostępowych do API, które przekazuje przewoźnik. Dostępne rozwiązania różnią się w zależności od platformy, dlatego przed wyborem sprawdź ich zakres (stan na sierpień 2026 - sprawdź aktualne listy integracji).
PrestaShop: przewoźnik udostępnia własny moduł z instrukcją, a w konfiguracji jest przycisk testu połączenia z API.
Shoper: w sklepie z aplikacjami dostępna jest aplikacja integrująca Orlen Paczka, a dane dostępowe przekazuje opiekun handlowy przewoźnika.
Inne platformy: wtyczki firm trzecich lub własna integracja na podstawie dokumentacji API Orlen Paczka.
Mapa punktów: niezależnie od platformy moduł musi pokazywać mapę automatów i punktów w koszyku i zapisywać wybór w zamówieniu.
Wtyczka w sklepie rozwiązuje problem tylko dla zamówień z tego sklepu. Jeśli sprzedajesz też na Allegro, Empiku czy innych marketplace'ach, każdy kanał trzeba by obsługiwać osobno. Dlatego sprzedawcy wielokanałowi przenoszą wysyłki do Base.
Jakie dane w zamówieniu są potrzebne do etykiety Orlen Paczka?
Integracja jest tak dobra, jak dane, które do niej trafiają. Jeśli w zamówieniu czegoś brakuje, przewoźnik odrzuci przesyłkę albo etykieta powstanie z błędem. Zanim włączysz automatyzację, upewnij się, że każde zamówienie zawiera komplet informacji.
Kod punktu lub automatu: zapisany w zamówieniu podczas wyboru w koszyku lub na Allegro.
Telefon i e-mail odbiorcy: potrzebne do powiadomień e-mail i SMS o przesyłce.
Gabaryt S, M lub L: przypisany do produktu albo ustawiony w domyślnej formatce przesyłki.
Dane nadawcy: adres nadania zgodny z kontem Orlen Paczka podłączonym do integracji.
Orlen Paczka w Base - jak skonfigurować automatyczne etykiety?
Base ma bezpłatną integrację z Orlen Paczka działającą przez API przewoźnika. Pozwala nadawać przesyłki pojedynczo, masowo lub w pełni automatycznie według reguł, a numer przesyłki od razu trafia do systemu i dalej do sklepu oraz marketplace'ów. Integracja generuje też książkę nadawczą i protokół przekazania. Konfiguracja przebiega w kilku krokach.
[#chart:kur74b]
Włącz integrację: w panelu Base dodaj Orlen Paczka w integracjach przewoźników i wpisz dane konta.
Ustaw formatkę: domyślny gabaryt, adres nadania i format etykiety pod drukarkę.
Powiąż metody dostawy: przypisz metody ze sklepu i marketplace'ów do usług Orlen Paczka albo do metod Allegro Delivery.
Dodaj akcje automatyczne: np. po zmianie statusu na „Do wysyłki” Base tworzy przesyłkę i drukuje etykietę.
Przetestuj: utwórz kilka przesyłek testowych i sprawdź etykietę, punkt odbioru oraz numer śledzenia u klienta.
Base pozwala podłączyć wiele kont Orlen Paczka, także to samo konto kilka razy z różnymi adresami nadania. Przydaje się to firmom z kilkoma magazynami. Gdy w sklepie działa kilku przewoźników, reguły mogą same wybierać kuriera według wagi, kraju czy kanału sprzedaży - szczegóły opisujemy we wpisie o automatycznym wyborze kuriera w Base.
Masowe nadawanie paczek Orlen Paczka w Base
Przy kilkudziesięciu zamówieniach dziennie wygodniej pracować na liście zamówień niż na pojedynczych kartach. Zaznaczasz zamówienia gotowe do wysyłki, tworzysz dla nich przesyłki jednym poleceniem i drukujesz etykiety seriami. Jeśli część zamówień ma braki, np. brak kodu punktu, Base zgłosi błąd tylko dla nich. Dobrą praktyką jest osobny status dla zamówień z błędem. Etykiety najwygodniej drukować na drukarce termicznej - więcej we wpisie o drukowaniu etykiet w BaseLinkerze.
| Ścieżka | Umowa z Orlen Paczka | Kanały | Dla kogo |
|---|
| Allegro Delivery | Nie | Tylko Allegro | Sprzedawcy tylko na Allegro |
| Moduł lub aplikacja w sklepie | Tak | Jeden sklep | Sklepy bez marketplace'ów |
| Base z integracją Orlen Paczka | Tak (lub Allegro Delivery dla Allegro) | Wszystkie kanały w jednym panelu | Sprzedaż wielokanałowa |
Jak przygotować produkty i zamówienia do integracji Orlen Paczka?
Automatyczne etykiety działają tylko wtedy, gdy system wie, jaki gabaryt przypisać do paczki i do którego punktu ją wysłać. Dlatego przed włączeniem automatyzacji warto uporządkować katalog i reguły dostaw. To jednorazowa praca, która potem oszczędza czas przy każdej przesyłce.
Wymiary i waga produktów: uzupełnij je w magazynie Base lub w sklepie, żeby reguły mogły dobrać gabaryt S, M lub L.
Produkty wykluczone: oznacz towary, które nie mieszczą się w gabarytach Orlen Paczka lub ważą ponad 20 kg, i wyłącz dla nich tę metodę.
Zamówienia wieloproduktowe: ustal regułę dla koszyków z kilkoma produktami, np. gabaryt według największego kartonu lub ręczna weryfikacja.
Nazwy metod dostawy: ujednolicić nazwy w sklepie i marketplace'ach, żeby mapowanie w Base było jednoznaczne.
Gabaryty Orlen Paczka to S do 8 cm, M do 19 cm i L do 41 cm wysokości, przy podstawie 38 × 60 cm i wadze do 20 kg (stan na sierpień 2026 - sprawdź aktualny regulamin). Jeśli przypiszesz gabaryt do produktu raz, integracja będzie go używać przy każdym zamówieniu bez decyzji pakowacza.
Testy przed uruchomieniem automatyzacji
Zanim etykiety zaczną tworzyć się same, przygotuj krótką listę przypadków testowych: zamówienie z Allegro, zamówienie ze sklepu, koszyk z kilkoma produktami, produkt w gabarycie L i zamówienie bez kodu punktu. Każdy przypadek przeprowadź przez cały proces - od utworzenia przesyłki, przez wydruk, po numer śledzenia u klienta. Tak wyłapiesz błędy, zanim trafią do kupujących.
Statusy i numery śledzenia Orlen Paczka - co dzieje się po utworzeniu etykiety?
Integracja nie kończy się na wydruku etykiety. Równie ważne jest to, czy klient dostaje numer śledzenia, czy zamówienie zmienia status i czy obsługa widzi, gdzie jest paczka. Dobrze ustawiona integracja zamyka obieg informacji bez ręcznej pracy.
Numer do kanału sprzedaży: Base przekazuje numer przesyłki do Allegro, sklepu lub innego marketplace'u.
E-mail do klienta: szablon z linkiem do śledzenia i informacją o czasie na odbiór paczki w punkcie.
Akcje na statusach przesyłki: np. po odebraniu paczki Base wysyła podziękowanie lub prośbę o opinię.
Kontrola nieodebranych: statusy pomagają wyłapać paczki, które czekają w punkcie lub wracają do nadawcy.
Etykiety Orlen Paczka nie generują się - co sprawdzić?
Większość problemów z integracją Orlen Paczka ma kilka powtarzalnych przyczyn: błędne dane dostępowe, braki w danych zamówienia albo niewłaściwie powiązane metody dostawy. Najczęstsze objawy i poprawki zebraliśmy poniżej.
[#chart:kur74c]
Gdy błąd dotyczy pojedynczych zamówień, zwykle winne są dane w zamówieniu. Gdy nie powstaje żadna etykieta, problem leży najczęściej w danych dostępowych albo w ustawieniach integracji. Przed zgłoszeniem do pomocy technicznej zapisz treść komunikatu, numer zamówienia i godzinę próby.
Kiedy integrację Orlen Paczka warto przejrzeć ponownie?
Integracja ustawiona raz nie zawsze działa bez zmian latami. Warto ją sprawdzić po dodaniu nowego kanału sprzedaży, nowej metody dostawy w koszyku, zmianie warunków z przewoźnikiem, przejściu na inne kartony albo otwarciu drugiego magazynu. Każda z tych zmian może sprawić, że część zamówień dostanie zły gabaryt lub trafi do niewłaściwego konta nadawcy.
[#tip] Przed włączeniem automatycznego tworzenia przesyłek uruchom akcję tylko dla jednego kanału sprzedaży albo jednej metody dostawy. Gdy przez kilka dni wszystko działa, rozszerz ją na pozostałe zamówienia.
Jak Vinson pomaga zintegrować Orlen Paczka z Allegro, sklepem i Base?
W Vinson wdrażamy integracje przewoźników od strony sklepu, Allegro i Base. Podłączamy Orlen Paczka w Base, mapujemy metody dostawy ze wszystkich kanałów, ustawiamy akcje automatyczne, statusy i drukowanie etykiet oraz reguły automatycznego wyboru kuriera. Jeśli korzystasz z kilku przewoźników, porównujemy koszty i dobieramy metody do produktów. Szczegóły znajdziesz na stronie wdrożenia Base. Nie jesteśmy partnerem Orlen Paczka - umowę z przewoźnikiem zawierasz bezpośrednio.
Vinson to agencja e-commerce z Bochni działająca od 2021 r., certyfikowany partner Base, Allegro Ads Partner+ i autoryzowany partner Shoper, z oceną 4,9/5 ze 171 opinii.
Najczęściej zadawane pytania
Czy Orlen Paczka ma integrację z BaseLinkerem?
Tak. W Base (dawniej BaseLinker) dostępna jest bezpłatna integracja Orlen Paczka działająca przez API przewoźnika. Pozwala tworzyć przesyłki i drukować etykiety pojedynczo, masowo lub automatycznie, a numer śledzenia od razu trafia do zamówienia. Można podłączyć kilka kont, np. dla różnych adresów nadania.
Jak generować etykiety Orlen Paczka automatycznie?
Najprościej przez system do obsługi zamówień, np. Base, z akcją automatyczną tworzącą przesyłkę po zmianie statusu zamówienia. Reguły dobierają metodę do wyboru klienta i gabarytu, a drukarka termiczna drukuje etykietę bez dodatkowych kliknięć. W samym sklepie podobnie działają moduły korzystające z API Orlen Paczka.
Czy do wysyłki Orlen Paczka z Allegro potrzebuję umowy z przewoźnikiem?
Nie, jeśli korzystasz z metod Allegro Automat ORLEN Paczka i Allegro Odbiór w Punkcie ORLEN Paczka w programie Allegro Delivery. Przesyłki rozliczasz wtedy z Allegro według jego cennika. Własna umowa jest potrzebna do wysyłek ze sklepu i innych kanałów.
Jakie platformy sklepowe mają integrację z Orlen Paczka?
Przewoźnik udostępnia własny moduł dla PrestaShop, a w Shoper dostępna jest aplikacja integrująca Orlen Paczka. Dla innych platform istnieją wtyczki firm trzecich albo można zbudować integrację na podstawie dokumentacji API. Sklepy wielokanałowe zwykle łączą Orlen Paczka przez Base.
Dlaczego etykieta Orlen Paczka nie generuje się w Base?
Najczęstsze przyczyny to błędne dane dostępowe konta, brak kodu punktu w zamówieniu, niepoprawny gabaryt albo metoda dostawy niepowiązana z Orlen Paczka. Sprawdź komunikat błędu przy zamówieniu, przetestuj połączenie w ustawieniach integracji i uzupełnij brakujące dane.
Automatyczne etykiety Orlen Paczka to jeden z najprostszych sposobów na szybsze pakowanie i mniej pomyłek. Jeśli chcesz zobaczyć, jak działa cały układ przewoźników w jednym panelu, przeczytaj o kurierach w BaseLinkerze, albo umów bezpłatną konsultację z Vinson - podłączymy Orlen Paczka do Twoich kanałów sprzedaży.