# Iiko

# Состав установочного пакета

### **Структура каталогов библиотеки**

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

<div id="bkmrk-"><div><svg class="svg-icon" data-icon="link" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg></div></div>

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

Для установки плагина, его нужно поместить в каталог плагинов кассы iikoFront.

Подробное описание установки от вендора кассы [расположено тут](https://ru.iiko.help/articles/#!iikofront-8-0/topic-40).

Создайте каталог Rarus.Lms.Plugin в каталоге установки iikoFront (по умолчанию: *C:\\Program Files\\iiko\\iikoRMS\\Front.Net\\Plugins\\)* и поместите туда все файлы плагина, после чего перезапустите кассу.

Если плагин успешно стартовал, на экране начального меню появится кнопка "Дополнения" -&gt; "Система управления лояльностью". При нажатии, откроется диалог настроек.

[![плагин.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/scaled-1680-/plagin.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/plagin.png)

# Настройка кассового ПО

Настройка кассового ПО выполняется в интерфейсе кассы.

Чтобы настроить скидки и оплаты сервиса, необходимо в iikoOffice создать 2 скидки:

**1. Скидка системы лояльности** - скидка, с которой будут связаны суммы скидки СУЛ;

**2. Оплата баллами -** скидка связанная с оплатой баллами.

Скидки должны иметь следующие настройки:

- Можно назначать вручную
- Выбор блюд на усмотрение официанта
- Места продаж где применяется скидка - Все места продаж

[![image.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/scaled-1680-/oJtimage.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/oJtimage.png)

Режим обслуживания в котором применяется скидка

- Обычный заказ
- Можно использовать с другими скидками

[![image.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/scaled-1680-/Njmimage.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/Njmimage.png)

Размер и тип скидки - **фиксированная сумма с возможностью назначения**

[![image.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/scaled-1680-/I6wimage.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/I6wimage.png)

<p class="callout warning">Обе скидки должны применяться во всех местах применения, где планируется использование плагина.   
Обе скидки должны предоставлять возможность назначения суммы скидки.  
В противном случае плагин не сможет изменять объем скидок. </p>

После этого в окне настроек плагина необходимо выбрать соответствующие скидки, при выпадении списка они будут отфильтрованы в соответствии с ожидаемыми настройками.

[![11.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/scaled-1680-/3uN11.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/3uN11.png)

<span style="mso-bidi-font-family: Aptos; mso-bidi-theme-font: minor-latin;"><span style="mso-list: Ignore;">1.<span style="font: 7.0pt 'Times New Roman';"> </span></span></span>В окне необходимо указать идентификатор клиента и токен регистрации интеграции, полученный при регистрации в сервисе.

Обязательно указать идентификатор магазина, с которым связана касса. Идентификатор магазина, можно получить в личном кабинете (если магазина нет - его нужно создать).

[![image-1781603912894.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/scaled-1680-/image-1781603912894.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/image-1781603912894.png)

# Сценарии работы

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

[![2_Окно плагина с функционалом.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/scaled-1680-/2-okno-plagina-s-funkcionalom.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/2-okno-plagina-s-funkcionalom.png)

### Подбор карты клиента

При выборе команды "Клиент", плагин позволяет подобрать клиента в заказ по номеру телефона или штрихкоду карты.

[![4_Клиент поиск по номеру телефона.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/scaled-1680-/4-klient-poisk-po-nomeru-telefona.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/4-klient-poisk-po-nomeru-telefona.png)

[![3_Клиент поиск по ШК.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/scaled-1680-/3-klient-poisk-po-sk.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/3-klient-poisk-po-sk.png)

В случае, если настроена двухфакторная аутентификация, потребуется подтверждение, путем ввода 6-значного кода подтверждения, отправленного на указанный в настройках канал.

[![5_Окно ввода кода подтверждения при поиске клиента.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/scaled-1680-/5-okno-vvoda-koda-podtverzdeniia-pri-poiske-klienta.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/5-okno-vvoda-koda-podtverzdeniia-pri-poiske-klienta.png)

После подбора, найденный клиент связывается с первым гостем в заказе. Доступно использование только одного клиента системы лояльности на заказ.

[![6_Экран заказа после поиска клиента.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/scaled-1680-/6-ekran-zakaza-posle-poiska-klienta.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/6-ekran-zakaza-posle-poiska-klienta.png)

Чтобы отменить подобранную карту, требуется нажать на кнопку плагина и выбрать "Отменить клиента".

[![image.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/scaled-1680-/t03image.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/t03image.png)

Появится окно подтверждения

[![7_Отмена клиента.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/scaled-1680-/7-otmena-klienta.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/7-otmena-klienta.png)

### Ввод промокода

Для применения промокода, необходимо нажать на кнопку плагина и выбрать команду "Промокод"

[![изображение (3).png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-09/scaled-1680-/izobrazenie-3.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-09/izobrazenie-3.png)

[![13_Окно ввода промокода.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/scaled-1680-/13-okno-vvoda-promokoda.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/13-okno-vvoda-promokoda.png)

Промокод будет передаваться в систему лояльности, при расчете скидок.

### Расчет скидок

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

[![9_Кнопка рассчитать рассчитывает скидку.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/scaled-1680-/9-knopka-rasscitat-rasscityvaet-skidku.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/9-knopka-rasscitat-rasscityvaet-skidku.png)

<p class="callout warning">Важно понимать, что скидка будет агрегированной, но при отправке документа в сервис, детализация сохраняется.</p>

Автоматический расчет скидок при изменении заказа не производится, так как заказ может часто меняеться официантом и сотрудником кухни.

При переходе на экран оплаты заказа, выполняется перерасчет скидок, для финализации значений в заказе.

### Оплата бонусами

Для оплаты баллами, требуется нажать на кнопку плагина

[![1Открытие плагина.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-09/scaled-1680-/1otkrytie-plagina.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-09/1otkrytie-plagina.png)

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

[![2Функционал-выбор потратить баллы.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-09/scaled-1680-/2funkcional-vybor-potratit-bally.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-09/2funkcional-vybor-potratit-bally.png)

[![3Оплата — копия.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-09/scaled-1680-/3oplata-kopiia.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-09/3oplata-kopiia.png)

В случае, если настроена подтверждение при списании баллов, потребуется ввод 6-значного кода подтверждения, отправленного на указанный в настройках канал.

[![10__-~1.PNG](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/scaled-1680-/10-1.PNG)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/10-1.PNG)

После применения баллов в оплату, информация отобразится в нижней части экрана

[![4Экран заказа после применения баллов — копия — копия.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-09/scaled-1680-/4ekran-zakaza-posle-primeneniia-ballov-kopiia-kopiia.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-09/4ekran-zakaza-posle-primeneniia-ballov-kopiia-kopiia.png)

Скидка будет рассчитана автоматически

[![5 Просмотр скидки послеприменения баллов.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-09/scaled-1680-/5-prosmotr-skidki-posleprimeneniia-ballov.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-09/5-prosmotr-skidki-posleprimeneniia-ballov.png)

Кликнув на значение скидки, можно увидеть список скидок, примененных в продаже

[![6Просмотр примененных скидок — копия.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-09/scaled-1680-/6prosmotr-primenennyx-skidok-kopiia.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-09/6prosmotr-primenennyx-skidok-kopiia.png)

### Оплата заказа

Для перехода к оплате требуется кликнуть на значок "касса"

[![7Переход к оплате.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-09/scaled-1680-/7perexod-k-oplate.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-09/7perexod-k-oplate.png)

Откроется окно ввода оплаты. Необходимо ввести сумму и нажать "Оплатить".

[![8Экран оплаты.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-09/scaled-1680-/8ekran-oplaty.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-09/8ekran-oplaty.png)

Так же, функционал плагина доступен в режиме "Быстрый чек" и "Банкет"

[![image.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/scaled-1680-/sNrimage.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/sNrimage.png)

[![image.png](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/scaled-1680-/c8Uimage.png)](https://wiki.pro.bonus-rarus.ru/uploads/images/gallery/2026-08/c8Uimage.png)

# Интеграция с Iiko

### Релиз 2.0.26

[Первая интеграция с плагином](https://rzn-wb-02.1c-hosting.com/attachments/380)