Интеграция iikoCard

iikoCard — это бонусная программа для заведений на платформе iiko. Гость накапливает бонусы за заказы и может оплачивать ими части заказа.

Как это работает:

1. Гость авторизуется по номеру телефона — платформа находит его карточку в iikoCard и показывает баланс бонусов в личном кабинете.
2. В корзине видно, сколько бонусов можно списать. Лимит считается для каждого заказа отдельно, с учётом настроек акции в iiko.biz, процента оплаты бонусами и баланса гостя.
3. Списание выполняется на стороне iiko при обработке заказа.

Перейдите в: Интеграция с CRM → iiko → вкладка Бонусная система.

На вкладке доступны следующие настройки:

1. Включить бонусную систему iikoCard. Переключатель активирует интеграцию. Без него остальные настройки работать не будут.
2. Статус данных. Под переключателем видно, когда данные последний раз получались из iiko. Чтобы получить данные вручную, нажмите кнопку Обновить.
3. Бонусная программа. Выберите программу из списка. Список подгружается из iiko, поэтому доступны только действующие программы вашего заведения.
4. Тип оплаты для списания баллов. Выберите тип оплаты, который вы создали в iikoOffice для списания бонусов. Как его создать — описано в разделе «Настройка в iikoOffice» ниже.
5. Скольким бонусам равен 1 ₽ в бонусной программе. Курс обмена показывает, сколько бонусов равны 1 ₽. Например, 10 бонусов = 1 ₽. Значение подставляется из iiko.biz.
6. Показывать QR-карту гостя в профиле. Опция включает QR-карту в личном кабинете клиента (подробнее — в разделе «Что видит клиент»).
7. Правила списания. Здесь задаётся, когда клиент может тратить бонусы:
   • Минимальная сумма заказа для списания — при заказе дешевле этой суммы списание недоступно. 0 — ограничения нет.
   • Разрешить при доставке.
   • Разрешить при самовывозе.
   • Разрешить в зале.

Чтобы бонусами можно было оплачивать заказы, в iikoOffice нужно создать тип оплаты. Он используется для оплаты заказов средствами со счёта гостя и накопленными бонусами, а также позволяет проводить сумму заказа в счёт выручки.

В версиях iiko 7.1.5 и выше

1. В главном меню iikoOffice выберите: Розничные продажи → Типы оплат и нажмите кнопку «Добавить».
2. В поле «Наименование» введите название типа оплаты.
3. В поле «Тип» выберите пункт «Безналичный расчет».
4. В поле «Безналичный тип» выберите пункт «Система iikoCard5».
5. На закладке «Дополнительные настройки» нажмите кнопку «Получить маркетинговые программы с действием оплаты». С сервера iikoCard загрузится список действующих акций, которые содержат действие «Оплата со счёта».
6. Установите галочки напротив акций, по которым можно расплачиваться данным типом оплаты.
7. Нажмите кнопку «Сохранить».

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

Заморозка бонусов. Чтобы гости не тратили одни и те же бонусы дважды (например, заказали доставку на завтра с оплатой бонусами, а потом в тот же день оплатили в ресторане), настройте заморозку бонусов на счёте при размещении заказа. Для этого выберите маркетинговую акцию с включённой функцией холдирования бонусов. Включите настройки «Запрещать вводить вручную», чтобы тип оплаты был недоступен на кассе, и «Может приниматься извне».

На вкладке «Основные настройки» типа оплаты можно указать дополнительные параметры:

• Фискальный тип печатается на фискальном чеке и отправляется в ОФД.
• Если включена настройка «Проводить как скидку», сумма фискального чека уменьшается на сумму бонусов, а в OLAP-отчётах оплата бонусами отображается как скидка. Если настройка выключена — как выручка.
• Настройка «Фискализировать как скидку» позволяет комбинировать данный тип оплаты с нефискальной оплатой: бонусы будут уменьшать сумму заказа, а в OLAP-отчётах отображаться как тип оплаты.

В личном кабинете сайта и мобильных приложений у гостя есть вкладка «Бонусы». На ней видно:

• баланс — например, «На вашем счету 3 050 бонусов»;
• курс обмена — например, «1 ₽ = 10 бонусов»;
• QR-карту гостя с подсказкой «Покажите код для привязки заказа к вашему бонусному счёту».

QR-карта нужна для заказов в зале. Гость показывает код официанту, тот сканирует его в iikoWaiter и привязывает заказ к гостю — бонусы за заказ начисляются на счёт гостя. Код содержит номер телефона гостя и формируется на стороне платформы.

На странице оформления заказа при оформлении заказа на сайте или в приложениях клиент видит, сколько бонусов можно списать в этом заказе. Сумма списания зависит от лимита из iiko.biz, процента оплаты бонусами и текущего баланса гостя.

Бонусы не списываются в заказе. Что проверить?

Пройдитесь по списку:

1. Включён ли переключатель «Включить бонусную систему iikoCard».
2. Выбрана ли бонусная программа и тип оплаты для списания баллов.
3. Создан ли выбранный тип оплаты в iikoOffice и отмечена ли в нём нужная маркетинговая акция.
4. Разрешено ли списание для этого способа получения заказа (доставка, самовывоз, в зале).
5. Проходит ли сумма заказа по минимальной сумме для списания.
6. Не превышен ли лимит оплаты бонусами, заданный в iiko.biz.

Курс обмена в карточке заказа отличается от ожидаемого. Почему?

Курс задаётся в iiko.biz, и платформа при каждом заказе берёт актуальные данные. Если курс поменялся в iiko, то в админ-панели вам нужно обязательно его поменять вручную. Автоматически данные не обновятся.

Гость говорит, что не видит бонусы в приложении. В чём может быть дело?

Проверьте по порядку:

1. Авторизован ли гость по номеру телефона — карточка в iikoCard находится именно по номеру.
2. Есть ли у гостя карточка в iikoCard и начислены ли на неё бонусы.
3. Включена ли опция «Показывать QR-карту гостя в профиле», если речь о QR-коде.