> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://dots.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Інтеграція Wolt Drive Доставки

# 1. Загальна інформація

 Інтеграція Wolt Drive як провайдера доставки в платформу Dots. Wolt Drive дозволяє закладам замовляти кур'єрів Wolt для доставки "останньої милі". Інтеграція підтримує створення замовлень на доставку, відстеження місцезнаходження кур'єра в реальному часі, отримання оновлень статусу доставки через вебхуки та управління налаштуваннями провайдера доставки з панелі адміністратора.
## ${color}[#000000](Ключові моменти)
·        Кожне місто може мати власну конфігурацію Wolt з окремими обліковими даними.
·        Wolt використовує систему "shipment promise": платформа спочатку запитує оцінку доставки (ціна та час), а потім створює фактичну доставку на основі цієї оцінки.
·        Усі оновлення статусу доставки надходять через вебхуки (немає можливості опитувати Wolt щодо статусу замовлення).
·        Підтримується відстеження місцезнаходження кур'єра в реальному часі через окремий вебхук локації.
·        Функція DELIVERY_WOLT повинна бути увімкнена в підписці акаунта, щоб опція Wolt з'явилась.
|| Важливо! Wolt Drive не підтримує отримання списку активних або архівних замовлень. Платформа повністю покладається на вебхуки для відстеження статусу замовлень. Якщо вебхуки не налаштовані належним чином, статуси замовлень не будуть оновлюватися.
# 2. Доступ до налаштувань доставки Wolt
## 2.1 Створення провайдера доставки Wolt
1.      Перейдіть в панелі керування в розділ Налаштування.
2.      Редагування міста - оберіть потрібне.
3.      Перейдіть до Доставка →  Служби Доставки.
4.      Натисніть кнопку Створити службу доставки та  "Create Wolt".
5.      Заповніть обов'язкові поля: Name, Merchant Key, Merchant Id, Venue Id.
6.      Налаштуйте статус та пріоритет за потребою.
7.      Натисніть Зберегти.
![](https://storage.crisp.chat/users/helpdesk/website/-/3/c/7/6/3c7680cb850c3200/image_17zy4dn.png)![](https://storage.crisp.chat/users/helpdesk/website/-/3/c/7/6/3c7680cb850c3200/image_1hulm1k.png)


## 2.2 Редагування провайдера доставки Wolt
8.  Перейдіть до розділу Налаштування → Місто → Доставка → Служба Доставки.
9.  Натисніть на існуючу доставку Wolt у списку.
10.  Відкриється сторінка Загальних налаштувань з формою доставки.
11.  Внесіть зміни та натисніть Зберегти.
![](https://storage.crisp.chat/users/helpdesk/website/-/3/c/7/6/3c7680cb850c3200/image_1p79dd8.png)

## 2.3 Управління вебхуками
12.  Відкрийте конфігурацію доставки Wolt.
13.  У бічному меню натисніть "Webhooks".
14.  На сторінці Webhooks відображаються поточні зареєстровані вебхуки з їх URL, ID та статусом.
15.  Натисніть "Оновити", щоб перереєструвати вебхуки в Wolt (це видалить старі вебхуки і створить нові).
![](https://storage.crisp.chat/users/helpdesk/website/-/3/c/7/6/3c7680cb850c3200/image_16em4up.png)

||| Важливо! Після створення або редагування доставки Wolt необхідно натиснути "Оновити" на сторінці Webhooks, щоб зареєструвати вебхуки в Wolt. Без цього кроку платформа не отримуватиме оновлення статусу доставки або дані про місцезнаходження кур'єра.
# 3. Вкладки та налаштування
## 3.1 Загальні налаштування (Форма доставки)
Сторінка General Settings містить основну конфігурацію для провайдера доставки Wolt.
·        Name — Відображуване ім'я провайдера доставки в панелі адміністратора.
·        Status — Active, Inactive або Pause. Тільки активні провайдери використовуються для доставки.
·        Priority — Числовий пріоритет (0 або більше). Менші значення означають вищий пріоритет, коли доступні кілька провайдерів доставки.
·        Stage Env — Перемикач для середовища тестування. При увімкненні API-запити направляються до тестового середовища Wolt.
·        Merchant Key — API-ключ, наданий Wolt для автентифікації. Це поле пароля (приховане).
·        Merchant Id — Ідентифікатор мерчанта в системі Wolt.
·        Venue Id — Ідентифікатор закладу в системі Wolt. Визначає конкретну точку видачі.
·        Webhook Secret — Автоматично згенерований секрет для перевірки підписів вебхуків. Це поле тільки для читання і не може бути змінено вручну.
|| Зверніть увагу! Merchant Key, Merchant Id та Venue Id надаються Wolt під час онбордингу. Зверніться до підтримки Wolt для отримання цих облікових даних.

## 3.2 Сторінка вебхуків
Сторінка Webhooks відображає всі вебхуки, зареєстровані в Wolt для цього провайдера доставки.
·        URL — URL зворотного виклику, куди Wolt надсилає події вебхуків.
·        ID — Унікальний ідентифікатор вебхука в системі Wolt.
·        Status — Active або Inactive.
| Корисно! Реєструються два вебхуки: один для подій статусу доставки (order.received, order.picked_up, order.delivered тощо) і один для оновлень місцезнаходження кур'єра. Вони відображаються окремими рядками в таблиці.

## 3.3 Відправка тестових вебхуків (тільки для адмінів)
Доступно тільки користувачам з правами Accounts Admin. Ці сторінки дозволяють надсилати тестові події вебхуків для перевірки працездатності інтеграції.
·        Відправка вебхука доставки:
* Wolt Order Reference Id — ID замовлення Wolt для симуляції події.
* Event Type — Тип події вебхука для симуляції (напр., order.received, order.delivered).
·        Відправка вебхука локації:
* Wolt Order Reference Id — ID замовлення Wolt для симуляції оновлення локації.
* Position — Координати кур'єра, обрані через вибір на карті.
||| Важливо! Тестові вебхуки симулюють реальні події Wolt. Вони оновлять фактичні статуси замовлень та позиції кур'єрів. Використовуйте обережно з виробничими даними.
![](https://storage.crisp.chat/users/helpdesk/website/-/3/c/7/6/3c7680cb850c3200/image_vqbnl5.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/3/c/7/6/3c7680cb850c3200/image_1rqe9za.png)

# 4. Панель компанії (Замовлення)
У Панелі компанії доставки Wolt відображаються поруч з іншими провайдерами доставки.
·        Замовлення, призначені Wolt, показують бейдж "Wolt" у заголовку замовлення.
·        При створенні або редагуванні замовлення з доставкою Wolt відображається селектор тарифу доставки (аналогічно Uklon). Оператор обирає тариф перед відправкою замовлення.
·        Замовлення Wolt автоматично завершуються після виконання доставки — оператору не потрібно закривати їх вручну.

# 5. Життєвий цикл доставки Wolt
Після відправки замовлення до Wolt надходять наступні оновлення статусу через вебхуки:
·        order.received — Wolt прийняв запит на доставку.
·        order.pickup_eta_updated — Оновлено очікуваний час отримання.
·        order.pickup_started — Кур'єр призначений і прямує до точки видачі.
·        order.pickup_arrival — Кур'єр поблизу точки видачі (в межах 150 метрів).
·        order.picked_up — Кур'єр забрав замовлення.
·        order.dropoff_started — Кур'єр прямує до адреси доставки.
·        order.dropoff_arrival — Кур'єр поблизу адреси доставки (в межах 150 метрів).
·        order.dropoff_eta_updated — Оновлено очікуваний час доставки.
·        order.dropoff_completed — Завдання доставки виконано.
·        order.delivered — Повна доставка завершена.
·        order.rejected — Wolt відхилив запит на доставку (причина в деталях).
|| Зверніть увагу! Якщо замовлення відхилено Wolt, система автоматично позначає його як невдале. Причина відхилення зберігається в деталях замовлення.
# 6. Приклади використання та поради
## ${color}[#000000](Приклад 1: Налаштування Wolt для нового міста)
1. Мережа ресторанів хоче додати Wolt як опцію доставки для Києва:
2. Отримайте Merchant Key, Merchant Id та Venue Id від Wolt.
3. Переконайтесь, що функція DELIVERY_WOLT увімкнена в підписці акаунта.
4. Перейдіть на сторінку Deliveries міста і натисніть "Create Wolt".
5. Заповніть облікові дані та встановіть Status на Active.
6. Збережіть конфігурацію доставки.
7. Перейдіть на сторінку Webhooks і натисніть "Refresh" для реєстрації вебхуків.
8. Перевірте, що два вебхуки з'явились у таблиці зі статусом Active.
## ${color}[#000000](Приклад 2: Тестування інтеграції)
1. Після налаштування доставки Wolt адміністратор хоче перевірити працездатність:
2. Створіть тестове замовлення з доставкою Wolt у Панелі компанії.
3. Запам'ятайте Wolt Order Reference Id з деталей замовлення.
4. Перейдіть до бічного меню Webhooks доставки Wolt і натисніть "Send delivery webhook".
5. Введіть Order Reference Id та оберіть "order.received" як тип події.
6. Відправте форму та перевірте оновлення статусу замовлення.
7. Повторіть з іншими типами подій (order.picked_up, order.delivered) для симуляції повного циклу.
## ${color}[#000000](Приклад 3: Перемикання між тестовим та виробничим середовищем)
Під час початкового налаштування використовуйте перемикач "Stage Env" для тестування з тестовим середовищем Wolt. Після завершення тестування вимкніть перемикач для переходу до виробничого середовища. Не забудьте натиснути "Refresh" на сторінці Webhooks після зміни середовища.
# 7. Часті питання
**Питання: Де отримати облікові дані Wolt (Merchant Key, Merchant Id, Venue Id)?**
Відповідь: Вони надаються Wolt під час процесу онбордингу. Зверніться до підтримки Wolt або вашого менеджера акаунту Wolt.

**Питання: Чому статуси замовлень не оновлюються після створення доставки Wolt?**
Відповідь: Швидше за все, вебхуки не зареєстровані. Перейдіть на сторінку Webhooks і натисніть "Refresh". Перевірте, що два вебхуки з'явились зі статусом Active.

**Питання: Що таке поле Webhook Secret?**
Відповідь: Це автоматично згенерований секрет, який використовується для перевірки того, що події вебхуків дійсно надходять від Wolt (а не від третьої сторони). Він генерується автоматично при створенні доставки і не може бути змінений вручну.

**Питання: Чи можна мати кілька провайдерів доставки Wolt для одного міста?**
Відповідь: Так, можна створити кілька конфігурацій доставки Wolt для одного міста, кожна з різними обліковими даними та закладами.

**Питання: Що станеться, якщо доставку Wolt відхилено?**
Відповідь: Замовлення автоматично позначається як невдале. Причина відхилення зберігається в деталях замовлення. Поширені причини: адреса доставки за межами зони обслуговування, заклад закритий або зона доставки тимчасово закрита.

**Питання: Чи можна скасувати доставку Wolt?**
Відповідь: Так, доставки Wolt можна скасувати через стандартний процес скасування замовлення. Система надсилає запит на скасування до API Wolt.

**Питання: Як працює тариф доставки?**
Відповідь: При створенні замовлення з Wolt система спочатку запитує "shipment promise" у Wolt, який включає ціну доставки та очікуваний час. Оператор обирає тариф перед відправкою замовлення.

**Питання: Для чого перемикач "Stage Env"?**
Відповідь: При увімкненні API-запити надсилаються до тестового середовища Wolt. Використовуйте це для тестування перед запуском. Вимкніть для виробничого використання.

**Питання: Чи можна бачити місцезнаходження кур'єра на карті?**
Відповідь: Так, якщо вебхуки локації кур'єра правильно зареєстровані, позиція кур'єра в реальному часі відстежується та відображається в системі.

**Питання: Кнопка "Create Wolt" не відображається. Чому?**
Відповідь: Функція DELIVERY_WOLT повинна бути увімкнена в підписці акаунта. Зверніться до адміністратора платформи для увімкнення цієї функції.