База знаний/Интеграции и оборудование

Как настроить интеграцию с iiko?

Интеграция настраивается в Настройки → Интеграции → iiko на вкладке «Настройки», отдельно для каждого филиала, а плагин iikoFront ставят разработчики модуля. Пока интеграция не подключена, в Настройки → Справочники → Способы оплат у способа «iiko» есть кнопка «Подключить», она ведёт в эти же настройки.

  1. Выберите «Услуга». Списания с депозита идут в зачёт этой услуги: она должна быть активной, создана на нужном филиале и с галочкой «Произвольная цена».
Вкладка «Настройки» iiko: 1 «Услуга», 2 «Сгенерировать», 3 «Домен клуба», 5 продажа в долг
Вкладка «Настройки» iiko: 1 «Услуга», 2 «Сгенерировать», 3 «Домен клуба», 5 продажа в долг
  1. Нажмите «Сгенерировать» у поля «Токен доступа». Токен показан маскированным, кнопка «Показать» открывает его, перегенерировать можно той же кнопкой.
  2. Скопируйте «Домен клуба» кнопкой «Скопировать». Это адрес вашей базы, который iiko передаёт в заголовке запроса.
  3. Передайте токен и домен клуба разработчикам плагина. Установку и настройку iikoFront Plugin (.NET) выполняют они, контакты на сайте kafesoft.uz.
  4. Чтобы разрешить оплату в долг, поставьте галочку «Разрешить продажу товаров в iiko в долг».

Логи

Вкладка «Логи» показывает все операции API iiko: поиск клиентов и списания. Фильтры: тип операции, клиент, статус (успех или ошибка), период. Таблица выгружается кнопкой «Экспорт» над ней.

Вкладка «Логи» iiko: фильтры и кнопки «Применить», «Сбросить», «Экспорт»
Вкладка «Логи» iiko: фильтры и кнопки «Применить», «Сбросить», «Экспорт»

Если оплата не проходит

Причину обычно подсказывает текст ошибки в iiko, сам запрос виден на вкладке «Логи».

ПроблемаПричинаРешение
Интерфейс оплаты не открывается в iikoПлагин не установлен или не настроенПроверьте, что плагин лежит в папке Plugins, и перезапустите iikoFront
«Интеграция iiko не настроена»В FitBase не выбрана услугаВыберите услугу в настройках интеграции
«Клиент не найден»Клиента нет в базе FitBase или он привязан к другому клубуПроверьте клиента в базе FitBase
«Недостаточно средств»Баланс депозита меньше суммы заказаКлиент пополняет депозит в приложении или на ресепшене, либо включите оплату в долг
Повтор выдаёт «уже выполняется»Предыдущий запрос с тем же externalId ещё обрабатываетсяПодождите 1-2 минуты и повторите

Сама оплата проходит в iiko через плагин.Подробно: Как работает оплата в клубном кафе через iiko?