R_keeper

Интеграция с R_keeper предоставляется нашему партнеру бесплатно, мы выполняем ее самостоятельно. Настройка займет около 60 минут.

Для интеграции используется XML‑интерфейс. Чтобы выдать необходимую лицензию, нам потребуются:

• код ресторана;
• доступ в менеджерскую станцию (через AnyDesk или другое ПО);
• доступ к кассе (кассовому серверу).

Минимальные системные требования

• Операционная система: Windows 7 SP1 (32/64-бит) и выше
• Процессор: Intel Atom и выше
• Оперативная память: 2 ГБ и выше
• Дисковая подсистема: 20 ГБ и выше
• Версия R_Keeper: 7.5.7.75 и выше
• Java: 1.8.0_231 и выше

Настройка на стороне R_Keeper

Настройка производится в менеджерской станции:

1. Создайте новую роль в персонале центрального офиса Yandex с максимальными правами.

2. Настройте пользователя YandexQRpay:

   • Код сотрудника: 10002. Если он уже используется, создайте новый, чтобы не пересекался с другими.

   • Пароль: совпадает с кодом сотрудника.

   • Роль: Yandex.

     

   • Пользователь: YandexQRpay

     

3. Проверьте настройки кассового сервера.

   

   Важно

   • Обязательно уберите чекбокс Use Free Listen Port.
   • В поле HTTP Data port укажите свои порты, только если в этом поле ничего нет. Если там уже установлен порт, не меняйте его.

4. Проверьте, верно ли указан код у кассовой станции в поле Код.

   

Установка и настройка RKPayer

1. Установите RKPayer в корень системного диска, где расположен кассовый сервер, например C:\\rkpayer.

   

2. Перед настройкой RKPayer запросите у инженера, ответственного за интеграцию, два важных параметра:

   • Идентификатор кассы в системе Яндекса (pos_id)
   • Токен для интеграции.

   Полученные значения внесите в соответствующие поля файла rkpayer.xml.

3. Настройте конфигурационный файл rkpayer.xml (пример ниже).

   Шаблон конфигурационного файла

   <service>
     <id>rkpayer</id>
     <name>RK Payer</name>
     <description>Сервис обработки платежей по коду стола</description>
     <executable>java</executable>
     <arguments>
   	-Xmx1024m -Xms256m
   	-jar
   	"C:\rkpayer\rk-payment-client.jar" <!-- не удалять -->
   	--run.health.check=true <!-- не удалять -->
   	--log.cash.xml=true <!-- не удалять -->
   	--payment.server.url=rk-pay.catlabs.tech <!-- не удалять -->
   	--payment.posId=<!-- идентификатор кассы в системе Яндекса -->
   	--payment.token= <!-- токен для интеграции с Яндексом -->
   	--cash.xml.user=YandexQRpay <!-- пользователь -->
   	--cash.xml.password=MTAwMDc= <!-- нужно изменить, если код 10007 -->
   	--cash.station.code=1 <!-- поменять в соответствии с кодом станции -->
   	--cash.waiter.code=10002 <!-- код пользователя YandexQRpay -->
   	--hall.plan.useSecondRequest=true <!-- не удалять -->
   	--cash.xml.ip=127.0.0.1 <!-- ip xml (ip кассового сервера) -->
   	--cash.xml.port=7373 <!-- ip xml интерфейса (парт из поля HTTP Data port) -->
     </arguments>
     <log mode="roll"></log>
     <delayedAutoStart>true</delayedAutoStart>
   </service>
   

   Примечание

   Если код пользователя YandexQRpay отличается от 10002:

   1. Сгенерируйте токен через Base64.
   2. Вставьте полученный код вместо MTAwMDc= в конфигурационном файле.

4. После внесения изменений сохраните файл.

5. Установите службу RKPayer командой c:\\rkpayer\\rkpayer.exe install.

   

6. Прожмите батник Yashedule.bat. Это добавит в Windows задачу по интервальному перезапуску интеграции.

7. Запустите службу, проверьте, что она не отключается в течение 1 минуты. Интеграция завершена.

   

8. Сообщите инженеру об успешном выполнении, чтобы он проверил связь с кассой. Также передайте данные о соответствии столов в R_keeeper и СмартРезерв.