Rozetka

1Налаштування

Підключає адміністратор. Дорога: «Налаштування» → «Інтеграції» → вкладка «Маркетплейси» → картка «Rozetka» → вкладка «Підключення».

Є два способи доступу — оберіть один:

• Логін і пароль кабінету продавця. Рядок «Кабінет Rozetka» → «Логін» → логін і пароль → «Увійти». Після входу видно «Авторизований як: <логін>» і до якого часу діє токен. Rozetka дає токен на 24 години — CRM оновлює його сама перед опитуванням. Пароль зберігається зашифрованим. «Вийти» забуває логін і пароль (далі діє ключ API, якщо він заданий).
• Ключ API. Рядок «API ключ (Seller API)» → «Ввести» → «Зберегти ключ». Ключ береться в кабінеті продавця Rozetka в розділі безпеки API.

«Перевірити» — безпечний запит лише на читання; успіх — «доступ до замовлень є».

Друга вкладка картки — «Налаштування продажів»: «Основне» (перемикач, «Джерело угод», «Відповідальний»), «Структура» («Бренд», «Філія», «Юрособа»), «Нові замовлення» («Автоприйняття», «Зв'язувати товари по»), «Чати», «Пов'язані статуси», «Автоматична відправка ТТН», «Фід для маркетплейсу», «Магазини Rozetka», «Імпорт замовлень і клієнтів». Унизу — «Зберегти» і «Скасувати зміни».

Дані замовлення пишуться в додаткові поля угоди з ключами rozetka_order_id, rozetka_status (назва статусу) і rozetka_status_code (його код), rozetka_status_history, rozetka_order_amount, rozetka_amount_with_discount, rozetka_payment_type, rozetka_payment_status, rozetka_user_rating, rozetka_delivery_address, rozetka_delivery_recipient_title, rozetka_delivery_cost та інші (повний перелік — у розділі 8). Самі поля налаштовуються в Налаштування›Типи даних›Угоди«Налаштування → Типи даних → Угоди».

Бренд, філію і юрособу угод Rozetka задає блок «Структура» у «Налаштуваннях продажів» — у кожного акаунта свій, а де його не задано, юрособу дають правила Налаштування›Компанія й система›Бренди та юрособи›Правила«Налаштування → Компанія й система → Бренди та юрособи → Правила» (Структура каналу: бренд, філія, юрособа).

2Підключити одним натиском

1. Увійдіть логіном/паролем або введіть ключ API.
2. Рядок «Одним натиском» → «Підключити Rozetka» → підтвердіть.
3. CRM перевірить доступ і поставить налаштування як у KeepinCRM: джерело «Rozetka», головний відповідальний, «Нове замовлення» → «Обробляється менеджером» через 1 хвилину, товари за артикулом, усі три види чатів, статус назад на Rozetka, пов'язані статуси (статуси шукаються в списку Rozetka за назвою, етапи — у воронці «Продажі» за назвою), «Магазини Rozetka» з доступом відповідальному; потім увімкне приймання і зробить перше опитування.
4. Під кнопкою з'явиться «Підключено: …», перелік застосованого і пропущеного (з рискою): наприклад, етапу з такою назвою у воронці нема. Пропущене допишіть у «Налаштуваннях продажів» вручну.

Типовий відповідальний і назви етапів у цьому наборі взято з компанії власника; якщо такого користувача нема, CRM ставить іншого і пише це в пропущеному.

Повторне натискання — «Застосувати налаштування знову».

Важливо. Того ж дня вимкніть інтеграцію Rozetka в KeepinCRM, інакше замовлення прийдуть двічі.

3Приймати замовлення в угоди

Коли інтеграцію ввімкнено, CRM кожні 5 хвилин забирає замовлення. Клієнт шукається за телефоном (нема — створюється), угода отримує назву = № замовлення, етап за «Пов'язаними статусами», позиції — за вибраним полем зв'язку, доставку й оплату. Повторне надходження оновлює статус і додаткові поля (оплату, статус оплати, ТТН, історію статусів), а якщо статус на Rozetka справді змінився і є в мапі — рухає угоду. Те саме замовлення з тим самим кодом статусу етап не чіпає, навіть якщо змінився лише запис статусу (наприклад, код «1» став назвою «Нове замовлення»). Результат — Стан роботи›Приймання замовлень«Стан роботи → Приймання замовлень» і «Журнал подій».

«Адреса доставки» угоди — як у KeepinCRM: місто, вулиця, будинок і точка з номером, напр. «Київ, вул. Якуба Коласа, 15, Відділення №88»; поштомат — «Поштомат №13 (маг. …)», село — з районом і областю, точка ROZETKA Delivery — адреса з описом. До 15.10 номер відділення потрапляв у вулицю («вул. Якуба Коласа 88 15») — такі незмінені адреси в уже створених угодах уточнено разовою заявкою; вписане людиною не чіпали.

4Пов'язані статуси і статус назад на Rozetka

1. «Налаштування продажів» → «Пов'язані статуси» → «+ Додати статус».
2. «Статус на Rozetka» (зі списку Rozetka за назвою) → «Етап угоди»; для етапу скасування — «Причина скасування» і «Коментар покупцю».
3. Один статус можна прив'язати до кількох етапів: нова угода стане на перший рядок, а угода на будь-якому з цих етапів не рухатиметься.
4. «Зворотний зв'язок» → «Передавати етап назад на маркетплейс»: етап угоди → статус на Rozetka за цією мапою.
5. «Автоприйняття» → «Автоматично змінити статус з «Нового замовлення» на «Обробляється менеджером»» через N хвилин: CRM ставить цей статус на Rozetka, лише поки угоду ніхто не рушив вручну. Під перемикачем — «переводити угоду на етап»: «не переводити (лише статус на Rozetka)» — угода лишається там, куди її поставив рядок «Пов'язаних статусів» (наприклад «1» → «Новий»); «перший етап «Прийнято» воронки» — перший за порядком етап з роллю «Прийнято» (у «Продажах» це «Бронь» — тому 15–17.10 нові замовлення опинялись на «Бронь»); або будь-який етап зі списку (лише своєї воронки). Власник 17.10 обрав «як у KeepinCRM»: «1» → «Новий», автоприйняття не переводить.

5Магазини Rozetka: ТТН у точки видачі

1. «Налаштування продажів» → блок «Магазини Rozetka» → перемикач «Увімкнути створення ТТН в магазини Rozetka».
2. «Відправник»: «Оновити інформацію» підтягує відправника з налаштувань сервера; або заповніть ім'я, телефон, місто й відділення руками.
3. «Параметри відправлення»: довжина, висота, ширина, вага, об'єм і короткий опис (вага товарів угоди, якщо є, головніша).
4. «Доступ до доставки»: після підключення доступу нема ні в кого — поставте «Показати» тим, хто створює ТТН. Без галочки людина бачить і друкує ТТН, але створити не може.
5. В угоді з доставкою «Магазини Rozetka» у блоці «Доставка» ТТН створюється в точку видачі через Rozetka Delivery. Докладно — Rozetka Delivery.

5аТТН із замовлення: доставка ROZETKA Delivery (16.10)

Покупець вибрав у замовленні доставку ROZETKA Delivery — таке замовлення не приймає ТТН ззовні (ЕН з власного акаунта Rozetka Delivery Rozetka відхиляє: check_correctness_of_data). Накладну створює сама Rozetka — так робить і KeepinCRM.

1. Перемикач — «Налаштування продажів» → блок «Магазини Rozetka» → «ТТН із замовлення на боці Rozetka» (типово увімкнено). Вимкнули — в угоді знову звичайна шторка «Створити ТТН».
2. В угоді з Rozetka, де «Служба доставки (Rozetka)» — ROZETKA Delivery, у блоці «Доставка» «+» і «Додати місце» відкривають форму «ТТН із замовлення Rozetka».
3. «Замовлення Rozetka» — одержувач, куди й оплата: лише показ, Rozetka бере їх із замовлення (накладений платіж — як у замовленні).
4. «Параметри відправлення» — вага (0,1–30 кг), довжина, ширина, висота (1–120 см), місць, опис до 100 символів. Типово — посилка з налаштувань ROZETKA Delivery кабінету продавця (або вага товарів угоди, або параметри цієї картки).
5. «Відправник» — ПІБ, телефон, місто й відділення відправлення зі списку ROZETKA Delivery; типово — відправник за замовчуванням з кабінету продавця. Інше місто — введіть назву, список відділень оновиться. У списку всі відділення міста (Rozetka віддає їх сторінками по 50, форма збирає всі); відділення з кабінету, якого у списку нема, показується як «З кабінету Rozetka».
6. «Платник доставки» — одержувач або відправник; безкоштовна для покупця доставка (вартість у замовленні 0) — типово відправник.
7. «Створити ТТН на Rozetka» — ТТН з'являється в угоді (служба Rozetka Delivery), у полі rozetka_ttn і в трекінгу; стікер — ⋮›Роздрукувати стікер«⋮ → Роздрукувати стікер» (друк Rozetka). У замовленні вже є ТТН — кнопка вимкнена, номер можна записати через «вручну». «Інший перевізник» — звичайна шторка.
8. Замовлення на Rozetka ще «Нове замовлення» — форма це показує, а при створенні Helomi сам спершу ставить на Rozetka «Обробляється менеджером» (на «Новому» Rozetka ТТН із замовлення не дає), оновлює «Статус Rozetka» в угоді й лише тоді створює ТТН. Якщо Rozetka відповідає, що ТТН до замовлення вже прив'язана, — Helomi бере цю ТТН в угоду, другої не створює.
9. Видалити таку ТТН можна лише в кабінеті продавця Rozetka (у Seller API методу нема); ⋮›Видалити ТТН«⋮ → Видалити ТТН» пояснить це й запропонує прибрати її лише з угоди.

Доступ — той самий «Доступ до доставки» з блоку «Магазини Rozetka».

6Імпорт старих замовлень і клієнтів

1. Спершу пов'яжіть статуси з етапами — інакше всі замовлення стануть на початковий етап.
2. «Імпорт замовлень і клієнтів» → «Запуск»: вкажіть «за N дн.» → «Запустити імпорт».
3. Імпорт іде у фоні сторінка за сторінкою (Rozetka віддає по 20 замовлень): «Триває», потім «Готово» з лічильниками «отримано, створено, оновлено, в архів». Виконані й скасовані замовлення йдуть в архів; дублі за rozetka_order_id не створюються.

7Другий кабінет Rozetka (акаунти)

Картка «Rozetka» → «Підключення» → «Акаунти» → «+ Додати акаунт» → «Назва» і «API ключ (Seller API)» (можна пізніше) → «Додати акаунт». Новий акаунт вимкнений: перевірте ключ і ввімкніть. Перемикач вмикає приймання замовлень; переписки кабінету читаються й без нього (розділ «7а»). У нього свої ключ, вхід у кабінет, налаштування продажів і журнал. «Прибрати» — угоди лишаються, зникають ключ, налаштування й журнал акаунта.

7аПереписки кабінету

Чати покупців читаються з кожного кабінету Rozetka — основного і кожного акаунта, де задано ключ і увімкнено «Читати переписки цього кабінету». Розмова в «Переписках» підписана назвою кабінету, і відповідь з неї йде з того самого кабінету.

1. Відкрийте Налаштування›Інтеграції й автоматизація›Маркетплейси›Rozetka«Налаштування → Інтеграції й автоматизація → Маркетплейси → Rozetka» і виберіть кабінет у перемикачі акаунтів під шапкою.
2. Перевірте, що у вкладці «Підключення» задано ключ Seller API цього кабінету (або виконано вхід логіном і паролем).
3. Перейдіть у «Налаштування продажів» → блок «Чати»: залиште ввімкненим «Читати переписки цього кабінету» і виберіть, які чати брати — про товари, про замовлення, запитання до продавця. У кожного кабінету ці перемикачі свої.
4. Натисніть «Зберегти». За кілька хвилин чати кабінету з'являться в «Переписках».

• Підпис. Розмови основного кабінету підписано «Rozetka», як і раніше; розмови акаунта — назвою, яку ви дали акаунту. За підписом «Переписки» показують кабінет окремо, і доступ людини можна обмежити одним кабінетом.
• Відповідь. Відповідь із «Переписок» чи від ШІ-відповідача йде ключем того кабінету, з якого прийшла розмова.
• Приймання замовлень і чати — окремо. Перемикач «Інтеграція» вмикає лише приймання замовлень: акаунт, створений вимкненим, читає переписки, щойно задано ключ.
• Другий кабінет додається кнопкою «+» у картці — розділ «7. Другий кабінет Rozetka (акаунти)».

8Блок «Rozetka» в угоді

У картці угоди з джерелом Rozetka є блок «Rozetka (<джерело>)» з даними замовлення. Чого Rozetka не передала — «…». Значення, яке можна змінити, змінюється кліком по ньому.

Комісії Rozetka Seller API у замовленні не віддає — рядок «Комісія» лишається порожнім.

• Натиск на ID або на назву блоку відкриває це замовлення в кабінеті продавця Rozetka (seller.rozetka.com.ua/main/orders/all/<ID>) у новій вкладці. Якщо ви ще не входили в кабінет у цьому браузері, Rozetka спершу попросить увійти. Замовлення з другого кабінету (акаунта) відкриється, коли в браузері виконано вхід саме в той кабінет.
• «?» праворуч у заголовку блоку відкриває цю статтю у шторці одразу на цьому розділі; «Відкрити у WIKI» — повна сторінка статті.

9Підключити ШІ-відповідача

ШІ-відповідач — агент, який читає чати Rozetka, готує чернетки відповідей і розбір розмови, пропонує угоду й задачу з чату. Для Rozetka це ШІ Руслан; назовні він нічого не надсилає, поки ви не дозволите це в його налаштуваннях.

1. Відкрийте Інтеграції›Маркетплейси›Rozetka›Налаштування продажів«Інтеграції → Маркетплейси → Rozetka → Налаштування продажів».
2. У блоці «ШІ-відповідач» виберіть у списку «Хто відповідає на чати» агента «Руслан» і натисніть «Зберегти».
3. Увімкніть агента: Інтеграції›ШІ«Інтеграції → ШІ» → картка «Руслан» → перемикач «Увімкнено» (ключ моделі — Інтеграції›ШІ›Anthropic (Claude)«Інтеграції → ШІ → Anthropic (Claude)»).
4. Натисніть «Відкрити» в блоці «ШІ-відповідач» — вікно Руслана з чатами Rozetka, чернетками, угодами й задачами з чату.

Чати Rozetka мають приходити в «Переписки»: у блоці «Чати» «Налаштувань продажів» Rozetka увімкнено чати про товари, про замовлення і запитання до продавця. Другий кабінет Rozetka (акаунт) окремого вибору не має: його чати бере агент, підключений в основній картці Rozetka. Підключає агента адміністратор; у вікні агента для цього є ще й кнопка «Підключити до каналу». Працює лише агент, який і увімкнений, і підключений до каналу Rozetka. Докладно — стаття ШІ Руслан.

Усі замовлення, не лише нові (14.10)

Приймання бере замовлення в УСІХ статусах Seller API (нові, підтверджені, у доставці, виконані, скасовані, повернення); етап — за мапою статус›етап«статус → етап», без мапи — за змістом статусу (у доставці → «Відправлено», виконано → «Отримано», не буде → «Скасована», повернення → «Повернення»). У картці каналу → «Стан роботи» → «Вивантажити замовлення» за N днів назад.

Якщо замовлення не з'являються

Опитування йде кожні 5 хвилин: Seller API /orders/search з групою «усі замовлення» двічі — від дати створення і від дати зміни (останнє опитування мінус 2 години), усі сторінки (по 20 замовлень). Так нові замовлення стають угодами, а оплата, статус і ТТН, що змінились на Rozetka пізніше, оновлюються в уже створених угодах. У картці Rozetka → «Журнал подій» має бути «intake: отримано N, створено M»; якщо рядків нема зовсім — замовлень за вікно не було; «ПОМИЛКА» з текстом — ключ чи Rozetka. «Вивантажити замовлення» за N днів у «Стані роботи» бере все заново без дублів.

Фінанси каналу: нарахування, комісія, виплата (16.10)

Гроші Rozetka у «Фінансах» — правило каналу у Фінанси›Звірка«Фінанси → Звірка» → рядок «Rozetka» (кожен акаунт — своє правило; типово вимкнено). Увімкнене правило в момент «гроші наші» (при замовленні, коли угода виграна чи на вибраних етапах) проводить дохід угоди в транзитний гаманець «Транзит · Rozetka» (угода стає «сплаченою») і комісію майданчика витратою по угоді; угода скасована — сторно. Заготовка комісії: сума з поля угоди rozetka_commission (її пише Rozetka). Виплата Rozetka на рахунок — правило імпорту «Виплата каналу» або кнопка у «Вхідних»: переказ, а не другий дохід; баланс транзитного гаманця — скільки Rozetka ще винен. Докладно — стаття «Фінанси», розділ 7а.

З 20.10 увімкнено: «ТОВ РОЗЕТКА ПЕЙ» платить і за Rozetka, і за Пром-оплату — транзит спільний, «Транзит · RozetkaPay (Prom, Rozetka)»; дохід — коли угода виграна, лише якщо «Тип оплати checkbox» Rozetkapay (картка, Apple/Google Pay, наложка ROZETKA Delivery; наложка Новою поштою йде через NovaPay). Комісія — одразу при замовленні, для будь-якої оплати: поле rozetka_commission — приймання бере його з API замовлення (commission_sum позицій × кількість, як KeepinCRM); порожнє чи 0 — комісії нема (рішення власника 20.10); з «Баланс · Rozetka» — це звірка, у P&L і «Грошовий потік» не входить; витрата на Rozetka — поповнення кабінету («Комісія Розетка» на гаманці, з якого платили, власник 21.10). Виплата з виписки — переказ із транзиту сам, винагорода з призначення — «Комісія RozetkaPay». Щодня (і кнопкою «Підтягнути з API за 7 днів» у шторці правила каналу) комісію звіряє журнал балансу кабінету з API: комісія замовлення мінус повернення при скасуванні — якщо інша, ніж у журналі, береться з кабінету; зарахування на баланс без замовлення — у підсумку як «поповнення». Докладно — «Фінанси», розділ 7а, «Виписка майданчика».