I. Настройки в менеджерской RK7
Настройка PDS-интерфейса кассового сервера.
В справочнике «Сервис –> Станции и устройства» выбираем кассовый сервер, для которого будем настраивать связку GK+RK7 (если кассовых серверов несколько, например кафе в режиме фаст-фуд, то необходимо сделать для каждого кассового сервера) и на закладке «Устройства» нажимаем правой клавишей мыши (ПКМ), выбираем список драйверов (рисРис. 1).
Рис. 1
В открывшимся списке выбираем PDS interface (рисРис. 2).
Рис. 2
Удерживая выделенную строку PDS interface левой кнопкой мыши (ЛКМ), перетягиваем ее на вкладку «Устройства» кассового сервера и отпускаем. Система выдаст сообщение, где спросит привязать этот интерфейс к стандартному, на что стоит нажать кнопку «Нет» (рисРис. 3).
Рис. 3
Наступаем мышкой на Выбираем только что накинутый PDS interface и в его свойствах заполняем строку «PDS Server Name», где указываем имя, которое присвоим нашему FARCARDS, а также параметр «Maximal Discount Value» выставляем в значение «No limits» (рисРис. 4).
Рис. 4
Это имя мы указываем в FARCARDS.INI (рисРис. 5).
Рис. 5
Далее в справочнике «Сервис –> Интерфейсы» создаем новый интерфейс, называем его, например GK+RK7, делаем активным и в свойствах этого интерфейса в блоке настроек «Файлы библиотек (DLL)» у нашего кассового сервера выбираем привязанный ранее логический интерфейс PDS interface #1 (рисРис. 6).
Рис. 6
2. Настройка MCR алгоритма Game-Keeper
Заходим в справочник «Сервис –> Обработка сигналов устройств –> MCR алгоритмы» и делаем активным MCR алгоритм «Карточки Game Keeper». В свойствах MCR алгоритма в блоке настроек «Основное» в параметре «Объект» выбираем наш интерфейс «GK+RK7» (рисРис. 7).
Рис. 7
Далее щелкаем дважды кликаем на наш MCR алгоритм «Карточки Game Keeper» два раза, и попадаем в тело скрипта для обработки, где в поле «ChainCode» вводим код корпорации, присвоенный вашему объекту в системе Game-Keeper (рисРис. 8).
Рис. 8
На приведенном рисунке код корпорации равен – 1, в вашем случае это будут другие цифры, узнать которые вы можете у специалистов тех. поддержки GK (тел. +7 -(499-) 703-42-61 4261 или направив запрос на трекер в службу технической поддержки на e-mail: support@game-keeper.com), а также либо самостоятельно в приложении «Редактор GK» в справочнике «Игровой зал» (рисРис. 9).
Рис. 9
3. Продажа Продажа игровых (гостевых) карт Game-Keeper на кассе RK7
Для того, чтобы настроить продажу игровой карты GK на кассе RK7 нам потребуется необходимо создать нераспределяемую (суммовую) наценку. В современных версиях RK7 для создания таких наценок сначала требуется завести специальные блюда в справочнике «Меню –> Нераспределяемые Наценки», которые в свою очередь дальше будем привязывать далее будут привязываться к нашим наценкам. ( В старых версиях RK7 делать это было необязательно, достаточно было указать в свойствах наценки Тип – Сумма и Налоговую группу). Пример добавления блюда для нераспределяемой наценки показан ниже (рисРис. 10).
Рис. 10
Далее заходим в справочник «Деньги –> Скидки и Наценки» и создаем новый тип скидок, называем его, например «Game-Keeper» (рисРис. 11).
Рис. 11
После создания типа скидок наступаем мышкой на него и ПКМ – Новая нераспределяемая наценка (рисРис. 12).
Рис. 12
Называем нашу наценку, например, «Карта Game-Keeper», выставляем параметры: «Блюдо наценки» - выбираем созданное нами ранее блюдо «Карта Game-Keeper»; «Тип» - Сумма; «Интерфейс» - выбираем созданный нами «GK+RK7»; Код транзакции – 54 – это соответствует коду продажи неактивированной карты в базе данных GK (рисРис. 13).
Рис. 13
Стоит обратить внимание, что в свойствах этой наценки в поле «Код» проставлено значение 333, этот код мы должны проставить в файле gkFarCards.ini в секции [discount.table] именно так как показано ниже 0=333 (рисРис. 14). Этот код можно оставить таким, каким система присвоила автоматом, можно, как в нашем случае, поставить свой.
Рис. 14
Нашу нераспределяемую Нераспределяемую наценку сохраняем пока «Не активной». Далее для этой наценки делаем Детализацию, в поле «Сумма» ставим значение равное стоимости нашей карты при продаже ее на кассе RK7 . (рисРис. 15). После этого переводим наценку в статус «Активный».
Рис. 15
4. Пополнение баланса игровой карты GK на кассе RK7
Наступаем на Выбираем Тип скидок «Game-Keeper» мышкой, далее ПКМ – Новая Новая нераспределяемая наценка, создаем новую нераспределяемую наценку, как указано на рисРис. 12. Называем Называем наценку, например «Пополнение баланса GK», выставляем параметры: «Блюдо наценки» - выбираем созданное нами ранее блюдо «Пополнение баланса GK»; «Тип» - Сумма; «Интерфейс» - выбираем созданный нами «GK+RK7»; Код транзакции – 51 – это соответствует коду пополнения баланса игровой карты в базе данных GK (рисРис. 16).
Рис. 16
Нашу нераспределяемую Нераспределяемую наценку сохраняем пока «Не активной». Далее для этой наценки делаем Детализацию, в поле «Сумма» ставим значение 1 – обязательно!!! (рисРис. 17). После этого переводим наценку в статус «Активный».
...
Для учёта пополнения баланса карты фискальным регистратором, в справочнике «Деньги –> Причины внесения/выдачи денег» создайте денег» необходимо создать причину для пополнения баланса карты. В свойствах причины, в поле «Пополнение баланса» выберите выбираем – Фискальное, установите устанавливаем флаг - Передавать потраты, в поле «Наценка» выберите поле «Наценка» выбираем нераспределяемую наценку, которую создали выше которая была создана ранее - «Пополнение баланса GK» (рисРис. 18).
Рис. 18
5. Настройка общих параметров RK7
В справочнике «Настройки –> Параметры» находим параметр «Оплата платежной картой» и выставляем значение «Спрашивать» (рисРис. 19).
Рис. 19
В справочнике «Настройки –> Параметры » находим параметр «ПДС показывать инфо о карте» и включаем флаг «Логический» (рисРис. 20).
Рис. 20
6. Настройка валюты для оплаты блюд игровой картой GK на кассе RK7
Заходим в справочник «Деньги – >Валюты», выбираем тип валют «Платежные карты» и на основе валюты «ПДС оплата» создаем валюту «Карта Game-Keeper» и выставляем в свойствах валюты параметры: «Автозаполнение» - Вся сумма + подтверждение, и подтверждаем; «Интерфейс» - наш созданный интерфейс «GK+RK7», так же в блоке настроек «Печать» необходимо выставить параметр «Тип фискальности» - Суммарно с вычитанием . (рисРис. 21). Стоит отметить, что настройка Суммарно Настройка Суммарно с вычитанием доступна в менеджерской RK7 только под дилерским паролем, так как определяет валюту как нефискальную, т.е. не попадающую в память фискального регистратора. Валюта «Game-Keeper» должна быть нефискальной, чтобы исключить двойное налогообложение. Когда мы пополнили баланс игровой карты, то фискальным регистратором был выдан фискальный чек на сумму пополнения и теперь при оплате блюд игровой картой GK на кассе RK7, операция должна быть нефискальной.
Рис. 21
II. Установка и настройка ретранслятора транзакций FARCARDS
...
Для связи кассового сервера и игрового сервера GK (PosServer) используется приложение FARCARDS (ретранслятор запросов/транзакций между базами данных). Применимо к настройке связки GK+RK7 на текущий момент используется FARCARDS версии 5.07. Стоит обратить внимание, что нужно Необходимо использовать именно эту версию, а не старшую более позднюю 6.04 – , с этой версией работать, если будет работать, то очень некорректноработа может быть некорректной!
Сборка рабочего 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).
Рис. 22
Переходим к настройке Настройка .ini-файлов.
FARCARDS.INI:
[FarServer]
Type = 1
...
0=333 – соответствие кода неактивной карты GK с кодом нераспределяемой наценки RK7 (рисРис. 13).
Первый запуск FARCARDS делаем приложением, т.е. ярлык с ключом /desktop. Такой запуск позволяет оценить работоспособность приложения (рисРис. 23, 24).
Рис. 23
Рис. 24
На постоянной основе после настройки связки GK+RK7 нужно проинсталлировать FARCARDS службой, запуск с ключом /install и убедиться, что указанная служба появилась в списке служб Windows, запустить ее (рисРис. 25).
Рис. 25
III. Настройка кассового сервера RK7
После настройки интерфейса в менеджерской RK7, описанных описанной в главе I, необходимо настроить кассовый сервер RK7 и убедиться, что настройки , сделанные нами, попали на негоприменились. Предварительно в .ini-файле кассового сервера rkeeper.ini в в секции [TCPDNS] необходимо прописать связь с FARCARDS:.
[TCPDNS]
RK7SRVGK=127.0.0.1:3639
...
После этого запускаем кассовый сервер приложением - ярлык с ключом /desktop, в трее появится значок кассового сервера, нажимая нажав на него 2 раза, откроется окно с текущим состоянием сервера. Переходим на вкладку «Интерфейсы» и убеждаемся, что наш интерфейс «GK+RK7» подцепился (рисРис. 26).
Рис. 26
IV. Проверка работоспособности связки GK+RK7
Наша задача купить Для проверки необходимо приобрести на кассе RK7 неактивированную игровую (гостевую) карту GK, пополнить ее баланс и приобрести на кассе блюда, расплатившись этой картой GK. Также дополнительно пополним необходимо пополнить карту на кассе GK бонусами и проверимпроверить, что на кассе RK7 мы можем оплатить заказ как очками-деньгами так и очками-бонусами.
Берем неактивированную карту GK, проверить это можно, прокатав ее на кассе GK (рисРис. 27).
Рис. 27
На кассе RK7 входим в режим создания заказа (рисРис. 28).
Рис. 28
Прокатываем в этом режиме игровой картой GK, попадаем в окно информации по карте (рисРис. 29).
Рис. 29
Нажимаем на надпись [Картинка], наша наценка «Карта Game-Keeper» попадает в заказ (рисРис. 30).
Рис. 30
Далее оплачиваем стандартным образом на кассе RK7 (можно наличными, можно банковской картой). После оплаты выйдет фискальный чек, говорящий о покупке подтверждающий покупку игровой карты и одновременно, эта карта станет активная в системе GK с . После оплаты карта становится активной с присвоенным ей уровнем «Стандартный». Это мы можем можно проверить на кассе GK (рисРис. 31).
Рис. 31
Как видно из рисРис. 31 наша тестовая карта № 207 стала активной с уровнем «Стандартный» и залоговой стоимостью 30 руб. – столько сколько стоит карта на кассе RK7 (детализация нераспределяемой наценки «Карта Game-Keeper» (см. рисРис. 15). Пока баланс карты равен 0. Пополним баланс на кассе RK7, для этого в режиме Главного меню (рисРис. 32) Вы берем пункт "Пополнение баланса платёжной карты".
Рис. 32
Проведем игровой картой, попадаем в окно «Инфо о карте» и нажимаем кнопку «Пополнение» (рисРис. 33).
Рис. 33
После нажатия кнопки пополнения, попадаем в форму для пополнения баланса карты (рисРис. 34).
Рис. 34
Вводим сумму, на которую хотим пополнить баланс игровой карты и выбираем валюту, которой будем оплачивать пополнение (рубли или банковская карта) (рисРис. 35).
Рис. 35
После нажатия на кнопку валюты, фискальный регистратор зафиксирует операцию пополнения баланса, из него выйдет фискальный чек и откроется окно «Инфо о карте», где будет видно изменения баланса (рисРрис. 36).
Рис. 36
Проверим пополнилась ли реально наша игровая карта на кассе GK (рисРис. 37).
Рис. 37
Теперь проверим как можно оплатить заказ на кассе RK7 игровой картой GK. Но сначала добавим на нашу тестовую карту № 207 бонусов и сделаем это для начала внесем на счёт тестовой карты №207 бонусы на кассе GK. (Сейчас мы для простоты начислим бонусы вручную на кассе GKДля упрощения начислим Ручной бонус, но бонусы на карте могут появиться при участии карты в системе лояльности, где бонусы могут начисляться по разным причинам, будь то От пополнения баланса, или межуровневого перехода и т.д.). и другими доступными способами. Внесем на тестовую карту 200 бонусов (рисРис. 38, 39).
Рис. 38
Рис. 39
Из рисРис. 39 мы видим, что после наших действий, пополнения на тестовой карте теперь Очков 700, из них 500 – это очки-деньги, 200 – очки-бонусы. Приобретем на эти средства блюда на кассе RK7. Делаем заказ на кассе RK7 (рисРис. 40).
Рис. 40
Как видно из рисРис. 40 наш заказ на 575 рублей. В этом же окне заказа прокатываем нашей игровой картой GK попадаем в знакомое окно «Инфо о карте» (рисРис. 41),
Рис. 41
где видим, что баланс карты 700 (500+200) и нажимаем кнопку «Оплата картой». Кнопка «Оплата картой» становится активной только при наличии положительного баланса либо очков-денег, либо очков-бонусов на игровой карте. После нажатия на кнопку «Оплата картой» система предложит подтвердить операцию оплаты (рисРис. 42). Подтверждаем, печатается чек. Обращаем внимание, что чек выйдет нефискальный, так как валюта, созданная нами в главе I, пункте 6 нефискальная (объяснения приведены там же). На распечатанном чеке будет информация о карте: номер, остаток баланса (рисРис. 43).
Рис. 42
Рис. 43
После оплаты проверим баланс нашей игровой карты на кассе RK7 и для сравнения/проверки на кассе GK. У нас должно остаться 700 – 575 = 125 (рисРис. 44, 45).
Рис. 44
Рис. 45
Стоит обратить Обратите внимание, что на кассе RK7 в окне «Инфо о карте» мы видим отображаются суммарные средства на игровой карте, в нашем случае 0 очков-денег (рублей) и 125 очков-бонусов, что в сумме 0 + 125 = 125.
Подробную детализацию Чтобы увидеть конкретные цифры баланса на игровой карте с разделением, то следует смотреть на кассе ГК, где четко видно, что отдельно отображается баланс очков-денег 0 , и очков-бонусов 125 (рисРис. 45).V.
Заключение
В данной инструкции описаны настройки классической связки программных комплексов Game-Keeper и R-Keeper 7. На рисунках стоит обращать внимание как на общий вид, так и на выделенное маркером (желтым, красным, синим цветами). Тест связки проводился на версиях GK 4.12, RK7.6.4.208. Рекомендуем всем, кто хочет настраивать и использовать данный функционал, всегда обновляться на последние При настройке и использовании данного функционала рекомендуется использовать последние на момент инсталляции версии GK и RK7.
Если в системе GK настроена бонусная сетка за пополнениесумму пополнения, например, за пополнение на 1000 руб. начисляется 100 бонусов, то при пополнении игровой карты на кассе RK7 на 1000 руб. на эту игровую карту автоматически начисляется также неё также будет начислено 100 бонусов.
В расширенной версии связки GK+RK7 имеется возможность настройки использования системы скидок на кассе RK7 в зависимости от уровня игровой карты в GK. Например, игровые карты с уровнем «Стандартный» будут могут иметь скидку на кассе RK7 в размере 5%, игровые карты с уровнем «Серебряный» будут иметь скидку на кассе RK7 в размере - 10%, игровые карты с уровнем «Золотой» будут иметь скидку на кассе RK7 в размере - 20% и т.д. Данный функционал настраивается сотрудниками отдела Game-Keeper, т.к. требуется вмешательство в базу данных GK для сопоставления кодов уровней GK и скидок RK7.
...
Обязательно закрыть кассирам право на кассе RK7 «Изъятие денег со счета платежной карты ПДС». Возвраты средств за пополнения баланса игровой карты GK на кассе RK7 делать только через удаление/анулирование аннулирование чека. И также стоит знатьиметь ввиду, что не получится вернуть на кассе RK7 залоговую стоимость карты (в нашем примере 30 руб.) нельзя.