Інтеграція з Rozetka підключає кабінет продавця до Elbuz за API-ключем: замовлення, повернення, накладні й комісія приходять самі, ціни й залишки йдуть на Rozetka за розкладом, а нові картки заводить XML-фід з вашого каталогу.
Seller API відкриває продавцю товари, замовлення, баланс і листування кабінету. Elbuz уже вміє з ними працювати — писати запити самому не потрібно.
Каталог і стан карток
Товари кабінету приходять у картки Elbuz з назвою, описом, ціною, старою ціною, залишком, артикулом, виробником, категорією, фото й характеристиками. Журнал прогону показує, скільки карток на модерації, невалідних, прихованих модератором чи поза діапазоном цін, а проблемні картки Elbuz заводить у каталог, щоб ви їх бачили. Дані товару ведуться один раз у каталозі товарів (PIM).
Ціни й залишки за розкладом
API-шаблон вивантаження надсилає ціну, стару ціну й кількість пачками по сто позицій. Ціна береться з поля, яке ви оберете в шаблоні, тож для Rozetka може бути своя ціна з націнкою під комісію, а на сайті — своя: див. правила націнки. Скільки цін Rozetka затримала на перевірку менеджером, журнал пише окремим рядком.
Замовлення й зворотний статус
Замовлення Rozetka лягають документами «Замовлення покупця» поруч із замовленнями сайту й Prom. Коли менеджер змінює статус в Elbuz, відповідний статус разом із номером накладної повертається на Rozetka. Повторне завантаження дубля не створює — див. керування замовленнями.
ТТН і статуси доставки
З картки замовлення накладна виписується через Rozetka для Rozetka Delivery, Нової пошти, Укрпошти й Meest — доступами того самого підключення. Статуси доставки за накладними приходять у замовлення, а заявки на повернення стають документами «Повернення від покупця» з причиною. Свої договори з перевізниками — у інтеграції служб доставки.
Комісія й гроші
Комісія Rozetka записується в саме замовлення, тож прибуток з продажу видно без вивірки. Реальні рухи грошей на балансі стають прибутковими й видатковими ордерами, місячні звіти про продані товари — актами виконаних робіт. Залишок на рахунках кабінету журнал показує одним рядком.
Відгуки, питання й чати
Відгуки про магазин і питання до товарів приходять у вікно «Відгуки, коментарі», а відповідь з Elbuz іде на Rozetka. Повідомлення покупців у чатах замовлень стають зверненнями зі строком відповіді майданчика, а звернення Rozetka щодо замовлення лягають у його історію. Як це працює разом — служба підтримки клієнтів.
2
Rozetka XML чи API: фід заводить картки, API тримає їх свіжими
У Rozetka два канали обміну, і вони не замінюють один одного. Elbuz веде обидва з одного каталогу.
XML-фід
Rozetka API
Нові картки
заводить: назви, описи, фото, характеристики й ціни
не заводить
Ціни й залишки
оновлює разом з усім фідом, коли Rozetka забирає файл
оновлює точково між прогонами фіда
Замовлення, статуси, ТТН
ні
так, в обидва боки
Що потрібно
постійне посилання на файл
API-ключ з кабінету продавця
Що Elbuz кладе у фід для Rozetka
Готовий шаблон Rozetka.UA підставляє номери категорій (rz_id) і характеристик (paramid) майданчика та кількість stock_quantity. Фото обрізаються до 15, значення характеристик — до 255 символів, з опису прибираються посилання й картинки. Номери зіставляються один раз для категорії, а не для кожного товару.
Як фід потрапляє на Rozetka
Файл збирається за розкладом за постійною адресою. Посилання ви один раз перевіряєте у валідаторі кабінету й передаєте Rozetka через підтримку, далі майданчик забирає файл сам. Окремий Прайс-креатор для цього не потрібен: Rozetka приймає фід з будь-якої системи.
Як це працює: Rozetka — ще один канал вашого каталогу
Окрема база товарів під Rozetka не потрібна: фід і API беруть товари з каталогу, який ви вже ведете.
Каталогтовари, ціни й залишки з вашого складу й прайсів постачальників
XML-фідзаводить і поповнює картки на Rozetka
Каталог Rozetkaприносить в Elbuz номери карток і їхній стан
APIціни й залишки за номерами карток між прогонами фіда
Замовлення назаду той самий список, що й замовлення сайту
Залишки рахуються з ваших складів і прайсів постачальників. Той самий каталог наповнює ваш сайт, Prom, Епіцентр та інші майданчики.
4
Екрани Elbuz: шаблони, зіставлення й замовлення
Ті самі вікна працюють з усіма маркетплейсами: шаблони вивантаження, зіставлення категорій і список замовлень.
Шаблон Rozetka серед шаблонів інших майданчиківКатегорії й характеристики Rozetka зіставляються один разЗамовлення Rozetka, сайту й інших майданчиків в одному списку
5
Як підключити Rozetka через API: де взяти ключ
Ключ генерується в кабінеті продавця за хвилину, решту Elbuz налаштовує шаблоном.
Ключ«Генерувати API-токен», роль із доступом до товарів і замовлень, ключ gapi_… — кнопкою копіювання
Шаблону вікні «Завантаження даних» шаблон «Rozetka», ключ — у поле «API-ключ Rozetka»
Перевірка«Перевірити підключення», далі галочки «Товари», «Замовлення», «Відгуки»
Розкладшаблон сам оновлює дані; ціни й залишки повертає API-шаблон вивантаження
Ключ не дає входу в кабінет, і його можна відкликати, не змінюючи пароль. Rozetka вимикає ключ, яким не користуються понад 24 години, тож розклад хоча б раз на добу тримає його живим. Шаблони, налаштовані раніше логіном і паролем кабінету, працюють і далі. Перенесення даних з іншої програми чи сайту служба підтримки бере на себе безкоштовно.
6
Що потрібно від Rozetka, щоб підключитися
Що має бути готове в кабінеті продавця до першого запуску.
Магазинверифікованийпоки магазин не пройшов верифікацію, Rozetka не віддає замовлення через API
API-ключgapi_…з розділу «Безпека API»; власник і адміністратор створюють ключі й для інших менеджерів
Категоріїзіставленітих категорій, товари з яких ви продаєте на Rozetka, — для фіда
Це Seller API кабінету продавця Rozetka: через нього програма отримує й змінює товари, замовлення, статуси, накладні, баланс і листування без входу в кабінет. В Elbuz це шаблон завантаження «Rozetka» з API-ключем і API-шаблон вивантаження, що повертає на Rozetka ціни й залишки.
Як отримати API-ключ Rozetka?
У кабінеті продавця: «Налаштування» → «Безпека API» → «Генерувати API-токен», роль — з доступом до товарів і замовлень. Ключ починається з gapi_. Якщо ним не користуються понад 24 години, Rozetka робить його неактивним — тоді згенеруйте новий і замініть у шаблоні. Докладніше — імпорт з Rozetka.
Чи потрібен програміст, щоб підключити Rozetka через API?
Ні. Запити до API Elbuz робить сам: ви вставляєте ключ у шаблон, натискаєте «Перевірити підключення» й ставите шаблон на розклад. Програміст потрібен, лише якщо ви пишете власну інтеграцію з документацією Seller API.
Чи можна завести товари на Rozetka тільки через API, без фіда?
В Elbuz — ні: картки заводить XML-фід, а API оновлює ціну, стару ціну й кількість уже заведених карток. Номери карток приносить завантаження каталогу Rozetka, тому порядок такий: фід → каталог → API.
Як зробити XML-фід для Rozetka?
Створіть у вікні «Вивантаження даних» шаблон Rozetka.UA і зіставте категорії й характеристики з довідником Rozetka. Elbuz збере фід за постійним посиланням; перевірте його у валідаторі кабінету й передайте посилання Rozetka через підтримку. Докладніше — вивантаження на Rozetka.
Чи потрібен Прайс-креатор Rozetka, якщо є Elbuz?
Ні. Rozetka приймає фід з будь-якої системи, і Elbuz збирає його з вашого каталогу сам. Прайс-креатор зручний, коли каталогу в іншій програмі немає.
Чому частина цін не змінилася на Rozetka?
Це правило Rozetka: ціна, змінена більш ніж у 1,5 раза вгору або у 2 рази вниз, застосовується після перевірки менеджером майданчика. Elbuz її надіслав і пише в журнал, скільки таких цін чекає підтвердження; решта цін прогону вже застосована.
Чи бачить Elbuz відгуки й повідомлення покупців Rozetka?
Так. Відгуки про магазин і питання до товарів приходять у вікно «Відгуки, коментарі», і відповідь звідти йде на Rozetka. Повідомлення в чатах замовлень стають зверненнями — див. повідомлення маркетплейсів.
Скільки коштує інтеграція з Rozetka?
Окремої плати за інтеграцію немає: вона входить в єдиний тариф Elbuz, ціна якого залежить від кількості товарів і користувачів. Комісію й абонплату Rozetka ви платите майданчику — ставки й розрахунок одного замовлення в статті як почати продавати на Rozetka.
Відділ сайту й маркетплейсів входить у вашу AI-корпорацію разом з усіма іншими відділами. 50 € на балансі після реєстрації й 14 днів, щоб перевірити інтеграцію на своїх товарах і замовленнях.