IIKO v8.7+

Настройка интеграции ресторана с сервером лояльности MAXMA
Альтернативная инструкция:  ссылка 

Установка плагина на iikoFront

1. Сохранение старого плагина:
  • Перед установкой нового плагина рекомендуется сохранить старую версию, например, на рабочем столе. Это позволит восстановить предыдущую версию в случае возникновения проблем.
Плагин устанавливается на каждую кассу, то есть на каждый экземпляр iikoFront.
2. Распаковка файлов:
  • Получите архив с файлами плагина от менеджера  maxma.com .
  • Распакуйте файлы из архива в следующую папку: 
C:\Program Files\iiko\iikoRMS\ Front.Net \Plugins\Resto.Front.Api.CloudLoyaltyPlugin


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

Шаг 1. Переходим в папку плагина, Resto.Front.Api.CloudLoyaltyPlugin
Шаг 2. Открываем файл в любом текстовом редакторе Resto.Front.Api.CloudLoyalty.dll.config
Шаг 3. Прописываем в следующие поля настройки модуля
  • Адрес сервера:  api.maxma.com 
  • API ключ выдает интегратор или техническая поддержка.
  • Код точки должны быть уникален и отличатся от других
  • Наименование точки

https://slite.com/api/files/gVUVgZqZdkxn_P/image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiQmFicW1jc0JyQThRRTciLCJpYXQiOjE3NDM3ODk5MjMsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiY1BuaXAyb0E1TmNzSm8iLCJleHAiOjE3NDYzODE5MjN9.b00md3gHL5YiZf9HcTWo9L8FBb1vXv-MBI62JV9KvCM
Шаг 4. Скроллим в самый низ файла, и находим поле discount, там должно быть прописано "MAXMA", как на скриншоте, данная настройка отвечает за скидки.
Шаг 4. Закрываем и сохраняем файл конфига в корневой папке плагина.

Настройка скидок и Типов оплат в iikoOffice

Нужно войти в iikoOffice, в Дисконтная система -> Скидки и надбавки.
Шаг 1. Нажать кнопку "Добавить"
Шаг 2. В "Название" и "Название в пречеке" написать Бонусы (MXM), Тип скидки указать: "Скидки и надбавки", нажать "Далее", галочку "Можно назначить вручную" отключаем у всех типов кроме MAXMA и Промокоды(MXM)
Шаг 3. Проконтролировать, чтобы были отмечены все места продаж, а остальные поля - были заполнены аналогично скриншоту, нажать "Далее"

Шаг 4. В этом окне необходимо указать: Метод применения - К полной сумме заказа; Тип - Скидка и Процент Процент - 100% Нажать "Далее"
Шаг 5. Активировать чек-бокс "Активировать скидку" и нажать "ОК"
По аналогии с шагами 1-5, завести ещё 2 скидки, в которых будет отличаться только "Название" и "Название в пречеке".
Для второго типа скидки следует указать (данный тип предназначен для акций заведенных на нашей стороне):
"Название": MAXMA
"Название в пречеке": MAXMA
Для третьего типа скидки следует указать:
"Название": Промокод (MXM)
"Название в пречеке": Промокод (MXM)

Шаг 6. Добавить 2 типа оплаты, как указано на скриншоте. Настройки следующие:
1 тип:
  • Наименование: Бонусы (MXM)
  • Тип: Внешний тип оплаты
  • Название в чеке: Бонусы (MXM)
  • Безналичный тип: CloudLoyalty Бонусы
  • ✔: Проводить как скидку
  • Скидка: Выбрать
  • Бонусы (MXM)
2 тип:
  • Наименование: Промокод (MXM)
  • Тип: Внешний тип оплаты
  • Название в чеке: Промокод (MXM)
  • Безналичный тип: CloudLoyalty Промокод
  • ✔: Проводить как скидку
  • Скидка: Выбрать
  • Промокод (MXM)

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

Шаг 1. Переходим в папку плагины, путь: C:\Program Files\iiko\iikoRMS\ Front.Net \Plugins\Resto.Front.Api.CloudLoyaltyPlugin

Шаг 2. Открываем файл в текстовом документе Resto.Front.Api.CloudLoyalty.dll
Шаг 3. После чего ищем "send_sms" и меняем следующую настройку с False на True.
Было:
<setting name="send_sms" serializeAs="String">
<value>False</value>
Стало:
<setting name="send_sms" serializeAs="String">
<value>True</value>

Шаг 4. Закрываем и сохраняем файл, это нужно проделать на каждой точке, после чего РМК будет появляться окно с вводом кода смс




Отключение и включения округления


Шаг 1. Переходим в папку плагины, путь: C:\Program Files\iiko\iikoRMS\ Front.Net \Plugins\Resto.Front.Api.CloudLoyaltyPlugin

Шаг 2. Открываем файл в текстовом документе Resto.Front.Api.CloudLoyalty.dll

Шаг 3. После чего ищем discountRoundStep и меняем следующую настройку с 0 на 1
Было:
<setting name="round_sum" serializeAs="String">
<value>0</value>
Стало:
<setting name="round_sum" serializeAs="String">
<value>1</value>
После чего округление включится, если нужно отключить округление до выставляем 0.
Примечание: если вы установите 1 то округление будет работать в пользу покупателя на один рубль, если же установите 2 или более то сооствественно сумма установленного округления будет так же работать.

Шаг 4. Закрываем и сохраняем файл, это нужно проделать на каждой точке.


Актуальные версии плагинов


IIKO 8.7 и выше -  ссылка на плагин 

Как узнать версию IIKO

Посмотрите на левый верхний угол экрана IIKO — там указана версия программного обеспечения.


Путь к логам плагина

Логи плагина находятся по пути: 
C:\Users\e.bulychev\AppData\Roaming\iiko\CashServer\Logs