Elbuz створює посилку ORLEN Paczka із замовлення: код автомата чи пункту береться з замовлення, етикетка PDF друкується з картки, а статус посилки програма питає кожні 10 хвилин.
Коли це знадобиться:
- Покупці забирають посилки в автоматах і на АЗС ORLEN — пункт із замовлення вже стоїть у формі накладної.
- Коду пункту в замовленні немає — під полем з'являється список пунктів міста одержувача.
- Посилок за день багато — кур'єра ORLEN Paczka викликаєте з перегляду накладної.
З чого почати: отримайте PartnerID і PartnerKey → впишіть їх і адресу відправника в Elbuz.
Що вміє ORLEN Paczka в Elbuz
- Посилка із замовлення — в автомат, на АЗС ORLEN чи в пункт партнера.
- Підказка пунктів — список пунктів міста одержувача прямо під полем коду.
- Етикетка PDF — з картки замовлення і з реєстру «Відправлення».
- Виклик кур'єра — у вікно, яке ORLEN Paczka пропонує для вашого індексу.
- Статуси посилок — кожні 10 хвилин; замовлення в позначених статусах переходить у ваш статус саме.
Як підключити ORLEN Paczka: PartnerID і PartnerKey
Де взяти PartnerID і PartnerKey
ORLEN Paczka відкриває API бізнес-клієнтам за договором. Заповніть формуляр на сторінці Integracja z ORLEN Paczka — з вами зв'яжеться представник.
- Дані для роботи приходять на e-mail під час активації договору.
- Дані для тестового середовища окремі, їх дає ваш opiekun handlowy.
- PartnerKey збігається з паролем WebTrucker: змінили пароль — оновіть його і в Elbuz.
Куди вписати доступ в Elbuz
Де: «Зовнішні сервіси та інтеграції» → група «Доставка» → «ORLEN Paczka».
- Увімкніть «Активність».
- PartnerID впишіть у «Користувач», PartnerKey — у «Пароль».
- Оберіть «Габарит за замовчуванням (S, M, L)».
- Заповніть блок «Відправник»: назву компанії, індекс, місто, вулицю, будинок, телефон і e-mail. Усі сім полів обов'язкові, адреса друкується на етикетці.
1
Користувач і Пароль2
Габарит за замовчуванням3
Відправник- Користувач і Пароль — PartnerID і PartnerKey, які видає менеджер продажів ORLEN Paczka.
- Габарит за замовчуванням (S, M, L) — розмір, який форма накладної підставляє сама; для окремої посилки його міняють у формі.
- Відправник — дані компанії, що відправляє посилки: назва, адреса, телефон і e-mail.
Форма зберігається сама при кожній зміні поля. Доступ при збереженні не перевіряється: помилку покаже перша накладна.
«Тестове середовище (sandbox)» перемикає Elbuz на тестовий сервер ORLEN Paczka; посилки звідти не їдуть і на сайті ORLEN не відстежуються. Довідник пунктів Elbuz отримує сам щоночі — це рядок «Пункти ORLEN Paczka» в таблиці «Довідники служби».
Габарит посилки
| Габарит | Розміри | Вага |
|---|---|---|
| S | 8 × 38 × 60 см | до 20 кг |
| M (за замовчуванням) | 19 × 38 × 60 см | до 20 кг |
| L | 41 × 38 × 60 см | до 20 кг |
Габарит із запису служби форма накладної підставляє сама. Для посилки іншого розміру виберіть його у формі в полі «Габарит (макс. розміри, см)» — запис служби міняти не треба.
Як відправити замовлення в пункт ORLEN Paczka
Де: картка замовлення → «Вид доставки» = «ORLEN Paczka» → секція «Доставка» → «Створити накладну» («Редагувати накладну», якщо форму вже відкривали).
Форма бере одержувача й пункт із замовлення. ORLEN Paczka доставляє лише в пункти, тому без коду пункту накладна не створиться.
1
Пункт ORLEN Paczka (код)2
Габарит (макс. розміри, см)3
Створити накладну- Пункт ORLEN Paczka (код) — код пункту видачі, який обрав покупець; береться із замовлення.
- Габарит (макс. розміри, см) — розмір цієї посилки: S, M або L; за замовчуванням береться із запису служби.
- Кнопка «Створити накладну» надсилає накладну в ORLEN Paczka.
Пункт видачі
Якщо покупець обрав пункт на сайті, його код уже в полі «Пункт ORLEN Paczka (код)». Якщо ні і в замовленні вказано місто — почніть вводити: під полем з'явиться список пунктів цього міста з кодом, типом і адресою.
Пункти бувають чотирьох типів: автомат (APM), АЗС ORLEN (PKN), пункт з обслуговуванням (PPP) і пункт партнера PointPack (PPK). Усього їх понад 15 000, з них 8 000 автоматів.
Одержувач
Обов'язкові ім'я, прізвище й телефон. Elbuz прибирає з телефону пробіли й знаки і відкидає 48 на початку 11-значного номера — лишитися має 9 цифр. Ім'я та прізвище — до 30 символів.
Код отримання ORLEN Paczka надсилає SMS або на e-mail, тому e-mail краще не стирати.
ORLEN Paczka з 2 січня 2025 року не приймає наложений платіж, а з 4 грудня 2024 року — страхування посилок. Тому у формі немає «Зворотна доставка (одержувач)», і замовлення з оплатою при отриманні йдуть без наложки — і по одному, і пачкою.
Що відбувається після «Створити накладну»
- Elbuz перевіряє, що номера в замовленні ще немає, і що заповнені доступ, відправник і пункт.
- Створює посилку в ORLEN Paczka з габаритом із форми і номером замовлення.
- Пише номер посилки в поле «Сервіс доставки: номер».
Вагу й опис з форми ORLEN Paczka не отримує. Якщо вибраний пункт закрито, ORLEN сам замінює його актуальним: накладна створиться, а у вікні «Накладну створено» з'явиться код нового пункту.
Посилку треба здати в мережу ORLEN Paczka протягом 14 днів, інакше етикетка скасовується автоматично.
Друк етикетки і скасування
«Друк» біля номера в перегляді накладної або «Друк накладної» у «Відправленні» відкриває етикетку PDF. Elbuz завантажує її з ORLEN Paczka сам, доступ у браузер не потрапляє.
Посилку здаєте в пункті ORLEN Paczka в години його роботи або віддаєте кур'єру. Пункти PointPack лише видають посилки.
Скасувати посилку з Elbuz не можна — лише в кабінеті ORLEN Paczka, поки її не здано. Після скасування зітріть номер у полі «Сервіс доставки: номер», щоб створити накладну знову.
Як викликати кур'єра ORLEN Paczka
Де: картка замовлення → «Перегляд накладної» → блок «Виклик курʼєра».
- Перевірте «Дату забору» — за замовчуванням найближчий робочий день.
- Години «Забрати з» і «до» можна не вказувати: Elbuz візьме вікно, яке ORLEN Paczka пропонує на цю дату для індексу відправника.
- Натисніть «Викликати курʼєра».
Адреса забору — блок «Відправник» запису служби. ORLEN Paczka повертає номер заявки: він з'являється в повідомленні й лягає в замовлення; результат пишеться в журнал замовлення. Якщо на дату немає вікна — «no courier pickup for ‹дата›», оберіть іншу дату.
Як Elbuz стежить за посилкою
Кожні 10 хвилин Elbuz питає ORLEN Paczka про стан посилок, по одній. ORLEN віддає код статусу й назву польською.
Коди ORLEN Paczka з таблиці нижче Elbuz сам вписує у вікно «Статуси доставки» запису «ORLEN Paczka» — за ними «Відправлення» показують стан посилки. Код поза таблицею — стан «Невідомо». Як працюють вікна кодів — у статті про статуси перевізника.
| Статус доставки Elbuz | Коди ORLEN Paczka | Що означає |
|---|---|---|
| Зібрано | 210, 240 | здано в пункті чи автоматі; забрав кур'єр |
| У пункті призначення | 620, 690, 695 | готова до видачі; у пункті; одержувачу надіслано SMS |
| Доставлено | 1000 | отримана клієнтом |
| Відмова від отримання | 709, 750, 900 | не забрали вчасно; повернення відправнику |
Код 201 означає скасовану посилку. Ті самі коди ORLEN Paczka ставить і під час повернення, а Elbuz бере лише код — тож під час повернення стан у «Відправленні» може повторювати шлях посилки. Історію старшу за 90 днів ORLEN не віддає.
Посилка чекає одержувача 3 робочі дні, в автоматі — 72 години. Потім вона повертається відправнику за його рахунок.
«Відстеження на сайті служби» у «Відправленні» відкриває orlenpaczka.pl/sledz-paczke з номером посилки — це ж посилання можна дати покупцю.
Сценарії
Покупець обрав автомат на сайті
Код автомата приходить у замовленні. Відкрийте «Створити накладну», перевірте одержувача, натисніть «Створити накладну» і надрукуйте етикетку. Посилку здайте в пункті ORLEN Paczka.
Вечірній забір кур'єром
Створіть накладні на всі посилки дня. В одній із них відкрийте «Перегляд накладної» і викличте кур'єра на завтра без годин — ORLEN Paczka сам запропонує вікно.
Що робити, коли щось пішло не так
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «Служба доставки не підключена: заповніть налаштування API цієї служби…» | У записі немає пароля (PartnerKey) або вимкнено «Активність» | Впишіть доступ і ввімкніть запис (куди вписати) |
| «Error: sender address, phone and email are required (API settings)» | У блоці «Відправник» порожнє хоч одне поле | Заповніть усі сім полів відправника (відправник) |
| «Error: ORLEN Paczka pickup point is required for recipient» | Не вказано код пункту | Оберіть пункт зі списку під полем (пункт видачі) |
| «Error: name is required for recipient» або «phone is required for recipient» | У замовленні немає імені чи телефону одержувача | Допишіть їх у формі (одержувач) |
| «Error: ORLEN Paczka: ‹код› ‹опис›» | ORLEN Paczka не прийняла посилку; причина — в описі | Виправте дані за текстом помилки і створіть накладну знову |
| У «Відправленні» стан «Невідомо» | Коди ORLEN Paczka не вписані у «Статуси доставки» | Впишіть коди (статуси) |
Часті запитання
Скільки коштує інтеграція з ORLEN Paczka?
Elbuz за посилки, етикетки й статуси нічого не списує. Посилки ви оплачуєте ORLEN Paczka за договором.
Чи можна відправити ORLEN Paczka на адресу покупця?
Ні, ORLEN Paczka доставляє лише в пункти: автомати, АЗС ORLEN і пункти партнерів.
Чи можна вибрати розмір для окремої посилки?
Так: у формі накладної — поле «Габарит (макс. розміри, см)». За замовчуванням там габарит із запису служби (габарит).
Скільки посилка чекає в пункті?
Кілька днів, потім ORLEN Paczka повертає її відправнику (строки зберігання).
Як покупцю відстежити посилку?
На сторінці orlenpaczka.pl/sledz-paczke за номером посилки з поля «Сервіс доставки: номер».
Де це і хто має доступ
- Меню
- Кабінет → Налаштування системи → Інші налаштування → Зовнішні сервіси та інтеграції → Доставка → ORLEN Paczka
- Інші входи
- Довідники → Документи → Відправлення → «Служби доставки»; картка замовлення → секція «Доставка»
- Право доступу
- підключення — «API та токени доступу»; накладна й кур'єр — «Створення ТТН служби доставки»; посилки — «Відправлення»
- Підготувати
- договір з ORLEN Paczka, PartnerID і PartnerKey, адресу відправника з телефоном і e-mail
- Отримати PartnerID і PartnerKeyORLEN Paczka, договір
- Вписати доступ, габарит і відправникаЗовнішні сервіси та інтеграції → ORLEN Paczka
- Створити посилкуКартка замовлення, секція «Доставка»
- Надрукувати етикетку, викликати кур'єраПерегляд накладної
Суміжні теми
- Якщо треба бачити посилки всіх служб в одному списку — реєстр «Відправлення».
- Якщо покупцю потрібен наложений платіж — InPost в Elbuz або Poczta Polska в Elbuz.
- Якщо статус замовлення має мінятися сам за статусом посилки — статуси перевізника.
- Якщо накладні треба створити на десятки замовлень — накладні пачкою.
