Модуль "YARUS" предназначен для выполнения оплаты платежными картами с использованием банковского платежного терминала YARUS P2100.
Типы поддерживаемых операций:
- оплата,
- возврат,
- отмена оплаты или возврата,
- сверка итогов.
Передача параметров операции – типа операции, суммы, валюты передаются из кассовой программы через Ethernet-интерфейс по протоколу UDP. При проведении платежных операций из интерфейса кассы возможность их выполнения с терминала блокируется.
Конфигурирование модуля
Для использования процессинга необходимо установить пакет artix-yarus
.
aptitude install artix-yarus
Вызов клиентского приложения выполняется при выборе специального типа оплаты. Добавление типа оплаты осуществляется при конфигурировании модуля. Конфигурирование модуля выполняется по команде:
dpkg-reconfigure artix-yarus
При конфигурировании модуля необходимо указать номер типа оплаты, который будет использован в данном процессинге. После указания типа оплаты соответствующий вид валюты автоматически добавляется и настраивается в БД. Информацию о типе оплаты можно просмотреть в утилите администрирования Yuki в разделе "Справочники" > "Валюты".
Параметры настройки процессинга задаются в конфигурационном файле /linuxcash/cash/paysystems/yarus/artixyarus.conf
.
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
encoding | строковый | Кодировка сообщений, получаемых от терминала | По умолчанию cp1251 | |
host | строковый | Хост терминала | По умолчанию 192.168.0.1 | |
port | строковый | Порт терминала | По умолчанию 5757 | |
printerPort | строковый | Порт сетевого принтера | По умолчанию 5858 | |
valCode | числовой |
| Код валюты:
| По умолчанию 933 |
timeout | числовой | Таймаут ожидания отчета | По умолчанию 30 секунд | |
attemptCount | числовой | Количество попыток отправки пакета | По умолчанию 5 | |
discountCardCommand | строковый | Код команды (в hex формате) для запроса номера бонусной/дисконтной карты через терминал | По умолчанию 0xF1 | |
printOperationJournal | логический |
| Печатать журнал операций | По умолчанию true |
Для печати платежных квитанций (слипов) необходимо настроить взаимодействие кассовой программы и терминала. В настройках терминала указываются настройки местоположения сетевого принтера - ip адрес кассы и порт сетевого принтера (printerPort
). При настройке процессинга указываются хост и порт подключаемого терминала. Слипы платежных квитанций передаются на кассу по TCP протоколу на порт сетевого принтера.
Для добавления бонусной/дисконтной карты в чек через терминал YARUS необходимо для параметра discountCardCommand
в конфигурационном файле /linuxcash/cash/paysystems/yarus/artixyarus.conf
задать код команды в формате hex
.
[main] ; Кодировка сообщений, получаемых от терминала (По умолчанию cp1251) ; encoding = cp1251 ; Хост терминала (По умолчанию 192.168.0.1) ; host = 192.168.0.1 ; Порт терминала (По умолчанию 5757) ; port = 5757 ; Порт сетевого принтера. ; Касса по текущему порту, ; дожидается сообщений от терминала (По умолчанию 5858) ; printerPort = 5858 ; Код валюты (По умолчанию 933) ; valCode = 933 ; Таймаут ожидания отчета ; timeout = 30 ; Количество попыток отправки пакета (По умолчанию 5) ; attemptCount = 5 ; Код команды (в hex формате) для запроса номера бонусной/дисконтной карты через терминал (По умолчанию 0xF1) ; discountCardCommand = 0xF1 ; Печатать журнал операций (По умолчанию true) ; printOperationJournal = true
Печать отчета из архива
Для возможности печати отчета из архива на пин-паде Yarus необходимо в утилите администрирования Yuki на клавишу или пункт меню настроить действие "Печать отчета из архива" с командой COMMAND_EMV_PRINTREPORT
и параметром valutcode
с указанием кода валюты. О настройке действий подробнее можно прочитать в разделе "Настройка действий".
Таймаут ожидания отчета с пин-пада определяется параметром timeout
в конфигурационном файле /linuxcash/cash/paysystems/yarus/artixyarus.conf
.
Команда печати может быть вызвана по нажатию клавиши в контексте открытого документа или через пункт из главного меню.
При вызове на экран кассира выводится сообщение "Выполняется печать отчета". Кассовая программа открывает порт для печати. Необходимо выбрать на пин-паде нужный отчет и отправить на печать. Отчет будет напечатан на ФР.
Касса ожидает печать отчета в течение таймаута, затем сообщение закрывается. Если в течение установленного таймаута печать отчета на пин-паде не была запущена, то на экран выводится диалоговое сообщение "Не удалось напечатать отчет: Истек таймаут ожидания. Повторить?". Ошибка записывается также в terminal.log
.
Печать отчета по безналу
Для возможности печати отчета по безналу на пин-паде Yarus необходимо в утилите администрирования Yuki на пункт меню настроить действие "Печать отчета по безналу" с командой COMMAND_EMV_PRINTREPORT
и параметром valutcode
с указанием кода валюты. О настройке действий подробнее можно прочитать в разделе "Настройка действий".
Сохранение сверки итогов по безналу возможно для процессинга только при включенной настройке saveTotalsReports
. Отчет сверки итогов по безналу сохраняется в БД Documents
таблицу Report
в поле name
с именем processing
.t
otals
, журнал операций – processing.journal
.
Печать краткого отчета по безналу
Для возможности печати краткого отчета по безналу на пин-паде Yarus необходимо в утилите администрирования Yuki на пункт меню настроить действие "Печать краткого отчета по безналу" с командой COMMAND_EMV_PRINTSHORTREPORT
и параметром valutcode
с указанием кода валюты. О настройке действий подробнее можно прочитать в разделе "Настройка действий".
Логирование
Журнал вызовов процессинга из кассовой программы ведется в основном логе /linuxcash/logs/current/terminal.log
. Для идентификации данных, которые записаны данным модулем, используется логгер с именем payment
. В журнал заносятся параметры вызова, результат выполнения и образ слипа, который предназначен для печати.