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

Отчёты

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

POST report/settlement

Отчёт о текущем состоянии расчётов по ККТ.

URL: {{HTTPRoot}}/report/settlement

Тело запроса

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

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

Тип данных: Cashier

Имя поля Тип Обяз Назначение Пример
Name string - Имя кассира.

Если не указано — подставляется имя из настроек ККТ, иначе «Кассир».		 “Иванов А.И.”
Vatin string - ИНН кассира.

Если не указан — ИНН кассира в чеке не печатается.		 “7722345678”

Тело ответа

Успешный ответ (200 OK)

{
    "Result": {
        "datetime": "2026-05-24T04:19:36.2382553+08:00",
        "deviceName": "Atol",
        "docId": "08e4c202-8953-4b0a-9e9a-4ace823c4e84",
        "fnsUrl": "nalog.ru",
        "fnNumber": "0123123123123",
        "rnNumber": "00031415926",
        "fiscalDatetime": "20260524041936",
        "shiftNumber": 0
    },
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Поле Result

Тип: ReportResult

Имя поля Тип Назначение Пример
datetime datetime Время операции “2026-05-12T18:38:52”
deviceName string Имя устройства “Atol”
docId string Идентификатор документа “d4caa283-0438-4bff-8ccf-2d77a5014d7d”
fnsUrl string Адрес сайта уполномоченного органа (ФНС) в сети «Интернет» “nalog.ru”
fnNumber string Номер фискального накопителя “0123123123123”
rnNumber string РНМ “00031415926”
fiscalDatetime string Дата и время документа по часам ФН “20260523234515”
shiftNumber int Номер смены 0

Примеры ошибок

709 — Устройство не найдено

{
    "Code": 709,
    "Description": "Устройство не найдено: Устройство '{device}' не найдено.",
    "Success": false
}

4 — Не указано имя ККТ

{
    "Code": 4,
    "Description": "Не указано имя ККТ",
    "Success": false
}

-2 — Постановка в очередь печати

{
    "Code": -2,
    "Description": "Постановка в очередь печати",
    "Success": false
}

POST report/settlement/async

Асинхронно получить отчёт о текущем состоянии расчётов по ККТ.

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

Тело запроса

{
    "DeviceName": "{device}",
    "Cashier": {
        "Name": "Иванов",
        "Vatin": "7722345678"
    }
}

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

Тело ответа

Успешный ответ (200 OK)

{
    "Result": "d4caa283-0438-4bff-8ccf-2d77a5014d7d",
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Поле Result

Имя поля Тип Назначение Пример
Result string Результат “321581c0-2ebe-4f4e-bdf8-a932ad758dac”

Примеры ошибок

709 — Устройство не найдено

{
    "Code": 709,
    "Description": "Устройство не найдено: Устройство '{device}' не найдено.",
    "Success": false
}

4 — Не указано имя ККТ

{
    "Code": 4,
    "Description": "Не указано имя ККТ",
    "Success": false
}

-2 — Постановка в очередь печати

{
    "Code": -2,
    "Description": "Постановка в очередь печати",
    "Success": false
}

GET report/settlement?id={id}

Получение результата выполнения отчёта о состоянии расчётов

URL: {{HTTPRoot}}/report/settlement?id={id}

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

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

Тело ответа

Успешный ответ (200 OK)

{
    "Result": {
        "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": {
            "IsCountersReaded": true,
            "ShiftNumber": 41,
            "CashDrawer": {
                "Sum": 2165.68,
                "Count": 0
            },
            "ShiftIncome": {
                "Count": 0,
                "Sum": 0
            },
            "ShiftOutcome": {
                "Count": 0,
                "Sum": 0
            },
            "Counters": {
                "SumCorrection": 0,
                "NumberCorrections": 0,
                "Sales": {
                    "Count": 16,
                    "Sum": 800,
                    "Payments": {
                        "Sum": 0,
                        "Cash": 800
                    },
                    "Discount": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Adding": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Tax": {
                        "TaxVat_20": 133.28
                    }
                },
                "SalesReturn": {
                    "Count": 0,
                    "Sum": 0,
                    "Payments": {
                        "Sum": 0
                    },
                    "Discount": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Adding": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Tax": {}
                },
                "SalesCorrection": {
                    "Count": 0,
                    "Sum": 0,
                    "Payments": {
                        "Sum": 0
                    },
                    "Discount": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Adding": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Tax": {}
                },
                "SalesReturnCorrection": {
                    "Count": 0,
                    "Sum": 0,
                    "Payments": {
                        "Sum": 0
                    },
                    "Discount": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Adding": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Tax": {}
                },
                "Purchases": {
                    "Count": 0,
                    "Sum": 0,
                    "Payments": {
                        "Sum": 0
                    },
                    "Discount": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Adding": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Tax": {}
                },
                "PurchasesReturn": {
                    "Count": 0,
                    "Sum": 0,
                    "Payments": {
                        "Sum": 0
                    },
                    "Discount": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Adding": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Tax": {}
                },
                "PurchasesCorrection": {
                    "Count": 0,
                    "Sum": 0,
                    "Payments": {
                        "Sum": 0
                    },
                    "Discount": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Adding": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Tax": {}
                },
                "PurchasesReturnCorrection": {
                    "Count": 0,
                    "Sum": 0,
                    "Payments": {
                        "Sum": 0
                    },
                    "Discount": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Adding": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Tax": {}
                }
            }
        },
        "OverallTotals": {
            "DataLoaded": false,
            "Sum": 0,
            "Count": 0,
            "Counters": {
                "SumCorrection": 0,
                "NumberCorrections": 0,
                "Sales": {
                    "Count": 0,
                    "Sum": 1444796.3,
                    "Payments": {
                        "Sum": 0
                    },
                    "Discount": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Adding": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Tax": {}
                },
                "SalesReturn": {
                    "Count": 0,
                    "Sum": 21678.61,
                    "Payments": {
                        "Sum": 0
                    },
                    "Discount": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Adding": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Tax": {}
                },
                "SalesCorrection": {
                    "Count": 0,
                    "Sum": 0,
                    "Payments": {
                        "Sum": 0
                    },
                    "Discount": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Adding": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Tax": {}
                },
                "SalesReturnCorrection": {
                    "Count": 0,
                    "Sum": 0,
                    "Payments": {
                        "Sum": 0
                    },
                    "Discount": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Adding": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Tax": {}
                },
                "Purchases": {
                    "Count": 0,
                    "Sum": 11008.5,
                    "Payments": {
                        "Sum": 0
                    },
                    "Discount": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Adding": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Tax": {}
                },
                "PurchasesReturn": {
                    "Count": 0,
                    "Sum": 2596.4,
                    "Payments": {
                        "Sum": 0
                    },
                    "Discount": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Adding": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Tax": {}
                },
                "PurchasesCorrection": {
                    "Count": 0,
                    "Sum": 0,
                    "Payments": {
                        "Sum": 0
                    },
                    "Discount": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Adding": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Tax": {}
                },
                "PurchasesReturnCorrection": {
                    "Count": 0,
                    "Sum": 0,
                    "Payments": {
                        "Sum": 0
                    },
                    "Discount": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Adding": {
                        "Count": 0,
                        "Sum": 0
                    },
                    "Tax": {}
                }
            },
            "CashDrawer": {
                "Sum": 0,
                "Count": 0
            }
        },
        "AnullatesCount": 0,
        "ShiftNumber": 41,
        "DocNumber": 366,
        "DocNumberInShift": 0,
        "FiscalSign": "5847203916",
        "Fn": "0123123123123",
        "FiscalDate": "2026-05-24T04:22:00+08:00",
        "CashierName": "Иванов А.И.",
        "CashierVatin": "7722345678",
        "DocumentHeader": {
            "OrganizationInfo": "ООО 'Ромашка'",
            "SerialNumber": "0020260207",
            "Vatin": "7722345678",
            "Cashier": "Иванов А.И.",
            "RnNumber": "00031415926",
            "Fn": "0123123123123",
            "FnsUrl": "www.nalog.gov.ru",
            "ShiftNumber": 41,
            "DocNumber": 366,
            "FiscalSign": "5847203916",
            "OfdOrganizationName": "Тестовый ОФД",
            "OfdVatin": "1234554321"
        },
        "SaleAddress": "г.Улан-Удэ, ул.Виноградная, д11А, офис 25",
        "SaleLocation": "Офис",
        "FfdVersion": "1.2",
        "Tlv": "1209,Номер версии ФФД:4\r\n1041,Номер ФН:0123123123123\r\n1037,Регистрационный номер ККТ:00031415926    \r\n1018,ИНН пользователя:7722345678  \r\n1040,Номер ФД:366\r\n1012,Дата, время:24.05.2026 04:22:00\r\n1077,ФПД:28-04-54-1B-A7-70\r\n1002,Признак автономного режима:false\r\n1097,Количество непереданных ФД:0\r\n1116,Номер первого непереданного документа:0\r\n1098,Дата первого из непереданных ФД:01.01.1970 00:00:00\r\n1038,Номер смены:41\r\n1157,Счетчики итогов ФН\r\n  1134,Количество чеков (БСО) со всеми признаками расчетов:272\r\n  1129,Счетчики операций «приход»\r\n    1135,Количество чеков (БСО) по признаку расчетов:248\r\n    1201,Общая итоговая сумма в чеках (БСО):1152031.45\r\n    1136,Итоговая сумма в чеках (БСО) наличными денежными средствами:97324.54\r\n    1138,Итоговая сумма в чеках (БСО) безналичными:0.71\r\n    1218,Итоговая сумма в чеках (БСО) предоплатами (авансами):1054706.00\r\n    1219,Итоговая сумма в чеках (БСО) постоплатами (кредитами):0.20\r\n    1220,Итоговая сумма в чеках (БСО) встречными предоставлениями:0.00\r\n    1139,Сумма НДС по ставке 20%:558.22\r\n    1140,Сумма НДС по ставке 10%:68.33\r\n    1143,Сумма расчетов с НДС по ставке 0%:26181.00\r\n    1183,Сумма расчетов без НДС:11046.00\r\n    1141,Сумма НДС по расч. ставке 20/120:0.00\r\n    1142,Сумма НДС по расч. ставке 10/110:0.00\r\n  1130,Счетчики операций «возврат прихода»\r\n    1135,Количество чеков (БСО) по признаку расчетов:14\r\n    1201,Общая итоговая сумма в чеках (БСО):3495.10\r\n    1136,Итоговая сумма в чеках (БСО) наличными денежными средствами:3494.49\r\n    1138,Итоговая сумма в чеках (БСО) безналичными:0.61\r\n    1218,Итоговая сумма в чеках (БСО) предоплатами (авансами):0.00\r\n    1219,Итоговая сумма в чеках (БСО) постоплатами (кредитами):0.00\r\n    1220,Итоговая сумма в чеках (БСО) встречными предоставлениями:0.00\r\n    1139,Сумма НДС по ставке 20%:0.00\r\n    1140,Сумма НДС по ставке 10%:0.10\r\n    1143,Сумма расчетов с НДС по ставке 0%:288.00\r\n    1183,Сумма расчетов без НДС:700.00\r\n    1141,Сумма НДС по расч. ставке 20/120:0.00\r\n    1142,Сумма НДС по расч. ставке 10/110:0.00\r\n  1131,Счетчики операций «расход»\r\n    1135,Количество чеков (БСО) по признаку расчетов:6\r\n    1201,Общая итоговая сумма в чеках (БСО):1350.50\r\n    1136,Итоговая сумма в чеках (БСО) наличными денежными средствами:0.00\r\n    1138,Итоговая сумма в чеках (БСО) безналичными:1350.50\r\n    1218,Итоговая сумма в чеках (БСО) предоплатами (авансами):0.00\r\n    1219,Итоговая сумма в чеках (БСО) постоплатами (кредитами):0.00\r\n    1220,Итоговая сумма в чеках (БСО) встречными предоставлениями:0.00\r\n    1139,Сумма НДС по ставке 20%:0.00\r\n    1140,Сумма НДС по ставке 10%:0.00\r\n    1143,Сумма расчетов с НДС по ставке 0%:1300.50\r\n    1183,Сумма расчетов без НДС:50.00\r\n    1141,Сумма НДС по расч. ставке 20/120:0.00\r\n    1142,Сумма НДС по расч. ставке 10/110:0.00\r\n  1132,Счетчики операций «возврат расхода»\r\n    1135,Количество чеков (БСО) по признаку расчетов:4\r\n    1201,Общая итоговая сумма в чеках (БСО):1040.40\r\n    1136,Итоговая сумма в чеках (БСО) наличными денежными средствами:0.00\r\n    1138,Итоговая сумма в чеках (БСО) безналичными:1040.40\r\n    1218,Итоговая сумма в чеках (БСО) предоплатами (авансами):0.00\r\n    1219,Итоговая сумма в чеках (БСО) постоплатами (кредитами):0.00\r\n    1220,Итоговая сумма в чеках (БСО) встречными предоставлениями:0.00\r\n    1139,Сумма НДС по ставке 20%:0.00\r\n    1140,Сумма НДС по ставке 10%:0.00\r\n    1143,Сумма расчетов с НДС по ставке 0%:1040.40\r\n    1183,Сумма расчетов без НДС:0.00\r\n    1141,Сумма НДС по расч. ставке 20/120:0.00\r\n    1142,Сумма НДС по расч. ставке 10/110:0.00\r\n  1133,Счетчики операций по чекам коррекции\r\n    1144,Количество чеков коррекции (БСО коррекции) или непереданных чеков (БСО) и чеков коррекции (БСО коррекции):0\r\n1158,Счетчики итогов непереданных ФД\r\n  1144,Количество чеков коррекции (БСО коррекции) или непереданных чеков (БСО) и чеков коррекции (БСО коррекции):0\r\n1213,Ресурс ключей ФП:423\r\n",
        "TaskType": 14,
        "DocId": "d4caa283-0438-4bff-8ccf-2d77a5014d7d",
        "Date": "2026-05-24T04:22:40.1783213+08:00",
        "TerminalId": "",
        "DeviceName": "Atol",
        "PoolId": "",
        "ResultCode": 0,
        "ResultDescription": "OK",
        "Processed": true,
        "ServerVersion": "4.0.62.521",
        "DeviceInfo": {
            "FfdVersion": "1.2",
            "FnFfdVersion": "1.2",
            "TimeZone": 7,
            "KktLicenses": [],
            "IsFiscal": true,
            "LineLength": 64,
            "LineLengthPixels": 576,
            "DeviceClass": 4,
            "Model": "АТОЛ FPrint-22ПТК",
            "SerialNumber": "00106305393630",
            "FirmwareVersion": "5.15.102",
            "ConfigurationVersion": "5.17.0"
        }
    },
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Поле Result

Тип: ReportSettlements

Имя поля Тип Назначение Пример
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”: {
“IsCountersReaded”: true,
“ShiftNumber”: 41,
“CashDrawer”: {
“Sum”: 2165.68,
“Count”: 0
},
“ShiftIncome”: {
“Count”: 0,
“Sum”: 0
},
“ShiftOutcome”: {
“Count”: 0,
“Sum”: 0
},
“Counters”: {}
}
}
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”
Tlv string Cтруктура значений тегов документа “1209,Номер версии ФФД:4\r\n1041,Номер ФН:9999078902010507\r\n1037,Регистрационный номер…”
Before List Заголовок []
After List Подвал []
TaskType int Тип чека:
Не используется = 0;
Продажа = 1;
Возврат = 2;
Покупка = 3;
ВозвратПокупки = 4;
ЧекКоррекцииПрихода = 5;
ЧекКоррекцииВозвратаПрихода = 6;
ЧекКоррекцииРасхода = 7;
ЧекКоррекцииВозвратаРасхода = 8.		 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”

Тип: OutputParameters

Имя поля Тип Назначение Пример
DepartmentTotals список типа данных Показатели отдела за смену []
NumberOfChecks int Количество кассовых чеков за смену 1
NumberOfDocuments int Количество общее ФД за смену 1
ResourcesFn int Срок действия ключей фискального признака 365
Backlog Тип данных Статус обмена данными с ОФД “Backlog”: {
“DocumentsCounter”: 0,
“DocumentFirstNumber”: 0,
“DocumentFirstDateTime”: “1970-01-01T00:00:00+08:00”
},
Warnings Тип данных Предупреждения ФН “Warnings”: {
“CriticalError”: false,
“MemoryOverflow”: false,
“NeedReplacement”: false,
“OfdTimeout”: false,
“ResourceExhausted”: false
},
ShiftNumber int Номер открытой смены/Номер закрытой смены 2
CheckNumber int Номер последнего фискального документа 3
ShiftClosingCheckNumber int Номер последнего чека за смену 1
DateTime DateTime Дата и время формирования фискального документа “2026-05-23T23:45:15.6391315+08:00”
ShiftState int Состояние смены:
1 — Закрыта;
2 - Открыта;
3 — Истекла		 2
CashBalance decimal Остаток наличных денежных средств в кассе 0.0
FnValidityDate decimal Срок действия ФН “2027-05-23T23:45:15.6391315+08:00”
DocumentsCounter long Количество непереданных документов 0

Тип: Backlog

Имя поля Тип Назначение Пример
DocumentsCounter int Количество непереданных документов 0
DocumentFirstNumber int Номер первого непереданного документ 0
DocumentFirstDateTime DateTime Дата и время первого из непереданных документов “0001-01-01T00:00:00”

Тип: Warnings

Имя поля Тип Назначение Пример
CriticalError bool Критическая ошибка ФН false
MemoryOverflow bool Память ФН переполнена false
NeedReplacement bool Требуется срочная замена ФН false
OfdTimeout bool Превышено время ожидания ответа от ОФД false
ResourceExhausted bool Исчерпан ресурс ФН false

Тип: DocumentHeader

Имя поля Тип Назначение Пример
OrganizationInfo string Информация об организации “ООО ‘Ромашка’“
SerialNumber string Заводской номер ККТ “0020260207”
Vatin string ИНН Организации “7722345678”
Cashier string Кассир “Иванов А.И.”
RnNumber string Регистрационный номер ККТ “00031415926”
Fn string Фискальный накопитель “0123123123123”
FnsUrl string Сайт ФНС “nalog.ru”
ShiftNumber int Номер смены 3
DocNumber int Номер фискального документа 5
FiscalSign string Фискальный признак документа “5847203916”
OfdOrganizationName string Наименование ОФД “Тестовый ОФД”
OfdVatin string ИНН ОФД “1234554321”

Тип: deviceInfo

Имя поля Тип Назначение Пример
FfdVersion string Версия ФФД “1.2”
FnFfdVersion string Версия ФФД ФН “1.2”
TimeZone int Часовая зона устройства 7
KktLicenses array Массив лицензий ККТ []
IsFiscal bool Фискальный true
LineLength int Ширина чековой ленты 64
LineLengthPixels int Ширина чековой ленты в пикселях 0
DeviceClass int Тип устройства: 1 — Принтер
2 — Чековый принтер
3 — Фискальный регистратор (не онлайн-ккм)
4 — Онлайн-ккм, применяемая в РФ в соответствии с ФЗ-54.
5 — Эквайринговый терминал
6 — Терминал сбора данных
7 — Электронные весы
8 — Электронные весы
9 — Сканер штрихкодов		 7
SerialNumber string Заводской номер ККТ “0020260207”
FirmwareVersion string Версия прошивки “2026”
ConfigurationVersion string Версия конфигурации прошивки устройства “02.07”

Тип: ShiftTotal

Имя поля Тип Назначение Пример
IsCountersReaded bool Прочитаны ли дополнительные счетчики ККМ true
ShiftNumber double Номер смены 3.0
CashDrawer Тип данных Данные о наличности в денежном ящике “CashDrawer”:
ShiftIncome Тип данных Внесение “ShiftIncome”:
ShiftOutcome Тип данных Выплата “ShiftOutcome”:
Counters Тип данных Чеки “Counters”: {
“SumCorrection”: 0,
“NumberCorrections”: 0,
“Sales”: {
“Count”: 16,
“Sum”: 800,
“Payments”: {
“Sum”: 0,
“Cash”: 800
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {
“TaxVat_20”: 133.28
}
},
“SalesReturn”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
},
“SalesCorrection”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
},
“SalesReturnCorrection”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
},
“Purchases”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
},
“PurchasesReturn”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
},
“PurchasesCorrection”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
},
“PurchasesReturnCorrection”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
}
}

