код ресторана r keeper
Ключи, лицензии, механизмы лицензирования
В таблице ниже приведены параметры ключей, используемых для защиты программного обеспечения компании ЮСИЭС.
Таблица №1 Ключи
ПО UCS
Название файла / модуля
Параметры ключа защиты
Программный (логический)
Аппаратный (физический)
Виртуальный / сетевой
Подготовка ключа *
Другое ПО, где может быть использован
r_keeper_7
rkReportServer.exe, midserv.exe, dlvserv.exe
refsrv.exe, midserv.exe, dlvserv.exe
rkReportServer.exe, refsrv.exe, dlvserv.exe
r_keeper_7_CRM
r_keeper_7_Delivery
r_keeper_6
refsrv.exe, rkReportServer.exe, midserv.exe
refsrv.exe, rkReportServer.exe, midserv.exe
refsrv.exe, rkReportServer.exe, midserv.exe
refsrv.exe, rkReportServer.exe, midserv.exe
refsrv.exe, rkReportServer.exe, midserv.exe
StoreHouse_4
refsrv.exe, rkReportServer.exe, midserv.exe
RK-Order
r_keeper_6_Delivery
Резервирование
Surveillance
*Примечание: Под «подготовкой ключа» имеется ввиду необходимость предварительной подготовка ключа под конкретное ПО в офисе компании «ЮСИЭС».
В таблице ниже приведены характеристики лицензий, прописываемых в ключи защиты.
ПО UCS
Название файла / модуля
Параметры лицензии
Временное ограничение
Ограничение по количеству подключений
Привязка к коду ресторана
Привязка к оборудованию
Совместимость с другими лицензиями в ключе
Установка r_k Cloud и r_k Office на новой точке
Введение
Инструкция по первичному подключению к r_k Office.Данная инструкция предполагает только чистую установку r_keeper + WSA v2. Обновление и установка других версий поверх старых описаны в соответствующем разделе.
Сделать заявку на объект в системе лицензирования. После этого автоматически создастся заявка в Service Desk
Подробное описание
Получение лицензий
Если в системе лицензирования у вас еще нет объекта — создайте его. Это обязательное условие для получения лицензий.
Закажите лицензии в системе лицензирования. Лицензия называется R-Keeper Cloud-RK7 MAX 2021 Stations 12 мес ПО.
Заявки на такие лицензии, как правило, подтверждаются автоматически. На почту придет уведомление о том, что заявка подтверждена.
Необходимо заказывать весь набор лицензий на точку, т.е. весь пакет Cloud Max/Mix.
После подтверждения создаётся внутренняя заявка в Service Desk на развёртывание точки
Если у дилера ещё нет аккаунта в r_k Loyalty — то на его почту придёт письмо с приглашением создать аккаунт. В письме будет ссылка на создание пароля. Этот аккаунт стане техническим для дилера в r_k loyalty и все последующие точки будут привязаны к этому аккаунту. Все настройки в r_k Loyalty для точки необходимо будет делать под этим аккаунтом
Установка r_keeper Cloud
Ошибка отображения макрокоманды «excerpt-include»
No link could be created for ‘RK7:2021-07-02_10-51-22_.Установка r_keeper Cloud v7.6.2’.
Настройка менеджерской станции
Установите кассовый сервер и кассу. Обратите внимание, что кассовый сервер требуется версии 7.6.5.459 и выше.
На Windows 7 обязателен Internet Explorer 11 с обновлением, на Windows 10 — Net Framework 4.7.1+
Настройки в административной панели WSA
Далее необходимо настроить White Server Agent v2. Для этого:
Настройка подключения на портале r_k Loyalty
Данные настройки производятся на портале https://loyalty.r-keeper.ru/. Авторизуйтесь на портале и перейдите в Администрирование > Рестораны > Настраиваемый ресторан > Кассовые настройки.. Заполните следующие поля:
Код стола, для заказов к предзаказу — это код стола, на который будут записываться предзаказы.
Указание кода стала обязательно — независимо от того, хотите ли вы использовать предзаказ или нет.
Проверка работы лояльности
Проверьте корректность работы начисления и списания бонусов, если требуется r_k Loyalty.
Начисление бонусов в режиме Table service
Для проверки необходимо создать тестовый заказ.
Начисление бонусов в режиме Fast-Food
Принцип тот же самый.
Оплата бонусами и наличными
Проверяем работу оплаты заказа бонусами и наличными.
Создайте ещё один заказ и оплатите его через Sberfood накопленными в первом заказе бонусами. Перейдите в окно с кассой и убедитесь что появилась галочка с предоплатой.
Нажмите на бонусы, чтобы оплатить часть заказа бонусами:
Касса спишет бонусы и выдаст итоговый чек.
Возврат заказа
Срок возврата денежных средств на банковскую карту может составлять до 7 банковских дней.
Чтобы сделать возврат:
Чекин по номеру стола
Проверяем работоспособность опции Чекин по номеру стола.
Проверка начисления бонусов в режиме авторизации по номеру карты или телефона
Завершающие действия
Печать QR-кода на чеке для оплаты безналичных чаевых
Введение
В статье описана настройка печати QR-кода для оплаты чаевых SberTips.
Печатать QR-код можно на чеке, пречеке или любом желаемом макете.
Настройка расширенных свойств
На чеке печатается QR-код со ссылкой. Ссылка должна быть вида:
Для генерации ссылки на оплату необходимо получить в макете параметры:
Для получения кода официанта и кода заведения в системе SberTips необходимо:
для кода — CodeSberTips
для кода ресторана — RestCodeSberTips
Добавьте каждому свойству список типов Class Info:Работник. Для этого:
Настройка печати QR-кода
Для этого нужно создать новый или отредактировать имеющийся макет пречека.
В скрипте берутся данные официанта, который выполняет печать пречека. Если необходимо использовать код официанта-создателя заказа, то строки
необходимо заменить на:
Два варианта выделить код официанта в пречеке.
Заменить строку на:
7. В свойствах бэнда со скриптом задайте двойную высоту и ширину. Это изменит шрифт всего блока о чаевых — проверьте, подходит ли такой вариант вам
8. Нажмите ОК и сохраните изменения
9. Замените шаблон пречека в используемой схеме печати.
В настройках оборудования необходимо задать размер QR-кода с помощью параметра:
Для фискальных регистраторов:
Для принтеров с драйвером EPSON
В результате на пречеке официанта, у которого заданы свойства Код SberTips и Код заведения SberTips будет печататься QR-код со ссылкой на страницу оплаты.
Настройка оплаты с помощью QR-кодов
В инструкции описана настройка оплаты по QR-кодам из мобильных платежных систем sendy, alipay, wechat
Требуемая версия r_keeper — версия 7.6.4.412 и старше
Для того, чтобы интеграция SENDY, ALIPAY, WECHAT работала на объекте, необходимо на ресторан заказать лицензию на продукт «R-Keeper модуль XML-интерфейс для Приложения 12 мес ПО».
После того, как заявка будет подтверждена, в системе лицензирования нужно сгенерировать активную лицензию на продукт.
Сценарии оплаты
Офлайн-оплата (fastfood)
Онлайн-оплата (Table service)
Настройка в менеджерской станции
1. В справочнике «Кассовые станции и устройства» на кассовый сервер ресторана добавьте «PDS interface#1» и настройте его параметры в разделе «Опции»
Для свойства «Look up Card By Mail Addr» необходимо указать значение «Yes, error on not found»
2. В справочнике «Интерфейсы» добавьте новый интерфейс с наименованием SENDY.
На кассовом сервере ресторана в выпадающем списке выберите интерфейс «PDS interface#1», ранее добавленный во вкладке «Устройства», сохраните изменения.
3. В справочнике Валюты в группе «Платежные карты» добавьте новую валюту «Sendy, Alipay, Wechat».
Для валюты в секции свойств Интерфейс в свойстве Интерфейс укажите интерфейс SENDY
4. В справочнике «Меню» в группу «Нераспределяемые наценки» добавьте новое блюдо «Sendy блюдо».
В разделе свойств Основное укажите налоговую группу и тип товара «Платеж»
5. В справочнике «Скидки и наценки»:
5.1 Для оффлайн оплаты по QR-коду (qr-код сканируется кассиром из мобильного приложения гостя) необходимо:
— создать новый тип скидок с наименованием «Sendy». В нем создать новую суммовую нераспределяемую наценку «Sendy наценка» с нулевой детализацией. В разделе свойств «Ограничения» выставить чекбокс в свойстве На заказ. В свойстве «Блюдо наценки» необходимо указать ранее созданное блюдо «Sendy блюдо»
В разделе свойств «Интерфейс» для наценки необходимо указать ранее созданный интерфейс Sendy
5.2 Для онлайн оплаты по QR-коду (кассир добавляет в заказ одну из скидок «Sendy/Alipay/Wechat» и печатает пречек с QR-кодом) необходимо:
— создать новый тип скидок «QR online». В нем создать скидки «Alipay», «Sendy», «Wechat» с нулевой детализацией
В разделе свойств Интерфейс для скидки необходимо указать ранее созданный интерфейс Sendy, сохранить.
6. Для печати qr-кода в пречеке необходимо создать новый макет «Купон QR», импортировать в Дизайн макета макет из файла couponQR.mak
В справочнике «Схемы печати» выбрать используемую схему и добавить в нее представление документа «Купон QR»
7. В случае оффлайн оплаты по QR-коду гость может предоставить кассиру QR-код из одного из приложений – Sendy, Alipay, Wechat.
Для того, чтобы этот qr-код после сканирования был правильно обработан, необходимо создать MCR-алгоритм с наименованием «Sendy» в справочнике MCR алгоритмы: «Сервис->Обработка сигналов устройств->MCR алгоритмы». Для алгоритма необходимо указать Тип алгоритма Скрипт (сам скрипт указан ниже).
Настройка HTTPS сервера
В менеджерской станции необходимо настроить доступ к кассовому серверу через HTTPS.
Для этого необходимо сделать следующее:
9. Создать роль с правами на привилегию HTTP_порт.
При авторизации HTTP запросов используются только роли текущего ресторана и центрального офиса.
10. Для этой роли добавить работника, задать ему пароль. Название и пароль данного работника будут использоваться для авторизации на сервере через HTTPS.
Настройка Farcards
11. Распакуйте архив Sendy_Farcards.zip и выполните настройку farcards.ini:
Настройка конфигуратора Sendy
13. Из папки Farcards_Sendy запустите SendyConfigurator.exe и выполните следующие действия:
13.1 Укажите номер терминала, код активации и нажмите кнопку Активировать
13.2 На закладке «r_keeper» укажите ip + HTTP data port кассового сервера, а также код и пароль пользователя из п.п. 10для подключения к r_keeper_7 и нажмите «Тест соединения»
13.3 Если настройки выполнены правильно, то появится сообщение с номером версии rk7:
13.4 Затем установите дополнительные параметры для оффлайн и онлайн оплаты с помощью qr-кодов:
13.5 Для того, чтобы интеграция Sendy работала на объекте, необходимо на ресторан заказать лицензию на продукт «R-Keeper модуль XML-интерфейс для Приложения 12 мес ПО»
13.6 После того, как заявка будет подтверждена, на l.ucs.ru нужно сгенерировать активную лицензию на продукт.
13.7 На вкладке «Лицензия» введите логин и пароль дилера, у которого есть права на работу (настройку) с объектом. И нажмите кнопку «Проверить лицензию»
13.8 Если лицензия есть, то будет выведено сообщение:
Если лицензия не найдена, то либо продукта нет на объекте, либо нет активной лицензии на продукт (вернитесь к шагам 13.5 и 13.6).
Базовый процесс внедрения
В данной статье описан процесс подключения r_k Loyalty к r_keeper 7.
Инструкции отличаются и зависят от способа установки r_keeper.
Есть три варианта установки:
Общая принцип работы интеграции представлен на схеме ниже:
Таким образом, для настройки системы Вам понадобятся:
Системные требования
Ниже приводятся минимальные системные требования для интеграции с Loyalty.
Требования к кассовому серверу
Требования к кассовым станциям
Активация настроек в менеджерской r_keeper_7
Если у вас «HTTP Access» отсутствует, то перепроверьте версию кассового ПО или создайте новую привилегию с таким именем.
Далее перейдите в справочник Сервис > Станции и устройства и выберете используемый кассовый сервер.
В свойствах кассового сервера перейдите в блок HTTP ограничения
для параметра XML интерфейс выберете привилегию HTTP Access
Порт кассового сервера по умолчанию — 2345, стараемся использовать его. Http Bind Adress и UseFreeListenPort убираем.
Проверьте права XML – это скрытый профиль для обмена XML-данными. Для этого:
Настройка ограничений
Проверьте пользователя XML-Editing:
Выберите пользователя PlaziusExternal. Пароль в явном виде хранится в конфиге RposAppSettings.Prod.json в rpos 0.19.0.632 и выше
Сохраните и закройте меню Работники.
Активация предустановленных элементов справочника Plazius
В менеджерской станции перейдите в Расширения > Активировать Plazius.
Если у вас расширение установлено, то необходимо проверить версию библиотеки DLL. Версия библиотеки PlaziusWizard.dll должна быть 1.07.89 или выше.
Если у вас отсутствует расширение или PlaziusWizard.dll версия меньше 1.07.89, то скачайте актуальную по ссылке и поместите в папку plugins менеджерской станции r_keeper_7.
Если у вас данная папка отсутствует, то необходимо создать ее вручную.
Отметьте галочками рестораны, в которых необходимо активировать Plazius и нажмите Execute.
При активации данного расширения, будет автоматически добавлено и привязано два интерфейса на выбранные кассовые сервера.
Данные логические интерфейсы являются предустановленными в версиях r_keeper_7, которые поддерживают интеграцию с r_keeper Loyalty.
По умолчанию они скрыты и при успешной активации поменяют статус на Активный, сами привяжут созданные на кассовом сервере интерфейсы.
Настройка валют
В менеджерской станции перейдите в раздел Деньги > Валюты и выберите Платежные карты > Plazius.
Убедитесь, что иерархический порядок валют в разделе Платежные карты настроен, как показано на скриншоте ниже:
Если это не так, то, удерживая левую кнопку мыши, перетащите Карта Plazius в раздел Платежные карты.
Аналогично перетащите в этот раздел и подраздел Карта Plazius (предоплата), тем самым разделив оплату бонусами со скидками от оплаты картами.
Сохраните и закройте валюты.
При наличии в сети множества торговых точек с уникальными настройками меню, валют и т. д., для их корректной работы с валютами и скидками Plazius необходимо произвести настройки, описанные в разделе настройка причин внесения денег и зачета аванса
Настройка кассовых станций
Настройка печати чеков
Для исключения ошибок из-за ненапечатанного пречека в сценарии «Чекин по номеру стола», необходимо создать дополнительный класс принтера «Не печатать».
На случай необходимости повторной печати подвала с промокодом, настройте макеты Пречек и Plazius.
Настройка макета Пречек
Настройка макета Plazius
Если пречек не распечатался, для повторной печати пречека необходимо добавить на кассу кнопку Копия пречека.
Ее настройка описана в статье о настройке печати чека с промокодом (при подключении опции Валидатор).
Отключение печати документов
Необходимо отключить печать документов о внесении предоплатных валют Plazius.
Скидка Plazius — 96
Если эти значения заняты, то следует расчистить их для использования в настройке.
Важно для механизма автоматического уведомления (pushing) информации о рассчитанных/полученных лимитах и оплатах с сервера лояльности на сторону кассового сервера (через WSA
Добавьте скрипт к макету из текста ниже:
Настройка передачи категорий блюд для работы с маркетинговыми акциями
Для настройки передачи категорий блюд для работы с маркетинговыми акциями:
Выберите интерфейс Plazius (ПДС). В разделе Интерфейс в строке Xml dish attributes укажите параметр 2560.ClassificatorGroups^4193792
Параметр должен быть указан именно в таком виде: 2560.ClassificatorGroups^4193792
Установка комплекта интеграции rPOS
Если активация прошла без ошибок, и вы придерживались светлой стороны (дефолтные порты), а так же компоненты rPos и Farcard находятся на одном ПК с Кассовым сервером, в конфигурационном файле останется исправить только Пин и Пароль.
Распакуйте архив в папку.
Перейдите в папку rPos и отредактируйте файл RposAppSettings.Prod.json. Укажите в конфигурации:
3. Остальное: В настройка кассового сервера посмотрите параметр HTTP Data Port кассового сервера:
Не путать Host в блоке TcpRefServer.
В поле Password указан дефолтный пароль пользователя PlaziusExternal. Задайте его пользователю PlaziusExternal.
Обязательно брать пароль пользователя PlaziusExternal из конфигурационного файла.
Сохраните и закройте файл.
Убедитесь что кассовый сервер получил интерфейсы Plazius ПДС и XML. (Запуск в desktop, вкладка интерфейсы или в логах midsrv.stk)
Убедитесь что кассовый сервер слушает 2345 порт и http часть сервера успешно работает (в логах или кликом правой кнопкой мыши по значку в трее)
Откройте папку rPOS и запустите файл setService.bat от администратора. Этот скрипт установит и запустит на компьютер службу PlaziusClientHost.
Теперь необходимо настроить службу.
Только в случае если нужно заново проинициализировать компоненту, например в случае правки каких либо настроек конфигурации:
Установка MiniFarcards
Чтобы установить miniFarcards из комплекта и связать его с rPOS выполните действия ниже:
Перейдите в папку FarcardsPlazius и отредактируйте файл настроек FARCARDS.INI:
Сохраните и закройте файл настроек Farcards.
Запуск MiniFarcards
В менеджерской станции перейдите в Сервис > Интерфейсы. Откройте свойства интерфейса Plazius (ПДС) и проверьте, что ему назначен драйвер PDS interface #1. Интерфейс должен быть активен.
Farcards можно запускать как приложение и как службу.
Рекомендуется во время настройки запускать Farcards как приложение, а после — как службу.
Запускайте Farcards как приложение от имени администратора.
Чтобы выбрать, как запускать Farcards, сделайте ярлык файла Farcards.exe и в его свойствах пропишите:
Задать другой порт возможно в файле настроек farcard.ini
Установка WS-агента
Чтобы настройки применились, перезапустите службу WSA.
Для ускорения процесса по возможности заранее закажите лицензию.
Скачайте и распакуйте архив с WS агентом по ссылке: ftp://ftp.ucs.ru/WS/WSAgent/versions/.
Утилиты для лицензирования и регистрации кассовых серверов на стороне WS доступны по ссылке: ftp://ftp.ucs.ru/WS/WSAgent/tools/
Интерфейс White Server.
+ В системе лицензирования заказать R-Keeper модуль Loyalty (пакет) XX мес. ПО
После получения мастер-лицензии, её необходимо активировать в конфигураторе WS-агента на вкладке «Лицензирование».
Информация запишется в файл WSA.dat и на сервере лицензирования появится лицензия «WSClient».
Если мастер-лицензия есть, но её срок действия истекает или уже истёк — необходимо на сервере лицензирования сделать заявку на Продление мастер-лицензий.
Далее необходимо перевнедрить лицензию.
Повторно запросите лицензию на агента в конфигураторе на вкладке Лицензирование.
После продления лицензии перезапустите службы:
Обновление агента
После авторизации перейдите на вкладку Обновление и проверьте наличие новой версии.
Если новая версия есть — скачайте её, нажав кнопку Скачать.
Когда обновление загрузится, вы получите уведомление:
Нажмите ОК и Обновить. Приложение начнёт обновляться и в конце появится уведомление:
По очереди обновите монитор и затем агент.
Перейдите на вкладку Служба нажмите кнопку Установить. Агент установит 2 службы:
После установки нажмите ОК. Должно появиться уведомление об успешной установке.
В окне статуса агент будет писать Service running.
Служба установлена.
Если служба была установлена ранее, после настройки просто нажмите кнопку Применить настройки и перезагрузить службу.
В ресторанах, в которых WS Agent подключается к серверу через фаервол с проверкой по IP-адресу, необходимо изменить в настройки:
Настройка связи WSA с r_keeper_7 midserv
В окне White Server Agent Configurator перейдите на вкладку Общие.
В разделе «Взаимодействие с системами» отметьте галочкой параметр r_keeper_7.
Для корректной работы WSA должен быть подключен к кассовому серверу r_keeper_7.
При использовании прокси-сервера укажите параметры прокси.
Перейдите на появившуюся вкладку r_keeper_7 и настройте соединение с кассовым сервером.
Укажите IP-адрес и порт в полях Host и Port. Если используется шифрование интерфейса, укажите ещё и CryptKey.
Нажмите кнопку Check connection для проверки соединения. Если сервер запущен и параметры указаны верно, агент подключится к кассовому серверу и все поля в разделе Заказы поменяются на [Не выбрано]. З аполнять их не нужно! Настройка этой части проводится на r_keeper Loyalty в карточке организации на вкладке «Кассовые настройки».
Перейдите на вкладку Лицензирование. У вас уже должна быть получена мастер-лицензия R-Keeper модуль Loyalty (пакет)XX мес. ПО.
В строке поиска введите девятизначный код объекта и нажмите кнопку поиска
В окне Получение новой лицензии нажмите кнопки MaxDate и Далее. Будет указано что лицензия до 2100 года.
На месте списка появится информация о лицензии:
Агент активирован.
Перейдите на вкладку White Server и проверьте путь к API White Server. Путь прописан по умолчанию — https://ws-test.ucs.ru/wsserverlp.
Нажмите кнопку Check connection — агент должен подключиться к серверу.
Нажмите в правом углу кнопку Применить настройки и перезагрузить службу и закройте агент.
Чекин (авторизация гостя) по коду (номеру) стола
Опция «Чекин по номеру стола» позволяет гостю просматривать и оплачивать заказ самостоятельно через мобильное приложение или на сайте http://app.sberfood.ru.
Перед тем как активировать опцию на портале, необходимо:
Настройка r_keeper_7
Для корректной работы чекина по номеру стола, перед настройкой необходимо убедиться, что Название стола совпадает с Кодом и уникально в рамках организации.
Для этого необходимо настроить столы.
Настройка подключения на портале
Вы можете сделать их самостоятельно или прислать нам настройки WSA в заявку, в рамках которой ведётся внедрение.
В точке продаж перейдите на вкладку Сервисы. Если вкладка не отображается, скопируйте GUID точки продаж и вставьте после ссылки https://loyalty.r-keeper.ru/app/#/administration/editOrganization/services/[GUID]
Значение [GUID] Вы можете взять из текста ссылки, находясь на главной странице организации, отбросив символы %2F.
