IIKO v8.7+

Руководство по настройке интеграции точки продаж с сервером программы лояльности MAXMA


Альтернативное руководство по настройке можно найти по  ссылке .

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

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

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

IIKOv8.7+ актуальная  ссылка на плагин 
IIKO - в этой версии реализована возможность списывать бонусы после оформления пречека -  ссылка на плагин 

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

1 шаг: Открытие конфигурационного файла
1. Перейдите в папку с установленным плагином:
C:\Program Files\iiko\iikoRMS\ Front.Net \Plugins\Resto.Front.Api.CloudLoyaltyPlugin.
2. Откройте файл Resto.Front.Api.CloudLoyalty.dll с помощью текстового редактора (например, Notepad++, Visual Studio Code или Блокнот).

2 шаг: Изменение параметров
Найдите и измените следующие параметры:
- Адрес сервера: Установите значение  https://api.maxma.com/ .
- API-ключ: Вставьте ключ, предоставленный интегратором или специалистом технической поддержки.
- Код точки: Убедитесь, что код уникален и отличается от других точек продаж. Код можно найти в личном кабинете бренда: «Настройки» → «Точки продаж» → выбранная точка.
- Наименование точки: Укажите название.

3 шаг: Настройка скидок
Пролистайте файл до конца и найдите поле <discount>, которое отвечает за скидки. Убедитесь, что его значение равно MAXMA.

4 шаг: Сохранение изменений
После завершения всех изменений сохраните файл и закройте текстовый редактор.


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

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

2 шаг: Дополнительные настройки скидки
1. Снимите галочку с пункта «Можно назначить вручную» только для типа скидки «Бонусы (MXM)».
2. Убедитесь, что выбраны все точки продаж.
3. Остальные настройки выполните согласно скриншоту, затем нажмите «Далее».

3 шаг: Метод применения скидки
1. В открывшейся вкладке выберите следующие параметры:
- Метод применения: «К полной сумме заказа».
- Тип скидки: Выберите «Скидка» и «Процент».
- Установите значение процента на 100.
2. Нажмите «Далее».

4 шаг: Активация скидки
1. Установите флажок в чекбоксе «Активировать скидку».
2. Нажмите «ОК».

https://slite.com/api/files/pzsFjI8rTZNt7a/imported-image?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoieWJzTkJTMHdiam9NZ0YiLCJpYXQiOjE3NjEzNjU2ODgsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiSGxIeHJQUld5d3BDTnUiLCJleHAiOjE3NjM5NTc2ODh9.VM8RdILKuBGfr_5UOQGKUieyfNmAqKf-FpH9j5_NZYo

5 шаг: Дополнительные типы скидок
По аналогии с шагами 1—4 создайте еще два типа скидок, в которых будет отличаться только "Название" и "Название в пречеке":
- Название: MAXMA.
- Название в пречеке: MAXMA (этот тип предназначен для акций, созданных на нашей стороне).
- Тип скидки: «Скидка» и «Фиксированная сумма».
- Название: Промокод (MXM).
- Название в пречеке: Промокод (MXM).
- Тип скидки: «Скидка» и «Фиксированная сумма».

6 шаг: Настройка типов оплаты
1. В левой боковой панели выберите пункт «Розничные продажи», затем — «Типы оплат».
2. Нажмите «Добавить» и создайте два новых типа оплаты:
- I тип:
- Название: Бонусы (MXM).
- Тип: Внешний тип оплаты.
- Наименование в чеке: Бонусы (MXM).
- Безналичный тип: CloudLoyalty Бонусы.
- Активируйте чекбокс «Проводить как скидку».
- Выберите скидку «Бонусы (MXM)» из выпадающего списка.
- II тип:
- Название: Промокод (MXM).
- Тип: Внешний тип оплаты.
- Наименование в чеке: Промокод (MXM).
- Безналичный тип: CloudLoyalty Промокод.
- Активируйте чекбокс «Проводить как скидку».
- Выберите скидку «Промокод (MXM)» из выпадающего списка.


Дополнительные настройки плагина

Активация SMS-подтверждения для операций по списанию бонусов

1. Откройте файл Resto.Front.Api.CloudLoyalty.dll, находящийся по адресу:
C:\ProgramFiles\iiko\iikoRMS\ Front.Net \Plugins\Resto.Front.Api.CloudLoyaltyPlugin.
2. Найдите параметр <setting name="send_sms" serializeAs="String">.
3. Измените значение с False на True:

Было:
<setting name="send_sms" serializeAs="String">
<value>False</value>
Стало:
<setting name="send_sms" serializeAs="String">
<value>True</value>


Включение и отключение функции округления

1. Откройте файл Resto.Front.Api.CloudLoyalty.dll по адресу:
C:\Program Files\iiko\iikoRMS\ Front.Net \Plugins\Resto.Front.Api.CloudLoyaltyPlugin.
2. Найдите параметр <setting name="discountRoundStep" serializeAs="String">.
3. Для активации округления установите значение 1:

Было:
<setting name="discountRoundStep" serializeAs="String">
<value>0</value>
Стало:
<setting name="discountRoundStep" serializeAs="String">
<value>1</value>
Если необходимо отключить округление, установите значение 0.
Примечание:
- Значение 1 означает округление в пользу покупателя на один рубль.
- При значении 2 и больше округление будет происходить на указанную сумму.


Как определить версию IIKO

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


Логи плагина

Прежде чем собирать логи, нужно закрыть IIKO Front. После этого необходимо открыть следующую папку:
C:\Users\admin\AppData\Roaming\iiko\CashServer\Logs
Для проведения анализа потребуется сохранить следующие файлы:
1. pligin-Resto.Front.Api.CloudLoyalty.V..... .log
2. error.log
3. cash-server.log
4. api.log