/
Настройки для работы с iikoCard5

Настройки для работы с iikoCard5

Актуально для функционала:

 

Данные настройки определяют интерфейс приложения iikoWaiter (доступность кнопок и сценариев работы) и внутреннюю работу плагина.

По умолчанию поддержка работы с лояльностью iikoCard5 выключена.

Настройка осуществляется через web-админку плагина или путем редактирования конфигурационного файла плагина.

Краткий список шагов для подключения iikoCard к iikoWaiter

  1. Создать пользователя для POS Loyalty Server и прописать его в конфиге

  2. Выбрать систему лояльности Card5 в веб-админке плагина

  3. Прописать настройки соединения с POS-сервером

  4. Создать дополнительные специальные типы оплат для iikoWaiter в iikoOffice

  5. Сопоставить (соединить) созданные типы оплат и маркетинговые программы из iikoBiz в веб-админке плагина

  6. Настроить iikoBiz

Создание пользователя для POS Loyalty Server

Создаем пользователя POS Loyalty Server в iikoWeb по статье (требуется для новых интеграций. старые интеграция продолжат работать без этих параметров).

Прописываем полученные логин (начинается с “pos_login…”) и пароль в конфиге плагина WaiterServer в полях "UserName" и "UserSecret".

image-20260701-080843.png

Сохраняем конфиг файл.

Включение iikoCard в плагине и подключение к POS-серверу

Пропишите адрес POS сервера.

image-20250917-032053.png

POS сервер iikoCard желательно размещать на главной кассе вместе с плагином iikoWaiter или в локальной сети предприятия.

Выберите в качестве системы лояльности Card5

image-20250917-032157.png

После выполнения настроек проверьте соединение кнопкой Check connection.

При рабочих настройках должно появиться сообщение

Connected to POS server.

В случае появления сообщений об ошибке обратитесь к параграфу Возможные ошибки.

Настройка типов оплат для бонусов и депозитов iikoCard

  • Платежный процессор - обрабатывает проведение платежа в iiko. Существует в единственном экземпляре на весь iikoRMS.

  • Тип оплаты - “обертка“ над платежным процессором. Имеет настраиваемые свойства вроде фискальности, счетов перемещения и т.д. Можно настроить несколько типов оплаты для одного платежного процессора.

  • Элемент оплаты – относится к заказам. Когда пользователь выбирает какой-либо тип оплаты, в заказ добавляется элемент оплаты этого типа оплаты.

Для осуществления безналичного расчета бонусами и депозитами iikoCard5 напрямую через iikoWaiter необходимо добавить и настроить соответствующие типы оплат. Они настраиваются в дополнение к безналичным оплатам, которые задействуют “Система iikoCard5” и используются при оплате заказов через стационарные терминалы iikoFront.

Необходимость добавления дополнительных ТО связана с ограничениями iikoFrontAPI на использование типов оплат, требующих внешнего процессинга.

Дополнительные типы оплаты iikoCard5 через iikoWaiter настраиваются как внешние и обрабатываются платежным процессором “iikoCard5 (iikoWaiter)”, который появляется после включения iikoCard в плагине iikoWaiter.

Бонусный и депозитный тип оплаты настраиваются отдельно ввиду требований 54-ФЗ. Бонусный тип оплаты не является фискальным и проводится в чеках как скидка на сумму списываемых бонусов. Депозитный тип является фискальным и в чеке проходит как постоплата. 

Тип оплат для бонусов

Пример настройки типа оплаты для бонусов iikoCard.

В наименовании типа оплаты желательно указывать имя платежного процессора, который отвечает за проведение данных платежей.

Галочка “Запрещать вводить вручную” должна быть неактивна, чтобы данные типы оплаты могли быть автоматически добавлены плагином в заказ как несохраненные платежи. Ручное добавление данного типа оплат на фронте запрещено проверкой наличия в заказе сохраненных платежей на соответствующие ТО.

Настройка скидки под бонусы

Согласно требованиям 54-ФЗ бонусы должны проводиться как скидка. (название скидки для примера)

Тип оплат для депозитов

Пример настройки типа оплаты для депозитов iikoCard.

Сопоставление типов оплат и маркетинговых акций

Чтобы Waiter отображал созданные и настроенные в iikoOffice бонусные и депозитные типы оплат, необходимо выбрать их в соответствующих выпадающих списках настройки iikoCard в админ панели WaiterServer и нажать на кнопку “Save settings“.

image-20250917-032232.png

Настройки iiko.biz

Опция “Синхронизировать только гостей, побывавших в ресторане” должна быть выключена (см. скриншот).

Замечания

На практике со стороны iikoCard может быть настроено несколько маркетинговых программ бонусного или депозитного типа с действием оплаты. При этом со стороны iikoOffice добавляется только один дополнительный ТО под каждый тип МП. Через теги <BonusPaymentTypeId>  и  <DepositPaymentTypeId> МП привязываются к соответствующему типу оплат iikoOffice и при операциях их балансы будут суммироваться в рамках своего типа.

Варианты размещения POS сервера

Для общей локации с несколькими группами терминалов желательно все терминалы настроить на общий iikoCard POS Server.