ТЕХНИЧЕСКАЯ ДОКУМЕНТАЦИЯ

Отчёты

> СерверККМ V4 > REST API > Работа с ККМ
Дата обновления: 17 августа 2026 г.

Формирование отчета о текущем состоянии расчетов

URL: {{HTTPRoot}}/report/settlement

Тело запроса

{
    "DeviceName": "{{SKKMDEVICE}}",
    "Cashier": {
        "Name": "Иванов А.И.",
        "Vatin": "7722345678"
    }
}
Имя поля Тип Обяз Назначение Пример
DeviceName string + Имя устройства “Atol”
Cashier Cashier – Сведения о кассире (продавце).

Если тип данных Cashier отсутствует или все его поля пустые, данные о кассире не передаются в чек.		 {“Name”: “Иванов А.И.”, “Vatin”: “7722345678”}

Тело ответа

Result (ReportResult)

Имя поля Тип Обяз Назначение Пример
datetime datetime - Время операции “2026-05-12T18:38:52”
deviceName string + Имя устройства “Atol”
docId string + Идентификатор документа отчёта о текущем состоянии расчётов. Передайте в GET-запрос report/settlement, чтобы получить отчёт о состоянии расчётов. “d4caa283-0438-4bff-8ccf-2d77a5014d7d”
fnsUrl string - Адрес сайта уполномоченного органа (ФНС) в сети «Интернет» “nalog.ru”
fnNumber string - Номер фискального накопителя “0123123123123”
rnNumber string - РНМ “00031415926”
fiscalDatetime string - Дата и время документа по часам ФН “20260523234515”
shiftNumber int + Номер смены 51
outputParameters OutputParametersV4 - Выходные параметры для документов “outputParameters”: {
“NumberOfChecks”: 2,
“NumberOfDocuments”: 2,
“ResourcesFn”: 365,
“ShiftNumber”: 51,
“CheckNumber”: 449,
“ShiftClosingCheckNumber”: 2,
“DateTime”: “2026-07-27T18:51:15.4799866+08:00”,
“ShiftState”: 1,
“CashBalance”: 2795.80,
“Backlog”: {
“DocumentsCounter”: 0,
“DocumentFirstNumber”: 0,
“DocumentFirstDateTime”: “0001-01-01T00:00:00”
},
“FnWarnings”: {
“CriticalError”: false,
“MemoryOverflow”: false,
“NeedReplacement”: false,
“OfdTimeout”: false,
“ResourceExhausted”: false
},
“FnValidityDate”: “2027-07-27T18:51:15.4799866+08:00”
}

Формирование отчета о текущем состоянии расчетов асинхронно

URL: {{HTTPRoot}}/report/settlement/async

Тело запроса

{
    "DeviceName": "{{SKKMDEVICE}}",
    "Cashier": {
        "Name": "Иванов А.И.",
        "Vatin": "7722345678"
    }
}

Смотрите документацию POST-запроса report/settlement

Тело ответа

Result

Имя поля Тип Обяз Назначение Пример
Result string + Идентификатор документа отчёта о текущем состоянии расчётов. Передайте в GET-запрос report/settlement, чтобы получить отчёт о состоянии расчётов. “321581c0-2ebe-4f4e-bdf8-a932ad758dac”

Возвращает отчёт о состоянии расчётов по идентификатору документа (docId), полученному в POST-запросе report/settlement.

URL: {{HTTPRoot}}/report/settlement?id=c17036da-f782-4d22-8f0d-e1b03f52ddaf

Параметры запроса

Имя параметра Тип Обяз Назначение Пример
id string + Идентификатор документа отчёта о текущем состоянии расчётов b0ce9370-4435-49f8-a5e8-9bc267a26f77

Тело ответа

Result (ReportSettlements)

