Описание

Инструкция описывает настройку кассового решения SetRetail10 для работы с банковскими терминалами Аркус Ingenico 3500 и Sunmi P2 через Arcus Net Server по протоколу TCP/IP.

Решение применяется для интеграции банковских терминалов, которые работают через промежуточную службу Arcus Net Server. Касса обращается к банковскому модулю стандартным способом, а параметры соединения с терминалом задаются в конфигурационном файле cashreg.ini.

Базовая настройка банковского ПО Аркус описана в статье SetRetail10 ▪️ Касса ◾️ АРКОМ (Аркус) (Ingenico). При настройке через Arcus Net Server вместо локального COM/USB-порта в пункте необходимо использовать сетевые параметры подключения.

Ценность

Поддерживается работа терминалов Ingenico 3500 и Sunmi P2 через Arcus Net Server по TCP/IP.
Кассовое ПО SetRetail10 не требует доработок: вызов cashreg и обработка файлов ответа остаются прежними.
Решение позволяет использовать сетевую схему подключения терминалов в магазинах, где требуется промежуточный сервер Arcus Net Server.
Маршрутизация обращения к конкретному ПИН-паду выполняется настройками Arcus Net Server и параметрами в cashreg.ini.

Ограничения

Arcus Net Server должен быть установлен и настроен отдельно. По проектному решению сервер может размещаться на промежуточном компьютере в магазине.
Настройку банковского ПО и параметров терминала выполняет сотрудник банка или ответственная команда, имеющая доступ к настройкам Аркус.
Параметры ADDR_IP и PORT_IP должны соответствовать адресу и порту Arcus Net Server, выделенным для конкретной кассы или терминала.
При использовании сетевого подключения не нужно одновременно настраивать локальный COM/USB-порт в качестве активного подключения.
Перед изменением конфигурации необходимо сделать резервную копию текущего файла cashreg.ini.

Настройки

cashreg.ini

Откройте на редактирование /home/tc/storage/crystal-cash/banks/arcom/linux/cashreg.ini

Параметры сетевого подключения

Параметр	Значение	Описание

Параметр	Значение	Описание
`PORT`	`ETH`	Тип подключения через Ethernet/TCP/IP.
`ADDR_IP`	`10.104.13.232`	IP-адрес Arcus Net Server.
`PORT_IP`	`9300`	TCP-порт Arcus Net Server, используемый для подключения кассы к терминалу.
`TIMEOUT`	`120000`	Таймаут ожидания выполнения операции.
`PPAD_IDLE_TO`	`120000`	Таймаут ожидания действий на ПИН-паде.

Пример cashreg.ini

В файле cashreg.ini добавьте или актуализируйте параметры:

PORT=ETH
ADDR_IP=10.104.13.232
PORT_IP=9300

Полный пример файла cashreg.ini:

#port section
#PORT=/dev/tty1
# port for I3070 with USB connection
#PORT=/dev/ttyUSB0
# port for Telium with USB connection
# PORT=/dev/usbSV0b00P00a2
# SPEED=115200
# BYTE=8
# PARITY=N
# STOP=1

PORT=ETH
ADDR_IP=10.104.13.232
PORT_IP=9300

#to in seconds
TIMEOUT=120000
PPAD_IDLE_TO=120000
NODIALOGS

# SPDH / Compass Plus
#OPERATION_INI_FILE=ops.ini
#RC_CONVERT_FILE=rc_conv.ini
#RC_RESOLVE_FILE=rc_res.ini

#ISO8583 - SmartVista / OpenWay / Tieto
OPERATION_INI_FILE=ops_8583.ini
RC_CONVERT_FILE=rc_conv_8583.ini
RC_RESOLVE_FILE=rc_res_8583.ini

#files section
CHEQ_FILE=cheq.out
RESULT_FILE=rc.out
OUTPUT_FILE=output.out

#auto cancel operation
CANCEL_CH_FILE=auto_can.out
CANCEL_RC_FILE=can_rc.out

#Comment to enable PPAD Date and time Syncronisation
#NOTIMESYNC

