Интеграции

Список подключённых внешних сервисов продаж — агрегаторов доставки, ботов, сайта, колл-центра и QR-меню. Для каждой интеграции задаётся, из какого меню берутся блюда, какой оплатой и подтипом заказа проводится чек и в каких торговых точках интеграция работает.

Где находится

Внешние сервисы → Интеграции

Список интеграций

123

1. Название — имя интеграции, ссылка открывает её настройки.
2. Тип — сервис, с которым настроено подключение (Яндекс.Еда, WOLT, Telegram бот, Веб-сайт и другие). Задаётся при создании и в списке только показывается.
3. Создать — открывает форму новой интеграции.

Фильтры: на странице нет ни фильтров, ни поиска; число в заголовке равно количеству интеграций сети.

примечание

В списке видны и те интеграции, которые кабинет заводит сам при первом сохранении настроек других разделов: «Колл-центр», «Веб-сайт», «QR меню стола». Открывать их здесь не нужно — они настраиваются на своих страницах.

Создание интеграции

45678910111213141516171819202122232425

4. Тип — сервис, с которым настраивается подключение. Обязательное поле, от него зависит, какие ключи доступа нужно заполнить.
5. Vendor Client ID — идентификатор заведения на стороне сервиса.
6. Vendor Client Secret — секрет заведения на стороне сервиса.
7. Название — имя интеграции в кабинете, обязательное.
8. Скидка — скидка, которая автоматически применяется к заказам из этого сервиса.
9. Добавить акцию — добавляет строку в таблицу акций «1+1 / блюдо в подарок».
10. Акции 1+1 / блюдо в подарок — пары «основное блюдо → подарочное блюдо» для заказов из этого сервиса.
11. Описание — произвольный комментарий к интеграции.
12. Торговые точки — переключатели, в каких точках интеграция работает.
13. Webhook URL — адрес, который вы передаёте сервису, чтобы он присылал заказы. Поле заполняется системой и только читается.
14. prefix — префикс, который подставляется к номеру заказа из этого сервиса.
15. Client ID — идентификатор, выданный кабинетом для этого подключения, только для чтения.
16. Client Secret — секрет, выданный кабинетом, только для чтения.
17. Копировать — копирует блок Webhook URL, Client ID и Client Secret целиком, чтобы передать его сервису.
18. Внешнее меню — витрина, из которой берутся блюда заказа. Обязательное поле.
19. Тип оплаты — оплата, которой проводится чек из этого сервиса. Обязательное поле.
20. Тип доставки — подтип заказа, который получит чек. Обязательное поле.
21. Авто подтверждение заказа — заказ подтверждается без ручного шага.
22. Авто удаление заказа — чек закрывается автоматически.
23. Оплата принимается автоматически — оплата проводится сама. При включении на форме появляются обязательные поля контрагента.
24. Отмена — возвращает к списку без сохранения.
25. Сохранить — создаёт интеграцию.

Как создать интеграцию

1. Нажмите 3 — Создать.
2. Выберите 4 — Тип сервиса и введите 7 — Название.
3. Заполните ключи, выданные сервисом: 5 — Vendor Client ID и 6 — Vendor Client Secret.
4. Передайте сервису данные из блока 13 — Webhook URL, 15 — Client ID, 16 — Client Secret — их удобно скопировать кнопкой 17 — Копировать.
5. Выберите 18 — Внешнее меню, 19 — Тип оплаты и 20 — Тип доставки.
6. При необходимости задайте 8 — Скидка и акции 10.
7. В блоке 12 — Торговые точки включите точки, где интеграция работает.
8. Настройте переключатели 21–23; если включаете 23 — Оплата принимается автоматически, заполните появившиеся поля контрагента.
9. Нажмите 25 — Сохранить.

Проверки перед сохранением

Проверка	Когда срабатывает
Название заполнено	поле пустое
Тип выбран	сервис не выбран
Внешнее меню выбрано	витрина не задана
Тип оплаты выбран	оплата не задана
Тип доставки выбран	подтип заказа не задан
Оплата принимается автоматически — значение да/нет	пришло не булево значение
Контрагент и его юрлицо заполнены	включена Оплата принимается автоматически, но контрагент не выбран

Проверка останавливается на первой ошибке, интеграция при этом не создаётся. Если переключатель 23 выключен, ранее выбранный контрагент очищается при сохранении.

Редактирование и удаление

Интеграция открывается кликом по её названию в списке — форма та же, что при создании. Кнопки удаления в разделе нет: ненужную интеграцию отключают, выключив все торговые точки в блоке 12 — Торговые точки.