Подключение и поддержка¶

Порядок подключения ресторана¶

Договор и заведение площадки. Менеджер Брони заводит ресторан и выдаёт доступ в личный кабинет партнёра.
Сопоставление столов. В личном кабинете столы Брони связываются со столами POS-системы. Без этого шага брони не смогут попасть в r_keeper, а скидки — в iiko.
Выдача учётных данных интеграции. В разделе Интеграции появляется токен площадки (iiko) или код привязки (r_keeper).
Установка на кассовом сервере. По инструкции: iiko или r_keeper 7.
Проверка сквозного сценария. Тестовая бронь → посадка → счёт → закрытие.
Запуск в работу.

Шаги 1–3 выполняет менеджер Брони, шаги 4–5 — технический специалист ресторана или его подрядчик по POS.

Параллельно с этим ресторан заполняет карточку заведения и задаёт расписание скидок: без открытых слотов бронировать нечего, даже когда интеграция уже работает. Как это устроено — в разделе «Как работает Брони», настройка расписания — на странице «Слоты и скидки».

Где взять учётные данные¶

Что нужно	Для чего	Где в личном кабинете
Токен площадки (`posToken`)	плагин iiko: вписывается в `%APPDATA%\Broni.Front.Plugin\venue.config`	Интеграции → iiko
Код привязки `XXXX-XXXX`	агент r_keeper 7: вводится командой `enroll`	Интеграции → r_keeper

Адрес сервера Брони получать и вводить не нужно: и плагин, и агент знают его из своей сборки.

Обращайтесь с ними как с паролями

Токен площадки и код привязки дают доступ к данным броней ресторана. Не пересылайте их в мессенджерах и не храните в общедоступных файлах.

Если данные скомпрометированы — перевыпустите их в личном кабинете. Старое значение перестаёт работать немедленно; после этого потребуется прописать новый токен (iiko) или выполнить повторную привязку (r_keeper).

Обращение в поддержку¶

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

Диагностика iiko Диагностика r_keeper

Куда писать¶

Канал	Адрес
Почта поддержки	partners@broni.io
Ваш менеджер	контакт выдаётся при подключении

Что приложить¶

Обращение без этих данных разбирается заметно дольше:

название ресторана и POS-система;
версия плагина или агента;
журнал — plugin-Broni.Front.Plugin.log для iiko, logs\sidecar.log для r_keeper;
номер брони и точное время, когда ожидалось действие;
что именно ожидалось и что произошло вместо этого.

Сроки реакции¶

Тип обращения	Реакция
Интеграция не работает, брони или скидки не проходят	в течение рабочего дня
Частичный сбой, есть обходной путь	1–2 рабочих дня
Вопрос, консультация, пожелание	до 3 рабочих дней

Часы работы поддержки: по рабочим дням.

Часть проблем мы видим раньше вас

Плагин и агент автоматически сообщают нам о своих внутренних ошибках — с версией, настройками и идентификатором площадки. Данные гостей и содержимое счетов при этом не передаются. Это ускоряет разбор, но не заменяет обращение: без него мы не знаем, какую именно бронь смотреть.

Обновления¶

	iiko	r_keeper 7
Как обновляется	вручную, заменой файлов	вручную, заменой `sidecar.exe`
Автообновление	нет	нет
Как узнать о новой версии	эта страница и уведомление менеджера	агент сам пишет предупреждение в журнал
Настройки при обновлении	сохраняются: они лежат вне папки плагина	сохраняются

Обновление всегда запускает человек: ни один компонент не меняет себя сам на кассовом сервере ресторана.

Инструкции: обновление плагина iiko · обновление агента r_keeper

Что передаётся в Брони¶

Прозрачность здесь важна, поэтому короткий список.

Передаётся:

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

Не передаётся:

заказы, не связанные с бронями Брони;
персональные данные гостей из POS-системы;
учётные данные POS-системы — пароль r_keeper шифруется средствами Windows и не покидает кассовый сервер.

Частые вопросы¶

Нужен ли ресторану белый IP или проброс портов?

Нет. Оба компонента устанавливают соединения только исходящие, по HTTPS. Достаточно доступа к https://broni.io с кассового сервера.

Что будет, если на площадке пропадёт интернет?

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

r_keeper: новые брони не приедут до восстановления связи, но закрытые счета сохранятся в очереди и не потеряются.

Нужно ли ставить что-то на кассовые станции r_keeper?

Нет. Агент ставится один раз на кассовый сервер.

Нужно ли ставить плагин iiko на каждую кассу?

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

Можно ли перенести установку на другой сервер копированием папки?

r_keeper: нет. Ключи привязаны к машине, потребуется новый код привязки.

iiko: папку плагина скопировать можно — своих значений в ней нет. Настройки площадки лежат отдельно, в %APPDATA%\Broni.Front.Plugin\venue.config той учётной записи, под которой работает iikoFront, поэтому на новом рабочем месте этот файл нужно создать заново (см. шаг 5 установки).

Влияет ли интеграция на скорость работы кассы?

Нет. Обращения к сети происходят в фоне, а скидка в iiko рассчитывается из локального хранилища, без сетевых запросов в момент расчёта счёта.