iiko и iikoCard
Loyalhub работает вместе с iiko и iikoCard: из iiko берёт точки продаж и меню и отправляет туда заказы, а из iikoCard — гостей, балансы и операции по программе лояльности. Страница показывает, что откуда и куда идёт и в каком порядке всё настроить.
Как устроена связка
iiko — учётная система ресторана (её ещё называют «бэкофис»): в ней ведутся номенклатура, касса, точки продаж и заказы. iikoCard — программа лояльности iiko: в ней живут гости, карты, балансы бонусов и категории гостей.
Loyalhub подключается к iiko через iikoCloud API: ключ создаётся в iikoWeb, а добавляет его специалист Loyalhub. К iikoCard Loyalhub подключается отдельно: логин и пароль веб-кабинета iikoCard вводит администратор группы компаний в CRM.
Где в CRM: Настройки → Настройки → Учётная система — связь с iiko; Настройки → Настройки → Интеграции — подключение iikoCard. Вкладка Интеграции видна только администратору группы компаний.
Что откуда и куда идёт
Данные | Направление | Когда |
|---|---|---|
Точки продаж, терминалы, типы заказов и оплат, настройки доставки, схемы залов | iiko → Loyalhub | По команде Загрузить точки продаж на вкладке Учётная система |
Номенклатура и меню | iiko → Loyalhub | По кнопке Обновить меню и автоматически: когда гости открывают меню и до 4 раз в день в заданное время |
Стоп-листы и статусы заказов | iiko → Loyalhub | Сразу, через вебхук, который Loyalhub сам регистрирует в iiko для каждой точки |
Заказы гостей | Loyalhub → iiko | При оформлении, если включено Отправлять заказы во внешнюю систему |
Расчёт акций и скидок для корзины | Loyalhub ↔ iiko | При сборке корзины, если включено Расчитывать корзину во внешней системе |
Гости, карты, кошельки, балансы, категории, операции | iikoCard → Loyalhub | В фоне, пока интеграция iikoCard подключена и включена; можно запустить вручную |
Регистрация гостя и списание бонусов | Loyalhub → iikoCard | При регистрации гостя и оформлении заказа |
Смена баланса гостя | iikoCard → Loyalhub | Сразу, если в iikoCARD настроены webhook-уведомления: баланс обновляется примерно через 10 секунд, гость получает push |
Касса, фискализация, цены, состав номенклатуры и правила программы лояльности настраиваются в iiko и iikoCard, а не в CRM.
Что настроить и в каком порядке
Ключ создаётся в iikoWeb и передаётся специалисту Loyalhub, который добавляет его в вашу группу компаний. Без ключа Loyalhub не видит ни точки, ни меню. Подробно: Cloud API в iikoWeb.
Администратор группы компаний вводит URL кабинета, логин и пароль iikoCard в Настройки → Настройки → Интеграции, проверяет подключение и выбирает сеть или точку для синхронизации. Общие правила окна — в Подключение интеграций, особенности iikoCard — в iikoCard: фоновая синхронизация гостей.
Точки продаж не создаются в CRM вручную. Добавьте их в ключ интеграции в iikoWeb, затем в Настройки → Настройки → Учётная система нажмите ⋮ рядом с Синхронизировать данные и выберите Загрузить точки продаж. Подробно: Точка продаж.
Меню собирается на основе номенклатуры iiko и обновляется вручную или автоматически. Как создать меню — Создание меню, как обновлять — Обновление меню и автообновление.
Шаг нужен, если гости должны получать push сразу после начисления или списания бонусов. Подписка создаётся в кабинете iikoCARD, а не в CRM. Без неё данные гостей всё равно догружает фоновая синхронизация. Подробно: Уведомления iikoCARD.
Вебхук iiko для событий заказов и стоп-листов настраивать в iikoWeb не нужно: Loyalhub регистрирует его для каждой точки продаж сам. Если события перестали приходить, на вкладке Основное точки продаж есть пункт Обновить webhook в меню действий ⋮.
Что внутри
Как создать API-ключ, который подключает iiko к Loyalhub. Cloud API в iikoWeb
Гости, балансы и операции из iikoCard без ручной выгрузки. iikoCard: фоновая синхронизация гостей
Push гостю сразу при смене баланса. Уведомления iikoCARD
Для интеграторов
Список методов iikoCloud API, которые использует Loyalhub, и адреса, на которые iiko отправляет вебхуки, приведены в Обзор интеграций. Настройки связи с iiko в CRM (флажки отправки заказов и расчёта корзины) описаны там же.