# Rozetka + Krokul CRM

Так, нативно. Krokul CRM забирає замовлення з кабінету продавця Rozetka через Seller API. Замовлення стає угодою з товарами вашого каталогу, а покупець стає контактом. Назад у Rozetka йдуть статус замовлення й номер ТТН, ціни й наявність товарів зі складу Krokul, а заявки на повернення видно в угоді.

**Статус:** Нативна.

## Що отримує команда

### Замовлення маркетплейсу в робочій воронці

Krokul читає /orders/search з розгорнутими purchases і створює угоду «Rozetka № …» у воронці підключення. Кожна позиція замовлення зіставляється з товаром каталогу Krokul за вашим ідентифікатором товару, тож резерв і маржа рахуються так само, як для угоди менеджера. Номер замовлення стає зовнішнім ключем, і дубля не буде.

### Постійний покупець в одній картці

Ім’я й телефон отримувача з замовлення Krokul звіряє з контактами. Якщо покупець уже замовляв, угода чіпляється до його контакту, і менеджер бачить усі покупки людини на Rozetka й поза нею.

### Статус і ТТН повертаються в кабінет

Менеджер переводить угоду на етап «Відправлено», і Krokul оновлює замовлення запитом PUT /orders/{id}. У кабінет ідуть новий статус із довідника /order-statuses/search і номер ТТН, створеної в картці угоди. Відповідність етапів і статусів задається в налаштуваннях підключення.

### Наявність і ціни зі складу Krokul

Коли залишок товару на складі Krokul змінюється, Krokul надсилає нову наявність і ціну пачкою через PUT /items/mass-update. Товар, якого немає на складі, не продається на Rozetka далі, а менеджеру не треба вести залишки у двох місцях.

### Повернення прив’язане до угоди

Заявки на повернення з /item-return/ticket/search і повернення коштів з /order-refund/search Krokul прив’язує до угоди за номером замовлення. У стрічці угоди видно причину й стан заявки, а відповідальний отримує задачу.

## Що передається між системами

| Rozetka | Krokul | Напрям | Коли |
|---|---|---|---|
| Замовлення (/orders/search) | Угода «Rozetka № …» із зовнішнім ключем | Rozetka → Krokul | Фонове опитування, типово раз на п’ять хвилин |
| Позиції замовлення (purchases) | Рядки угоди з товарами каталогу | Rozetka → Krokul | Разом з угодою |
| Отримувач (ПІБ, телефон) | Контакт: знайдений за телефоном або новий | Rozetka → Krokul | Разом з угодою |
| Статус замовлення (PUT /orders/{id}) | Етап угоди | Krokul → Rozetka | Зміна етапу угоди |
| ТТН замовлення (PUT /orders/{id}) | ТТН у картці угоди | Krokul → Rozetka | Після створення ТТН |
| Ціна й наявність (PUT /items/mass-update) | Товар і залишок на складі | Krokul → Rozetka | Зміна залишку чи ціни |
| Заявка на повернення, повернення коштів | Запис у стрічці угоди і задача | Rozetka → Krokul | Фонове опитування |

## Як підключити сьогодні

### Підключення в «Маркетплейсі»

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

### Для інтеграторів

Угоди з Rozetka проходять тим самим шляхом, що й створені вручну. Для них спрацьовують автоматизації воронки та вебхук `card.created`, підписаний HMAC-SHA256. Склад чи служба доставки отримують сигнал підпискою з фільтром за воронкою, а прийняті події з результатом читає `integration/api-readEvents`. Товари зіставляються з зовнішніми ключами через `externalRef`.

[Документація API](https://app.krokul.com/api/v1/docs)

## Питання й відповіді

### Чи є в Krokul інтеграція з Rozetka?

Так, нативна. Krokul забирає замовлення в угоди з товарами каталогу, повертає в Rozetka статус, ТТН, ціни й наявність і показує заявки на повернення.

### Що потрібно для підключення Rozetka?

Логін і пароль кабінету продавця Rozetka. Seller API працює з тими самими даними, окремого ключа немає.

### Чи потраплять у Krokul старі замовлення?

Типово ні. Перший прохід запам’ятовує останнє замовлення кабінету, і Krokul починає з наступного. Історію можна забрати окремим перемикачем у налаштуваннях підключення.

### Чому замовлення з’являється в Krokul не одразу?

Rozetka не надсилає вебхуків, тому Krokul перепитує кабінет фоном, типово раз на п’ять хвилин.

### Що робити, якщо в журналі помилка авторизації?

Оновіть пароль кабінету продавця в налаштуваннях підключення, якщо його змінювали в Rozetka.

## Обмеження

Rozetka не надсилає вебхуків, тому Krokul опитує кабінет продавця фоном, типово раз на п’ять хвилин. Підключення працює логіном і паролем кабінету продавця, окремого ключа Rozetka не видає.

## Пов’язані сервіси

- [Prom.ua](https://krokul.com/uk/integrations/prom-ua/index.md)
- [Хорошоп](https://krokul.com/uk/integrations/horoshop/index.md)
- [Нова пошта](https://krokul.com/uk/integrations/nova-poshta/index.md)
- [monobank](https://krokul.com/uk/integrations/monobank/index.md)
- [Shopify](https://krokul.com/uk/integrations/shopify/index.md)

[Маркетплейси й магазини (Україна)](https://krokul.com/uk/integrations/category/marketplaces-ua/index.md)

Rozetka є торговою маркою її власника. Krokul не афілійований з Rozetka.

Оновлено: 2026-10-12

---

Застосунок: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs