Настройка связи Game-Keeper c R-Keeper 7
- Настройки в менеджерской RK7
- Настройка PDS-интерфейса кассового сервера.
...
- Настройка MCR алгоритма Game-Keeper
...
- Продажа игровых (гостевых) карт Game-Keeper на кассе RK7
Wiki разметка |
---|
\\
Для того, чтобы настроить продажу игровой карты GK на кассе RK7 нам потребуется создать нераспределяемую (суммовую) наценку. В современных версиях RK7 для создания таких наценок сначала требуется завести специальные блюда в справочнике «Меню –> Нераспределяемые Наценки», которые в свою очередь дальше будем привязывать к нашим наценкам. (В старых версиях RK7 делать это было необязательно, достаточно было указать в свойствах наценки Тип – Сумма и Налоговую группу). Пример добавления блюда для нераспределяемой наценки показан ниже (рис. 10)
\\
!worddave86f6b4aaf06e4cd3e1aa7fb8f669227.png|height=309,width=577!
Рис. 10
\\
Далее заходим в справочник «Деньги –> Скидки и Наценки» и создаем новый тип скидок, называем его, например «Game-Keeper» (рис. 11)
\\
!worddav09aa33f08c0b7f3701d06d0bafed5130.png|height=263,width=477!
Рис. 11
\\
После создания типа скидок наступаем мышкой на него и ПКМ – Новая нераспределяемая наценка (рис. 12)
\\
!worddav21545ac5a550698b47f3390e86d8f312.png|height=301,width=533!
Рис. 12
\\
Называем нашу наценку, например «Карта Game-Keeper», выставляем параметры «Блюдо наценки» - выбираем созданное нами ранее блюдо «Карта Game-Keeper»; «Тип» - Сумма; «Интерфейс» - выбираем созданный нами «GK+RK7»; Код транзакции – 54 – это соответствует коду продажи неактивированной карты в базе данных GK (рис. 13)
\\
!worddavb809f33e3b05b7df3b58706e47966512.png|height=429,width=575!
Рис. 13
\\
Стоит обратить внимание, что в свойствах этой наценки в поле «Код» проставлено значение 333, этот код мы должны проставить в файле gkFarCards.ini в секции \[discount.table\] именно так как показано ниже 0=333 (рис. 14) Этот код можно оставить таким, каким система присвоила автоматом, можно, как в нашем случае, поставить свой.
\\
!worddav5ee1f60bc98ce666a6d03c1873d33067.png|height=361,width=217!
Рис. 14
\\
Нашу нераспределяемую наценку сохраняем пока «Не активной». Далее для этой наценки делаем Детализацию, в поле «Сумма» ставим значение равное стоимости нашей карты при продаже ее на кассе RK7. (рис. 15) После этого переводим наценку в статус «Активный».
\\
!worddave3b00d821aa8347cdf58a8b29c52bd4d.png|height=259,width=485!
Рис. 15
\\ |
- Пополнение баланса игровой карты GK на кассе RK7
...
- Настройка общих параметров RK7
...
- Настройка валюты для оплаты блюд игровой картой GK на кассе RK7
...
- Установка и настройка ретранслятора транзакций FARCARDS.
Wiki разметка |
---|
\\
Для связи кассового сервера и игрового сервера GK (PosServer) используется приложение FARCARDS (ретранслятор запросов/транзакций между базами данных). Применимо к настройке связки GK+RK7 на текущий момент используется FARCARDS версии 5.07. <span style="color: #ff0000">Стоит обратить внимание, что нужно использовать именно эту версию, а не старшую 6.04 – с этой версией работать, если будет работать, то очень некорректно!</span>
\\
Сборка рабочего FARCARDS:
\\
Дистрибутив FARCARDS необходимо скопировать с FTP Компании ЮСИЭС :/r-keeper/versions/PERSCARD/FARCARDS/ fc507.7z. Обычно папку с FARCARDS размещаем на сервере GK, в нее распаковываем скачанный архив с FTP. Также необходимо в папку с FARCARDS скопировать библиотеки связи, находятся на FTP Компании ЮСИЭС :/r-keeper/versions/PERSCARD/ netdll.7z. Далее в папку с FARCARDS необходимо скопировать файлы для связи с кассовым сервером RK7, взять из дистрибутива версии RK7, установленной на объекте, в нашем примере INST7.06.04.208\bin\For cardserv\. Из указанной папки берем *dll и netk.ini. Для связи с PosServer GK необходимо скопировать файлы из дистрибутива версии GK, установленной на объекте, в нашем примере: stable_409_23.08.2019\409\Files\GK\gkInterface\gkFarCards. Из указанной папки берем *.dll и gkFarCards.ini. В итоге у нас должна получиться сборка, вид которой выглядит следующим образом (рис. 22)
\\
!worddavd9c28d523cf0824d6e2abd70028f2c1a.png|height=443,width=325!
Рис. 22
\\
Переходим к настройке ini-файлов.
\\
<span style="color: #4472c4">FARCARDS.INI:</span>
\\
\[FarServer\]
Type = 1
DLL = gkFarCards.DLL
XMLCP=1251
\\
\[LinkDLL\]
1= Rlocal
2 = pds_netk
\\
\\
\[Rlocal\]
Port = 1
\\
\[pds_netk\]
NetServerName=FARGK – имя нашего PDS interface кассового сервера
ininame=netk.ini
\\
<span style="color: #4472c4">NETK.INI:</span>
\\
\[netkern\]
TESTMESSAGES=0
protocols=tcpsoc.dll
\[TCPSOC\]
port=2299 – порт связи FARCARDS с кассовым сервером RK7
\\
<span style="color: #4472c4">gkFarCards.INI:</span>
\\
\[DbConnect\]
ServerName = 127.0.0.1 – IP-адрес PosServer GK
Port=50300 – порт PosServer GK
\\
\[log\]
Name= gkFarCards.log
Level = 5
DebugLevel = 0
\\
\[gkFarCards\]
Coupons =0
OnlyCash=0 – разрешить оплату бонусами на кассе RK7
:OnlyCash=1 не оплачивать бонусами
\\
\[discount\]
usage=2
Field=0
\\
\[bonus\]
usage=0
\\
\[discount.table\]
0=333 – соответствие кода неактивной карты GK с кодом нераспределяемой наценки RK7 (рис. 13)
\\
Первый запуск FARCARDS делаем приложением, т.е. ярлык с ключом /desktop. Такой запуск позволяет оценить работоспособность приложения (рис. 23, 24)
\\
!worddavac366733ab2cb4aff8254d1decf4e63d.png|height=129,width=381!
Рис. 23
\\
!worddav9f84c570684ff9eb5f4dacd0db049a8b.png|height=159,width=381!
Рис. 24
\\
На постоянной основе после настройки связки GK+RK7 нужно проинсталлировать FARCARDS службой, запуск с ключом /install и убедиться, что указанная служба появилась в списке служб Windows, запустить ее (рис. 25)
\\
!worddavc2ed682aebc670826933ccad7b704c44.png|height=373,width=577!
Рис. 25
\\ |
- Настройка кассового сервера RK7
Wiki разметка |
---|
\\
После настройки интерфейса в менеджерской RK7, описанных в главе I, необходимо настроить кассовый сервер RK7 и убедиться, что настройки, сделанные нами, попали на него. Предварительно в ini-файле кассового сервера rkeeper.ini в секции \[TCPDNS\] прописать связь с FARCARDS:
\\
\[TCPDNS\]
RK7SRVGK=127.0.0.1:3639
<span style="color: #ff0000">FARGK=127.0.0.1:2299 – IP-адрес, где крутится FARCARDS, порт указанный в NETK.INI (смотреть выше настройка ini-файлов)</span>
\\
После этого запускаем кассовый сервер приложением - ярлык с ключом /desktop, в трее появится значок кассового сервера, нажимая на него 2 раза, откроется окно с текущим состоянием сервера. Переходим на вкладку «Интерфейсы» и убеждаемся, что наш интерфейс «GK+RK7» подцепился (рис. 26)
\\
!worddav0f2e906d430fcc96a1cf15f35a519354.png|height=145,width=576!
Рис. 26
\\ |
- Проверка работоспособности связки GK+RK7
Wiki разметка |
---|
\\
Наша задача купить на кассе RK7 неактивированную игровую (гостевую) карту GK, пополнить ее баланс и приобрести на кассе блюда, расплатившись этой картой GK. Также дополнительно пополним карту на кассе GK бонусами и проверим, что на кассе RK7 мы можем оплатить заказ как очками-деньгами так и очками-бонусами.
Берем неактивированную карту GK, проверить это можно, прокатав ее на кассе GK (рис. 27)
\\
!worddav348fad2c5f87e4d08ee40c72d06868a1.png|height=431,width=573!
Рис. 27
\\
На кассе RK7 входим в режим создания заказа (рис. 28)
\\
!worddav5b1a41f2721b087a15e261daae69c539.png|height=431,width=575!
Рис. 28
Прокатываем в этом режиме игровой картой GK, попадаем в окно информации по карте (рис. 29)
\\
!worddav8b2ee53d7c5c9fdc3f98cfac7bd76080.png|height=435,width=577!
Рис. 29
\\
Нажимаем на надпись \[Картинка\], наша наценка «Карта Game-Keeper» попадает в заказ (рис. 30)
\\
!worddav6469369b4a25010553618edca8755c34.png|height=433,width=577!
Рис. 30
Далее оплачиваем стандартным образом на кассе RK7 (можно наличными, можно банковской картой). После оплаты выйдет фискальный чек, говорящий о покупке игровой карты и одновременно, эта карта станет активная в системе GK с уровнем «Стандартный». Это мы можем проверить на кассе GK (рис. 31)
\\
!worddav8c23f9790dd05f98b8c6962a3f36737d.png|height=433,width=576!
Рис. 31
\\
Как видно из рис. 31 наша тестовая карта № 207 стала активной с уровнем «Стандартный» и залоговой стоимостью 30 руб. – столько сколько стоит карта на кассе RK7 (детализация нераспределяемой наценки «Карта Game-Keeper» (см. рис. 15). Пока баланс карты равен 0. Пополним баланс на кассе RK7, для этого в режиме Главного меню (рис. 32)
\\
!worddav3b8efa230bfb51ecd848a8d6ee66a6a0.png|height=431,width=575!
Рис. 32
\\
Проведем игровой картой, попадаем в окно «Инфо о карте» и нажимаем кнопку «Пополнение» (рис. 33)
\\
!worddav4b2c987c57b985825a1744017cdc9e60.png|height=433,width=577!
Рис. 33
\\
После нажатия кнопки пополнения, попадаем в форму для пополнения баланса карты (рис. 34)
!worddav40ce2218f714924a7f09ac2d5c41192a.png|height=435,width=577!
Рис. 34
\\
Вводим сумму, на которую хотим пополнить баланс игровой карты и выбираем валюту, которой будем оплачивать пополнение (рубли или банковская карта) (рис. 35)
\\
!worddav1d2f7adcac7e142103864749d19c8d00.png|height=433,width=577!
Рис. 35
\\
После нажатия на кнопку валюты, фискальный регистратор зафиксирует операцию пополнения баланса, из него выйдет фискальный чек и откроется окно «Инфо о карте», где будет видно изменения баланса (рис. 36)
\\
!worddavf32bf215e98abaf1ad28f1c34521aa64.png|height=433,width=576!
Рис. 36
\\
Проверим пополнилась ли реально наша игровая карта на кассе GK (рис. 37)
\\
!worddavbb64da5fa50b34ce2f25ba3ac1f74e16.png|height=431,width=575!
Рис. 37
\\
Теперь проверим как можно оплатить заказ на кассе RK7 игровой картой GK. Но сначала добавим на нашу тестовую карту № 207 бонусов и сделаем это на кассе GK. (Сейчас мы для простоты начислим бонусы вручную на кассе GK, но бонусы на карте могут появиться при участии карты в системе лояльности, где бонусы могут начисляться по разным причинам, будь то От пополнения баланса, или межуровневого перехода и т.д.). Внесем на тестовую карту 200 бонусов (рис. 38, 39)
\\
!worddav2d5c7b33e0cce880172d78d9b3c8f80c.png|height=433,width=576!
Рис. 38
!worddavdf5fe42abe6e99bad3e9d10ca3138392.png|height=433,width=576!
Рис. 39
\\
Из рис. 39 мы видим, что после наших действий, на тестовой карте Очков 700 из них 500 – это очки-деньги, 200 – очки-бонусы. Приобретем на эти средства блюда на кассе RK7. Делаем заказ на кассе RK7 (рис. 40)
\\
!worddav378756f3e15264cf8ff951ad9e32c0a4.png|height=433,width=576!
Рис. 40
\\
Как видно из рис. 40 наш заказ на 575 рублей. В этом же окне заказа прокатываем нашей игровой картой GK попадаем в знакомое окно «Инфо о карте» (рис. 41),
\\
!worddav93e9978c187b096a3f64d918ad4f2d0b.png|height=433,width=577!
Рис. 41
\\
где видим что баланс карты 700 (500+200) и нажимаем кнопку «Оплата картой». Кнопка «Оплата картой» становится активной только при наличии положительного баланса либо очков-денег, либо очков-бонусов на игровой карте. После нажатия на кнопку «Оплата картой» система предложит подтвердить операцию оплаты (рис. 42). Подтверждаем, печатается чек. Обращаем внимание, что чек выйдет <span style="color: #ff0000">нефискальный</span>, так как валюта, созданная нами в главе I пункте 6 нефискальная (объяснения приведены там же). На распечатанном чеке будет информация о карте: номер, остаток баланса (рис. 43).
\\
!worddav2970c15078c39414345bae1a02fee061.png|height=433,width=575!
Рис. 42
\\
!worddav3f67cedb4b861c0419a9951f2614ef64.png|height=403,width=313!
Рис. 43
\\
После оплаты проверим баланс нашей игровой карты на кассе RK7 и для сравнения/проверки на кассе GK. У нас должно остаться 700 – 575 = 125 (рис. 44,45)
\\
!worddavc37d75f1943fc62f1e557e82b03fdf18.png|height=433,width=577!
Рис. 44
\\
\\
!worddav575a6676daae633151628f055d00e6d1.png|height=431,width=573!
Рис. 45
\\
Стоит обратить внимание, что на кассе RK7 в окне «Инфо о карте» мы видим суммарные средства на игровой карте, в нашем случае 0 очков-денег (рублей) и 125 очков-бонусов, что в сумме 0+125=125
Чтобы увидеть конкретные цифры баланса на игровой карте с разделением, то следует смотреть на кассе ГК, где четко видно, что очков-денег 0, очков-бонусов 125 (рис. 45).
\\ |
- Заключение
...