Подключение iiko

Подключение к iiko делает две вещи. Первое: в панель приходят меню и заказы из кассы, и по заказам видно, кто из гостей к вам ходит. Второе: если на кассе стоит модуль Revisitr, кассир списывает и начисляет бонусы гостю прямо при оплате, по коду из бота.

Первую часть вы подключаете сами за пару минут. Модуль на кассу ставим вместе с вами.

Перед началом

Понадобится API Login — ключ доступа к облаку iiko. Его создают в настройках Cloud API в iiko. Если не знаете, где это, попросите вашего партнёра iiko: это стандартная настройка.

Шаги

1. Добавьте интеграцию

   Интеграции → Добавить → iiko.

2. Введите API Login

   Вставьте ключ и нажмите Продолжить. Поле API URL оставьте пустым, если партнёр iiko не сказал иначе.

   

3. Выберите организацию и меню

   Панель сама найдёт ваши организации в iiko. Выберите нужную. Во втором списке можно выбрать внешнее меню, если вы его ведёте в iiko; иначе останется номенклатура. Нажмите Создать.

4. Запустите первую синхронизацию

   Откройте интеграцию и на вкладке Обзор нажмите Синхронизировать. Это нужно сделать один раз: после первой удачной загрузки интеграция становится активной и дальше обновляется сама.

   

   «Без привязки» — заказы, которые не удалось сопоставить ни с одним гостем бота.

Что приходит из iiko

• Меню. Появится в разделе меню под именем «Меню из iiko». Его можно переименовать, добавить фото и описания: при следующих загрузках ваши правки названия меню не затрутся. Блюда, которые убрали из кассы, не удаляются, а помечаются «не найдено в кассе». Подробнее — Меню.
• Заказы. В первый раз загружаются заказы за последние 30 дней, дальше только новые. Без модуля на кассе из облака iiko приходят доставки. Заказы в зале видны, когда на кассе стоит модуль Revisitr.
• Гости. Заказ привязывается к гостю бота по номеру телефона. Если у гостя в боте нет телефона или он другой, заказ попадёт в «Без привязки».

Данные обновляются автоматически раз в 4 часа. Если нужно сейчас, нажмите Синхронизировать.

Бонусы на кассе

Чтобы кассир мог списывать и начислять бонусы, на кассу iikoFront ставится модуль Revisitr. Как это выглядит для кассира и гостя:

1. Гость открывает в боте «💳 Лояльность» и называет код — одно слово.
2. Кассир вводит слово в кассе и видит гостя, баланс и сколько можно списать.
3. При оплате бонусы списываются, после оплаты начисляется кешбэк. Гостю приходит сообщение в Telegram.

Повторное проведение того же заказа бонусы не задваивает.

Как подключить модуль. Напишите нам: Помощь → Связаться. Мы договоримся о времени установки. Вас попросим создать ключ для кассы: вкладка Настройки интеграции → блок Ключи плагина → Создать ключ. Ключ показывается один раз, скопируйте его сразу.

На каждую кассу удобно делать отдельный ключ с понятным названием. Ненужный ключ отзывается кнопкой с корзиной.

Лицензия iiko

Модулю на кассе может понадобиться лицензия iiko на модуль API. Уточните у вашего партнёра iiko, есть ли она у вас.

Частые ситуации

Интеграция не обновляется сама

Новая интеграция начинает обновляться автоматически только после первой удачной синхронизации. Нажмите Синхронизировать на вкладке Обзор.

«Не удалось подключиться к iiko с этим API Login»

Проверьте, что ключ скопирован целиком, без пробелов. Если ошибка повторяется, попросите у партнёра iiko новый API Login.

Уйдёт ли заказ гостя из бота на кассу

Нет. Заказы из бота приходят персоналу в Telegram, в iiko они не создаются. Подробнее — Куда приходят заказы и брони.

Видны ли мои ключи в панели

Нет. После сохранения API Login и ключи кассы нигде не показываются.