UK
Подивитися демо

Rozetka Delivery + Krokul CRM

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

  • Через 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, paramsKrokul → Rozetka DeliveryВідправлення угоди, сума післяплатиМенеджер створює відправлення
track_id, shipping_cost, delivery_dateRozetka 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.

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

Чи можна створити накладну 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 %, і ця комісія лишається умовою вашого договору зі службою.

Чогось бракує?

Напишіть, яким сервісом ви користуєтесь і що має ходити між ним і Krokul. Ми відповімо способом і строком.

Запит отримано. Відповімо на вашу пошту.

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

Подивитися демо