Rozetka не надсилає вебхуків: щоб дізнатися про нове замовлення, продавець мусить сам спитати Seller API. Тому CRM опитує ваш кабінет кожні 15 хвилин і зводить усе, що звідти приходить, у звичайне CRM-замовлення — з позиціями, сумою, покупцем, оплатою й доставкою. Менеджер працює в одному вікні замість того, щоб тримати відкритим кабінет Rozetka поряд із CRM і переносити дані руками. Кожен робочий простір ізольований: облікові дані, каталог і замовлення одного бізнесу недосяжні для іншого.
Що вміє адаптер
Замовлення кожні 15 хвилин
CRM сама опитує Seller API за розкладом і створює замовлення. Повторний прогін не дублює те, що вже завели — ключ ідемпотентності будується з id замовлення Rozetka.
Оплата й доставка одразу в замовленні
На кожному проході CRM оновлює статус, спосіб оплати, спосіб доставки та номер накладної, якщо Rozetka їх уже віддала.
Статуси назад у кабінет
Менеджер змінює статус у CRM — адаптер логіниться в Seller API і оновлює замовлення на боці Rozetka. Неоднозначний перехід не пишеться взагалі.
Товари з Rozetka в каталог
Опубліковані позиції підтягуються в каталог: наявні звіряються за артикулом, нові стають чернетками в черзі на перегляд — нічого не з’являється в каталозі без вашого рішення.
Публікація товарів прайс-файлом
API Rozetka не вміє створювати товари — їх створює прайс-файл. CRM віддає його за постійним посиланням, ви вставляєте це посилання в кабінет один раз, і далі нові товари з каталогу їдуть на Rozetka самі та проходять модерацію.
Готовність видно до відправки
Rozetka вимагає назву, ціну, фото, бренд і характеристики, а про відмову повідомляє через години й не називає товар. CRM перевіряє це за її ж правилами у себе: список того, що не поїде, з посиланнями на кожен товар.
Ціни та залишки назад на Rozetka
Щогодини CRM оновлює ціну й кількість уже опублікованих позицій. Кількість надсилається лише для товарів, де ви ведете облік залишків.
Питання покупців стають лідами
Той самий прохід забирає повідомлення з картки товару й створює лід із джерелом «Rozetka», відповідальним і наступним кроком.
Технічні деталі
Що саме адаптер робить із Seller API — для тих, хто хоче звірити з власним кабінетом.
- База API
- api-seller.rozetka.com.ua
- Авторизація
- Логін продавця + пароль → токен на 24 години. Облікові дані зашифровані в базі.
- Читання замовлень
- GET /orders/search з розгорнутими позиціями, доставкою та покупцем
- Курсор
- Rozetka фільтрує замовлення лише за датою, тому курсор денний і кожен прохід перечитує ще один день назад — щоб замовлення на межі доби не загубилося
- Запис статусу
- PUT /orders/{id} після логіну
- Ціни та залишки
- PUT /items/update-price-stock/{id} — звірка за артикулом (article = SKU)
- Публікація товарів
- XML-прайс (yml_catalog) за постійним посиланням, яке Rozetka забирає сама; ідентифікатор позиції походить від id товару в CRM і не змінюється, артикул дорівнює SKU
- Категорії
- Своє дерево категорій із rz_id — прив’язкою до категорії Rozetka; підказки беруться з ваших уже опублікованих товарів після імпорту
- Валюта
- Гривня. Товар із ціною в іншій валюті пропускається, а не конвертується за вигаданим курсом.
- Розклад
- Замовлення й повідомлення — кожні 15 хвилин, каталог — щогодини, плюс кнопка «Синхронізувати» вручну
Маппінг статусів CRM → Rozetka
Статуси Rozetka — числові й залежать від налаштувань конкретного кабінету, тому маппінг винесено в один блок, який ми звіряємо на живому акаунті. Перехід, у якому адаптер не впевнений, не надсилається.
Доставка й накладна
Rozetka відповідає за доставку своїх замовлень, тому CRM тут читає, а не командує.
- Спосіб доставки й номер накладної приходять із Rozetka в блок доставки замовлення — на кожному проході, а не один раз при створенні.
- Якщо ви відправляєте самостійно, накладну Нової Пошти можна створити прямо із замовлення CRM: адреса й отримувач підставляються з даних покупця.
- Самовивіз — окремий спосіб доставки, а не текстове поле: він не має перевізника й трек-номера, і в замовленні відображається як «Самовивіз».
- Статус доставки не переписує статус замовлення: після того як менеджер змінив статус вручну, CRM вважає його авторитетним і полл його не перетирає.
Жоден запис не ввімкнений за замовчуванням
Ви приходите з товарами, які вже живуть і в CRM, і на Rozetka. Тому читання працює одразу, а кожен напрямок запису — ціни, залишки, статуси, публікація прайс-файлом — вмикає власник окремо і лише після пробного прогону, який показує, що саме зміниться, нічого не змінюючи. У публікації свій власний пробний прогін: він називає кожен товар, який не потрапить у прайс, і причину. Порожній прайс не віддається взагалі — він міг би зняти ваші позиції з продажу. Адаптер ніколи не видаляє й не архівує товари — ні в CRM, ні на маркетплейсі.
Підключення
- 1
Додайте адаптер Rozetka
Налаштування → Інтеграції → Адаптери платформ. На першому кроці потрібна лише назва.
- 2
Вставте логін продавця
Логін і пароль кабінету Seller API. Натисніть «Перевірити з’єднання» — CRM зробить справжній логін і покаже, чи є доступ до замовлень.
- 3
Увімкніть потрібні напрямки
Замовлення почнуть приходити самі. Пробний прогін покаже, що станеться з цінами й залишками — і лише після нього ви вмикаєте запис.
- 4
Підключіть прайс-файл, якщо публікуєте з CRM
Скопіюйте посилання на прайс із картки адаптера і додайте його як XML-прайс у кабінеті Rozetka. Категорії прайсу зіставляються з категоріями Rozetka в кабінеті — без цього товари не опублікуються.
Часті запитання
Як підключити Rozetka до CRM?
Додайте адаптер Rozetka в Налаштуваннях → Інтеграції, вставте логін і пароль кабінету Seller API та натисніть «Перевірити з’єднання». Після успішної перевірки замовлення починають приходити самі, без воркерів і без коду на вашому боці.
Чи потрібен програміст?
Ні. Опитування Rozetka, звірку замовлень і оновлення статусів робить CRM. Програміст потрібен лише якщо ви хочете писати в CRM зі власної системи — для цього є публічний REST API.
Як швидко замовлення з Rozetka з’являється в CRM?
У межах 15 хвилин: Rozetka не надсилає вебхуків, тому CRM опитує Seller API за розкладом. Це компроміс платформи, а не наш вибір — і саме тому в інтерфейсі видно час останнього успішного опитування.
Чи підтягується доставка й номер накладної?
Так. Спосіб доставки й номер накладної приходять із Rozetka в блок доставки замовлення й оновлюються на кожному проході. Якщо відправляєте самостійно — накладну Нової Пошти можна створити прямо із замовлення.
Чи можна керувати цінами й залишками з CRM?
Так. Для вже опублікованих позицій CRM звіряє їх за артикулом і оновлює ціну та кількість щогодини. А для нових товарів працює прайс-файл: API Rozetka створювати позиції не вміє, тому CRM віддає XML-прайс за посиланням, яке ви один раз підключаєте в кабінеті, і Rozetka створює за ним товари сама.
Чи можна опублікувати новий товар на Rozetka з CRM?
Так — прайс-файлом. Seller API Rozetka створювати товари не вміє (він лише оновлює ціну й залишок наявної позиції), тому CRM віддає ваш каталог як XML-прайс за постійним посиланням. Власник вмикає цей напрямок після пробного прогону і вставляє посилання в кабінет Rozetka; далі нові товари їдуть туди самі й проходять модерацію Rozetka, як і будь-який товар продавця.
Що станеться з моїм каталогом при першому імпорті?
Нічого без вашого рішення. Товар, артикул якого вже є в CRM, просто зв’язується з лістингом. Товар, якого CRM не знає, стає чернеткою в черзі на перегляд — там ви або активуєте його, або об’єднуєте з наявною карткою.
Чи можна відповідати покупцям Rozetka з CRM?
Питання з картки товару стають лідами в CRM з історією й відповідальним менеджером. Відповідь поки пишеться в кабінеті Rozetka — двосторонній чат для цього каналу ще не відкритий.
Чи це той самий патерн, що Prom?
Спосіб приймання спільний — обидва маркетплейси опитуються за розкладом і проходять через один шар прийому замовлень, тож ідемпотентність і списання складу поводяться однаково. Запис побудований під Seller API Rozetka окремо: контракт кожної платформи ми беремо з її офіційної документації, а не з іншого адаптера.
Що підключають разом
Prom.ua
ДоступноЗамовлення, оплати й доставка приходять самі. Питання покупців стають лідами, і ви відповідаєте на них прямо з CRM, не відкриваючи кабінет Prom.
ДетальнішеНова Пошта
ДоступноМенеджер не перемикається в кабінет перевізника: накладна створюється в CRM, а статуси доставки оновлюються самі.
ДетальнішеMonobank
БетаПокупець оплатив рахунок — CRM отримує підписане підтвердження від Monobank, ставить оплату на замовлення й одразу повідомляє команду. Без зведення виписки руками.
ДетальнішеOLX
ДоступноКожне звернення з оголошення стає лідом, а вся переписка живе в спільному інбоксі поряд з іншими каналами. Відповідати можна з CRM — заходити в OLX не треба.
ДетальнішеTelegram
ДоступноКлієнти пишуть вашому боту в Telegram, а ви не губите жодної заявки: повідомлення автоматично потрапляють у воронку з джерелом «telegram».
ДетальнішеБета: Бета-версія: підключення доступне вже сьогодні, можливості каналу ще доопрацьовуються.
Підключіть Rozetka
Замовлення, оплата, доставка й залишки маркетплейсу в одному просторі з рештою ваших каналів.
Почати безкоштовно