Elbuz виписує накладну Rozetka Delivery за вашим партнерським договором прямо з картки замовлення, друкує етикетку й кожні 10 хвилин приносить статуси посилок одним запитом.
Коли це знадобиться:
- Відправляєте через точки ROZETKA — одержувач, місто й сума підставляються із замовлення, накладна — однією кнопкою.
- Клієнт платить при отриманні — післяплата на суму замовлення ставиться сама.
- Замовлення не з маркетплейсу — Rozetka Delivery працює для будь-якого замовлення, не лише з Rozetka.
З чого почати: створіть статичний токен партнера Rozetka Delivery → впишіть його в Elbuz.
Що вміє Rozetka Delivery в Elbuz
- Накладна із замовлення — у точку видачі або на адресу, з габаритами, кількістю місць, вибором платника й післяплатою; по одній або пачкою.
- Міста й точки — спільний для всіх магазинів Elbuz список, оновлюється сам; окремо точки приймання (звідки відправляєте) і точки видачі (куди).
- Статуси посилок — кожні 10 хвилин, усі накладні одним запитом.
- Етикетка — PDF з картки замовлення або з «Відправлення».
Це інтеграція за вашим договором з Rozetka Delivery. Накладна для замовлення з маркетплейсу Rozetka доступами продавця — інша дія: «Накладна через Rozetka».
Продовження зберігання, повернення й видалення накладної з Elbuz немає — це в кабінеті Rozetka Delivery. Повернення й видалення з Elbuz є лише в Нової пошти.
Як підключити Rozetka Delivery: токен і точка приймання
Де взяти токен Rozetka Delivery
Elbuz працює зі статичним токеном партнера. За документацією API Rozetka Delivery партнер створює його сам методом «Створення статичного токена партнера» після входу за телефоном і паролем; там же — список і видалення токенів.
Документація: rz-delivery.rozetka.ua/api/docs. Якщо доступу до API ще немає — зверніться до свого менеджера Rozetka Delivery.
Звичайний токен сесії живе 72 години від останнього використання — для Elbuz він не підходить, потрібен саме статичний.
Куди вписати токен в Elbuz
Де: Зовнішні сервіси та інтеграції → група «Доставка» → запис «Rozetka Delivery».
- Статичний токен вставте в поле «Токен».
- Увімкніть «Активність».
- У блоці «Відправник» заповніть «Прізвище», «Ім'я», «Телефон» і «Назва компанії».
- Оберіть «Область», «Місто», «Відділення» — точку приймання, куди здаєте посилки.
1
Токен- Токен — статичний токен партнера Rozetka Delivery; збережений показується крапками.
Elbuz не перевіряє токен під час збереження: помилку ви побачите в першій накладній.
Довідники міст і точок
Міста й точки Rozetka Delivery Elbuz бере зі спільного для всіх магазинів списку, який оновлюється сам. Завантажувати нічого не треба: блок «Довідники служби» лише показує, скільки точок знає Elbuz і коли список оновлено, а «Оновити довідники» перевіряє його свіжість.
1
Відділення відправника2
Рядок «Точки видачі»3
Оновити довідники- Відділення — точка приймання, куди ви здаєте посилки.
- Скільки точок знає Elbuz і коли спільний список оновлено.
- Кнопка лише перевіряє, чи свіжий спільний список; завантажувати нічого не треба.
У блоці «Відправник» видно лише точки, які приймають посилки, у формі накладної — лише ті, що видають. Поки спільний список не оновився, діє попередній.
Коди статусів Rozetka Delivery
Статус замовлення міняється лише в позначених статусах замовлень і за трьома таблицями «Налаштування повідомлень» — як в Укрпошти. Коди з таблиці Elbuz вписує в «Статуси доставки» сам, свої дописуйте через кому, латиницею — як у документації API Rozetka Delivery:
| Ваш статус доставки | Коди Rozetka Delivery |
|---|---|
| Чекання від відправника | planned, acceptedFromMerchant, acceptedFromReception |
| У дорозі | readyToCarrier, acceptedByCarrier, inTheWay, arrivedToDistributionCenter, acceptedOnDistributionCenter, forwarding |
| У пункті призначення | acceptedInDepartment, placedInStore, readyToIssueOctopus, storageDateIncreased |
| Доставлено | gaveOut |
| Доставлено частково | gaveOutPartially |
| Відмова від отримання | clientCanceled, storageDateExpired, readyToReturn, inTheWayReturn, returned |
Без кодів посилки у «Відправленні» стоять у стані «Невідомо».
Як створити накладну Rozetka Delivery із замовлення
Де: картка замовлення → секція «Доставка» → «Створити накладну». Посилання є, якщо вид доставки замовлення — Rozetka Delivery; після першого відкриття форми воно називається «Редагувати накладну».
Що форма заповнить сама і що перевірити
| Поле | Звідки береться |
|---|---|
| Спосіб відправлення | «Відділення» або «Адреса» — за способом доставки із замовлення; без нього — «Відділення» |
| Прізвище, Ім'я, По батькові, Телефон | Із замовлення |
| Населений пункт | За назвою міста із замовлення; з однакових назв — найбільше місто |
| Відділення | Точка із замовлення; порожньо — під час створення Elbuz шукає точку, чия назва збігається з адресою доставки |
| Загальна вага, кг | Сума ваг товарів; порожньо — піде 1 кг |
| Довжина, Ширина, Висота, см | Порожньо — підуть 30 × 20 × 10 см |
| Кількість місць | 1 |
| Оголошена вартість, грн | Сума замовлення; має бути більше нуля |
| Платник за доставку | «Відправник»; можна обрати «Одержувач» |
1
Довжина, ширина, висота2
Платник за доставку3
Зворотна доставка (одержувач)4
Створити накладну- Габарити посилки в сантиметрах: довжина, ширина, висота.
- Платник за доставку — відправник або одержувач.
- Зворотна доставка — одержувач сплачує товар грошима при отриманні.
- Кнопка створює накладну в службі доставки.
Для «Адреса» заповніть «Вулиця»; «Відділення» потрібне й тут — без нього накладна не створиться. Форма зберігається в замовлення за кожної зміни поля.
Що відбувається після «Створити накладну»
- Elbuz перевіряє відправника в записі (місто, точка, прізвище, ім'я, телефон) і одержувача у формі (прізвище, ім'я, телефон, місто, точка) та оголошену вартість.
- Створює накладну в Rozetka Delivery; номер замовлення Elbuz передає в накладну як ваш номер.
- Номер накладної записує в замовлення.
Другу накладну на те саме замовлення Elbuz не створить: «Накладну вже створено: … — пропущено.» Опис обрізається до 250 символів.
Пачкою: список замовлень → позначте → «Створити ТТН (доставка)» (накладні пачкою).
Післяплата і хто платить комісію
«Зворотна доставка (одержувач)» → «Гроші» ставиться сама, якщо замовлення не оплачене й оплата — при отриманні; сума — сума замовлення. «Не потрібно» — посилку видадуть без оплати.
За документацією API Rozetka Delivery одержувач у точці платить суму післяплати плюс комісію 15 грн + 1,5%. Як і коли гроші надходять вам — за вашим договором з Rozetka Delivery.
Статуси посилок і друк етикетки
Кожні 10 хвилин Elbuz питає Rozetka Delivery про статуси одним запитом на всі накладні — до 100 за прохід. Відстежуються замовлення за останні 60 днів або в позначених статусах, доки код посилки не стане навпроти «Доставлено» в «Статуси доставки». Усі посилки — у «Відправленні», стан — за вашою таблицею кодів.
Етикетка: картка замовлення → «Перегляд накладної» → «Друк» або «Відправлення» → рядок → «Друк накладної». Elbuz завантажує PDF у Rozetka Delivery й відкриває його у вікні; токен у браузер не потрапляє.
Сценарії
Перше підключення
Що зробити. Створіть статичний токен, впишіть у «Токен», заповніть відправника, оберіть точку приймання, перевірте коди в «Статуси доставки».
Що вийде. У формі накладної є міста й точки видачі, статуси приходять самі.
Оплата при отриманні
Що зробити. Залиште в замовленні оплату при отриманні й не відмічайте його оплаченим.
Що вийде. У накладній післяплата на суму замовлення; клієнт сплатить її з комісією 15 грн + 1,5%.
Доставка додому
Що зробити. У формі накладної оберіть «Спосіб відправлення» → «Адреса», заповніть «Вулиця» й залиште обране «Відділення».
Що вийде. Накладна на доставку від вашої точки до дверей одержувача.
Що робити, коли щось пішло не так
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «Служба доставки не підключена: заповніть налаштування API цієї служби…» замість форми | У записі Rozetka Delivery порожній «Токен» або вимкнено «Активність» | Впишіть статичний токен, увімкніть «Активність» (підключення) |
| «Error: sender department is required (API settings)» (або sender city, first_name, last_name, phone) | Не заповнено відправника чи точку приймання | Заповніть блок «Відправник» (підключення) |
| «Error: city is required for recipient» або «department is required for recipient» | Місто чи точку одержувача не знайдено в довіднику | Оберіть місто й відділення у формі вручну |
| «Error: Unauthorized» або «HTTP 401» у накладній | Токен не дійсний: видалений або вписано токен сесії | Створіть новий статичний токен і впишіть його (токен) |
| Посилки Rozetka Delivery у «Відправленні» в стані «Невідомо» | Таблиця «Статуси доставки» запису порожня | Впишіть коди (таблиця кодів) |
Часті запитання
Скільки коштує інтеграція з Rozetka Delivery?
Elbuz за накладні, етикетки й статуси нічого не списує. Доставку ви оплачуєте Rozetka Delivery за договором.
Чим це відрізняється від «Накладна через Rozetka»?
Тут ваш договір і ваш токен, для будь-якого замовлення. «Накладна через Rozetka» — для замовлень маркетплейсу, доступами продавця (детальніше).
Чи можна продовжити зберігання посилки з Elbuz?
Ні, продовження — у кабінеті Rozetka Delivery. Elbuz покаже посилку у «Відправленні», клієнту можна надіслати SMS.
Навіщо габарити, якщо я їх не знаю?
Rozetka Delivery їх вимагає. Порожні поля Elbuz заповнить як 30 × 20 × 10 см.
Чи можна відправити посилку кількома місцями?
Так, у формі є «Кількість місць». Вага й габарити вказуються одні на всю накладну.
Де це і хто має доступ
- Меню
- Кабінет → Налаштування системи → Інші налаштування → Зовнішні сервіси та інтеграції → Доставка
- Інші входи
- Довідники → Документи → Відправлення → «Служби доставки»; картка замовлення → секція «Доставка»
- Право доступу
- підключення — «API та токени доступу»; накладна — вікно «Створення ТТН служби доставки»; посилки — «Відправлення»
- Підготувати
- договір партнера Rozetka Delivery, статичний токен, точку приймання, з якої відправляєте
Накладну можна виписати лише для замовлення, яке користувач бачить за налаштуванням «Чиї дані».
- Створити статичний токенRozetka Delivery
- Вписати токен і відправникаЗовнішні сервіси та інтеграції → Rozetka Delivery
- Обрати точку прийманняТам само, «Довідники служби»
- Заповнити коди статусівТам само, «Налаштування повідомлень»
- Виписати накладнуКартка замовлення, секція «Доставка»
Суміжні теми
- Якщо потрібно бачити посилки всіх служб в одному списку — Відправлення.
- Якщо замовлення прийшло з маркетплейсу Rozetka — накладна через Rozetka.
- Якщо відправляєте ще й Новою поштою — Нова пошта API в Elbuz.
- Якщо накладні треба виписати по десятках замовлень — накладні пачкою.