Тип: CashDrawer

Имя поля Тип Назначение Пример
Sum decimal Сумма 0.0
Count int Количество 0

Тип: ShiftIncome

Имя поля Тип Назначение Пример
Count int Количество 0
Sum decimal Сумма 0.0

Тип: ShiftOutcome

Имя поля Тип Назначение Пример
Count int Количество 0
Sum decimal Сумма 0.0

Тип: Counters

Имя поля Тип Назначение Пример
SumCorrection decimal Сумма коррекций 0.0
NumberCorrections int Количество коррекций 0
Sales Тип данных Чеки прихода “Sales”: {
“Count”: 16,
“Sum”: 800,
“Payments”: {
“Sum”: 0,
“Cash”: 800
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {
“TaxVat_20”: 133.28
}
}
SalesReturn Тип данных Чеки возврата прихода “SalesReturn”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
}
SalesCorrection Тип данных Чеки коррекции прихода “SalesCorrection”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
}
SalesReturnCorrection Тип данных Чеки возврата прихода “SalesReturnCorrection”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
}
Purchases Тип данных Чеки расхода “Purchases”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
}
PurchasesReturn Тип данных Чеки возврата расхода “PurchasesReturn”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
}
PurchasesCorrection Тип данных Чеки расхода “PurchasesCorrection”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
}
PurchasesReturnCorrection Тип данных Чеки возврата расхода “PurchasesReturnCorrection”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
}

