Интеграция с Rozetka: Rozetka API без программиста
Интеграция с 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.
8
Другие маркетплейсы и что работает вместе с Rozetka
Отдел сайта и маркетплейсов входит в вашу AI-корпорацию вместе со всеми остальными отделами. 50 € на балансе после регистрации и 14 дней, чтобы проверить интеграцию на своих товарах и заказах.