Данное решение предназначено для случаев, когда на объекте существует внешняя система лояльности, которой необходимо передавать информацию о покупках в системе Game-Keeper, и для конвертации бонусов внешней системы в бонусы системы Game-Keeper для возможности их использования.
В первом случае, при регистрации в чеке на кассе Game-Keeper карты внешней системы и последующей его оплате, во внешнюю систему отправляется транзакция с информацией о сумме чека. Эта информация может быть использована внешней системой для начисления собственных бонусов.
Во втором случае, при последовательной регистрации игровой карты Game-Keeper и карты внешней системы и указании количества бонусов к начислению (на игровую карту), во внешнюю систему отправляется транзакция с информацией о количестве бонусов, подлежащих списанию. Если указанного количества бонусов на карте внешней системы нет, списания не производится.
При регистрации карты внешней системы касса запрашивает во внешней системе информацию о ней только с целью определить существование такой карты. Никакие данные о ней (например, информация о владельце или об остатках на счетах) не используются и не отображаются.
Для связи кассы GK с внешней системой лояльности используется ПО FARCARDS 5-го поколения (5.06, 5.07), которое взаимодействует с внешней системой через библиотеку этой системы. Эта библиотека создаётся разработчиками внешней системы согласно протокола работы FARCARDS. В библиотеке необходимо реализовать обработку двух обязательных процедур и нескольких необязательных. Описание процедур представлено в файле Extdll.txt, входящего в состав дистрибутива FARCARDS. Дистрибутив можно получить по запросу в службе технической поддержки по адресу: support@game-keeper.com. Касса GK (gkPos.exe) в свою очередь связывается с FarCards.exe напрямую. Настройки для работы кассы с FarCards задаются в файле ecFarCards.ini, который размещается в корне паки gkPos. В gkPos.ini настраивается ExtCardInterface=Х - номер, получаемый по запросу в отделе Game-Keeper при подключении нового объекта, ExtCardBonusConvertCfn=Y - курс пересчета бонусов внешней системы лояльности в бонусы GK.
Выдержка из gkPos.ini:
[Settings]
POSID=101
ExtCardInterface=1 – код объекта
ExtCardBonusConvertCfn=5 (целое) – коэффициент конвертации бонусов
Пример файла ecFarCards.ini:
[Settings]
Server = 127.0.0.1 – ip-адрес Farcards.exe
Port = 3456 – порт Farcards.exe (из FARCARDS.INI)
RK_RestCode = 1 – код объекта при подключении, из параметра ExtCardInterface=1
RK_Unit = 101 – POSID кассы GK (из gkPos.ini)
Выдержка из файла описания farcards.txt:
Type = 1
В этом режиме FarCards передает запросы своих клиентов внешней DLL и возвращает результат ее работы. Название DLL указывается в .ini-файле. Требования к разработке DLL описаны в файле Extdll.txt.
Настройки в Farcards.ini.
секция [LinkDLL] и секции для DLL связи - так же как в cardserv.ini
[FarServer]
Type = 1 режим работы ретранслятора - см выше
DLL = XXXXXX название DLL.
Log = 1 уровень подробности LOG-файла 0..2
При правильных настройках всех узлов связи (касса, Farcards, внешняя библиотека) на кассе GK становится активной кнопка «Пополнение внеш. бонусами». Все взаимодействие кассы GK с внешней системой лояльности происходит в режиме, открывающемся при нажатии на эту кнопку.