Тип: OverallTotals

Имя поля Тип Назначение Пример
DataLoaded bool Все ли данные успешно прочитаны из устройства true
Sum decimal Сумма 1365.68
Count int Количество 0
Counters Тип данных Чеки “Counters”: {
“SumCorrection”: 0,
“NumberCorrections”: 0,
“Sales”: {
“Count”: 0,
“Sum”: 1444796.3,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
},
“SalesReturn”: {
“Count”: 0,
“Sum”: 21678.61,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
},
“SalesCorrection”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
},
“SalesReturnCorrection”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
},
“Purchases”: {
“Count”: 0,
“Sum”: 11008.5,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
},
“PurchasesReturn”: {
“Count”: 0,
“Sum”: 2596.4,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
},
“PurchasesCorrection”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
},
“PurchasesReturnCorrection”: {
“Count”: 0,
“Sum”: 0,
“Payments”: {
“Sum”: 0
},
“Discount”: {
“Count”: 0,
“Sum”: 0
},
“Adding”: {
“Count”: 0,
“Sum”: 0
},
“Tax”: {}
}
}

Тип: Sales

Имя поля Тип Назначение Пример
Count int Количество 0
Sum decimal Сумма 50.0
Payments Тип данных Сумма оплат “Payments”: {
“Sum”: 0
},
Discount Тип данных Скидки “Discount”:
Adding Тип данных Надбавки “Adding”: {
“Count”: 0,
“Sum”: 0
},
Tax Тип данных Налоги “Tax”: {}

