IIKO v8.7



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

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

Архив с файлами плагина вам предоставит менеджер  maxma.com . Плагин устанавливается на каждую кассу (на каждый экземпляр iikoFront).

Распаковка архива

Для установки плагина распакуйте все файлы из архива в:
C:\Program Files\iiko\iikoRMS\ Front.Net \Plugins\Resto.Front.Api.CloudLoyaltyPlugin

https://slite.com/api/files/sDGKYkIfiNMzET/image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiQmFicW1jc0JyQThRRTciLCJpYXQiOjE3MzI0NTQzOTAsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiRFFKbWR2eWhVN2lyN1MiLCJleHAiOjE3MzUwNDYzOTB9.6IVAhxsybU9hrZnV4JihWU6cJ5N1DeE0IBD1AMjt3QE

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

Нужно войти в iikoOffice, в Дисконтная система -> Скидки и надбавки.

https://slite.com/api/files/fOV-r2KXiTZqiT/image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiQmFicW1jc0JyQThRRTciLCJpYXQiOjE3MzI0NTQzOTAsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiRFFKbWR2eWhVN2lyN1MiLCJleHAiOjE3MzUwNDYzOTB9.6IVAhxsybU9hrZnV4JihWU6cJ5N1DeE0IBD1AMjt3QE
Шаг 1. Там нажать кнопку "Добавить"

https://slite.com/api/files/GNRKeX4u36s4Q-/image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiQmFicW1jc0JyQThRRTciLCJpYXQiOjE3MzI0NTQzOTAsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiRFFKbWR2eWhVN2lyN1MiLCJleHAiOjE3MzUwNDYzOTB9.6IVAhxsybU9hrZnV4JihWU6cJ5N1DeE0IBD1AMjt3QE
Шаг 2. В "Название" и "Название в пречеке" написать Бонусы (MXM), Тип скидки указать: "Скидки и надбавки", нажать "Далее", галочку "Можно назначить вручную" отключаем у всех типов кроме MAXMA и Промокоды(MXM)

https://slite.com/api/files/goRw92owVYeviY/image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiQmFicW1jc0JyQThRRTciLCJpYXQiOjE3MzI0NTQzOTAsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiRFFKbWR2eWhVN2lyN1MiLCJleHAiOjE3MzUwNDYzOTB9.6IVAhxsybU9hrZnV4JihWU6cJ5N1DeE0IBD1AMjt3QE
Шаг 3. Проконтролировать, чтобы были отмечены все места продаж, а остальные поля - были заполнены аналогично скриншоту, нажать "Далее"

https://slite.com/api/files/R3VI12WAFh3omD/image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiQmFicW1jc0JyQThRRTciLCJpYXQiOjE3MzI0NTQzOTAsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiRFFKbWR2eWhVN2lyN1MiLCJleHAiOjE3MzUwNDYzOTB9.6IVAhxsybU9hrZnV4JihWU6cJ5N1DeE0IBD1AMjt3QE

Шаг 4. В этом окне необходимо указать: Метод применения - К полной сумме заказа; Тип - Скидка и Процент Процент - 100% Нажать "Далее"

https://slite.com/api/files/ZOfTuK8NnPZw5o/image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiQmFicW1jc0JyQThRRTciLCJpYXQiOjE3MzI0NTQzOTAsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiRFFKbWR2eWhVN2lyN1MiLCJleHAiOjE3MzUwNDYzOTB9.6IVAhxsybU9hrZnV4JihWU6cJ5N1DeE0IBD1AMjt3QE
Шаг 5. Активировать чек-бокс "Активировать скидку" и нажать "ОК"
По аналогии с шагами 1-5, завести ещё 2 скидки, в которых будет отличаться только "Название" и "Название в пречеке".
Для второго типа скидки следует указать (данный тип предназначен для акций заведенных на нашей стороне):
"Название": MAXMA
"Название в пречеке": MAXMA
Для третьего типа скидки следует указать:
"Название": Промокод (MXM)
"Название в пречеке": Промокод (MXM)

Шаг 6. Добавить 2 типа оплаты, как указано на скриншоте. Настройки следующие:

https://slite.com/api/files/OvaGWQrA6WcURB/image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiQmFicW1jc0JyQThRRTciLCJpYXQiOjE3MzI0NTQzOTAsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiRFFKbWR2eWhVN2lyN1MiLCJleHAiOjE3MzUwNDYzOTB9.6IVAhxsybU9hrZnV4JihWU6cJ5N1DeE0IBD1AMjt3QE
1 тип:
  • Наименование: Бонусы (MXM)
  • Тип: Внешний тип оплаты
  • Название в чеке: Бонусы (MXM)
  • Безналичный тип: CloudLoyalty Бонусы
  • ✔: Проводить как скидку
  • Скидка: Выбрать
  • Бонусы (MXM)

https://slite.com/api/files/kYHbVh_SeZkJk8/image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiQmFicW1jc0JyQThRRTciLCJpYXQiOjE3MzI0NTQzOTAsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiRFFKbWR2eWhVN2lyN1MiLCJleHAiOjE3MzUwNDYzOTB9.6IVAhxsybU9hrZnV4JihWU6cJ5N1DeE0IBD1AMjt3QE
2 тип:
  • Наименование: Промокод (MXM)
  • Тип: Внешний тип оплаты
  • Название в чеке: Промокод (MXM)
  • Безналичный тип: CloudLoyalty Промокод
  • ✔: Проводить как скидку
  • Скидка: Выбрать
  • Промокод (MXM)

https://slite.com/api/files/qxZpbp8Dmtf4h-/image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiQmFicW1jc0JyQThRRTciLCJpYXQiOjE3MzI0NTQzOTAsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiRFFKbWR2eWhVN2lyN1MiLCJleHAiOjE3MzUwNDYzOTB9.6IVAhxsybU9hrZnV4JihWU6cJ5N1DeE0IBD1AMjt3QE


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

Шаг 1. Переходим в папку плагина, Resto.Front.Api.CloudLoyaltyPlugin

https://slite.com/api/files/fx9kLemDlpdeCx/image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiQmFicW1jc0JyQThRRTciLCJpYXQiOjE3MzI0NTQzOTAsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiRFFKbWR2eWhVN2lyN1MiLCJleHAiOjE3MzUwNDYzOTB9.6IVAhxsybU9hrZnV4JihWU6cJ5N1DeE0IBD1AMjt3QE
Шаг 2. Открываем файл в любом текстовом редакторе Resto.Front.Api.CloudLoyalty.dll.config

https://slite.com/api/files/8tcF4n_uAiOrLg/image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiQmFicW1jc0JyQThRRTciLCJpYXQiOjE3MzI0NTQzOTAsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiRFFKbWR2eWhVN2lyN1MiLCJleHAiOjE3MzUwNDYzOTB9.6IVAhxsybU9hrZnV4JihWU6cJ5N1DeE0IBD1AMjt3QE
Шаг 3. Прописываем в следующие поля настройки модуля
  • Адрес сервера:  api.maxma.com 
  • API ключ выдает интегратор или техническая поддержка.
  • Код точки должны быть уникален и отличатся от других
  • Наименование точки

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

https://slite.com/api/files/vDSiGpCyaepHnJ/image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiQmFicW1jc0JyQThRRTciLCJpYXQiOjE3MzI0NTQzOTAsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiRFFKbWR2eWhVN2lyN1MiLCJleHAiOjE3MzUwNDYzOTB9.6IVAhxsybU9hrZnV4JihWU6cJ5N1DeE0IBD1AMjt3QE
Шаг 4. Закрываем и сохраняем файл конфига в корневой папке плагина.



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

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

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

https://slite.com/api/files/8tcF4n_uAiOrLg/image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiQmFicW1jc0JyQThRRTciLCJpYXQiOjE3MzI0NTQzOTAsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiRFFKbWR2eWhVN2lyN1MiLCJleHAiOjE3MzUwNDYzOTB9.6IVAhxsybU9hrZnV4JihWU6cJ5N1DeE0IBD1AMjt3QE
Шаг 3. После чего ищем "send_sms" и меняем следующую настройку с False на True.
Было:
<setting name="send_sms" serializeAs="String">
<value>False</value>
Стало:
<setting name="send_sms" serializeAs="String">
<value>True</value>

https://slite.com/api/files/pK5Qbw9hXKvsa0/image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiQmFicW1jc0JyQThRRTciLCJpYXQiOjE3MzI0NTQzOTAsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiRFFKbWR2eWhVN2lyN1MiLCJleHAiOjE3MzUwNDYzOTB9.6IVAhxsybU9hrZnV4JihWU6cJ5N1DeE0IBD1AMjt3QE

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




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


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

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

https://slite.com/api/files/8tcF4n_uAiOrLg/image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiQmFicW1jc0JyQThRRTciLCJpYXQiOjE3MzI0NTQzOTAsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiRFFKbWR2eWhVN2lyN1MiLCJleHAiOjE3MzUwNDYzOTB9.6IVAhxsybU9hrZnV4JihWU6cJ5N1DeE0IBD1AMjt3QE

Шаг 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 или более то сооствественно сумма установленного округления будет так же работать.

https://slite.com/api/files/N0lZ1gsqFR-fiu/image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiQmFicW1jc0JyQThRRTciLCJpYXQiOjE3MzI0NTQzOTAsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiRFFKbWR2eWhVN2lyN1MiLCJleHAiOjE3MzUwNDYzOTB9.6IVAhxsybU9hrZnV4JihWU6cJ5N1DeE0IBD1AMjt3QE

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


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


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


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

В правом верхнем углу указана версия вашего ПО.

https://slite.com/api/files/5x5XFOojnWUiLJ/image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiQmFicW1jc0JyQThRRTciLCJpYXQiOjE3MzI0NTQzOTAsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiRFFKbWR2eWhVN2lyN1MiLCJleHAiOjE3MzUwNDYzOTB9.6IVAhxsybU9hrZnV4JihWU6cJ5N1DeE0IBD1AMjt3QE


https://slite.com/api/files/2iszBSK2YtuKiv/image.png?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiQmFicW1jc0JyQThRRTciLCJpYXQiOjE3MzI0NTQzOTAsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiRFFKbWR2eWhVN2lyN1MiLCJleHAiOjE3MzUwNDYzOTB9.6IVAhxsybU9hrZnV4JihWU6cJ5N1DeE0IBD1AMjt3QE


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

C:\Users\e.bulychev\AppData\Roaming\iiko\CashServer\Logs