Интеграция с системой лояльности Мята реализуется как расширение (advanced) контура интеграции с iikoCard5.

В заведениях с iiko для настройки лояльности будет настроен iikoCard5. iikoWaiter будет настроен на работу с iikoCard обычным способом.

Рис. 1. Пример настроек подключения плагина к iikoCard5.

Расширенные (advanced) настройки лояльности не вынесены в web-админку плагина. Их необходимо прописать через прямое редактирование конфигурационного файла плагина %appdata%\Roaming\iiko\CashServer\PluginConfigs\WaiterServer\WaiterServerConfig.json

Нужно прописать теги как в примере ниже:

“AuthorizationHeader” //токен авторизации, передаваемый как Bearer заголовок в запросе. Строку токена предоставляет ответственный сотрудник Управляющей компании Мяты.

“Url” //полный URL запроса ("https://api.myataofficial.com/v6/iiko/guest?value=")

"Loyalty": {
    "CardLoyalty": {
      "Advanced": {
        "AuthorizationHeader": "Bearer xHYFycBrLxvlAyCpriPaekKzcbz8XUreXA4APHbhSUMUBFvtTJr0zNA9jybvAl4X0gicXi0FpdGpnt1bPqu3rlyjaaM0bUEkkbux",
        "Url": "https://api.myataofficial.com/v6/iiko/guest?value="
      },

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

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

Считывание QR кода при первичном посещении

В заказе iikoWaiter выбрать кнопку Чекин гостя.

Отсканировать QR код с экрана мобильного приложения Мяты.

Подтвердить чекин нажатием кнопки Гость.

На экране смартфона должна появиться информация о госте с его именем, но с нулевым балансом.

В справочнике гостей БРД создается новый гость.

Заказ привязывается к созданному гостю БРД.

Сервер Мяты запускает команду на добавление гостя в базу iikoCard на Бизе.

Через некоторое время после создания гостя на Бизе и его прогрузки на iikoCard POS Server заведения начнет полноценно работать сценарий “Считывание QR кода ранее чекинившегося гостя”.

Считывание QR кода ранее чекинившегося гостя

В заказе iikoWaiter выбрать кнопку Чекин гостя.

Отсканировать QR код с экрана мобильного приложения Мяты.

Подтвердить чекин нажатием кнопки Гость.

На экране смартфона должна появиться информация о госте с его именем, значением баланса на бонусном кошельке и возможными доступными акциями.

После выхода с экрана профиля гостя он остается привязанным к заказу о чем свидетельствует соответствующая графическая пиктограмма на заказе.

Возможные проблемы

Указан неверный токен авторизации в конфиг файле в теге "AuthorizationHeader".

Ошибка авторизации плагина Waiter на POS сервере.

Обязательно нужно обновить iikoCard POS Server.

Возможно потребуется выполнить сброс БД POSа (iiko.biz > Администрирование > Состояние POS-ов).