Тип: SalesReturn

Имя поля Тип Назначение Пример
Count int Количество 0
Sum decimal Сумма 0.00
Payments Тип данных Сумма оплат “Payments”: {
“Sum”: 0
},
Discount Тип данных Скидки “Discount”:
Adding Тип данных Надбавки “Adding”: {
“Count”: 0,
“Sum”: 0
},
Tax Тип данных Налоги “Tax”: {}

Тип: SalesCorrection

Имя поля Тип Назначение Пример
Count int Количество 0
Sum decimal Сумма 0.00
Payments Тип данных Сумма оплат “Payments”: {
“Sum”: 0
},
Discount Тип данных Скидки “Discount”:
Adding Тип данных Надбавки “Adding”: {
“Count”: 0,
“Sum”: 0
},
Tax Тип данных Налоги “Tax”: {}

Тип: SalesReturnCorrection

Имя поля Тип Назначение Пример
Count int Количество 0
Sum decimal Сумма 0.00
Payments Тип данных Сумма оплат “Payments”: {
“Sum”: 0
},
Discount Тип данных Скидки “Discount”:
Adding Тип данных Надбавки “Adding”: {
“Count”: 0,
“Sum”: 0
},
Tax Тип данных Налоги “Tax”: {}

Тип: Purchases

