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

Інтеграція Wolt Drive як провайдера доставки в платформу Dots. Wolt Drive дозволяє закладам замовляти кур'єрів Wolt для доставки "останньої милі". Інтеграція підтримує створення замовлень на доставку, відстеження місцезнаходження кур'єра в реальному часі, отримання оновлень статусу доставки через вебхуки та управління налаштуваннями провайдера доставки з панелі адміністратора.

Ключові моменти

·        Кожне місто може мати власну конфігурацію Wolt з окремими обліковими даними.
·        Wolt використовує систему "shipment promise": платформа спочатку запитує оцінку доставки (ціна та час), а потім створює фактичну доставку на основі цієї оцінки.
·        Усі оновлення статусу доставки надходять через вебхуки (немає можливості опитувати Wolt щодо статусу замовлення).
·        Підтримується відстеження місцезнаходження кур'єра в реальному часі через окремий вебхук локації.
·        Функція DELIVERY_WOLT повинна бути увімкнена в підписці акаунта, щоб опція Wolt з'явилась.

2. Доступ до налаштувань доставки Wolt

2.1 Створення провайдера доставки Wolt

1.      Перейдіть в панелі керування в розділ Налаштування.
2.      Редагування міста - оберіть потрібне.
3.      Перейдіть до Доставка → Служби Доставки.
4.      Натисніть кнопку Створити службу доставки та "Create Wolt".
5.      Заповніть обов'язкові поля: Name, Merchant Key, Merchant Id, Venue Id.
6.      Налаштуйте статус та пріоритет за потребою.
7.      Натисніть Зберегти.

2.2 Редагування провайдера доставки Wolt

8.  Перейдіть до розділу Налаштування → Місто → Доставка → Служба Доставки.
9.  Натисніть на існуючу доставку Wolt у списку.
10. Відкриється сторінка Загальних налаштувань з формою доставки.
11. Внесіть зміни та натисніть Зберегти.

2.3 Управління вебхуками

12. Відкрийте конфігурацію доставки Wolt.
13. У бічному меню натисніть "Webhooks".
14. На сторінці Webhooks відображаються поточні зареєстровані вебхуки з їх URL, ID та статусом.
15. Натисніть "Оновити", щоб перереєструвати вебхуки в 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 — Автоматично згенерований секрет для перевірки підписів вебхуків. Це поле тільки для читання і не може бути змінено вручну.

3.2 Сторінка вебхуків

Сторінка Webhooks відображає всі вебхуки, зареєстровані в Wolt для цього провайдера доставки.
·        URL — URL зворотного виклику, куди Wolt надсилає події вебхуків.
·        ID — Унікальний ідентифікатор вебхука в системі Wolt.
·        Status — Active або Inactive.

3.3 Відправка тестових вебхуків (тільки для адмінів)

Доступно тільки користувачам з правами Accounts Admin. Ці сторінки дозволяють надсилати тестові події вебхуків для перевірки працездатності інтеграції.
·        Відправка вебхука доставки:

• Wolt Order Reference Id — ID замовлення Wolt для симуляції події.
• Event Type — Тип події вебхука для симуляції (напр., order.received, order.delivered).

·        Відправка вебхука локації:

• Wolt Order Reference Id — ID замовлення Wolt для симуляції оновлення локації.
• Position — Координати кур'єра, обрані через вибір на карті.

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 відхилив запит на доставку (причина в деталях).

6. Приклади використання та поради

Приклад 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.

Приклад 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) для симуляції повного циклу.

Приклад 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 повинна бути увімкнена в підписці акаунта. Зверніться до адміністратора платформи для увімкнення цієї функції.

Оновлено: 02/04/2026