Интеграции
Список подключённых внешних сервисов продаж — агрегаторов доставки, ботов, сайта, колл-центра и QR-меню. Для каждой интеграции задаётся, из какого меню берутся блюда, какой оплатой и подтипом заказа проводится чек и в каких торговых точках интеграция работает.
Где находится
Внешние сервисы → Интеграции
Список интеграций
- Название — имя интеграции, ссылка открывает её настройки.
- Тип — сервис, с которым настроено подключение (Яндекс.Еда, WOLT, Telegram бот, Веб-сайт и другие). Задаётся при создании и в списке только показывается.
- Создать — открывает форму новой интеграции.
Фильтры: на странице нет ни фильтров, ни поиска; число в заголовке равно количеству интеграций сети.
В списке видны и те интеграции, которые кабинет заводит сам при первом сохранении настроек других разделов: «Колл-центр», «Веб-сайт», «QR меню стола». Открывать их здесь не нужно — они настраиваются на своих страницах.
Создание интеграции
- Тип — сервис, с которым настраивается подключение. Обязательное поле, от него зависит, какие ключи доступа нужно заполнить.
- Vendor Client ID — идентификатор заведения на стороне сервиса.
- Vendor Client Secret — секрет заведения на стороне сервиса.
- Название — имя интеграции в кабинете, обязательное.
- Скидка — скидка, которая автоматически применяется к заказам из этого сервиса.
- Добавить акцию — добавляет строку в таблицу акций «1+1 / блюдо в подарок».
- Акции 1+1 / блюдо в подарок — пары «основное блюдо → подарочное блюдо» для заказов из этого сервиса.
- Описание — произвольный комментарий к интеграции.
- Торговые точки — переключатели, в каких точках интеграция работает.
- Webhook URL — адрес, который вы передаёте сервису, чтобы он присылал заказы. Поле заполняется системой и только читается.
- prefix — префикс, который подставляется к номеру заказа из этого сервиса.
- Client ID — идентификатор, выданный кабинетом для этого подключения, только для чтения.
- Client Secret — секрет, выданный кабинетом, только для чтения.
- Копировать — копирует блок Webhook URL, Client ID и Client Secret целиком, чтобы передать его сервису.
- Внешнее меню — витрина, из которой берутся блюда заказа. Обязательное поле.
- Тип оплаты — оплата, которой проводится чек из этого сервиса. Обязательное поле.
- Тип доставки — подтип заказа, который получит чек. Обязательное поле.
- Авто подтверждение заказа — заказ подтверждается без ручного шага.
- Авто удаление заказа — чек закрывается автоматически.
- Оплата принимается автоматически — оплата проводится сама. При включении на форме появляются обязательные поля контрагента.
- Отмена — возвращает к списку без сохранения.
- Сохранить — создаёт интеграцию.
Как создать интеграцию
- Нажмите 3 — Создать.
- Выберите 4 — Тип сервиса и введите 7 — Название.
- Заполните ключи, выданные сервисом: 5 — Vendor Client ID и 6 — Vendor Client Secret.
- Передайте сервису данные из блока 13 — Webhook URL, 15 — Client ID, 16 — Client Secret — их удобно скопировать кнопкой 17 — Копировать.
- Выберите 18 — Внешнее меню, 19 — Тип оплаты и 20 — Тип доставки.
- При необходимости задайте 8 — Скидка и акции 10.
- В блоке 12 — Торговые точки включите точки, где интеграция работает.
- Настройте переключатели 21–23; если включаете 23 — Оплата принимается автоматически, заполните появившиеся поля контрагента.
- Нажмите 25 — Сохранить.
Проверки перед сохранением
| Проверка | Когда срабатывает |
|---|---|
| Название заполнено | поле пустое |
| Тип выбран | сервис не выбран |
| Внешнее меню выбрано | витрина не задана |
| Тип оплаты выбран | оплата не задана |
| Тип доставки выбран | подтип заказа не задан |
| Оплата принимается автоматически — значение да/нет | пришло не булево значение |
| Контрагент и его юрлицо заполнены | включена Оплата принимается автоматически, но контрагент не выбран |
Проверка останавливается на первой ошибке, интеграция при этом не создаётся. Если переключатель 23 выключен, ранее выбранный контрагент очищается при сохранении.
Редактирование и удаление
Интеграция открывается кликом по её названию в списке — форма та же, что при создании. Кнопки удаления в разделе нет: ненужную интеграцию отключают, выключив все торговые точки в блоке 12 — Торговые точки.