Имя поля Тип Назначение Пример
Count int Количество 0
Sum decimal Сумма 0.00
Payments Тип данных Сумма оплат “Payments”: {
“Sum”: 0
},
Discount Тип данных Скидки “Discount”:
Adding Тип данных Надбавки “Adding”: {
“Count”: 0,
“Sum”: 0
},
Tax Тип данных Налоги “Tax”: {}

Тип: PurchasesReturn

Имя поля Тип Назначение Пример
Count int Количество 0
Sum decimal Сумма 1365.68
Payments Тип данных Сумма оплат “Payments”: {
“Sum”: 0
},
Discount Тип данных Скидки “Discount”:
Adding Тип данных Надбавки “Adding”: {
“Count”: 0,
“Sum”: 0
},
Tax Тип данных Налоги “Tax”: {}

Тип: PurchasesCorrection

Имя поля Тип Назначение Пример
Count int Количество 0
Sum decimal Сумма 0.00
Payments Тип данных Сумма оплат “Payments”: {
“Sum”: 0
},
Discount Тип данных Скидки “Discount”:
Adding Тип данных Надбавки “Adding”: {
“Count”: 0,
“Sum”: 0
},
Tax Тип данных Налоги “Tax”: {}

Тип: PurchasesReturnCorrection

Имя поля Тип Назначение Пример
Count int Количество 0
Sum decimal Сумма 0.00
Payments Тип данных Сумма оплат “Payments”:
Discount Тип данных Скидки “Discount”: {
“Count”: 0,
“Sum”: 0
},
Adding Тип данных Надбавки “Adding”: {
“Count”: 0,
“Sum”: 0
},
Tax Тип данных Налоги “Tax”: {}