#Code pages (iconv using)
#Operating Charset only 1251
PPCHARSET=UTF-8
#Output char set(KOI8-R,UTF-8,CP1251 etc)
OPCHARSET=UTF-8
PRINTERCHARSET=UTF-8

#LOGS
USEAPPLOG
USEPPADTRACE

#response code converting
DEFAULT_RC_STRING=No code
USEORIGINALRC

Настройка терминала

На терминале Ingenico 3500 или Sunmi P2 настройте работу с кассой через Ethernet. Набор пунктов меню может отличаться в зависимости от версии банковского приложения, но должны быть заданы следующие параметры:

режим работы с кассой — включен;
порт подключения — ETH;
IP-адрес сервера — 10.104.13.232;
порт сервера — 9300;
диалог на кассе — отключен, если используется параметр NODIALOGS;
печать слипа — на кассе, если банковские слипы должны печататься средствами кассы.

После сохранения настроек терминал должен перейти в состояние готовности к работе.

Подключение процессинга в конфигураторе кассы

Авторизуйтесь на кассе под сервисным инженером.
Откройте Конфигуратор → Банки.
Выберите банковский процессинг АРКУС2 или процессинг, предназначенный для работы через Arcus Net Server, если он добавлен в конфигурации.
Нажмите Задействовать.
Перезагрузите кассовый модуль.

Дополнительное отображение сообщений ПИН-пада

Для отображения сообщений ПИН-пада на экране кассира используйте параметр show.status.message. Функциональность доступна для процессинга ARCOM.

Откройте базу данных set.
В таблице sales_management_properties найдите параметр show.status.message.
Установите значение true.
Загрузите настройки на кассу.
Перезагрузите кассовый модуль.

Настройка имени и расширения файла ответа

Если требуется явно задать имя файла настроек, исполняемый файл, файл ответа или файл слипа, отредактируйте файл:

/home/tc/storage/crystal-cash/config/plugins/bank-arcom-config.xml

Пример параметров:

<!--Имя файла настроек-->
<property key="iniFile" value="cashreg.ini"/>
<!--Каталог с файлом настроек-->
<property key="iniDirectory" value="INI/"/>
<!--Каталог с исполнительным файлом-->
<property key="workingDirectory" value="bankDIR"/>
<!--Имя исполнительного файла-->
<property key="binaryFile" value="cashreg"/>
<!--Имя файла ответа-->
<property key="outputFile" value="output.out"/>
<!--Имя файла слипа-->
<property key="slipFile" value="p"/>
<!--Кодировка файла слипа и ответа-->
<property key="charsetOfResponse" value="cp1251"/>

Примеры работы

Проверка связи с банковским модулем

После изменения cashreg.ini выполните проверку из каталога банковского ПО:

cd /home/tc/storage/crystal-cash/banks/arcom/linux
./cashreg /o1

Если настройки корректны, банковский модуль должен обратиться к Arcus Net Server, а терминал должен перейти к ожиданию карты или показать сообщение о готовности к операции.

Тестовая продажа

Перезагрузите кассовый модуль после настройки.
Откройте продажу на кассе.
Добавьте товар в чек.
Выберите оплату банковской картой через Аркус.
Подтвердите сумму оплаты.
Следуйте указаниям на терминале.
Проверьте, что касса получила успешный ответ и зарегистрировала чек.

Файлы результата операции

После выполнения операции банковский модуль формирует файлы результата. Форматы файлов при работе через Arcus Net Server не меняются.

Файл	Назначение

Файл	Назначение
`output.out`	Ответ терминала с расшифровкой результата операции.
`rc.out`	Код ответа от терминала.
`cheq.out`	Печатаемый банковский слип.

Проверка файлов ответа

cat output.out
cat rc.out
cat cheq.out

В успешном сценарии код ответа должен соответствовать успешной операции, например 000.

Статьи по теме

SetRetail10 ▪️ Касса ◾️ АРКОМ (Аркус) (Ingenico)

SetRetail10 ▪️ Касса ◾️ Настройка Аркус-терминалов Ingenico 3500 и Sunmi P2 через Arcus Net Server TCP/IP