Настройка интеграции

Установка и настройка плагина iiko

Для работы плагина необходимо добавить Mace Loyalty в качестве типа оплаты. Для этого зайдите в “Типы оплаты” и нажмите кнопку Добавить. Тип оплаты настраивается согласно учётной политике организации. Название безналичного типа - “Api Payment”.Внешний тип “**** Api Payment” появится только после успешного запуска плагина

paymentSystemKey = "MaceLoyalty";
paymentSystemName = "MaceLoyalty Api Payment";

1. Расположите плагин в каталоге C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\Resto.Front.Api.MaceLoyalty.
2. Добавьте пользователю права на запись в этот каталог.
3. Настройки плагина хранятся в каталоге плагина в каталоге C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\Resto.Front.Api.MaceLoyalty

MaceLoyalty.json - создаётся автоматически с настройками по умолчанию:

• companyId - идентификатор компании в MaceLoyalty

• apiSecret - ключ API MaceLoyalty

Пропишите настройки companyId и apiSecret полученные от менеджера Mace Loyalty

В Resto.Front.Api.MaceLoyalty.dll.config убедитесь, что установлено:

DebugMode = "False"

Файл логов располагается по адресу: %appdata%\Roaming\iiko\CashServer\Logs\plugin-Resto.Front.Api.MaceLoyalty.log

После установки и настройки плагина запустите iikoFront и убедитесь, что он полностью запустился, посмотрев лог. При успешном запуске лог должен выглядеть так:

[2021-11-23 13:51:51,974]  INFO [ 1] - ================================================================================
[2021-11-23 13:51:51,980]  INFO [ 1] - Resto.Front.Api.Host ver. 7.5.6019.0[2021-11-23 13:51:51,980]  INFO [ 1]
================================================================================
[2021-11-23 13:51:51,980]  INFO [ 1] - Host process Resto.Front.Api.MaceLoyalty (25680) for “Resto.Front.Api.MaceLoyalty.MaceLoyaltyPlugin” class from “C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\Resto.Front.Api.MaceLoyalty\Resto.Front.Api.MaceLoyalty.dll” assembly is running in background mode.
[2021-11-23 13:51:51,982]  INFO [ 1] - Plugin assembly info: AITK.RU Resto.Front.Api.MaceLoyalty v1.1.1.0,  (Resto.Front.Api.MaceLoyalty.dll v1.1.1.0, Resto.Front.Api.MaceLoyalty)
[2021-11-23 13:51:51,990]  INFO [ 1] - Created plugin domain “Resto.Front.Api.MaceLoyalty” using “C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\Resto.Front.Api.MaceLoyalty\Resto.Front.Api.MaceLoyalty.dll.config”
[2021-11-23 13:51:51,997]  INFO [ 1] - Registering ipc channel...
[2021-11-23 13:51:52,266]  INFO [ 1] - Plugin context initialized, creating plugin instance...
[2021-11-23 13:51:52,280]  INFO [ 1] - Начало инициализации плагина ....
[2021-11-23 13:51:53,270]  INFO [ 1] - Конец инициализации плагина
[2021-11-23 13:51:53,289]  INFO [ 1] - Настройки округления - 0.5
[2021-11-23 13:51:53,289]  INFO [ 1] - GetPaymentTypes:
[2021-11-23 13:51:53,299]  INFO [ 1] - ====>64b832d6-9432-481f-8eba-e7f8af9f03db - Mace Loyalty
[2021-11-23 13:51:53,299]  INFO [ 1] - GetDiscountTypes:
[2021-11-23 13:51:53,301]  INFO [ 1] - ====>30ee9e91-36d4-a868-e087-15892defe17c - Mace Loyalty
[2021-11-23 13:51:53,302]  INFO [ 1] - Instance of “Resto.Front.Api.MaceLoyalty.MaceLoyaltyPlugin” created
[2021-11-23 13:51:53,303]  INFO [ 1] - Initialized as V6 plugin.

Настройки в iikoOffice

Добавление типа оплаты
Перейдите в раздел "Розничные продажи" → "Типы оплаты" → нажмите "Добавить". Создайте новый тип с названием "MaceLoyalty".

Варианты настройки

• Как отдельный тип оплаты (стандартный вариант)

• Как скидку (установите флажок "Проводить как скидку")

Рекомендации по выбору

Для корректной фискализации (ФЗ-54) рекомендуется использовать вариант учета как скидки. В этом случае сумма бонусов уменьшит итоговую сумму в чеке.

Настройте скидку, как показано на примере выше.

Обновление плагина

1. Закройте iikoFront.
2. Сделать резервную копию всего каталога - “C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\Resto.Front.Api.MaceLoyalty”.
3. Обновить все файлы в каталог - “C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\Resto.Front.Api.MaceLoyalty”.
4. Запустить iikoFront и проверить, что обновление работает