# VirtualPos Hardware Bridge

> Источник: https://wiki.virtualpos.ru/hc/hardware/hwbridge  
> Обновлено: 2026-10-07  
> Где в программе: Кассовый компьютер → Пуск → VirtualPos Hardware Bridge

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

## Общее описание

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

- *Служба* **Нужна** — Фискальный регистратор АТОЛ, ШТРИХ-М или Viki Print; банковский терминал Сбербанка, ВТБ, 2can или INPAS с типом «через бридж»; весы у кассы; двухстрочный дисплей покупателя; УТМ ЕГАИС.
- *Служба* **Не нужна** — Режим «Товарные чеки», автономный банковский терминал, терминал SmartPOS, терминал INPAS с типом «DualConnector HTTP», регистратор АТОЛ с типом «АТОЛ Web Requests (ДТО 10)», сканер штрихкодов, «Экран покупателя» на втором мониторе.

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

## Установка

> **Скачать:**
> **Скачать VirtualPos Hardware Bridge**: <https://core.virtualpos.ru/updates/files/viphwbridge_setup.zip>

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

![Запуск установки](https://wiki.virtualpos.ru/_media/hc/hardware/pasted/20150615-152529.png)

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

![Выбор папки](https://wiki.virtualpos.ru/_media/hc/hardware/pasted/20150615-152544.png)

![Установка](https://wiki.virtualpos.ru/_media/hc/hardware/pasted/20150615-152554.png)

![Завершение установки](https://wiki.virtualpos.ru/_media/hc/hardware/pasted/20150615-152604.png)

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

![Ошибка замены файла](https://wiki.virtualpos.ru/_media/hc/hardware/pasted/20231213-172451.png)

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

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

- **Запустить сервис** — Останавливает работающую службу и запускает её заново
- **Остановить сервис** — Останавливает службу
- **Проверить работу сервиса** — Открывает в браузере проверочный адрес службы

![Группа VirtualPos Hardware Bridge в меню «Пуск»](https://wiki.virtualpos.ru/_media/hc/hardware/pasted/20150615-152829.png)

### Java для Viki Print

Только для регистраторов **Viki Print**: установите Java версии 8. С этими регистраторами работает отдельная часть службы, которая принимает запросы на порту `8081`. Подробнее — [Viki Print (Пирит)](https://wiki.virtualpos.ru/hc/hardware/fiscal/viki).

## Проверка службы

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

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

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

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

![Ответ работающей службы](https://wiki.virtualpos.ru/_media/hc/hardware/pasted/20150615-153345.png)

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

## Настройка кассы

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

1. Откройте на кассе **Управление → Настройка оборудования**.
1. Выберите тип устройства — появятся поля подключения.
1. В поле **«IP-адрес сервера»** укажите адрес компьютера со службой. Если служба стоит на этом же компьютере — `127.0.0.1`.
1. Если служба работает не на порту 8080, допишите порт через двоеточие: `127.0.0.1:8093`.
1. Нажмите **«Протестировать»**, затем **«Сохранить»**.

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

## Смена порта

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

php -S 127.0.0.1:8080 -t wwwroot

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

> **Важно:**
> **УТМ ЕГАИС.** Универсальный транспортный модуль по умолчанию занимает тот же порт 8080. Если УТМ установлен на кассовом компьютере, переведите Hardware Bridge на другой порт, например `8093`, и проверяйте службу по адресу `http://127.0.0.1:8093/api.php?a=hello`. Настройка УТМ на кассе — [ЕГАИС: продажа крепкого алкоголя](https://wiki.virtualpos.ru/hc/pos/kassa#егаиспродажа_крепкого_алкоголя).

## Работа по сети

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

- *Режим* **Локальный** — Оборудование, служба и браузер с кассой — на одном компьютере. В поле «IP-адрес сервера» — `127.0.0.1`.
- *Режим* **Сетевой** — Оборудование и служба — на одном компьютере, касса — на другом: на планшете или компьютере с другой операционной системой. Так же несколько касс могут печатать на одном регистраторе.

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

1. В файле `StartConsole.bat` замените адрес `127.0.0.1` на `0.0.0.0`:

php -S 0.0.0.0:8080 -t wwwroot

1. Перезапустите службу.
1. Разрешите входящие подключения к порту службы в брандмауэре Windows.
1. На кассе в поле **«IP-адрес сервера»** укажите адрес компьютера со службой в локальной сети, например `192.168.1.10`.

## Для специалистов

### Состав и запуск

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

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

- **АТОЛ, драйвер 10** — Тип на кассе «Атол USB (v.10)»
- **АТОЛ, драйвер 8** — Типы «Атол USB (v.8)» и «Атол TCP/IP»
- **ШТРИХ-М, драйвер ФР** — Типы «Штрих-ФР-К» и «Штрих-ON-LINE»
- **Драйвер весов АТОЛ** — Тип весов «Драйвер весов АТОЛ (вер. 8)»
- **Библиотека терминала Сбербанка** — Тип терминала «Сбербанк»
- **INPAS DualConnector** — Тип терминала «INPAS (через бридж)» — см. [Банковский терминал INPAS](https://wiki.virtualpos.ru/hc/hardware/pinpad/inpas)

Если нужный драйвер не установлен, касса показывает ошибку вида «Failed to create COM object …: Класс не зарегистрирован» — см. [Вопросы и ошибки](https://wiki.virtualpos.ru/hc/pos/faq#фискальный_регистратор).

### Обновление

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

- `http://127.0.0.1:8080/api.php?a=checkupdate` — Показывает текущую и последнюю доступную версию: поля `currentversion`, `lastversion`, `needupdate`
- `http://127.0.0.1:8080/api.php?a=update` — Скачивает и устанавливает последнюю версию. Если обновление не требуется, отвечает «Обновление не требуется»

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

### Файл настроек config.ini

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

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

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

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

- `paper_sale_mode` — Печать чека продажи на бумаге: `0` — всегда печатать (по умолчанию); `1` — не печатать, если указан email или телефон покупателя для электронного чека; `2` — никогда не печатать
- `paper_sale_ret_mode` — То же для чека возврата
- `check_email` — Адрес, на который отправляются электронные чеки, если кассир не указал контакт покупателя
- `disable_cut` — `1` — не отрезать чеки, независимо от настроек кассы
- `disable_feed` — `1` — не прогонять ленту после чека
- `override_vat_no` — Ставка НДС для всех продаж. Если указана, ставка из карточки товара не учитывается
- `print_tax_number_no` — `1` — печатать в чеке строку «без НДС» для товаров без НДС
- `encashment_after_shift` — `1` — регистратор обнуляет наличные в денежном ящике при закрытии смены (по умолчанию), `0` — не обнуляет

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

- `tax_type` — Только ШТРИХ-М. Код системы налогообложения в чеке: `1` — ОСН, `2` — УСН доход, `4` — УСН доход минус расход, `16` — ЕСХН, `32` — ПСН. `0` — использовать СНО, заданную в регистраторе
- `vat_number_0`, `vat_number_10`, `vat_number_18`, `vat_number_20`, `vat_number_no` — Только АТОЛ с драйвером 8. Номера налоговых ставок в таблице регистратора для НДС 0 %, 10 %, 18 %, 20 % и «без НДС»
- `payment_type_cash`, `payment_type_card`, `payment_type_credit`, `payment_type_tare`, `payment_type_coupon` — Только АТОЛ с драйвером 8. Номера типов оплаты в таблице регистратора
- `inpas_timeout` — Только терминал INPAS. Наибольшее время выполнения операции на терминале в секундах, по умолчанию `180`
- `enable_auto_update` — `0` — отключить обновление службы

> **Важно:**
> **Внимание.** Параметры `paper_sale_mode`, `override_vat_no` и `tax_type` меняют содержание фискального чека. Меняйте их, только если понимаете последствия, и проверяйте результат на первом чеке.

### Логи

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

Те же сведения доступны в панели управления без доступа к кассовому компьютеру — см. [Технологические журналы](https://wiki.virtualpos.ru/hc/pos/terminals#технологические_журналы) кассового места. При обращении в службу поддержки приложите журнал за день, когда возникла ошибка.

## Поиск неисправностей

1. Проверьте, что служба отвечает по проверочному адресу.
1. Сверьте поле **«IP-адрес сервера»** на кассе с адресом и портом службы.
1. Проверьте устройство в утилите производителя и сверьте COM-порт и скорость с настройками кассы.
1. Закройте утилиту производителя: пока она держит порт открытым, касса не может обратиться к устройству.

## Частые ошибки

| Сообщение | Причина | Что делать |
| --- | --- | --- |
| Не найден сервис работы с оборудованием. Пожалуйста укажите IP адрес фискального регистратора | Служба не запущена или в настройках кассы указан неверный адрес | Запустите службу, проверьте адрес и порт |
| Cоединение с сервисом периферии установить не удалось. Попробуйте запустить его вручную через Пуск -> VirtualPos Hardware Bridge -> Запустить сервис | Служба перестала отвечать во время работы либо браузер блокирует обращение к ней | Запустите службу. Если она работает, а касса её не видит — см. [Связь с оборудованием](https://wiki.virtualpos.ru/hc/pos/faq#связь_с_оборудованием) |
| Модель устройства […] не зарегистрирована в системе | Установлена старая версия службы, в которой нет нужного драйвера | Обновите службу |
| Не удалось обновить файл … т.к. он недоступен для записи | Нет прав на запись в папку службы | Дайте пользователю Windows права на запись в папку `ViPHWBridge` |

## Связанные разделы

- [Торговое оборудование](https://wiki.virtualpos.ru/hc/hardware/overview) — Что подключается к кассе и в каком порядке
- [Фискальный регистратор](https://wiki.virtualpos.ru/hc/hardware/fiscal) — Типы регистраторов, проверка и ошибки
- [Фискальные регистраторы АТОЛ](https://wiki.virtualpos.ru/hc/hardware/fiscal/atol) — Драйвер и подключение
- [Настройка рабочего места](https://wiki.virtualpos.ru/hc/pos/kassa) — Окно настроек оборудования на кассе
- [Вопросы и ошибки](https://wiki.virtualpos.ru/hc/pos/faq) — Ошибки связи с оборудованием