Virtual personal card software for R-Keeper 7


1. General


1.1. "Virtual personal card" - new technology made to assign to customer unique identifier that allows to recognise him in R-Keeper CRM automated enterprice (the same functions as for regular plastic personal client card).

1.2. Customer will use his mobile phone as identifier.

1.3. "Virtual personal card" site (HTML5) has information about client account and his personal information and orders (current).

1.4. It is possible to make changes to current order (sent waiter message, use discount, add menu items).

1.5. This system additional module requires RK7, R-Keeper CRM to be installed.

1.6. Functionality to apply virtual card(s) added to Mobile waiter software (iOS).

Как это работает?

При входе в ресторан гостю выдают закодированный номер заказа, который соответствует номеру столика в RK7. После того как гость сделал заказ, он может просмотреть баланс своего заказа со своего мобильного устройства (телефона или планшета). При необходимости гость может отправить сообщение официанту. Оплата заказа с телефона на данный момент не реализована (планируется применить данный функционал в будущих версиях).

Для идентификации гостя используется виртуальная карта и номер мобильного телефона. При входе в приложение происходит создание новой или проверка уже существующей виртуальной карты в R-Keeper CRM и на мобильный телефон гостя отправляется код доступа.

Номер виртуальной карты и номер мобильного телефона должны быть уникальны в целях безопасности!

Отправка смс происходит с помощью системы R-Keeper CRM, настроенной на работу с оператором.


2. Files and folders


2.1. Where to get

2.1.1. Download from UCS FTP server.

2.2. Whats inside

2.2.1. There is server (vcsrv) and client (vc_client), both to be used as IIS sites. Серверная и клиентская части могут находиться либо на одной машине либо на разных.

Клиентская часть отвечает за регистрацию по телефону(содержит главные формы приложения, которые видит клиент при регистрации по телефону), серверная часть отвечает за связь с серверами РК7 и R-Keeper CRM.

2.3. External software

2.3.1. You have to install and configare web server(s).

2.3.2. We support and recomment Microsoft IIS (this web server is a part of any windows).

2.3.3. Learn IIS using Microsoft official support http://technet.microsoft.com/en-us/library/cc754281.aspx.


3. Server(s) set up


3.1. RK7 link

3.1.1. На кассовый сервер необходимо добавить XML-интерфейс и прописать у него порт. Связать данный интерфейс с существующим или новым логическим интерфейсом (Сервис-Интерфейсы).

3.1.2. Отредактировать файл ..\vcserver\bin\ips.ini (путь может отличаться от вашего).

;-------------------------- RK7 -------------------------

[RK7]

;--- код кассовой станции
StationCode=1

;--- код интерфеса для виртуальной карты (сервис-интерфейсы)
InterfaceCode=1

;--- код кассира (должен быть создан в менеджерской РК7)
CashierCode=3565

;--- для связи с кассовым сервером RK7 обязательно должны быть заданы MidIP(IP-адрес машины) и MidPwd
MidIP=192.168.100.103:17771 
;--- MidPwd = CryptKey в свойствах XML-интерфейса из п.3.1.1, если задан. 
MidPwd=

;--- код виртуального стола (должен быть создан в менеджерской РК7)
VirtualTable=212

;--- код виртуального официанта (должен быть создан в менеджерской РК7)
VirtualWaiter=3565

;--- код шаблона пречека (из менеджерской РК7)
BillPreviewCode=1002204

;--- время устаревания закачанных с RK данных (в секундах)
UpdateTime=60

;----------------- Сообщения официантам ------------------
;--- отправлять всем официантам, обслуживающим стол (1-Да, 0-Нет)
SendToAll=1

;--- код официанта, который всегда получит сообщение, если не задан промокод
;DefaultWaiterCode=3565

;--- время активности сообщений для официанта (в секундах)
WaiterMessageTimeToLive=3600

;------------------ Cлужебный раздел ---------------------
[SERVICE]

;--- язык интерфейса
Lang=RUS

;--- размер файла лога в байтах
LogFileMaxSize=1000000

;--- уровень логирования
LogLevel=4
3.1.3. Отредактировать файл ..\vcserver\settings.ini
 
[VERSION]

;версия RK (6 или 7. По-умолчанию 7)
RK=7

[AUTH]

; время активности сессии (в минутах). По-умолчанию 30 минут
SessionTimeOut=120

; время активности кода смс (в секундах). По-умолчанию 180 секунд.
SMSDuration=10
;180

[LOGGING]

; размер файла лога в байтах
LogFileMaxSize=1000000

; уровень логирования
LogLevel=3

[SERVICE]

; язык системы по-умолчанию
Lang=rus

3.2. IIS web site

Добавьте клиентскую и серверную части для сайта. Пропишите путь к сборке сервера и задайте порт для сервера(см.рис.1, п.2).

Рис.1 Работа в диспетчере служб IIS.

3.3. R-Keeper CRM link

3.2.1. В R-Keepr CRM необходимо добавить классификатор ПО для виртуальной карты и задать ему код (пункт меню: Файл - Классификаторы ПО) или использовать существующий.

3.2.2. Настроить связь с оператором для смс-рассылки (в конфигураторе для приложения "Карточная система" на вкладке SMS). В качестве провайдера выступает MobiService (http://smsconsult.ru/), с которым должен быть заключен соответствующий договор. Главное на что следует обратить внимание, это "Текст SMS сообщения при регистрации в карточной системе". Введите текст согласно рисунку ниже.

Рис.2 Настройки сервера для отправки смс в конфигураторе.

3.2.2. Так же следует получить код лицензии для внешних подключений-GlobalType.

3.2.3. В редакторе карт необходимо добавить тип адреса "Адрес доставки" и прописать его ID (посмотреть в базе) в файле cs5.ini.

3.2.4. Отредактировать файл ..\vcserver\cs5.ini

[CS5]

TimeOut=60
;--- порт сервера авторизации карт R-Keeper CRM
Port=9191
;--- IP-адрес машины, где установлен сервер авторизации карт
IP=198.154.196.215
;--- код лицензии для внешних подключений к R-Keeper CRM
GlobalType=FQvTNcT0249HHc9C9akF
;--- код классификатора ПО из редактора карт из п.3.2.1
TerminalType=1

[CONTACTS]

;---- по справочнику типов контактов
;--- идентификатор Страны
CountryId=
;--- идентификатор города
CityId=

; Id типа контактов: e-mail
EmailTypeId=252

; id типа адреса доставки, см. п.3.2.3
DeliveryAddressTypeId=251

4. Client settings


4.1. settings.xml

4.1.1. file format settings.xml в корневой папке.

?xml version="1.0" standalone="yes"?>

<Settings>

<!-- Включение/выключение демо-режима (в демо-режиме используются фиксированные локальные данные)-->

<Param Name="DemoMode" Value="0"/>

<!-- Подключение к серверу по IP-адресу и порту, см. рис.1 -->

<Param Name="DataSrc" Addr="http://vc.mysite.ru:8787/default.aspx"/>
<!-- <Param Name="DataSrc" Addr="http://198.154.196.152:8888/default.aspx"/> -->
<!-- Язык интерфейса

Value="eng"

  Английский

Value="rus"

  Русский

-->  

<Param Name="Language" Value="rus"/>

<!-- 

Value="0"

  Всегда требовать авторизацию

Value="1" 

  Если пользователь уже зарегистирован в системе, то он перенаправляется сразу к странице с qr-кодом, минуя этап авторизации -->  

<Param Name="GoToQrCode" Value="1"/>

<OrderMsgTemplates>

  <Msg info="CallTheWaiter" img="ico/icon_order_service.png"/>

  <Msg info="Calculate" img="ico/icon_order_check.png"/>

</OrderMsgTemplates>

<CommonMsgTemplates>

  <Msg info="CallTheWaiter" img="ico/icon_order_service.png"/>

</CommonMsgTemplates>

<WaiterMsgTemplates>

  <Msg info="PleaseCalculate" img="ico/icon_order_service.png" msg="Просьба рассчитать"/>

</WaiterMsgTemplates>

 </Settings>

4.2. Translation

4.2.1.


5. Licensing


5.1. Для R-Keeper CRM необходимо получить дополнительную лицензию (код лицензии для внешних приложений - GlobalType).


6. Run, use


6.1. Заходим на страницу сайта, в нашем случае систему клиента развернули на локальной машине на порту 8030: http://localhost:8030/, вводим номер телефона и получив код авторизации, автоизуемся в системе.

Tested for: R-Keeper CRM 5.06, R-Keeper 7.5.2.192.