...
Плагин, по большей части, работает на клиентской стороне. Взаимодействие с терминалами производится через утилиты и настройки сбербанка на компьютере, где установлен клиент биллинга (рабочее место кассира). Серверная часть плагина используется для ведения истории платежей. Работа осуществляется через обращение к утилите через командную строку. Путь до неё на текущем локальном компьютере и до файлов, которые она генерирует, прописываются в настройках. Основная конфигурация производится в файле настройки клиента биллинга (файл client[_ru_RU].properties):
Блок кода | ||||
---|---|---|---|---|
| ||||
# полный путь до утилиты sb_pilot (под linux или windows), который принимает параметры согласно протокола # или же любой бинарник/скрипт его заменяющий #sbpilot.path.bin=/home/bill/sb-pilot/sb_pilot #sbpilot.path.bin=C:\sb-pilot\SB_PILOT.EXE sbpilot.path.bin=/home/bill/sb-pilot/dowindow.sh # полные пути до файлов e и p, которые создаются утилитой (см.документацию по системе sb_pilot) sbpilot.path.e=/home/bill/sb-pilot/e sbpilot.path.p=/home/bill/sb-pilot/cheque.txt # коннектор к серверу печати, для печати чека sbpilot.cashcheckserver.connector=127.0.0.1:9876 # пароль оператора к устройству для печати текста sbpilot.cashcheckserver.oppass=30 # включить принудительную отрезку чека в конце sbpilot.cashcheckserver.endcut=1 |
Для распечатки чека используется сервер печати cashcheck. Необходимо установить и настроить его согласно инструкции, приведённой в соответствующем разделе.
...
Настройка утилиты производится сотрудниками сбербанка и в данном руководстве не рассматривается. Помимо настройки связи с банком необходимо уточнить в какие места и под каким именем сохраняются выходные файлы (см. настройку в клиенте). Также нужно попросить настроить ширину генерируемого чека в соответствии с шириной ленты в используемом вами принтере чека. Для Linux имена файлов обычно e и cheque.txt, для windows — e и p.
Донастройка в Linux
Используется консольная linux-версия утилиты. Для справки: в каталоге этой версии программы находятся файлы sb_pilot, config, upnixmn.out и прочие.
...
Используется консольная win32-версия (иногда она называется у сотрудников сбербанка почему-то DOS). Работа происходит через командную строку, аналогичную командной строке linux-версии. Для справки: в каталоге этой версии программы находятся файлы SB_PILOT.EXE, pinpad.ini, updoscf.exe и прочие. Некоторая настройка также необходима для указания рабочих каталогов. Файл dowindow.bat может выглядеть так:
Блок кода | ||||
---|---|---|---|---|
| ||||
start /d c:\dos /wait c:\dos\sb_pilot.exe %1 %2 %3 %4 |
...
После этого не забудьте прописать в файле client.properties полные пути до файлов dowindow.bat, e, p.
Имеются данные, что конкретно эта утилита не работает корректно в 64-битной версии windows.
...
При установке и активации плагина в диалоге добавления платежа появляется галка "принять оплату по карте".
При попытке добавления платежа с установленной галочкой активируется диалог работы с утилитой и сама утилита.
После завершения работы утилиты успешно или же с ошибкой диалог можно закрыть.
На второй вкладке "Log" можно увидеть более подробную информацию о взаимодействии с утилитой. Если работа была завершена с ошибкой, то платёж не совершается и мы по-прежнему имеем дело с диалогом добавления платежа. Если оплата проведена успешно, то платёж совершается, диалог закрывается, в историю платежей заносится запись. В истории платежей (Плагины->SbPilot) также имеется возможность совершения дополнительных действий - отмены, повторы, некоторые отчёты итп.
Также обратите внимание на одну особенность: если пользоваться распределением средств на зависимых договорах (т.е. одним платежом инициировать занесение в разные договоры), то в логе припишется только к одному из платежей, а оплата и чек пробьётся на всю сумму изначального платежа.