Раздел API

Обслуживание ККТ

Обслуживание всех ККТ рабочего места одной командой: паспорта ККТ (модель, прошивка, ФН, регистрация, часы), время по компьютеру, ставка НДС, реквизиты чека, X-отчёт и закрытие смены. Облако шлёт ту же команду группе касс — массовые операции. Мастер замены ФН — в разделе «ККТ».

POST	`/api/v1/kkt-service/actions`	Команда всем ККТ
GET	`/api/v1/kkt-service/inventory`	Паспорта ККТ

Команда всем ККТ#

POST/api/v1/kkt-service/actions

INFO — паспорт, CLOCK — время ККТ по компьютеру (смена закрыта; расхождение до 30 с не трогаем), VAT — основная ставка НДС в настройках ККТ (Штрих-М), REQUISITES — реквизиты чека рабочего места, X_REPORT — X-отчёт, CLOSE_SHIFT — закрыть смену. registers — номера ККТ, без него — все включённые. Ответ — результат по каждой ККТ

Тело запроса application/json обязательное

Поля · Request

originstring
firstAtstring date-time
lastAtstring date-time
requestsinteger int32

JSON

{
  "origin": "string",
  "firstAt": "2026-11-01T19:00:00+03:00",
  "lastAt": "2026-11-01T19:00:00+03:00",
  "requests": 1
}

Ответ 200 application/json

Поля · Response

actionstring
значения: INFO CLOCK VAT REQUISITES X_REPORT CLOSE_SHIFT
atstring date-time
okinteger int32
failedinteger int32
resultsмассив Result
3 поля · Result
- validboolean
- errorsмассив Issue
  8 полей · Issue
  - codestring
  - severitystring
    значения: ERROR WARNING
  - atstring date-time
  - registerinteger int32
  - terminalinteger int32
  - fdinteger int64
  - amountinteger int64
  - messagestring
- warningsмассив Issue
  8 полей · Issue
  - codestring
  - severitystring
    значения: ERROR WARNING
  - atstring date-time
  - registerinteger int32
  - terminalinteger int32
  - fdinteger int64
  - amountinteger int64
  - messagestring

Ошибки — problem+json с полем code, см. коды ошибок.

Пример запроса

curl

curl -X POST 'http://localhost:7790/api/v1/kkt-service/actions' \
  -H 'Content-Type: application/json' \
  --data '{"origin":"string","firstAt":"2026-11-01T19:00:00+03:00","lastAt":"2026-11-01T19:00:00+03:00","requests":1}'

curl

curl -X POST 'https://cloud.hw-connector.ru/agent/api/v1/kkt-service/actions' \
  -H 'X-Api-Key: hwk_…' \
  -H 'X-Device-Id: 42' \
  -H 'Content-Type: application/json' \
  --data '{"origin":"string","firstAt":"2026-11-01T19:00:00+03:00","lastAt":"2026-11-01T19:00:00+03:00","requests":1}'

Паспорта ККТ#

GET/api/v1/kkt-service/inventory

Модель, заводской номер, прошивка, ФФД, ФН и его срок, регистрационный номер, ИНН, часы ККТ — по каждой включённой ККТ; не ответившая — с полем error

Ответ 200 application/json

Массив · KktInfo

registerinteger int32
typestring
namestring
modelstring
serialNumberstring
firmwarestring
ffdstring
fnNumberstring
fnValidUntilstring date
fnDaysLeftinteger int64
registrationNumberstring
innstring
organizationstring
kktTimestring date-time
clockDriftSecondsinteger int64
errorstring

Ошибки — problem+json с полем code, см. коды ошибок.

Пример запроса

curl

curl 'http://localhost:7790/api/v1/kkt-service/inventory'

curl

curl 'https://cloud.hw-connector.ru/agent/api/v1/kkt-service/inventory' \
  -H 'X-Api-Key: hwk_…' \
  -H 'X-Device-Id: 42'