Диагностика — r_keeper 7¶

С чего начинать¶

Журнал агента:

cd C:\broni-sidecar
Get-Content .\logs\sidecar.log -Tail 100

Только ошибки:

Select-String -Path .\logs\sidecar.log -Pattern '"level":"(error|warn)"' | Select-Object -Last 40

Состояние службы:

Get-Service broni-rk7-sidecar

Версия агента:

.\sidecar.exe version

Не подключается к r_keeper¶

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

.\sidecar.exe probe --rk7-host 127.0.0.1 --rk7-port 15151 --rk7-login ЛОГИН --rk7-password ПАРОЛЬ

Соединение не устанавливается¶

XML-интерфейс midserv выключен. Самая частая причина. Включается в настройках r_keeper, требует перезапуска midserv.
Другой порт. По умолчанию 15151, но в конкретной установке может отличаться — уточните у ИТ-специалиста ресторана.
Локальный межсетевой экран. Проверьте доступность порта:
```
Test-NetConnection -ComputerName 127.0.0.1 -Port 15151
```
Агент не на том сервере. Он должен стоять на кассовом сервере r_keeper.

Неверный логин или пароль¶

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

.\sidecar.exe stop; .\sidecar.exe set-rk7-creds; .\sidecar.exe start

Ошибка сертификата после ранее успешной работы¶

Агент запоминает отпечаток TLS-сертификата кассового сервера при привязке и дальше принимает только его. Это защита от подмены. Если сертификат заменили законно:

.\sidecar.exe stop
.\sidecar.exe set-rk7-creds --repin
.\sidecar.exe start

В журнале — ошибка `5239`¶

r_keeper сообщает об отсутствии лицензии «XML: Save Order». Для интеграции Брони она не нужна: сценарий бронирования работает на базовой лицензии. Если ошибка появляется при обычной работе — передайте журнал в поддержку.

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

Проверьте доступ наружу¶

Test-NetConnection -ComputerName broni.io -Port 443

Закрыт — вопрос к ИТ-специалисту ресторана: нужен исходящий HTTPS с кассового сервера. Часто мешает корпоративный прокси или фильтрация трафика антивирусом.

Привязка не проходит¶

Код привязки уже использован или просрочен. Коды одноразовые. Запросите новый в личном кабинете партнёра.
Опечатка в коде. Формат XXXX-XXXX, вводится целиком.
Неверный адрес сервера. Проверьте backend.baseUrl в sidecar.yaml.

Площадка не появляется в личном кабинете¶

Убедитесь, что служба запущена: Get-Service broni-rk7-sidecar.
Проверьте в журнале успешные check-in.
Убедитесь, что привязка завершилась — рядом с sidecar.exe должны быть sidecar.yaml и secrets.bin.

Служба не запускается¶

`install` завершается ошибкой¶

PowerShell должен быть запущен от имени администратора — регистрация службы Windows требует прав.

Служба стартует и сразу останавливается¶

Смотрите logs\sidecar.log. Типичная причина — агент не может прочитать sidecar.yaml, то есть привязка не выполнена:

cannot read sidecar.yaml — run `sidecar.exe enroll` first

Выполните шаг 5 установки.

После переноса папки на другой сервер ничего не работает¶

secrets.bin расшифровывается только на исходной машине. Нужна новая привязка с новым кодом — скопировать установку нельзя.

Заказы и брони¶

Бронь создана, а заказ в r_keeper не появился¶

Стол не сопоставлен. Проверьте сопоставление столов в личном кабинете партнёра: столу в Брони должен соответствовать стол r_keeper.
Список столов устарел. Дождитесь очередной синхронизации или запустите её из личного кабинета.
Неверные служебные коды. Если в журнале ошибки при создании заказа, проверьте rk7Defaults — см. Параметры настройки.

Закрытые счета не доходят до Брони¶

Очередь отправки — data\spool\pending. Пока нет связи, файлы копятся и уходят после восстановления. Удалять их нельзя: это данные для расчёта комиссии.

Записи в data\spool\dead — то, что сервер отклонил. Передайте их в поддержку.

Расхождение по времени¶

probe печатает расхождение часов кассового сервера с агентом. Заметное расхождение приводит к неверному определению интервалов броней — настройте синхронизацию времени на сервере.

Что приложить к обращению в поддержку¶

Вывод команды:

.\sidecar.exe probe --rk7-host 127.0.0.1 --rk7-login ЛОГИН --rk7-password ПАРОЛЬ

(пароль в выводе не печатается)

Файл logs\sidecar.log.
Версию агента (.\sidecar.exe version) и версию r_keeper.
Номер брони и время, когда ожидалось действие.
Содержимое data\spool\dead\, если оно не пустое.

Ошибки мы видим и без обращения

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

Обратиться в поддержку