Переход с ККМ-Сервера

HW Connector или ККМ-Сервер

Если касса или 1С уже работают с ККМ-Сервером, переходить можно без правки кода: агент принимает те же JSON-команды на том же порту 5893, а устройства переносит из настроек ККМ-Сервера одной кнопкой.

Чем отличается

	HW Connector	ККМ-Сервер
Продажа одной операцией	`POST /api/v1/checkouts`: оплата картой → чек → слип; если чек не напечатан, оплата отменяется сама	Порядок «оплата → чек → отмена» ведёт программа кассы
Повтор после обрыва связи	Ключ идемпотентности у каждой операции: повтор не проведёт оплату и чек второй раз; журнал операций переживает перезапуск	`IdCommand` и `GetRezult`
ККТ без драйверов производителя	Штрих-М и совместимые, Пирит и Вики Принт, КИТ — по протоколу напрямую; АТОЛ — через ДТО10	Свои драйверы для большинства ККТ
Банковские терминалы	INPAS, Сбербанк, ARCUS 2, UCS, ТТК2, СБП Т-Банк и Сбербанк	Сопоставимый набор
Весы	Масса-К, Штрих-М, АТОЛ, CAS, Mertech, режим потока веса	Масса-К, Штрих-М, АТОЛ
Принтеры этикеток и билетов	ZPL, TSPL, EZPL, Boca FGL и ESC/POS без драйвера, PDF на принтеры Windows	Принтеры Windows и чековые
Одна ККТ на несколько мест	«ККТ на другом компьютере»: агент шлёт чеки агенту, к которому подключена ККТ, по сети с токеном	Есть
Системы	Windows (MSI, нативная сборка без Java), Linux (deb, rpm), macOS (dmg)	Windows, Linux, macOS (.NET)
Где ККМ-Сервер сильнее	Эвотор как ККТ, проверка кодов маркировки и ТС ПИоТ, внешняя компонента для «1С: Библиотеки подключаемого оборудования», годы работы у тысяч клиентов. У HW Connector для 1С — своя внешняя обработка через HTTP и совместимость с HTTP API ККМ-Сервера.

Как перейти

Установите HW Connector на компьютер кассира (скачать — в личном кабинете).
На странице агента http://localhost:7790/ нажмите «Перенести из ККМ-Сервера»: агент найдёт Settings\SettingsServ.ini или попросит выбрать файл, покажет, что перенесётся, и сохранит ККТ, терминалы, весы, дисплеи QR и сканеры с портами и паролями. Номера устройств (NumDevice) сохраняются.
Проверьте связь с каждым устройством кнопкой «Проверить». Для АТОЛ нужен драйвер ДТО10 x64, для INPAS — DualConnector, для Сбербанка — UPOS.
Остановите ККМ-Сервер и включите у агента совместимость — в config\application.yml:
```
hw:
  kkm-server:
    enabled: true
    port: 5893
    user: User
    password: ""   # тот же пароль, что был у ККМ-Сервера
```
и перезапустите агент. Программа кассы продолжит слать команды на http://localhost:5893/Execute.
Если касса в браузере, добавьте её адрес в «Разрешённые сайты» на вкладке «Рабочее место» агента.
Пробейте тестовый чек и вернитесь к оплатам: UniversalID оплат, проведённых через ККМ-Сервер, подходит для возврата через агент — формат тот же.

Команды, которые выполняет агент: List, GetRezult, GetDataKKT, OpenShift, CloseShift, ZReport, XReport, OfdReport, OpenCashDrawer, DepositingCash, PaymentCash, RegisterCheck (приход, возврат, расход, коррекция, нефискальный, с оплатой через терминал), PrintDocument, GetCounters, GetDataCheck, PayByPaymentCard, ReturnPaymentByPaymentCard, CancelPaymentByPaymentCard, EmergencyReversal, Settlement, TerminalReport, GetWeight, Calibrate, OutputOnCustomerDisplay, ClearCustomerDisplay. Сканер работает событиями barcode вместо GetBarcode. Новые программы удобнее писать на родном API агента — справка и Swagger.

Зарегистрироваться Скачать