VirtualPos Hardware Bridge

Служба, через которую касса в браузере работает с фискальным регистратором, банковским терминалом, весами и дисплеем покупателя. Как установить службу, проверить её, перевести на другой порт и использовать по сети.

VirtualPos Hardware Bridge — небольшой веб-сервер на кассовом компьютере. Касса отправляет ему запросы по протоколу HTTP, а служба превращает их в вызовы драйвера производителя устройства. По умолчанию служба принимает запросы по адресу 127.0.0.1:8080.

Служба работает вместе с драйвером производителя, поэтому сначала установите драйвер устройства и проверьте его в утилите производителя.

1. Распакуйте архив и запустите setup.exe.

1. Пройдите шаги мастера установки. Служба устанавливается в папку C:\Program Files (x86)\ViPHWBridge.

1. Если появится сообщение об ошибке замены файла, нажмите «Пропустить».

1. Убедитесь, что у пользователя Windows есть права на запись в папку C:\Program Files (x86)\ViPHWBridge: служба записывает в неё логи и обновления.

После установки служба запускается сама и добавляется в автозагрузку текущего пользователя Windows. В меню Пуск появляется группа VirtualPos Hardware Bridge:

Только для регистраторов Viki Print: установите Java версии 8. С этими регистраторами работает отдельная часть службы, которая принимает запросы на порту 8081. Подробнее — Viki Print (Пирит).

Выберите в меню Пуск → VirtualPos Hardware Bridge → Проверить работу сервиса или откройте в браузере на кассовом компьютере адрес:

http://127.0.0.1:8080/api.php?a=hello

Работающая служба отвечает строкой с названием и номером версии:

{"message":"VirtualPOS Hardware Bridge","version":"134","success":true}

Для Viki Print проверочный адрес — http://127.0.0.1:8081/api.php?a=hello. Если страница не открывается, служба не запущена: нажмите «Запустить сервис».

После установки службы укажите её адрес на кассе.

Поле «IP-адрес сервера» есть у фискального регистратора, дисплея, банковского терминала и весов. Адреса могут быть разными, если устройства подключены к разным компьютерам.

Порт задаётся в файле C:\Program Files (x86)\ViPHWBridge\StartConsole.bat. По умолчанию в нём записана команда:

Замените 8080 на нужный порт, сохраните файл и перезапустите службу: Пуск → VirtualPos Hardware Bridge → Запустить сервис. Затем допишите порт в поле «IP-адрес сервера» на кассе.

Служба устанавливается на тот компьютер, к которому подключено оборудование, а касса может быть открыта на любом устройстве в той же локальной сети.

Чтобы служба принимала запросы из сети:

Служба — это встроенный веб-сервер PHP, запущенный из папки установки. За ним следит программа BridgeWatchDog: если процесс php завершился, она запускает службу заново. Ярлык «Запустить сервис» выполняет start.bat, ярлык «Остановить сервис» — stop.bat.

Служба обращается к драйверам производителей, установленным в Windows:

Если нужный драйвер не установлен, касса показывает ошибку вида «Failed to create COM object …: Класс не зарегистрирован» — см. Вопросы и ошибки.

Служба обновляется сама: при каждом запуске касса с подключённым фискальным регистратором просит службу проверить и установить новую версию. То же можно сделать вручную — запросами в браузере на кассовом компьютере:

Чтобы обновление установилось, у пользователя Windows должны быть права на запись в папку службы. Отключить обновление можно параметром enable_auto_update=0 в файле настроек.

Дополнительные параметры службы задаются в файле C:\Program Files (x86)\ViPHWBridge\wwwroot\config.ini. Файла по умолчанию нет: скопируйте образец config_example.ini из той же папки под именем config.ini и оставьте в нём нужные строки. При обновлении службы файл сохраняется.

Формат строки — параметр=значение;. Строки, которые начинаются с #, — комментарии.

# Не печатать бумажный чек, если покупателю отправляется электронный
paper_sale_mode=1;
# Не отрезать чек
disable_cut=1;

Параметры для регистраторов АТОЛ с драйвером 10:

Параметры для других драйверов:

Служба пишет журнал обращений к устройствам в папку C:\Program Files (x86)\ViPHWBridge\wwwroot\logs — отдельный файл на каждый день, например 20261006_hwbridge.log. Подробность журнала задаётся для кассового места: журнал может не вестись, содержать только ошибки, ошибки и предупреждения или все обращения. Если файл за нужный день пуст или его нет, попросите службу поддержки включить журнал для вашей кассы.

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