<< Click to Display Table of Contents >> Navigation:  Дополнительные функции > Интеграция с банковским терминалом > Инструкции по подключению банковских терминалов > InpasEcrCom

Инструкция по подключению POS-терминалов по протоколу InpasEcrCom

Технология подключения банковского терминала по протоколу InpasEcrCom используется для подключения терминалов Международного Резервного банка (МР Банк - бывший Сбербанк Украина) (на примере Verifon VX 520). Также по информации от разработчика по данному протоколу работают терминалы банков: ТАСКОМБАНК, АЙБОКС БАНК, АЛЬФА-БАНК (только терминалы PAX), МЕГАБАНК, ПРАВЕКС БАНК , Укрексімбанк , ОТП БАНК.

Для подключения терминала по данному протоколу требуется, чтобы на локальном компьютере(к которому подключен терминал) был установлен соответствующий драйвер, а на компьютере с Торгсофт должен быть файл библиотеки InpasEcrCom.dll. Драйвера и библиотеки предоставляются банком. Также банком предоставляется эмулятор кассы, с помощью которого можно протестировать подключение и работу терминала.

Библиотека должна быть зарегистрирована, для чего в комплекте поставки должен быть файл RegEcrCom.bat. Файл должен находиться в той же папке, что и библиотека.

Чтобы зарегистрировать СОМ-объект для WIN OS (для регистрации) - в файле RegEcrCom.bat разработчик рекомендует вместо %SystemRoot% прописать явный путь

Пример:

C:\Windows\Microsoft.NET\Framework\v4.0.30319\regasm

C:\InpasEcrCom\InpasEcrCom.dll

/tlb:C:\InpasEcrCom\InpasEcrCom.tlb /codebase

 

Настройка подключения терминала

Подключение терминала возможно как по COM/USB так и по Ethernet (для терминалов МР-Банка порт по умолчанию 5555, так установлено в их эмуляторе кассы). При использовании подключения по COM/USB при установке драйвера по умолчанию терминал подключается на порт COM9 (Рис. 1).

Рис. 1

 

Подключение терминала Verifone по COM/USB выполняется с помощью обычного USB<->miniUSBкабеля.

Проверка подключения терминала с помощью эмулятора кассы InpasEcrComTest

Для проверки терминала с помощью данного эмулятора следует запустить файл InpasEcrComTest.exe, который поставляется банком вместе с драйверами и библиотекой (Рис. 2).

Рис. 2

 

Настройка подключения выполняется нажатием специальной кнопки. В открывшейся форме выбирается тип подключения и вводятся необходимые параметры. Параметр Контролировать сигнал не является обязательным, его можно оставить пустым.

Особенностью работы терминала по данному протоколу является то, что в случае совмещения терминала с ПК, терминал, возможно, не будет работать в ручном режиме. Т.е. все основные команды на выполнение операций должны генерироваться программой.

После ввода параметров следует нажать кнопку Подключить. В случае успешного подключения окно эмулятора кассы будет иметь следующий вид (Рис. 3).

Рис. 3

 

Важно. Возможна ситуация, когда терминал не переведен банком в режим работы совмещения с кассой. В этом случае все последующие операции, выполняемые на эмуляторе могут возвращать ошибку Е:0005:0005, а терминал визуально никак не будет реагировать на вызываемые операции. Подтверждением такой ситуации также может служить тот факт, что будет доступна работа терминала в ручном режиме. Если включен режим работы совмещения с кассой, то на экране терминала должна отображаться надпись ОЧІКУВАННЯ ККМ, а возможность ручной работы будет заблокирована (не обязательно). Перед тем, как будет продолжена настройка совмещения с кассой, банком должен быть включен соответствующий режим работы терминала.

Для выполнения операций Оплата, Возврат и Отмена следует выбрать тип операции Обычные операции DC4, а для операции Закрытие дня - Административные операции.

Параметр Имя торговца это аналог номера мерчанта для других протоколов, можно оставить пустым.

 

Подключение терминала Verifone в Торгсофт (на примере терминала от МР Банка)

Форма настройки банковского терминала (Рис. 4).

Рис. 4

 

Выбирается соответствующий протокол (можно сначала выбрать тип терминала и протокол подставится автоматически), вводится номер COM-порта (или IP и порт). Значение поля Таймаут для данного протокола устанавливается в секундах. Это время в секундах, в течение которого будет выполнятся попытка подключения терминала. Рекомендуется не оставлять для этого поля значение, равное 0 (желательно оставить 1-5 сек).

Параметр Рабочий каталог содержит путь к каталогу, в котором будет сохраняться лог работы терминала, а также должен находится файл настроек pinpad.ini. Это текстовый файл, который создается вручную и должен содержать следующую информацию:

[Connection]

PinpadLog=1

 

[Tag06]

SuccsessCode = 000,OK,OFF,Y1,Y2,Y3

Параметр PinpadLog может принимать значение 1 или 0 и, соответственно включает или выключает режим ведения лога. Если установлено 0 — лог вестись не будет.

Параметр SuccsessCode - это перечень успешных кодов результата операции. В приведенном примере — это успешные коды по умолчанию. Значение успешных кодов ответа у процессинговых систем (банков) могут быть различные, поэтому в каждом конкретном случае их следует узнать в банке и занести в виде строки с разделителем запятая.

Ведение лога имеет особенность. Для каждой операции терминала создается свой файл лога с именем InpasEcrComLog_ЧЧ_ММ_СС.txt, где ЧЧ_ММ_СС — время выполнения операции. Логи сохраняются в течение всего сеанса работы Торгсофт. При открытии нового сеанса Торгсофт при выполнении первой операции на терминале все "старые" логи будут удаляться.

Форма настройки мерчанта (операции) банковcкого терминала (Рис. 5).

Рис. 5

В случае с протоколом InpasEcrСom вместо порядкового номера мерчанта(кода операции) в соответствующее поле вводится Имя торговца (аналог мерчанта для BPOS), который может содержать не только цифры, но и буквы. Список торговцев можно получить в банке. Поле можно оставить пустым, если на терминале зарегистрирован только один торговец. Тип операции доступен только один - Оплата_Возврат.

Форма настройки дополнительных операций банковского терминала (Рис. 6).

Рис. 6

 

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

Операция Отмена служит для отмены операции текущего дня (до выполнения операции Закрытие дня). При выполнении операции требуется ввести сумму отменяемой операции и номер чека. Данная операция может полезной в случае, если оплата через банковский терминал прошла, а в Торгсофт по какой-то причине не зафиксировалась. Выполнение даной операции не создает никаких финансовых документов и на учет движения денежных средств в Торгсофт не влияет.

Важно! Данный протокол имеет две особенности при выполнении операции Возврат:

При выполнении возврата требуется на терминале ввести Номер кассира и Пароль кассира. Данную информацию должен предоставить банк.

Необходимым параметром для возврата является Код авторизации. Чтобы его не вводить вручную с чека (а специально он не сохраняется) значение данного параметра сохраняется в поле, в котором хранится RRN. В финансовом документе это выглядит следующим образом (Рис. 7).

Рис. 7

 

Формат значения поля: RRN_Код авторизации. На вывод информации в чек это не влияет.

Рис. 8

Важно! Для данного протокола в справочнике Валюта должен быть указан международный код валюты (Рис. 9), с которой выполняется операция на банковском терминале.

Рис. 9