Общие требования к кассовому терминалу GK
Кассовый терминал GK в бюджетном своем исполнении может представлять собой компьютер на базе PC, к которому подключен считыватель карт (магнитных или бесконтактных), монитор, мышка, клавиатура и на который установлено ПО «Касса GK». Но целесообразно использовать для этих целей сенсорный Pos-терминал со встроенным считывателем. Кассовый терминал GK обычно размещается при входе в игровой центр/парк. Предназначен для предоставления широкого спектра услуг для посетителей центра/парка, таких как продажа игровых карт, пополнение баланса, персонализация гостей, запуск/остановка тарификаций, продажа пакетов/товаров/услуг и многое другое. Для увеличения функциональности, а также для того, чтобы рабочее место кассира соответствовало ФЗ-54, к кассовому терминалу есть возможность подключить дополнительное оборудование: фискальный регистратор, дисплей покупателя, сканер штрих-кодов, банковский терминал оплаты…
Минимальные и рекомендуемые требования к рабочему месту кассира приведены в Общих требованиях к объектам перед инсталляцией.
Предварительные настройки
При инсталляции и настройке ПО “Касса GK” Pos-терминал должен быть залогинен под учетной записью с правами Администратора. Также стоит понизить политику контроля учетных записей до минимума:
Изменить системное имя компьютера (по желанию и на усмотрение заказчика):
Скопировать на Pos-терминал установочный дистрибутив – архив типа stable_412_17.02.2020.7z, разархивировать его.
Установить из папки \Files\DISTRIB\guardant дистрибутива GK драйвер лицензионного ключа защиты.
Вставить лицензионный ключ защиты Guardant в usb-порт на Pos-терминале. Убедиться, что на ключе загорелась световая индикация и что ключ отобразился в системе:
Содержимое папки \Files\DISTRIB\lib дистрибутива GK скопировать в системную директорию Windows C:\Windows\SysWOW64 – для 64-bit OC, C:\Windows\System32 – для 32-bit OC.
Настроить брандмауэр Windows, либо другой софт (антивирусник) со встроенным файрволлом на предмет разрешения обмена через определенные порты, используемые в системе GK. Следует создать правила как для входящих, так и исходящих соединений. Базовые порты, которые необходимо “открыть”:
211 – порт Borland Socket Server
1433 – порт MS SQL Server
50300 – порт службы gkPosServer
Если на Pos-терминале установлена ОС семейства Windows 7 или семейства Windows 10, то
для связи рабочего модуля с БД требуется установить SQL Server Native Client 2012!
Если на Pos-терминале установлена ОС семейства Windows XP, то
для связи рабочего модуля с БД требуется установить компонент Microsoft Visual C++ (vcredist_x86.exe)!
В корне диска D, если не имеется, то C, создать папку GK. В эту папку будут устанавливаться модуль Касса GK.
Настроить раскладку клавиатуры по-умолчанию на английский!
Установка модуля инфотерминал GK
В каталог GK в корне диска D, если нет, то C, из дистрибутива версии скопировать папку gkPos.
Настроить конфигурационный файл gkPos.ini:
[DbConnect]
ServerName=192.168.1.100 – ip-адрес сервера GK (Ip указан для примера)
Port=50300 – порт службы gkPosServer
В разделе [Settings] указать ID кассы из справочника Зоны
[Settings]
POSID=128
Если на объекте несколько кассовый мест, то POSID у каждой кассы будет свой. Именно этот параметр в отчетах GK используется для создания фильтра.
Вынести на рабочий стол ярлык утилиты Licence.exe, переименовать его в Лицензирование.
Вынести на рабочий стол ярлык bat-файла start_app.bat, далее этот ярлык скопировать в Автозагрузку Windows.
Здесь стоит обратить внимание на один нюанс. Если на Pos-терминале установлена ОС семейства Windows 10, то описанные выше действия актуальны. Если на Pos-терминале установлена ОС семейства Windows 7 или семейства Windows XP, то в теле bat-файла start_app.bat требуется модифицировать строку:
Вместо cmdow.exe /RUN /MAX gkPos.exe /ACT
Написать start gkPos.exe
Связано это с тем, что утилита cmdow.exe предназначена для работы только на Windows 10. Эта утилита переключает активность окон Windows. В нашем случаем это окно логина пользователя на кассе. Без использования этой утилиты, после запуска активность оставалась на последнем процессе, а это запуск bat-файла и при проводе карточкой гостя по считывателю, начинался повторно запуск приложения. И так по кругу. Такова особенность работы с окнами для Windows 10. На ОС семейства Windows 7 или семейства Windows XP таких проблем не выявлено.
Подключение фискального регистратора
На данный момент для использования на кассе GK поддержана работа аппаратов только 2 производителей ФР, это Атол и Штрих. В рамках этих двух производителей рекомендованные модели: АТОЛ-77Ф, АТОЛ-22 ПТК, ШТРИХ-01Ф, ШТРИХ-МИНИ-02Ф.
До подключения к кассе GK ФР должен быть с активированным ФН (фискальным накопителем), зарегистрированным в налоговом органе и в личном кабинете ОФД (оператор фискальных данных), должен быть заключен договор с ОФД на отправку копий чеков на электронную почту посетителя, либо в смс.
Рекомендованный тип подключения ФР к Pos-терминалу это RS-232 (чистый com-port), для отправки данных в ОФД использовать разьем Ethernet. В некоторых случаях, допустим при отсутствии возможности подключения по RS-232, можно использовать подключение по USB, но отправку в ОФД все-таки приоритетно настраивать через Ethernet.
Предварительно на Pos-терминале следует установить утилиту конфигурирования и настройки ФР актуальной версии от завода изготовителя по типу регистратора. Для ФР Штрих — это «Тест драйвер Штриха», для ФР Атол – это «Драйвер торгового оборудования».
Подключение ФР Атол
Через утилиту Атола «Драйвер торгового оборудования» выставляем тип подключения ФР к Pos-терминалу. Если регистратор подключен к com-порту на самой станции, то ставим RS-232, если подключен usb-кабелем, то соответственно выбираем USB. При подключении по RS-232 мы видим к какому com-порту подключен ФР, например com1. Через утилиту DTO – драйвер торгового оборудования выставим скорость на этом порту равную 115200.
При подключении по usb и установленных драйверах (устанавливаются при инсталляции утилиты завода изготовителя DTO – драйвер торгового оборудования), в системе Атол эмулирует 2 виртуальных com-порта. Один для подключения к кассовым программам, в нашем случаем это gkPos, второй для отправки данных в ОФД через службу EoU, которая использует сетевое подключение с интернетом самого Pos-терминала. Нас интересует только номер com-порта для связи с программой. Скорость в таком случае не важна, так как usb-подключение не имеет характеристики скорости. Будем условно понимать ее равной 115200. Также по умолчанию ФР Атол работает по протоколу 3.0 (есть еще старый протокол 2.4), это мы учтем в дальнейших настройках.
На кассе GK в папке gkPos настроим конфигурационный файл gkPos.ini:
; Печатающее устройство (регистратор)
[FiscReg]
UseDriver54 =2 – для использования ФР по ФЗ-54
Dll54Name = fpAtol54.dll – библиотека подключения ФР Атол
;UseDriver54 =0 – должна быть обязательно закомментирована
UPrintVat = 1
AllowZeroSales =1
Также настроим файл конфигурации fpAtol54.cfg:
[Settings]
LogLevel=5
LogDestination=1
MsgLanguage=ENG
PortName=COM6 – номер порта из утилиты DTO
PortConfiguration=baud=115200 – скорость com-порта
CashierPassword=28
AdminPassword=29
SysAdminPassw=30
InvertDrawerOpened=0
CommunicatPassw=0
UseSectionAs=Department
PaperWidth=0
OFDStatusUnsendWarningTime=300
OFDStatusUnsendErrorTime=0
Protocol=3 – протокол работы
Если ФР Атол находится в режиме работы по-старому протоколу 2.4, то настройку Protocol=3 из файла конфигурации следует удалить.
Подключение ФР Штрих
Смысл подключения идентичный, что и для Атола – через родную утилиту «Тест драйвер Штриха» определить параметры подключения к Pos-терминалу, такие как номер com-порта и его скорость. У ФР Штрих единый протокол работы. Затем эти данные внести в конфигурационные файлы gkPos.ini и fpShtr54.cfg. Рекомендуемая скорость порта также, как и для Атола 115200.
gkPos.ini:
; Печатающее устройство (регистратор)
[FiscReg]
UseDriver54 =2 – для использования ФР по ФЗ-54
Dll54Name = fpShtr54.dll – библиотека подключения ФР Атол
;UseDriver54 =0 – должна быть обязательно закомментирована
UPrintVat = 1
AllowZeroSales =1
fpShtr54.cfg:
[Settings]
LogLevel=5
MsgLanguage=ENG
Protocol=0
PhysicLayer=0
COMnum=1 – номер com-порта из утилиты «Тест драйвера Штриха»
COMbaud=115200 – скорость com-порта
TCPaddress=192.168.37.111
TCPport=12345
PasswOperat=1
PasswAdmin=30
PassBefCut=5
DoubleWFont=4
DoubleHFont=1
OFDStatusUnsendWarningTime=300
OFDStatusUnsendErrorTime=0
Достаточно указывать только эти 2 параметра, остальные можно оставить по умолчанию.
Настройка налогов на кассе
За настройку налогов на кассе GK в конфигурационном файле gkPos.ini отвечает секция [VatIndex], в которой прописывается соответствие размера ставки налога НДС номеру секции в справочнике налоговых ставок в самом фискальном регистраторе:
Для ФР Атол, если заведение работает с НДС:
[VatIndex]
2000=1 - цифра 1 в таблице налоговых ставок Атол соответствует позиции НДС 20%
1000=2
0=0
Для ФР Атол, если заведение работает без НДС (упрощенная система налогообложения):
[VatIndex]
2000=6 – цифра 6 в таблице налоговых ставок Атол соответствует позиции «Без НДС»
Если объект работает без НДС, то остальные 2 блок настроек (1000=2 и 0=0) следует удалить
Для ФР Штрих, если заведение работает с НДС:
[VatIndex]
2000=1 - цифра 1 в таблице налоговых ставок Штрих соответствует позиции НДС 20%
1000=2
0=0
Для ФР Штрих, если заведение работает без НДС (упрощенная система налогообложения):
[VatIndex]
2000=4 – цифра 4 в таблице налоговых ставок Штрих соответствует позиции «Без НДС»
Если объект работает без НДС, то остальные 2 блок настроек (1000=2 и 0=0) следует удалить
Подключение сканера к кассе GK
Сканер штрих-кодов на кассе GK предназначен для быстрого поиска товаров в призотеке, а также для сканирования карт/браслетов с нанесенными штрих-кодами как идентификаторами в системе тарификаций. Поддерживаются сканера подключающиеся по принципу в «разрыв клавиатуры» и отображающиеся в системе как устройства HID (устройства ввода-вывода). Также для использования сканера штрих-кодов на кассе GK, он должен быть предварительно запрограммирован на добавление к считываемому коду префикса, суффикса с переводом каретки на следующую строку (Enter). Префиксом в системе GK выступает символ « ` » - тильда, суффиксом « # » - решетка. При считывании штрих-кода в блокнот должен отображаться код вида:
`0123456789123#
Программирование префикса и суффикса осуществляется при помощи служебных штрих-кодов сканера из специальных таблиц от производителя. На данный момент мы рекомендуем 3 модели сканеров для работы на кассе GK: Metrologic MS 9520/9540 Voyager, Datalogic qw2120, Honeywell HH-400. Коды программирования к этим моделям можно скачать по ссылкам:
Программирование сканера штрих кодов datalogic QW2120
Программирование сканеров штрих кодов Metrologic MS 9520 Voyager и Honeywell HH-400
Проверка работоспособности сканера штрих-кодов на кассе GK.
В приложении «Редактор» в справочнике «Товары» завести тестовый товар и в его свойствах заполнить поле штрих-код. Если подключен принтер этикеток, то можно сгенерировать случайный штрих-код для тестового товара и сразу его распечатать. Если нет принтера этикеток, то можно взять реальную игрушку/приз со штрих-кодом или использовать подручные предметы, на которых имеется штрих-код.
На кассе отсканировать наш штрих-код и приз/товар должен отобразиться в рабочем поле кассы. Если мы пытаемся продать товар, то сканировать нужно в главном рабочем окне кассы GK, если нужно выдать приз, то ОБЯЗАТЕЛЬНО нажимаем кнопку «Призотека»:
Подключение дисплея покупателя к кассе GK
Дисплей покупателя (ДП) на кассе GK предназначен для вывода информации посетителю о текущих расходных операциях, таких как приобретение карты, пакетов, товаров, услуг, пополнение баланса, а также зачисление тикетов. В системе GK поддерживаются только ДП с интерфейсом RS-232. Также ДП должен находиться в эмуляции Epson и поддерживать русскую кодовую страницу.
Настройки на кассе в конфигурационном файле gkPos.ini:
; Дисплей покупателя
[CustDisp]
ComPort = Com5 – номер порта, на который физически подключен ДП
Если на кассе используется ДП, то запуск кассового приложения обязательно нужно организовывать через bat-файл, в котором наряду с параметрами запуска кассы, указывать параметры для ДП:
mode com5 9600,n,8,1
copy rus.txt com5
Также в корне папки gkPos должен присутствовать файл русификации rus.txt (по умолчанию включен в комплект дистрибутива). В дистрибутиве gkPos присутствует bat-файл start_app.bat, в котором это все учтено – рекомендовано для запуска кассы GK.
Подключение бесконтактного считывателя к кассе GK
Если бесконтактный считыватель, подключенный к кассе GK, определяется в системе Windows как устройство HID (устройство ввода), то такой считыватель будет работать в приложении gkPos без дополнительных настроек.
Если бесконтактный считыватель, подключенный к кассе GK, определяется в системе Windows как устройство, занимающее com-порт, то для такого считывателя требуется внести дополнительные настройки в конфигурационном файле gkPos.ini. Для таких считывателей, как правило, требуется установить драйвер от производителя. В системе GK широко применяются бесконтактные считыватели фирмы Ironlogic, такие как Z2USB. Настройки для такого считывателя в gkPos.ini:
[Z2_RFID]
elfComPort = COM3 – номер com-порта из диспетчера устройств Windows или утилиты производителя PlaceCard
elfBaudRate = 9600 – скорость работы считывателя
elfWriteLog=1
Для других бесконтактных считывателей стоит указывать:
[Elf_RFID_1]
elfComPort = COM2 – номер com-порта из диспетчера устройств Windows или утилиты производителя
elfBaudRate = 9600 – скорость работы считывателя
elfWriteLog=1
Но тут стоит понимать, что не все бесконтактные считыватели могут подойти для работы на кассе GK. Прежде, чем покупать считыватель, необходимо проконсультироваться со специалистами технической поддержки Game-Keeper.
Подключение банковского терминала к кассе GK
Интегрированный с кассовым приложением банковский терминал предназначен для проведения оплат банковскими картами в автоматическом режиме, чтобы исключать ошибки кассиров при выполнении такого рода операций. На текущий момент (04.20г.) для интеграции с кассой GK поддержаны пинпады только Сбербанка. Банковский терминал должен иметь интерфейс либо RS-232, либо USB, который эмулирует com-port.
Предварительно сотрудник банка подключает терминал к Pos-терминалу, устанавливает драйвера для него и программное обеспечение. По умолчанию софт банка устанавливается в папку C:\sc552. До работ по интеграции банковский терминал должен корректно работать через собственную утилиту банка.
В дистрибутиве gkPos по умолчанию присутствуют файлы необходимые для подключения банковского терминала: cvSBplt.dll – библиотека драйвера связи, btInit.txt – файл конфигурации, BarCodeGen.dll – вспомогательная библиотека.
В файле btInit.txt необходимо проверить настройки:
<DriverParameters>
<Parameter Name="Log level" IntegerValue="5"/>
<Parameter Name="Path to pilot_nt" StringValue="C:\sc552\"/> - папка с установленным софтом банка
<Parameter Name="HEX sequence to cut paper" StringValue="1B37"/> - команда на отрезку слипов
</DriverParameters>
Здесь стоит обратить внимание на команду 1B37. Именно такое значение сотрудник Сбербанка должен через утилиту конфигурации пинпада или файл настройки вставить в параметр «Последовательность после чека». Это нужно для корректного отреза при печати банковских слипов.
Настройки на кассе gkPos.ini:
; Настройки для пинпада
[BankTerminal]
DllName = cvSBplt.dll
CfgName = btInit.txt
StrId = bank_term
Настройка валют в приложении «Редактор»: