Плагин Брони для iiko — обзор¶
Что делает плагин¶
Плагин устанавливается в iikoFront на кассе и решает одну задачу: когда официант открывает или рассчитывает заказ на столе, забронированном через Брони, плагин сам находит бронь и применяет к счёту согласованную скидку.
Кассиру не нужно ничего искать, вводить коды или выбирать скидку вручную.
Дополнительно плагин отправляет в Брони закрытый оплаченный счёт по таким заказам — на его основе считается комиссия. Облачный API iiko такие заказы не отдаёт, поэтому плагин — единственный источник этих данных.
Почему именно плагин на кассе¶
Скидку в открытый счёт может внести только код, работающий внутри iikoFront: облачный (Transport) API iiko этого не умеет. Поэтому интеграция Брони с iiko устроена так же, как у других сервисов бронирования, — локальным плагином.
Работа без интернета¶
По умолчанию плагин работает в режиме офлайн-зеркала (resolverMode=mirror):
условия по будущим броням он заранее скачивает и хранит на кассе. В момент расчёта
счёта обращение к сети не требуется — скидка применится, даже если интернет
на площадке пропал.
Зеркало обновляется раз в минуту и полностью пересобирается раз в 6 часов.
Требования¶
| Требование | Значение |
|---|---|
| POS | iikoFront (iikoRMS), рабочее место кассы |
| Проверенная версия | 9.5.7018.0 |
| Интерфейс front.api | V9 |
| ОС | Windows с .NET Framework 4.7.2 (входит в состав Windows 10/11 и Windows Server 2016+) |
| Права для установки | Локальный администратор (запись в C:\Program Files\...) |
| Сеть | Исходящий HTTPS (443) к broni.io. Входящие правила не нужны |
| Настройка в iikoOffice | Тип скидки «Скидка Брони» с типом расчёта «гибкая сумма» |
| Данные площадки | backendBaseUrl и posToken из личного кабинета партнёра |
Лицензионный модуль front.api
Плагин объявляет в Manifest.xml идентификатор лицензионного модуля API
(LicenseModuleId). Значение в дистрибутиве рассчитано на тестовые стенды.
Для рабочей площадки идентификатор, назначенный компанией iiko, выдаёт
менеджер Брони — уточните его до установки.
Что попадёт на кассовый сервер¶
Дистрибутив разворачивается в одну папку внутри каталога плагинов iikoFront и ничего больше в системе не меняет: службы не устанавливаются, реестр не правится.
| Расположение | Что это |
|---|---|
…\Front.Net\Plugins\Broni.Front.Plugin\ |
сам плагин (8 файлов) и его настройки |
%APPDATA%\Broni.Front.Plugin\reservations\ |
офлайн-зеркало броней |
%APPDATA%\Broni.Front.Plugin\checks\ |
очередь неотправленных счетов |
%APPDATA%\iiko\CashServer\Logs\plugin-Broni.Front.Plugin.log |
журнал работы плагина |