Обзор интеграций
Loyalhub работает поверх учётной системы iiko: берёт из неё точки продаж, меню и программу лояльности и отправляет туда заказы из приложения, сайта, бота и киосков. В этом разделе — подключение iiko, онлайн-оплаты и внешних сервисов для ресторана и интегратора.
Общий сценарий: поля, проверка, сохранение. Подключение интеграций
Cloud API в iikoWeb, фоновая синхронизация гостей и уведомления iikoCARD. iiko и iikoCard
Банки, платёжные системы юрлиц и фискализация чеков. Онлайн-оплата
Отзывы гостей из Loyalhub в Поинтер. Pointer: передача отзывов
Заказы и брони в чат сотрудников. Уведомления в Telegram-группу
Коды входа гостей и их стоимость. SMS и баланс
Как Loyalhub работает с iiko
Loyalhub подключается к iiko через iikoCloud API. Ключ создаётся в iikoWeb, а добавляет его специалист Loyalhub. Дальше данные идут так:
Данные | Откуда → куда | Когда |
|---|---|---|
Точки продаж, типы оплат и заказов, скидки | iiko → Loyalhub | При подключении и по кнопкам на вкладке Учётная система |
Номенклатура и внешние меню | iiko → Loyalhub | При обновлении меню вручную или по расписанию |
Стоп-листы и статусы заказов | iiko → Loyalhub | Сразу, через вебхук, который Loyalhub регистрирует в iiko сам |
Заказы гостей | Loyalhub → iiko | При оформлении, если включено Отправлять заказы во внешнюю систему |
Расчёт акций и скидок для корзины | Loyalhub ↔ iiko | При сборке корзины, если включено Расчитывать корзину во внешней системе |
Гости, балансы, категории, списание бонусов | Loyalhub ↔ iiko | При регистрации гостя, заказе и обновлении карточки гостя |
Отзывы гостей | Loyalhub → Поинтер | Сразу после того, как гость оставил отзыв, если подключена интеграция с Поинтером |
Касса, фискализация, состав номенклатуры, цены и правила программы лояльности iikoCard настраиваются в iiko, а не в CRM.
Настройки учётной системы в CRM
Настройки связи с iiko находятся в Настройки → Настройки → Учётная система. Изменения флажков сохраняются кнопкой Сохранить.
Обновить данные после изменений в iiko. Нажмите ⋮ рядом с Синхронизировать данные: CRM загрузит точки продаж, категории гостей или программы лояльности.
Отправлять заказы на кассу. Включите Отправлять заказы во внешнюю систему. Если выключено, заказы остаются только в Loyalhub.
Считать акции и скидки в iiko. Включите Расчитывать корзину во внешней системе: акции и скидки для корзины гостя посчитает iiko.
Дать гостю выбрать город. Включите Выбор городов доступен — выбор появится в приложении и на сайте.
Поля Ключ, Идентификатор и Система лояльности — служебные идентификаторы группы компаний; их просит поддержка или интегратор.
Основные понятия
Учётная система — iiko, где ведутся номенклатура, касса и заказы (её ещё называют «бэкофис»).
API-ключ iikoCloud — ключ доступа Loyalhub к вашей iiko; создаётся в iikoWeb.
iikoCard (iikoCARD) — программа лояльности iiko: балансы, категории и операции гостей.
Интеграция — подключение внешнего сервиса на вкладке Интеграции: Поинтер или iikoCard.
Банк юрлица — платёжная система (эквайринг), через которую гости платят онлайн.
Для интеграторов
Какие методы iikoCloud API использует Loyalhub
Базовый адрес — https://api-ru.iiko.services/api/1/, меню — api/2/.
Доступ и справочники: access_token, organizations, terminal_groups, terminal_groups/is_alive, payment_types, deliveries/order_types, discounts
Меню и стоп-листы: nomenclature, menu, menu/by_id, stop_lists
Заказы: deliveries/create, deliveries/by_id, deliveries/drafts/create, order/create, order/by_id
Лояльность: loyalty/iiko/calculate, loyalty/iiko/customer/info, loyalty/iiko/customer/create_or_update, loyalty/iiko/customer/wallet/hold, loyalty/iiko/customer/wallet/cancel_hold, loyalty/iiko/customer_category, loyalty/iiko/program, loyalty/iiko/message/send_sms
Вебхуки: webhooks/update_settings
Куда iiko отправляет вебхуки
Loyalhub сам регистрирует вебхук для каждой точки продаж через webhooks/update_settings с собственным токеном. События заказов и стоп-листов приходят на адрес Loyalhub /api/v1/callbacks/iiko/main_events/. Настраивать вебхуки в iikoWeb вручную не нужно.