Switching from KKM-Server

HW Connector or KKM-Server

If your POS or 1C already works with KKM-Server, you can switch without changing code: the agent accepts the same JSON commands on the same port 5893 and imports devices from KKM-Server settings with one button.

What is different

	HW Connector	KKM-Server
Sale in one operation	`POST /api/v1/checkouts`: card payment → receipt → slip; if the receipt fails, the payment is cancelled automatically	The POS manages "payment → receipt → cancel" itself
Retry after a lost connection	An idempotency key on every operation: a retry never charges or prints twice; the operation journal survives restarts	`IdCommand` and `GetRezult`
Fiscal registers without vendor drivers	Shtrih-M and compatibles, Pirit and Viki Print, KIT — direct protocol; ATOL via DTO10	Own drivers for most models
Payment terminals	INPAS, Sberbank, ARCUS 2, UCS, TTK2, SBP (T-Bank, Sberbank)	A comparable set
Scales	Massa-K, Shtrih-M, ATOL, CAS, Mertech, continuous weight stream	Massa-K, Shtrih-M, ATOL
Label and ticket printers	ZPL, TSPL, EZPL, Boca FGL and ESC/POS without drivers, PDF to Windows printers	Windows and receipt printers
One register for several workplaces	"Register on another computer": the agent sends receipts to the agent the register is attached to, over the network with a token	Yes
Systems	Windows (MSI, native build without Java), Linux (deb, rpm), macOS (dmg)	Windows, Linux, macOS (.NET)
Where KKM-Server is stronger	Evotor as a register, marking code checks and TS PIoT, an add-in for the 1C Connected Equipment Library, years in production. HW Connector offers its own 1C data processor over HTTP and compatibility with the KKM-Server HTTP API.

How to switch

Install HW Connector on the cashier's computer (download in your account).
On the agent page http://localhost:7790/ click "Import from KKM-Server": the agent finds Settings\SettingsServ.ini or asks for the file, shows what will be imported and saves registers, terminals, scales, QR displays and scanners with their ports and passwords. Device numbers (NumDevice) are kept.
Check each device with the "Check" button. ATOL needs the DTO10 x64 driver, INPAS — DualConnector, Sberbank — UPOS.
Stop KKM-Server and enable compatibility in config\application.yml:
```
hw:
  kkm-server:
    enabled: true
    port: 5893
    user: User
    password: ""   # the same password KKM-Server had
```
and restart the agent. The POS keeps sending commands to http://localhost:5893/Execute.
If the POS runs in a browser, add its address to "Allowed sites" on the agent's Workplace tab.
Print a test receipt. UniversalID of payments made through KKM-Server works for refunds through the agent — the format is the same.

New integrations are easier on the agent's own API — see the help and Swagger.