Перейти к содержанию

Установка плагина для iiko

Установка выполняется на каждом рабочем месте iikoFront, где рассчитываются счета. Всё делается один раз; дальнейшие настройки приходят с сервера Брони.

Порядок важен

Сначала шаг 1 (тип скидки в iikoOffice) — без него плагин не сможет применить скидку и будет писать ошибку в журнал.

Шаг 1. Создайте тип скидки в iikoOffice

В iikoOffice → Розничные продажи → Скидки и надбавки создайте скидку:

Поле Значение
Название Скидка Брони
Тип Скидка
Способ расчёта Гибкая сумма (сумма задаётся при применении)
Применяется На весь заказ

Название должно совпадать с параметром discountTypeName в настройках плагина (значение по умолчанию — Скидка Брони). Если в вашей номенклатуре скидка названа иначе, поправьте параметр, а не название в iikoOffice.

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

Шаг 2. Получите данные площадки

В личном кабинете партнёра Брони, раздел Интеграции → iiko, скопируйте:

  • Адрес сервера (backendBaseUrl) — как правило https://broni.io
  • Токен площадки (posToken) — длинная строка, уникальная для ресторана

Токен площадки — это пароль

Он даёт доступ к данным броней ресторана. Не пересылайте его в мессенджерах и не сохраняйте в общедоступных файлах. При компрометации перевыпустите токен в личном кабинете — старый сразу перестанет работать.

Шаг 3. Скачайте дистрибутив

Скачать плагин 0.1.0 (824.2 КБ)

Файл: broni-iiko-plugin-0.1.0.zip · Версия: 0.1.0 · Опубликован: 2026-07-27
SHA-256: 2d32f3a98a3ae8bcba4f6fb3659f92965823482cb6dd48dc86cff6b00934c6dc

Проверьте контрольную сумму — она должна совпасть со значением выше:

Get-FileHash -Algorithm SHA256 "$env:USERPROFILE\Downloads\broni-iiko-plugin-0.1.0.zip"

Ссылка всегда ведёт на текущую версию

Страница показывает версию, размер и контрольную сумму из манифеста, который публикует наша сборочная система. Расхождения между документацией и файлом быть не может.

Шаг 4. Распакуйте плагин

  1. Закройте iikoFront на этом рабочем месте — работающий процесс держит файлы плагина открытыми.

  2. Распакуйте архив в каталог плагинов iikoFront:

    C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\

  3. Убедитесь, что получилась структура:

    …\Front.Net\Plugins\Broni.Front.Plugin\
    Broni.Front.Plugin.dll
    Broni.Front.Plugin.dll.config
    Manifest.xml
    Newtonsoft.Json.dll
    System.Reactive.dll
    System.Runtime.CompilerServices.Unsafe.dll
    System.Threading.Tasks.Extensions.dll
    System.ValueTuple.dll

Вложенной папки быть не должно

Частая ошибка — путь вида …\Plugins\Broni.Front.Plugin\Broni.Front.Plugin\. iikoFront такой плагин не найдёт. Файл Manifest.xml должен лежать ровно на один уровень ниже Plugins.

Каталог находится в C:\Program Files\, поэтому распаковка потребует подтверждения прав администратора.

Шаг 5. Пропишите настройки площадки

Откройте Broni.Front.Plugin.dll.config (в Блокноте от имени администратора) и заполните два параметра из шага 2:

<add key="backendBaseUrl" value="https://broni.io" />
<add key="posToken" value="ВСТАВЬТЕ_ТОКЕН_ПЛОЩАДКИ" />

Остальные параметры менять при первой установке не нужно — значения по умолчанию рассчитаны на обычный ресторан. Полный справочник: Параметры настройки.

Убедитесь, что параметр проверочного режима пока включён (так поставляется дистрибутив):

<add key="dryRun" value="true" />

Шаг 6. Проверочный запуск

Запустите iikoFront. В режиме dryRun=true плагин делает всё, кроме собственно применения скидки, — это безопасный способ убедиться, что он загрузился и видит брони.

Откройте журнал:

%APPDATA%\iiko\CashServer\Logs\plugin-Broni.Front.Plugin.log

Признаки нормального старта:

  • запись о подключении плагина к хосту front.api;
  • сообщение об успешной синхронизации зеркала броней (mirror);
  • отсутствие строк уровня ERROR.

Теперь проверьте на реальной брони: посадите гостя за забронированный через Брони стол, откройте заказ и перейдите к расчёту. В журнале должна появиться строка вида:

[dryRun] would apply discount …

Она означает: бронь найдена, сумма скидки рассчитана, применение пропущено из-за проверочного режима.

Строки нет?

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

Шаг 7. Включите боевой режим

Убедившись, что скидка рассчитывается верно:

  1. Закройте iikoFront.

  2. В Broni.Front.Plugin.dll.config поставьте:

    <add key="dryRun" value="false" />

  3. Запустите iikoFront.

С этого момента скидка применяется к счёту автоматически.

Изменение настроек требует перезапуска

Плагин читает .dll.config только при запуске. Любая правка вступает в силу после перезапуска iikoFront.

Проверка установки

Пройдите полный сценарий на тестовой брони:

  1. Создайте бронь в Брони на стол этого ресторана.
  2. Посадите гостя, откройте заказ на этом столе в iikoFront.
  3. Добавьте позиции и перейдите к расчёту → в счёте должна появиться «Скидка Брони» с рассчитанной суммой.
  4. Закройте счёт оплатой.
  5. Через несколько минут проверьте в личном кабинете партнёра, что визит отобразился как состоявшийся.

Если все пять пунктов прошли — установка завершена.

Обновление

Обновление ставится поверх предыдущей версии:

  1. Закройте iikoFront.
  2. Сохраните текущий Broni.Front.Plugin.dll.config — в нём ваш posToken.
  3. Удалите папку Broni.Front.Plugin и распакуйте новый архив.
  4. Верните сохранённый .dll.config на место.
  5. Запустите iikoFront.

Зеркало броней и очередь счетов лежат в %APPDATA% и при обновлении не теряются.

Временное отключение

Добавьте точку в начало имени папки:

…\Plugins\.Broni.Front.Plugin\

iikoFront пропускает такие каталоги. Перезапустите iikoFront — плагин не загрузится. Чтобы вернуть, уберите точку и снова перезапустите.

Удаление

Закройте iikoFront, удалите папку …\Plugins\Broni.Front.Plugin\ и, при необходимости, %APPDATA%\Broni.Front.Plugin\. Тип скидки в iikoOffice можно оставить — сам по себе он ни на что не влияет.