Частые вопросы по интеграции R-Keeper (FAQ)

Последние изменения: 12.03.2025

Мы ответим на частые вопросы, которые могут помочь в настройке интеграции и при возникновении неполадки на кассе. 

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 😃

Помогла ли вам статья?