# Rozetka Delivery + Krokul CRM

Так. Krokul CRM інтегрується з Rozetka Delivery через API служби. Менеджер створює експрес-накладну з картки угоди, Krokul бере одержувача з контакту, повертає номер ЕН, вартість і дату доставки й сам оновлює статус посилки в угоді. Етикетку, реєстр для передачі посилок і повернення склад оформлює там само.

**Статус:** Через API і вебхуки.

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

### Експрес-накладна з картки угоди

Менеджер відкриває угоду й вибирає місто та відділення з довідників /api/city і /api/department. Krokul надсилає POST /api/track з номером угоди в полі visible_id, типом доставки, кількістю місць, вагою й габаритами. У відповідь приходять track_id, shipping_cost і delivery_date, і номер ЕН з’являється у відправленні угоди та в її стрічці.

### Зворотна доставка закриває оплату

Для оплати при отриманні менеджер вказує суму, і Krokul передає її в поле cost накладної. Одержувач платить цю суму в точці видачі, а оголошена вартість іде в insurance_cost. Коли накладна отримує статус вручення, Krokul проводить оплату в угоді фактом, і подія `payment.received` іде в облік.

### Статус посилки без дзвінків на склад

За розкладом Krokul запитує /api/track/status для списку активних ЕН і зіставляє коди з групами зі /api/track/status-group. Кожна зміна з’являється в стрічці угоди. Вручення переводить угоду на наступний етап за правилом компанії, і опитування цієї накладної зупиняється.

### Посилку не забрали: зберігання чи повернення

Коли строк зберігання накладної спливає, Krokul ставить відповідальному задачу з угодою й номером ЕН. Менеджер дзвонить клієнту й одним кліком продовжує зберігання через /api/track/extend-expiration-date/{id}. Якщо клієнт відмовився, Krokul оформлює повернення через POST /api/track/return, доки статус накладної це дозволяє.

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

| Rozetka Delivery | Krokul | Напрям | Коли |
|---|---|---|---|
| Населений пункт і відділення (/api/city, /api/department) | Адреса доставки у формі відправлення | Rozetka Delivery → Krokul | Менеджер заповнює відправлення |
| Експрес-накладна (POST /api/track): visible_id, cost, insurance_cost, params | Відправлення угоди, сума післяплати | Krokul → Rozetka Delivery | Менеджер створює відправлення |
| track_id, shipping_cost, delivery_date | Номер ЕН, вартість і дата в угоді | Rozetka Delivery → Krokul | У відповідь на створення ЕН |
| Статус ЕН (/api/track/status) | Статус відправлення, запис у стрічці, етап угоди | Rozetka Delivery → Krokul | Опитування, доки накладна активна |
| Закінчення строку зберігання | Задача відповідальному | Rozetka Delivery → Krokul | Посилка чекає в точці видачі |
| Повернення (POST /api/track/return) | ЕН повернення в тій самій угоді | Krokul → Rozetka Delivery | Клієнт відмовився від посилки |
| Етикетка (/api/track/label) і реєстр ЕН (/api/reception) | Кнопки друку у відправленні й у реєстрі відправлень | Rozetka Delivery → Krokul | На запит складу |

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

### Власний потік через API і вебхуки Krokul

1. Укладіть договір з Rozetka Delivery, увійдіть в API через POST /api/auth/login і створіть статичний токен партнера методом POST /api/partner/static-token.
2. У Krokul створіть ключ API зі scope на угоди й контакти та підпишіть вебхук на `card.won` або `card.statusChanged` з фільтром за етапом. Перевіряйте заголовок `x-crm-signature` своїм секретом.
3. На подію прочитайте угоду й контакт через `card/api-read` і створіть накладну POST /api/track з номером угоди в visible_id.
4. Збережіть track_id на угоді через `externalRef/api-upsert`, а статуси з /api/track/status записуйте в стрічку угоди через `activity/api-create`.

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

API Rozetka Delivery працює з bearer-токеном, який живе 72 години від останнього виклику, а для серверних потоків служба дає статичний токен партнера. Заголовок Content-Language повертає довідники українською чи англійською. З боку Krokul є публічний API, підписані вебхуки з журналом доставок і повтором, зовнішній ключ `externalRef` для номера ЕН і пісочниця на демо-компанії.

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

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

### Чи можна створити накладну Rozetka Delivery прямо з угоди?

Так. Krokul бере одержувача з контакту угоди, створює експрес-накладну й показує номер ЕН, вартість і дату доставки у відправленні угоди.

### Як Krokul дізнається, що посилку Rozetka Delivery вручено?

Krokul сам читає статуси активних накладних за розкладом, бо служба не шле подій. Статус вручення записується в угоду, і опитування цієї накладної зупиняється.

### Чи працює післяплата Rozetka Delivery з оплатою в угоді?

Так. Сума з угоди йде в поле cost накладної, а після вручення Krokul проводить оплату фактом.

### Що потрібно, щоб підключити Rozetka Delivery до Krokul?

Договір з Rozetka Delivery і доступ до її API. Для постійного з’єднання краще статичний токен партнера, бо звичайний токен змінюється після 72 годин без викликів.

## Обмеження

Rozetka Delivery не надсилає подій про зміну статусу, тому Krokul читає статуси активних накладних за розкладом. Коли одержувач платить за замовлення в точках Rozetka, служба додає до суми комісію 15 грн і 1,5 %, і ця комісія лишається умовою вашого договору зі службою.

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

- [Нова пошта](https://krokul.com/uk/integrations/nova-poshta/index.md)
- [Укрпошта](https://krokul.com/uk/integrations/ukrposhta/index.md)
- [Meest](https://krokul.com/uk/integrations/meest/index.md)
- [Rozetka](https://krokul.com/uk/integrations/rozetka/index.md)
- [Хорошоп](https://krokul.com/uk/integrations/horoshop/index.md)

[Доставка (Україна)](https://krokul.com/uk/integrations/category/delivery-ua/index.md)

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

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

---

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