> Усі статті WIKI Helomi: /wiki/llms.txt

# Rozetka Delivery

Rozetka Delivery — служба доставки Rozetka: через неї створюються накладні для замовлень маркетплейсу Rozetka, зокрема в точки видачі «Магазини Rozetka». Картка в «Перевізниках» тримає вхід у кабінет Rozetka, відправника, дефолти накладної, доступи і зв'язок статусів доставки з етапами угоди. Для магазинів, що працюють через Prom, накладна створюється в кабінеті Prom, а не тут.

## Можливості
- Накладні Rozetka Delivery з угоди, зокрема в «Магазини Rozetka».
- Кілька акаунтів-відправників зі своїм входом у кабінет, відправником і доступами.
- «Додаткова інформація» (опис у накладній) і «Номер замовлення» за налаштуваннями.
- «Пов'язані статуси» і «Пов'язані типи оплат та статуси» → етап угоди, «Пов'язані поля».

## 1. Налаштування
Налаштовує адміністратор. Дорога: «Налаштування» → «Інтеграції» → вкладка «Перевізники» → картка «Rozetka Delivery». Відкривається вкладка «Налаштування»; поруч — «Підключення».

1. **Вхід у кабінет.** Логін і пароль кабінету Rozetka вводяться в акаунті (група «Доступ до кабінету») або в «Підключенні» («Логін», «Пароль») — останні діють, коли акаунтів нема. Зберігаються зашифрованими.
2. **Перевірка.** У «Підключенні» безпечної перевірки нема — дивіться стан ключів і журнал. У картці акаунта «Перевірити» входить у кабінет логіном акаунта.
3. **Налаштування.** «Інтеграція» («Увімкнути інтеграцію»), «Додаткова інформація», «Номер замовлення», «Акаунти», «Доступи», «Пов'язані статуси», «Пов'язані типи оплат та статуси», «Пов'язані поля», «Вага й габарити з товарів» (галочка: вага й розмір посилки — з товарів угоди й кількості, а не з акаунта; [докладно](shipping.md#3а-вага-й-габарити-з-товарів-угоди)). Унизу — «Скасувати зміни» / «Зберегти».
4. **Значки в шапці картки.** «Приєднано» — вхід у кабінет задано. «увімкнено» / «вимкнено» — головний перемикач картки у вкладці «Підключення». Для перевізника він нічого не вмикає й не вимикає: накладні й автооновлення статусів залежать від «Увімкнути інтеграцію» у «Налаштуваннях» і від «Увімкнено» в самому акаунті. Щоб шапка не плутала, увімкніть і перемикач у «Підключенні».
5. **Вкладки над «Підключення / Налаштування».** «Основний» — відправник із налаштувань сервера, діє лише тоді, коли акаунтів нема. Далі — акаунти (наприклад, «ФОП …») з крапкою: зелена — увімкнено, жовта — бракує входу чи відправника, сіра — вимкнено.