Тип: Payments

Имя поля Тип Назначение Пример
Sum decimal Общая сумма чеков 50.0
Cash decimal Сумма оплат наличными 50.0

Тип: Discount

Имя поля Тип Назначение Пример
Count int Количество 0
Sum decimal Сумма 0.0

Тип: Adding

Имя поля Тип Назначение Пример
Count int Количество 0
Sum decimal Сумма 0.0

Тип: Tax

Имя поля Тип Назначение Пример
TaxVat_5 decimal Налоги 0.0

Примеры ошибок

72 — Некорректный id

{
    "Code": 72,
    "Description": "Некорректный id",
    "Success": false
}

72 — Не указан id

{
    "Code": 72,
    "Description": "Не указан id",
    "Success": false
}

91 — Документ не найден

{
    "Code": 91,
    "Description": "Документ не найден",
    "Success": false
}

GET report/settlement/list?device={device}&from={from}&to={to}

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

URL: {{HTTPRoot}}/report/settlement/list?device={device}&from={from}&to={to}

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

Имя параметра Тип Обяз Назначение Пример
device string + Имя устройства. Atol
from DateTime + Начало даты отбора (формат: гггг-мм-дд). 2026-06-01
to DateTime + Конец даты отбора (формат: гггг-мм-дд). 2026-06-30

