Мы ответим на частые вопросы, которые могут помочь в настройке интеграции и при возникновении неполадки на кассе.
RestID
Это идентификатор ресторана в R-Keeper используется для уникальной идентификации каждого заведения в рамках одной базы данных или сети ресторанов.
Чтобы найти RestID, нужно обратиться к настройкам конкретного ресторана в интерфейсе R-Keeper:
1. Войдите в систему под учетной записью администратора или пользователя с соответствующими правами доступа.
2. Перейдите в настройки ресторана. Обычно этот раздел называется «Настройки» или «Администрирование».
3. Найдите параметр, связанный с идентификацией ресторана. В зависимости от версии R-Keeper он может называться по-разному, но чаще всего это просто RestID или ID ресторана. Это значение будет уникальным для каждого ресторана в системе.
ApiKey
Это идентификатор, который используется для аутентификации и авторизации при доступе к API (Application Programming Interface).
Он позволяет сторонним приложениям взаимодействовать с системой R-Keeper через программный интерфейс, обеспечивая безопасную передачу данных между различными системами.
А для взаимодействия кассы R-Keeper с Samosale использует токен пользователя из раздела "Настройки - Пользователи - Пользователя".
В системе R-Keeper ApiKey, а в Samosale токен.

Значения для максимального и минимального процента
Значение максимального процента нужно указать в "Платежные карты - Бонусы" во вкладке "Свойства - Ограничения" в поле "Макс.проц".
При этом минимальная сумма всегда равна 0.

Максимальный процент необходимо брать из Samosale раздела "Настройки - Лояльность - Настройки" поля "Можно оплатить бонусами до".

Значение для фискальности в R-Keeper
В поле "Тип фискальности" указывается "Фискальная скидка".
А также можно указать любое другое значение - интеграция работает со всеми типами.
Что делать, если не удается закрыть стол из-за нулевой позиции в чеке
Такая проблема зачастую происходит, когда добавлено 2 фискальных регистратора и только в чеках без авторизации гостя (без бонусов).
На данный момент доступна для установки обновленная версия интеграции, куда добавлена опция отключения передачи к нам чеков без авторизации/бонусов.
Для того, чтобы не столкнуться с ошибкой и не было проблем при закрытии стола, нужно отключить передачу чеков.
В личный кабинет Samosale будут передаваться только чеки с авторизацией/бонусами.
Что нужно сделать: добавьте в блок [PARAMS] в файле Samosale.ini xmlLogs=1
В нашей документации прописали дополнительные параметры в блоке "Конфигурационный файл".
Ошибка на кассе
Если столкнулись с ошибкой после оплаты при закрытии стола, то сначала убедитесь, что все действия на кассе сделаны правильно, а именно:
1. На кассе выбраны позиции/блюда;
2. Введен номер гостя, нажав кнопку "Код с клавиатуры".
При ситуации, когда на кассе все действия проделаны верно, то попробуйте очистить чек:
1. Удалите позиции/блюда
2. Удалите гостя
3. Проведите оплату заново с добавлением позиций и гостя
Если это не помогает, то:
1. Запишите последовательность действий на видео и отправьте в нашу службу технической поддержки @SamosaleSupport_Bot
2. Чтобы ускорить решение проблемы, одновременно запросите логи с кассового сервера у своего дилера по R-Keeper и прикрепите их к обращению.
Лог-файлы помогут быстрее и точнее разобраться в возникшей проблеме.
3. Также, если в настройках включена запись XML логов, то еще для проверки нужен файл "db_v2.sqlite3" (лежит в корневой папке). Без XML логов выявить причину будет довольно непросто. Нужно включить в настройках запись XML логов и повторить те же действия.
Как включить запись XML- логов
Включение записи XML-логов в r_keeper 7 выполняется через настройки кассового сервера RK7Srv.
Открыть конфигуратор сервера > Настройки сервера > Логирование > Найдите параметр LogToXML или LogFormat, если есть выбор формата > Установите его значение в "True" (или выберите XML, если есть выбор формата) > В разделе LogFileName укажите путь для сохранения XML-логов > Нажмите Сохранить (Save) > Перезапустите кассовый сервер RK7Srv (RK7Srv.exe)
Доп. параметры:
LogLevel – устанавливает уровень детализации (например, Debug, Info, Error).
MaxLogSize – ограничивает размер лог-файла.
LogRotation – задает ротацию логов (например, по дням).
Если вы не нашли ответ на свой вопрос, задайте его нам в Telegram @SamosaleSupport_Bot 😃