Відправник і параметри відправлення для «Магазинів Rozetka» задаються також у картці Rozetka → «Налаштування продажів» → «Магазини Rozetka» ([стаття](int-rozetka.md#5-магазини-rozetka-ттн-у-точки-видачі)).

## 2. Акаунти і доступи
«Акаунти» → «+ Додати акаунт» → назва → «Додати». Розгорнутий акаунт: «Увімкнено», «Перевірити», «Прибрати акаунт» і групи:
- «Доступ до кабінету»: «Логін», «Пароль»;
- «Відправник»: «Ім'я відправника», «Перевізник» (назва перевізника в кабінеті Rozetka), «Телефон», «Місто», «Відділення» (адреса або № точки видачі);
  - «Перевізник» — точно як у кабінеті Rozetka Delivery: «Самовивіз з магазинів Розетки» (точки видачі Rozetka), «Нова Пошта», «Meest Пошта» або «Укрпошта». Назва, якої в кабінеті нема, дає помилку «Rozetka: перевізника не знайдено» — накладна не піде іншим перевізником;
  - «Відділення» магазину Rozetka — адреса, як у кабінеті: номерів у магазинів нема, тож шукається збіг будинку й вулиці («Голосіївський просп., 108/1» = «м. Київ, Голосіївський пр-т, 108/1»). Кнопка «Перевірити» перевіряє лише вхід; чи знайшлось відділення, видно в прев'ю «Створити ТТН»;
- «Відправлення за замовчуванням»: «Платник доставки», «Опис» (короткий опис у накладній);
- «Розмір і вага відправлення».

«Доступи · <акаунт>»: «Показати» тим, хто створює накладні цим відправником; адміністратор бачить усі.

- **Автооновлення й архів отриманих** (над «Пов'язаними статусами»): «Оновлювати статуси ТТН автоматично» кожні N хв (типово так, 30 хв) — статуси відкритих угод оновлюються самі, без кнопки «Оновити статус»; «Посилку отримано → угода «Виграно» в архів» (типово так) — коли перевізник каже «отримано», угода переходить на етап «Виграно» своєї воронки й іде в архів навіть без рядка «Пов'язаних статусів». Відмови й повернення не архівуються. Скасовані ТТН не опитуються.
- **«Пов'язані статуси»** — назва статусу має збігатися дослівно (без регістру). Rozetka Delivery пише, наприклад, «В дорозі», «У відділенні», «Видано», «Відмова від одержання», «Створено рахунок», «Прийнято від продавця», «Помістили в контейнер», «Готово до видачі», «Клієнт відмовився на точці видачі» — список підказує їх у формі. Назви з KeepinCRM («Створено», «Прийнято», «У дорозі», «Очікує в пункті видачі», «Відмова») спрацьовують на ці тексти; під рядком видно, на які, а рядок без відповідника позначено. Типовий набір: «В дорозі» → «Відправлено», «У відділенні» → «У відділенні», «Видано» → «Отримано», «Відмова від одержання» → «Повернення». ТТН замовлень Rozetka, записані службою «rozetka_delivery», фон теж опитує (до 17.10 пропускав).
- **Кожна воронка — свої рядки** (17.10): рядок діє лише на угоди воронки свого етапу (воронку видно біля етапу: «Відправлено [Продажі Каста]»). Посилки цієї служби їздять у кількох воронках — додайте для кожної свої рядки з тими самими статусами.
- **«Скасовані угоди не чіпати»** і **«Не повертати угоду на етап до збірки»** (перемикачі над таблицею, типово ввімкнені, 17.10): скасовану угоду статус посилки не рухає й не закриває «Виграно»; коли посилка вже поїхала, рядки на етапи з роллю «Створено», «Прийнято», «Передали на збірку», «Зібрано», «Допомога» пропускаються — діє наступний рядок.
- **«Міняти етап, коли посилка»** (16.10): етап за статусом міняється лише на позначених станах посилки — типово «відправлена / в дорозі», «у відділенні», «отримана», «повернення». Поки посилка «створена, ще не відправлена», етап стоїть, навіть якщо для такого статусу є рядок; щоб і він діяв, позначте «створена, ще не відправлена».

## 3. Створити накладну з угоди
Картка угоди з Rozetka → «Доставка» → «+» → «Створити ТТН» → вкладка Rozetka → акаунт → точка видачі → «Створити ТТН». Вага товарів угоди, якщо вона є, головніша за дефолтну. Покроково — [Доставки і ТТН](shipping.md).

Для «Магазинів Rozetka» на Prom накладна створюється лише через кабінет Prom; якщо на сервері це вимкнено — створіть її в кабінеті Prom вручну.

## Можливі помилки
| Що ви бачите | Чому | Що зробити |
| --- | --- | --- |
| «Помилка валідації даних: одержувач → телефон — …» (поле і причина) при «Створити ТТН» | Rozetka не прийняла значення поля ЕН | Виправте назване поле у шторці |
| «Помилка валідації даних» без назви поля | Rozetka відмовила, не назвавши поле (так буває через опис чи номер замовлення з налаштувань акаунта) | Helomi сам повторює запит без номера замовлення і з коротким описом «Угода <id>» — ЕН створюється; якщо й це не допомогло, у дужках — відповідь Rozetka як є; напишіть її в підтримку |
| У «Підключенні» замість «Перевірити» — «Для цього каналу безпечної перевірки нема — …» | Перевірка картки не передбачена | Перевірте акаунт у вкладці «Налаштування» |
| ««Магазини Rozetka» на Prom: ЕН створюється ЛИШЕ через кабінет Prom, …» | Магазин працює через Prom, а створення через кабінет Prom вимкнено | Створіть ЕН у кабінеті Prom вручну |
| ««Магазини Rozetka»: в угоді нема prom_order_id — …» | Угода не з Prom | Створіть ЕН у кабінеті Prom вручну |
| «Нема доступу до створення ТТН у магазини Rozetka — …» | Немає галочки в «Доступ до доставки» картки Rozetka | Адміністратор дає доступ |
| «Нема доступу до акаунта «…» Rozetka Delivery — …» | Не поставлено «Показати» в «Доступах» | Адміністратор дає доступ |
| «Rozetka: перевізника не знайдено» | Назва в полі «Перевізник» акаунта не збігається з кабінетом | Впишіть одну з назв: «Самовивіз з магазинів Розетки», «Нова Пошта», «Meest Пошта», «Укрпошта» |
| «Rozetka: відділення відправника не знайдено» | Адреса у «Відділення» не збіглась із точкою Rozetka в місті | Візьміть адресу точки з кабінету Rozetka Delivery: будинок і вулиця мають збігатися |
| «Rozetka: магазин/відділення не знайдено: …» | Адреса одержувача з замовлення не збіглась із жодною точкою міста | Оберіть точку зі списку у формі «Створити ТТН» |
| У шапці «вимкнено», хоча накладні створюються | Вимкнено головний перемикач у «Підключенні» — для перевізника він ні на що не впливає | Увімкніть перемикач у «Підключенні» |
| Статус ТТН давно не змінюється | Вимкнено «Оновлювати статуси ТТН автоматично», угода в архіві або ТТН скасована | Перевірте перемикач над «Пов'язаними статусами»; разово — «Оновити статус» у рядку ТТН |

## Для ШІ-співробітників
З доступами «Інтеграції» і «Налаштування інтеграцій» (вкладка «Доступи» пульта ШІ) ШІ читає ці налаштування (`integrations_carrier_get`, `integrations_carrier_statuses`), натискає «Перевірити» акаунт (`integrations_carrier_check`) і пропонує зміни (`integrations_carrier_update`, `integrations_carrier_account_add`, `integrations_carrier_account_delete`) — кожна чекає «Підтвердити» адміністратора. Ключі й токени ШІ не бачить (лише «задано» й `••••1234`) і не вводить. Докладно — [Інтеграції — вхід для ШІ](integrations.md). Накладні створює людина. ШІ бачить доставки угоди в `deals_get`. Статтю ШІ читає інструментом `help("int-rozetka-delivery")`.

## Додаткова інформація
- Пов'язані статті: [Rozetka](int-rozetka.md), [Доставки і ТТН](shipping.md), [Prom](int-prom.md).