Модуль "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числовой
  • 974
  • 933
  • 840
  • 978

Код валюты:

  • 974 – (BYR) Белорусский рубль,
  • 933 – (BYN) Белорусский рубль (новый код),
  • 840 – (USD) Доллар США,
  • 978 – (EUR) Евро.
По умолчанию 933
timeoutчисловой
Таймаут ожидания отчетаПо умолчанию 30 секунд
attemptCountчисловой
Количество попыток отправки пакетаПо умолчанию 5
discountCardCommandстроковый
Код команды (в hex формате) для запроса номера бонусной/дисконтной карты через терминалПо умолчанию 0xF1
printOperationJournalлогический
  • true
  • false
Печатать журнал операцийПо умолчанию 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.totals, журнал операций – processing.journal. 

Печать краткого отчета по безналу

Для возможности печати краткого отчета по безналу на пин-паде Yarus необходимо в утилите администрирования Yuki на пункт меню настроить действие "Печать краткого отчета по безналу" с командой COMMAND_EMV_PRINTSHORTREPORT и параметром valutcode с указанием кода валюты. О настройке действий подробнее можно прочитать в разделе "Настройка действий". 

Логирование

Журнал вызовов процессинга из кассовой программы ведется в основном логе /linuxcash/logs/current/terminal.log. Для идентификации данных, которые записаны данным модулем, используется логгер с именем payment. В журнал заносятся параметры вызова, результат выполнения и образ слипа, который предназначен для печати.

  • No labels