Имя поля Тип Обяз Назначение Пример
outputParameters OutputParameters - Выходные параметры для документов “DepartmentTotals”: [],
“NumberOfChecks”: 16,
“NumberOfDocuments”: 18,
“Backlog”: {
“DocumentsCounter”: 0,
“DocumentFirstNumber”: 0,
“DocumentFirstDateTime”: “1970-01-01T00:00:00+08:00”
},
“Warnings”: {
“CriticalError”: false,
“MemoryOverflow”: false,
“NeedReplacement”: false,
“OfdTimeout”: false,
“ResourceExhausted”: false
},
“ResourcesFn”: 422,
“ShiftNumber”: 41,
“CheckNumber”: 366,
“ShiftClosingCheckNumber”: 16,
“DateTime”: “2026-05-24T04:22:48”,
“ShiftState”: 2,
“CashBalance”: 2165.68,
“FnValidityDate”: “2027-07-21T00:00:00”,
“DocumentsCounter”: 0
ShiftTotal ShiftTotal - Сменные итоги {“ShiftTotal”: {
“IsCountersReaded”: true,
“ShiftNumber”: 41,
“CashDrawer”: {
“Sum”: 2165.68,
“Count”: 0
},
“ShiftIncome”: {
“Count”: 0,
“Sum”: 0
},
“ShiftOutcome”: {
“Count”: 0,
“Sum”: 0
},
“Counters”: {}
}
}
OverallTotals OverallTotals Необнуляемые итоги {“OverallTotals”: {
“DataLoaded”: false,
“Sum”: 0,
“Count”: 0,
“Counters”: {
“SumCorrection”: 0,
“NumberCorrections”: 0,
“Sales”: {}
},
“CashDrawer”: {
“Sum”: 0,
“Count”: 0
}
}
}
AnullatesCount int - Количество аннулирваний 0
ShiftNumber int + Номер смены 3
DocNumber int + Номер фискального документа 5
DocNumberInShift int - Номер фискального документа за смену 1
FiscalSign string - Фискальный признак документа “4988644533”
Fn string - Серийный номер фискального накопителя “0123123123123”
FiscalDate DateTime - Время регистрации операции по часам ККМ. “2026-05-24T00:11:23.5505769+08:00”
CashierName string - Имя кассира “Иванов А.И.”
CashierVatin string - ИНН кассира “7722345678”
SaleAddress string - Адрес проведения расчетов “г.Улан-Удэ, ул.Виноградная, д11А, офис 25”
SaleLocation string - Место проведения расчетов “Офис”
FfdVersion string - Версия ФФД “1.2”
TaskType int - Тип чека:
0 — Текст
1 — Приход
2 — Возврат прихода
3 — Расход
4 — Возврат расхода
5 — Коррекция прихода
6 — Коррекция возврата прихода
7 — Коррекция расхода
8 — Коррекция возврата расхода
9 — Слип
10 — Фискализация
11 — Открытие смены
12 — Z-отчет
13 — X-отчет
14 — Отчет о состоянии расчетов
20 — Выемка
21 — Внесение
22 — Открытие денежного ящика		 11
DocId string + Идентификатор документа отчёта о текущем состоянии расчётов “7ccfb3d4-bc93-40c7-9e4d-aa1c8b0261b6”
Date DateTime - Дата создания документа “2026-05-24T00:11:23.5221437+08:00”
TerminalId string - Идентификатор терминала, с которго пришел документ ”“
DeviceName string + Имя устройства “Atol”
PoolId string + Пул, который назначен чеку ”“
ResultCode int - Результат 0
ResultDescription string - Описания результата “OK”
Processed bool - Признак удачного завершения обработки true
ServerVersion string - Версия сервера “4.0.62.521”

Список отчётов о состоянии расчётов по устройству за период.

URL: {{HTTPRoot}}/report/settlement/list?device={{SKKMDEVICE}}&from=2026-08-07&to=2026-08-13

Параметры запроса

Смотрите документацию GET-запроса shift/open/list

Тело ответа

Result (массив ReportsResponse)

Смотрите документацию GET-запроса shift/open/list