1. Что это

Интеграция Fitbase с iiko — это связка между фитнес-платформой Fitbase и кассовой системой iiko (популярная POS-система для кафе и ресторанов в России/СНГ). Она позволяет посетителям клуба оплачивать заказы в клубном кафе с внутреннего счёта (депозита) в Fitbase — напрямую, без наличных или банковской карты.

На практике это выглядит так:

1. Посетитель занимается в клубе, заходит в кафе и берёт кофе/еду.

2. Сотрудник кафе открывает заказ в iiko и выбирает способ оплаты «Fitbase».

3. В интерфейсе iiko (силами плагина iikoFront Plugin) сотрудник находит посетителя (по браслету, ФИО или телефону).

4. Сотрудник видит баланс депозита посетителя и подтверждает оплату.

5. Средства списываются с депозита в Fitbase — заказ закрывается.

Участники системы

2. Зачем это нужно

Для клуба

• Удержание клиентов: Пополнение депозита — дополнительная привязка к клубу. Клиенту проще тратить деньги внутри клуба, чем искать кофе на стороне.
• Дополнительная выручка: Депозиты работают как предоплаченные средства — клуб получает деньги раньше, чем клиент их потратит.
• Безналичный оборот внутри клуба: Снижается объём наличных расчётов, меньше ошибки кассиров.
• Единая платёжная среда: Клиент использует один баланс (депозит Fitbase) и для услуг клуба, и для кафе.

Для посетителя

• Удобство: Не нужно носить с собой кошелёк или карту в кафе — достаточно браслета.
• Быстро: Оплата в одно касание — не ждать сдачу или терминал.
• Контроль: Баланс и история трат видны в мобильном приложении Fitbase.

Для сотрудника кафе

• Меньше ошибок: Не нужно принимать и пересчитывать наличные.
• Быстрое обслуживание: Поиск клиента по браслету/QR занимает секунды.
• Всё в одном окне: Не нужно переключаться между терминалом и кассой.

3. Основной функционал

3.1. Поиск клиента Fitbase

В интерфейсе плагина iikoFront доступны три способа найти посетителя:

Система ищет клиента нечётко: сначала по ФИО и карте, затем по телефону, затем по контактам и номеру карты в абонементах.

3.2. Просмотр профиля и баланса

После выбора клиента плагин показывает:

• ФИО, фото (если есть)
• Текущий статус клиента (Открыт, Заблокирован, Заморожен и т.д.)
• Баланс депозита — сколько денег на внутреннем счёте

3.3. Оплата с депозита

Сотрудник выбирает «Оплата с депозита» — система автоматически списывает сумму заказа с баланса клиента.

Что при этом происходит «под капотом»:

1. Fitbase API проверяет, достаточно ли средств на депозите.

2. Если проверка пройдена — сумма списывается с депозита.

3. Создаётся запись о продаже «Продажа в кафе».

4. Fitbase возвращает в iiko статус «Оплачено».

5. iiko закрывает заказ.

3.4. Способ оплаты «iiko» и фискализация

Способ оплаты «iiko» добавлен в справочник способов оплат Fitbase (безналичный кастомный). Продажи по интеграции проводятся через этот способ оплаты.

Особенности способа оплаты «iiko»:

• Нефискализируемый — фискализация происходит на стороне iiko в соответствии с 54-ФЗ. iiko самостоятельно формирует и передаёт чеки в ОФД.
• Не отправляется на кассу Fitbase — операции не попадают в кассовые смены Fitbase.
• Виден в отчётах о продажах — продажи отображаются с пометкой «iiko» и участвуют в расчёте LTV.

Если интеграция iiko ещё не настроена, в справочнике способов оплат отображается кнопка «Подключить» — она ведёт в раздел настроек интеграции.

4. Как настроить

Настройка интеграции состоит из двух этапов: на стороне Fitbase (в панели администратора) и на стороне iiko (установка плагина).

4.1. Настройка в Fitbase (панель администратора)

Раздел интеграции находится в Панели администратора Fitbase → Интеграции → iiko.

Раздел содержит две вкладки:

Вкладка «Настройки»

Параметры настраиваются для каждого филиала отдельно (у каждого филиала свой токен).

Fitbase → Интеграции → iiko, вкладка «Настройки»: услуга, токен доступа, домен клуба и переключатель оплаты в долг.

Вкладка «Логи»

Таблица всех операций API iiko (поиск клиентов и списания). Доступна фильтрация:

• по типу операции (поиск / оплата)
• по клиенту
• по статусу (успех / ошибка)
• по дате (произвольный период)

Логи можно выгрузить в CSV.

4.2. Настройка плагина iikoFront

Установка и настройка плагина iikoFront Plugin (.NET) выполняется специалистами, которые разработали модуль интеграции. По вопросам настройки обращайтесь к ним напрямую.

4.3. Проверка работоспособности

После настройки убедитесь, что всё работает:

☐  При выборе оплаты «Fitbase» в iiko открывается интерфейс плагина.

☐  Поиск клиента работает по всем трём способам (RFID/QR, ФИО, телефон).

☐  Баланс депозита отображается корректно.

☐  Списание с депозита проходит без ошибок.

☐  В истории клиента в Fitbase отображается операция «Продажа в кафе».

5. Возможные проблемы и их решение

6. Оплата в долг

Если у клиента недостаточно средств на депозите, сотрудник может оформить «Оплата в долг»:

• Создаётся запись о задолженности.
• Продажа фиксируется, происходит списание товара в iiko
• Долг затем погашается в Fitbase — как оплата услуги
• Оплата в долг доступна только клиентам со статусом "Открыт"