Тело ответа

Успешный ответ (200 OK)

{
    "Result": [
        {
            "ResultCode": 0,
            "ResultDescription": "OK",
            "Date": "2026-05-24T04:22:40",
            "DocId": "d4caa283-0438-4bff-8ccf-2d77a5014d7d",
            "ShiftNumber": 41,
            "DeviceName": "Atol",
            "TerminalId": ""
        },
        {
            "ResultCode": 0,
            "ResultDescription": "OK",
            "Date": "2026-05-21T16:58:39",
            "DocId": "cd272ee8-ec7d-4875-9a89-13dee70fa990",
            "ShiftNumber": 39,
            "DeviceName": "Atol",
            "TerminalId": ""
        },
        {
            "ResultCode": 0,
            "ResultDescription": "OK",
            "Date": "2026-05-21T16:58:28",
            "DocId": "771c2b65-99eb-490a-b0a9-1caa2d34c4d7",
            "ShiftNumber": 39,
            "DeviceName": "Atol",
            "TerminalId": ""
        },
        {
            "ResultCode": 0,
            "ResultDescription": "OK",
            "Date": "2026-05-21T16:58:17",
            "DocId": "07091262-03ad-49a0-8360-fc7a4c5cc09d",
            "ShiftNumber": 39,
            "DeviceName": "Atol",
            "TerminalId": ""
        },
        {
            "ResultCode": 0,
            "ResultDescription": "OK",
            "Date": "2026-05-21T16:58:06",
            "DocId": "9287bcef-a403-4559-98d9-6676bfb4e93f",
            "ShiftNumber": 39,
            "DeviceName": "Atol",
            "TerminalId": ""
        },
        {
            "ResultCode": 0,
            "ResultDescription": "OK",
            "Date": "2026-05-21T16:57:55",
            "DocId": "2445dcfc-caf7-40f8-a397-076c4923bad7",
            "ShiftNumber": 39,
            "DeviceName": "Atol",
            "TerminalId": ""
        },
        {
            "ResultCode": 0,
            "ResultDescription": "OK",
            "Date": "2026-05-21T16:57:44",
            "DocId": "910dfc72-3a69-426d-b437-d42d9d0022ca",
            "ShiftNumber": 39,
            "DeviceName": "Atol",
            "TerminalId": ""
        },
        {
            "ResultCode": 0,
            "ResultDescription": "OK",
            "Date": "2026-05-21T16:57:34",
            "DocId": "a4de574d-41d5-40ab-8699-d10a14679d51",
            "ShiftNumber": 39,
            "DeviceName": "Atol",
            "TerminalId": ""
        },
        {
            "ResultCode": 0,
            "ResultDescription": "OK",
            "Date": "2026-05-21T16:57:23",
            "DocId": "0352c36e-b5b4-4cf0-8bed-1af671b50777",
            "ShiftNumber": 39,
            "DeviceName": "Atol",
            "TerminalId": ""
        }
    ],
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Поле Result

Тип: массив ReportsResponse

Имя поля Тип Назначение Пример
ResultCode int Результат 0
ResultDescription string Описания результата “OK”
Date DateTime Дата создания документа “2026-05-24T00:11:23.5221437+08:00”
DocId string Идентификатор документа “7ccfb3d4-bc93-40c7-9e4d-aa1c8b0261b6”
ShiftNumber int Номер сессии 3
DeviceName string Имя устройства “Atol”
TerminalId string Идентификатор терминала, с которго пришел документ ”“

Примеры ошибок

72 — Некорректный интервал

{
    "Code": 72,
    "Description": "Некорректный интервал",
    "Success": false
}

4 — Не указано имя ККТ

{
    "Code": 4,
    "Description": "Не указано имя ККТ",
    "Success": false
}