Денежный ящик

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

POST `cash/open`

Открытие денежного ящика

URL: {{HTTPRoot}}/cash/open

Тело запроса

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

Имя поля	Тип	Обяз	Назначение	Пример
DeviceName	string	+	Название устройства	“Atol”
Cashier	Тип данных	-	Сведения о кассире (продавце). Если тип данных Cashier отсутствует или все его поля пустые, данные о кассире в документ не попадают.	“Cashier”:

Поле Cashier

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

Тело ответа

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

{
    "Result": {
        "DrawerNumber": 1,
        "ShiftNumber": 41,
        "DocNumber": 369,
        "DocNumberInShift": 0,
        "FiscalSign": "5847203916",
        "Fn": "0123123123123",
        "FiscalDate": "2026-05-24T11:58:50",
        "CashierName": "Иванов А.И.",
        "CashierVatin": "7722345678",
        "DocumentHeader": {
            "OrganizationInfo": "ООО 'Ромашка'",
            "SerialNumber": "0020260207",
            "Vatin": "7722345678",
            "Cashier": "Иванов А.И.",
            "RnNumber": "0000000002005725",
            "Fn": "0123123123123",
            "FnsUrl": "nalog.ru",
            "ShiftNumber": 41,
            "DocNumber": 369,
            "FiscalSign": "5847203916",
            "OfdOrganizationName": "Тестовый ОФД",
            "OfdVatin": "1234554321"
        },
        "SaleAddress": "г.Улан-Удэ, ул.Виноградная, д11А, офис 25",
        "SaleLocation": "Офис",
        "FfdVersion": "1.2",
        "TaskType": 22,
        "DocId": "29461831-3d3f-4e5c-8dc1-2212e1c9871b",
        "Date": "2026-05-24T11:58:50.6898781+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

Тип: OpenDrawer

Имя поля	Тип	Назначение	Пример
DrawerNumber	int	Номер денежного ящика	1
ShiftNumber	int	Номер сессии	41
DocNumber	int	Номер фискального документа	5
DocNumberInShift	int	Номер фискального документа за смену	1
FiscalSign	string	Фискальный признак документа	“5847203916”
Fn	string	Серийный номер фискального накопителя	“0123123123123”
FiscalDate	DateTime	Время регистрации операции по часам ККМ.	“2026-05-24T00:11:23.5505769+08:00”
CashierName	string	Имя кассира	“Иванов А.И.”
CashierVatin	string	ИНН кассира	“7722345678”
DocumentHeader	Тип данных	Заголовок документа	“DocumentHeader”:
SaleAddress	string	Адрес проведения расчетов	“г.Улан-Удэ, ул.Виноградная, д11А, офис 25”
SaleLocation	string	Место проведения расчетов	“Офис”
FfdVersion	string	Версия ФФД	“1.2”
TaskType	int	Тип чека	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”
deviceInfo	Тип данных deviceInfo	“DeviceInfo”:

Тип: 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	Массив типа данных	Массив лицензий ККТ	“DeviceInfo”:
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”

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

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

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

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

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

49 — Устройство не активно

{
    "Code": 49,
    "Description": "Попытка обращения к отключенному устройству: Устройство '{device}' не активно.",
    "Success": false
}

GET `cash?device={device}`

Получение остатка наличных в денежном ящике

URL: {{HTTPRoot}}/cash?device={device}

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

Имя параметра	Тип	Обяз	Назначение	Пример
device	string	+	Имя устройства.	Atol

Тело ответа

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

{
    "Result": {
        "Sum": 4683.81
    },
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Поле Result

Тип: CashSum

Имя поля	Тип	Назначение	Пример
Sum	decimal	Остаток наличных в денежном ящике	4683.81

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

2 — Не найдено устройство

{
    "Code": 2,
    "Description": "Не найдено устройство с deviceName = {device}",
    "Success": false
}

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

{
    "Code": 2,
    "Description": "Bad Request",
    "Success": false
}

POST `cashin`

Регистрация операции внесения наличных в денежный ящик.

URL: {{HTTPRoot}}/cashin

Тело запроса

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

Имя поля	Тип	Обяз	Назначение	Пример
DeviceName	string	+	Имя устройства	“Atol”
Sum	decimal	+	Сумма внесения. Если указано значение меньше или равное 0, запрос завершается ошибкой	5
Cashier	Тип данных	-	Сведения о кассире (продавце). Если тип данных Cashier отсутствует или все его поля пустые, данные о кассире в документ не попадают.	“Cashier”:

Тип: Cashier

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

Тело ответа

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

{
    "Result": {
        "Sum": 5,
        "CashSum": 4688.81,
        "ShiftNumber": 9,
        "DocNumber": 108,
        "DocNumberInShift": 0,
        "FiscalSign": "5847203916",
        "Fn": "0123123123123",
        "FiscalDate": "2026-05-13T17:05:05",
        "CashierName": "Иванов А.И.",
        "CashierVatin": "7722345678",
        "DocumentHeader": {
            "OrganizationInfo": "ООО 'Ромашка'",
            "SerialNumber": "0020260207",
            "Vatin": "7722345678",
            "Cashier": "Иванов А.И.",
            "RnNumber": "00031415926",
            "Fn": "0123123123123",
            "FnsUrl": "nalog.ru",
            "ShiftNumber": 9,
            "DocNumber": 108,
            "OfdOrganizationName": "Тестовый ОФД",
            "OfdVatin": "1234554321"
        },
        "SaleAddress": "г.Улан-Удэ, ул.Виноградная, д11А, офис 25",
        "SaleLocation": "Офис",
        "FfdVersion": "1.0.5",
        "TaskType": 21,
        "DocId": "c9a7edab-5a0f-42a9-9ab4-937ad9990cc6",
        "Date": "2026-05-13T17:04:53.2838562+08:00",
        "TerminalId": "",
        "DeviceName": "Atol",
        "PoolId": "",
        "ResultCode": 0,
        "ResultDescription": "OK",
        "Processed": true,
        "ServerVersion": "4.0.61.427",
        "DeviceInfo": {
            "FfdVersion": "1.0.5",
            "FnFfdVersion": "1.0.5",
            "TimeZone": 7,
            "Licenses": [],
            "IsFiscal": true,
            "LineLength": 42,
            "LineLengthPixels": 384,
            "DeviceClass": 4,
            "Model": "АТОЛ 1Ф",
            "SerialNumber": "00109325182732",
            "FirmwareVersion": "5.8.1",
            "ConfigurationVersion": "5.8.17"
        }
    },
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Поле Result

Тип: CashIn

Имя поля	Тип	Назначение	Пример
Sum	decimal	Фактическая сумма внесения	5.0
CashSum	decimal	Сумма наличных в денежном ящике	5.0
ShiftNumber	int	Номер сессии	41
DocNumber	int	Номер фискального документа	5
DocNumberInShift	int	Номер фискального документа за смену	1
FiscalSign	string	Фискальный признак документа	“5847203916”
Fn	string	Серийный номер фискального накопителя	“0123123123123”
FiscalDate	DateTime	Время регистрации операции по часам ККМ.	“2026-05-24T00:11:23.5505769+08:00”
CashierName	string	Имя кассира	“Иванов А.И.”
CashierVatin	string	ИНН кассира	“7722345678”
DocumentHeader	Тип данных	Заголовок документа	“DocumentHeader”:
SaleAddress	string	Адрес проведения расчетов	“г.Улан-Удэ, ул.Виноградная, д11А, офис 25”
SaleLocation	string	Место проведения расчетов	“Офис”
FfdVersion	string	Версия ФФД	“1.2”
TaskType	int	Тип чека	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”
deviceInfo	Тип данных	“DeviceInfo”:

Тип: 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	Массив типа данных	Массив лицензий ККТ	[]
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”

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

72 — Сумма меньше или равна 0

{
    "Code": 72,
    "Description": "Сумма меньше или равна 0",
    "Success": false
}

49 — Устройство не активно

{
    "Code": 55,
    "Description": "Попытка обращения к отключенному устройству: Устройство '{device}' не активно.",
    "Success": false
}

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

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

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

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

14 — 24 часа кассовой смены истекли

{
    "Code": 14,
    "Description": "24 часа кассовой смены истекли",
    "Success": false
}

55 — Требуется открытая смена

{
    "Code": 55,
    "Description": "Требуется открытая смена",
    "Success": false
}

POST `cashin/async`

Асинхронно поставить операцию внесения наличных в очередь

URL: {{HTTPRoot}}/cashin/async

Тело запроса

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

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

Тело ответа

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

{
    "Result": "788eeda8-c2aa-4b51-8f39-db93d8e79b91",
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Поле Result

Имя поля	Тип	Назначение	Пример
Result	string	Идентификатор документа	“788eeda8-c2aa-4b51-8f39-db93d8e79b91”

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

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

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

72 — Сумма меньше или равна 0

{
    "Code": 72,
    "Description": "Сумма меньше или равна 0",
    "Success": false
}

49 — Устройство не активно

{
    "Code": 55,
    "Description": "Попытка обращения к отключенному устройству: Устройство '{device}' не активно.",
    "Success": false
}

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

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

GET `cashin/list?device={device}`

Получение истории операций внесения наличных по устройству.

URL: {{HTTPRoot}}/cashin/list?device={device}

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

Имя параметра	Тип	Обяз	Назначение	Пример
device	string	+	Имя устройства.	Atol

Тело ответа

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

{
    "Result": [
        {
            "Sum": 5,
            "CashSum": 4688.81,
            "ShiftNumber": 9,
            "DocNumber": 108,
            "DocNumberInShift": 0,
            "FiscalSign": "5847203916",
            "Fn": "0123123123123",
            "FiscalDate": "2026-05-13T17:05:05",
            "CashierName": "Иванов А.И.",
            "CashierVatin": "7722345678",
            "DocumentHeader": {
                "OrganizationInfo": "ООО 'Ромашка'",
                "SerialNumber": "00109325182732",
                "Vatin": "7722345678",
                "Cashier": "Иванов А.И.",
                "RnNumber": "00031415926",
                "Fn": "0123123123123",
                "FnsUrl": "nalog.ru",
                "ShiftNumber": 9,
                "DocNumber": 108,
                "OfdOrganizationName": "Тестовый ОФД",
                "OfdVatin": "1234554321"
            },
            "SaleAddress": "г.Улан-Удэ, ул.Виноградная, д11А, офис 25",
            "SaleLocation": "Офис",
            "FfdVersion": "1.0.5",
            "TaskType": 21,
            "DocId": "c9a7edab-5a0f-42a9-9ab4-937ad9990cc6",
            "Date": "2026-05-13T17:04:53.2838562+08:00",
            "TerminalId": "",
            "DeviceName": "Atol",
            "PoolId": "",
            "ResultCode": 0,
            "ResultDescription": "OK",
            "Processed": true,
            "ServerVersion": "4.0.61.427",
            "DeviceInfo": {
                "FfdVersion": "1.0.5",
                "FnFfdVersion": "1.0.5",
                "TimeZone": 7,
                "Licenses": [],
                "IsFiscal": true,
                "LineLength": 42,
                "LineLengthPixels": 384,
                "DeviceClass": 4,
                "Model": "АТОЛ 1Ф",
                "SerialNumber": "00109325182732",
                "FirmwareVersion": "5.8.1",
                "ConfigurationVersion": "5.8.17"
            }
        },
        {
            "Sum": 5000,
            "CashSum": 5004.94,
            "ShiftNumber": 9,
            "DocNumber": 103,
            "DocNumberInShift": 0,
            "FiscalSign": "5847203916",
            "Fn": "0123123123123",
            "FiscalDate": "2026-05-13T12:49:24",
            "CashierName": "Иванов А.И.",
            "DocumentHeader": {
                "OrganizationInfo": "ООО 'Ромашка'",
                "SerialNumber": "0020260207",
                "Vatin": "7722345678",
                "Cashier": "Иванов А.И.",
                "RnNumber": "00031415926",
                "Fn": "0123123123123",
                "FnsUrl": "nalog.ru",
                "ShiftNumber": 9,
                "DocNumber": 103,
                "OfdOrganizationName": "Тестовый ОФД",
                "OfdVatin": "1234554321"
            },
            "SaleAddress": "г.Улан-Удэ, ул.Виноградная, д11А, офис 25",
            "SaleLocation": "Офис",
            "FfdVersion": "1.0.5",
            "TaskType": 21,
            "DocId": "c6bdec98-c3a9-42f1-9950-19cfd35c3c36",
            "Date": "2026-05-13T12:49:11.8767798+08:00",
            "TerminalId": "",
            "DeviceName": "Atol",
            "PoolId": "",
            "ResultCode": 0,
            "ResultDescription": "OK",
            "Processed": true,
            "ServerVersion": "4.0.61.427",
            "DeviceInfo": {
                "FfdVersion": "1.0.5",
                "FnFfdVersion": "1.0.5",
                "TimeZone": 7,
                "Licenses": [],
                "IsFiscal": true,
                "LineLength": 42,
                "LineLengthPixels": 384,
                "DeviceClass": 4,
                "Model": "АТОЛ 1Ф",
                "SerialNumber": "00109325182732",
                "FirmwareVersion": "5.8.1",
                "ConfigurationVersion": "5.8.17"
            }
        }
    ],
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Поле Result

Тип: массив CashIn

Смотрите документацию GET-запроса cashin

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

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

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

GET `cashin?id={id}`

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

URL: {{HTTPRoot}}/cashin?id={id}

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

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

Тело ответа

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

{
    "Result": {
        "Sum": 5,
        "CashSum": 2019.85,
        "ShiftNumber": 41,
        "DocNumber": 369,
        "DocNumberInShift": 0,
        "FiscalSign": "5847203916",
        "Fn": "0123123123123",
        "FiscalDate": "2026-05-24T12:17:41",
        "CashierName": "Иванов А.И.",
        "CashierVatin": "7722345678",
        "DocumentHeader": {
            "OrganizationInfo": "ООО 'Ромашка'",
            "SerialNumber": "0020260207",
            "Vatin": "7722345678",
            "Cashier": "Иванов А.И.",
            "RnNumber": "00031415926",
            "Fn": "0123123123123",
            "FnsUrl": "nalog.ru",
            "ShiftNumber": 41,
            "DocNumber": 369,
            "FiscalSign": "5847203916",
            "OfdOrganizationName": "Тестовый ОФД",
            "OfdVatin": "1234554321"
        },
        "SaleAddress": "г.Улан-Удэ, ул.Виноградная, д11А, офис 25",
        "SaleLocation": "Офис",
        "FfdVersion": "1.2",
        "TaskType": 21,
        "DocId": "40b5b4c1-0040-4559-93e8-4e647f4a860b",
        "Date": "2026-05-24T12:17:40.2639607+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

Тип: CashIn

Имя поля	Тип	Назначение	Пример
Sum	decimal	Фактическая сумма внесения	5.0
CashSum	decimal	Сумма наличных в денежном ящике	5.0
ShiftNumber	int	Номер сессии	41
DocNumber	int	Номер фискального документа	5
DocNumberInShift	int	Номер фискального документа за смену	1
FiscalSign	string	Фискальный признак документа	“5847203916”
Fn	string	Серийный номер фискального накопителя	“0123123123123”
FiscalDate	DateTime	Время регистрации операции по часам ККМ.	“2026-05-24T00:11:23.5505769+08:00”
CashierName	string	Имя кассира	“Иванов А.И.”
CashierVatin	string	ИНН кассира	“7722345678”
DocumentHeader	Тип данных DocumentHeader	Заголовок документа	“DocumentHeader”:
SaleAddress	string	Адрес проведения расчетов	“г.Улан-Удэ, ул.Виноградная, д11А, офис 25”
SaleLocation	string	Место проведения расчетов	“Офис”
FfdVersion	string	Версия ФФД	“1.2”
TaskType	int	Тип чека	11
DocId	guid	Идентификатор документа	“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”
deviceInfo	Тип данных deviceInfo	“DeviceInfo”:

Тип: 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	Массив типа данных	Массив лицензий ККТ	[]
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”

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

72 — Не указан id

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

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

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

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

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

POST `cashout`

Проведение операции выемки наличных из денежного ящика.

URL: {{HTTPRoot}}/cashout

Тело запроса

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

Имя поля	Тип	Обяз	Назначение	Пример
DeviceName	string	+	Название устройства	“Atol”
Sum	decimal	+	Сумма выемки. Если указано значение меньше или равное 0, запрос завершается ошибкой. Если запрошенная сумма превышает фактический остаток наличных в денежном ящике, запрос завершается ошибкой “Недостаточно денег в денежном ящике”.	5
Cashier	Тип данных	-	Сведения о кассире (продавце). Если тип данных Cashier отсутствует или все его поля пустые, данные о кассире в документ не попадают.	“Cashier”:

Тип: Cashier

Имя поля	Тип	Обяз	Назначение	Пример
Name	string	-	ФИО кассира	“Иванов А.И.”
Vatin	string	-	ИНН кассира	“7722345678”

Тело ответа

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

{
    "Result": {
        "Sum": 5,
        "CashSum": 4683.81,
        "ShiftNumber": 9,
        "DocNumber": 108,
        "DocNumberInShift": 0,
        "FiscalSign": "5847203916",
        "Fn": "0123123123123",
        "FiscalDate": "2026-05-13T17:16:46",
        "CashierName": "Иванов А.И.",
        "CashierVatin": "7722345678",
        "DocumentHeader": {
            "OrganizationInfo": "ООО 'Ромашка'",
            "SerialNumber": "0020260207",
            "Vatin": "7722345678",
            "Cashier": "Иванов А.И.",
            "RnNumber": "00031415926",
            "Fn": "0123123123123",
            "FnsUrl": "nalog.ru",
            "ShiftNumber": 9,
            "DocNumber": 108,
            "OfdOrganizationName": "Тестовый ОФД",
            "OfdVatin": "1234554321"
        },
        "SaleAddress": "г.Улан-Удэ, ул.Виноградная, д11А, офис 25",
        "SaleLocation": "Офис",
        "FfdVersion": "1.0.5",
        "TaskType": 20,
        "DocId": "5f5e1295-1af8-4656-9e10-bcec64af0b72",
        "Date": "2026-05-13T17:16:34.5626773+08:00",
        "TerminalId": "",
        "DeviceName": "Atol",
        "PoolId": "",
        "ResultCode": 0,
        "ResultDescription": "OK",
        "Processed": true,
        "ServerVersion": "4.0.61.427",
        "DeviceInfo": {
            "FfdVersion": "1.0.5",
            "FnFfdVersion": "1.0.5",
            "TimeZone": 7,
            "Licenses": [],
            "IsFiscal": true,
            "LineLength": 42,
            "LineLengthPixels": 384,
            "DeviceClass": 4,
            "Model": "АТОЛ 1Ф",
            "SerialNumber": "00109325182732",
            "FirmwareVersion": "5.8.1",
            "ConfigurationVersion": "5.8.17"
        }
    },
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Поле Result

Тип: CashOut

Имя поля	Тип	Назначение	Пример
Sum	decimal	Фактическая сумма внесения	5.0
CashSum	decimal	Сумма наличных в денежном ящике	5.0
ShiftNumber	int	Номер сессии	41
DocNumber	int	Номер фискального документа	5
DocNumberInShift	int	Номер фискального документа за смену	1
CashierName	string	Имя кассира	“Иванов А.И.”
CashierVatin	string	ИНН кассира	“7722345678”
DocumentHeader	Тип данных DocumentHeader	Заголовок документа	“DocumentHeader”:
FiscalSign	string	Фискальный признак документа	“5847203916”
Fn	string	Серийный номер фискального накопителя	“0123123123123”
FiscalDate	DateTime	Время регистрации операции по часам ККМ.	“2026-05-24T00:11:23.5505769+08:00”
SaleAddress	string	Адрес проведения расчетов	“г.Улан-Удэ, ул.Виноградная, д11А, офис 25”
SaleLocation	string	Место проведения расчетов	“Офис”
FfdVersion	string	Версия ФФД	“1.2”
TaskType	int	Тип чека	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”
deviceInfo	Тип данных deviceInfo	“DeviceInfo”:

Тип: 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	Массив типа данных	Массив лицензий ККТ	[]
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”

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

78 — Недостаточно денег в денежном ящике

{
    "Code": 78,
    "Description": "Недостаточно денег в денежном ящике: atol2: драйвер: DeviceNetBase.Device.Atolv10FR: В ККТ нет денег для выплаты",
    "Success": false
}

72 — Сумма меньше или равна 0

{
    "Code": 72,
    "Description": "Сумма меньше или равна 0",
    "Success": false
}

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

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

49 — Устройство не активно

{
    "Code": 55,
    "Description": "Попытка обращения к отключенному устройству: Устройство '{device}' не активно.",
    "Success": false
}

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

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

14 — 24 часа кассовой смены истекли

{
    "Code": 14,
    "Description": "24 часа кассовой смены истекли",
    "Success": false
}

55 — Требуется открытая смена

{
    "Code": 55,
    "Description": "Требуется открытая смена",
    "Success": false
}

POST `cashout/async`

Асинхронно поставить операцию выемки наличных в очередь

URL: {{HTTPRoot}}/cashout/async

Тело запроса

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

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

Тело ответа

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

{
    "Result": "66da2237-6b87-4ca6-8c0b-b5264b7974b9",
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Поле Result

Имя поля	Тип	Назначение	Пример
Result	string	string	“788eeda8-c2aa-4b51-8f39-db93d8e79b91”

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

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

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

49 — Устройство не активно

{
    "Code": 55,
    "Description": "Попытка обращения к отключенному устройству: Устройство '{device}' не активно.",
    "Success": false
}

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

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

72 — Сумма меньше или равна 0

{
    "Code": 72,
    "Description": "Сумма меньше или равна 0",
    "Success": false
}

GET `cashout?id={id}`

Получение результата операции выемки наличных

URL: {{HTTPRoot}}/cashout?id={id}

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

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

Тело ответа

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

{
    "Result": {
        "Sum": 5,
        "CashSum": 0,
        "ShiftNumber": 0,
        "DocNumber": 0,
        "DocNumberInShift": 0,
        "Fn": "0123123123123",
        "FiscalDate": "0001-01-01T00:00:00",
        "CashierName": "Иванов А.И.",
        "CashierVatin": "7722345678",
        "DocumentHeader": {
            "OrganizationInfo": "ООО 'Ромашка'",
            "SerialNumber": "0020260207",
            "Vatin": "7722345678",
            "Cashier": "Иванов А.И.",
            "RnNumber": "00031415926",
            "Fn": "0123123123123",
            "FnsUrl": "nalog.ru",
            "ShiftNumber": 0,
            "OfdOrganizationName": "Тестовый ОФД",
            "OfdVatin": "1234554321"
        },
        "TaskType": 20,
        "DocId": "f26c26eb-720b-49d3-a5c5-7c9cafdd1e28",
        "Date": "2026-05-24T12:34:20.7516238+08:00",
        "TerminalId": "",
        "DeviceName": "Atol",
        "PoolId": "",
        "ResultCode": 0,
        "Processed": true,
        "ServerVersion": "4.0.62.521",
        "DeviceInfo": {
            "FfdVersion": "1.2",
            "FnFfdVersion": "1.2",
            "TimeZone": 7,
            "KktLicenses": [],
            "IsFiscal": true,
            "LineLength": 64,
            "LineLengthPixels": 512,
            "DeviceClass": 4,
            "Model": "АТОЛ FPrint-22ПТК",
            "SerialNumber": "0020260207",
            "FirmwareVersion": "2026",
            "ConfigurationVersion": "02.07"
        }
    },
    "Code": 0,
    "Description": "OK",
    "Success": true
}

Поле Result

Тип: CashOut

Имя поля	Тип	Назначение	Пример
Sum	decimal	Фактическая сумма внесения	5.0
CashSum	decimal	Сумма наличных в денежном ящике	5.0
ShiftNumber	int	Номер сессии	41
DocNumber	int	Номер фискального документа	5
DocNumberInShift	int	Номер фискального документа за смену	1
FiscalSign	string	Фискальный признак документа	“5847203916”
Fn	string	Серийный номер фискального накопителя	“0123123123123”
FiscalDate	DateTime	Время регистрации операции по часам ККМ.	“2026-05-24T00:11:23.5505769+08:00”
CashierName	string	Имя кассира	“Иванов А.И.”
CashierVatin	string	ИНН кассира	“7722345678”
DocumentHeader	Тип данных DocumentHeader	Заголовок документа	“DocumentHeader”:
SaleAddress	string	Адрес проведения расчетов	“г.Улан-Удэ, ул.Виноградная, д11А, офис 25”
SaleLocation	string	Место проведения расчетов	“Офис”
FfdVersion	string	Версия ФФД	“1.2”
TaskType	int	Тип чека	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”
deviceInfo	Тип данных deviceInfo	“DeviceInfo”:

Тип: 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	Массив типа данных	Массив лицензий ККТ	[]
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”

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

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

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

72 — Не указан id

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

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

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

Денежный ящик

POST cash/open

Тело запроса

Поле Cashier

Тело ответа

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

Поле Result

Тип: OpenDrawer

Тип: DocumentHeader

Тип: deviceInfo

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

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

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

49 — Устройство не активно

GET cash?device={device}

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

Тело ответа

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

Поле Result

Тип: CashSum

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

2 — Не найдено устройство

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

POST cashin

Тело запроса

Тип: Cashier

Тело ответа

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

Поле Result

Тип: CashIn

Тип: DocumentHeader

Тип: deviceInfo

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

72 — Сумма меньше или равна 0

49 — Устройство не активно

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

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

14 — 24 часа кассовой смены истекли

55 — Требуется открытая смена

POST cashin/async

Тело запроса

Тело ответа

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

Поле Result

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

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

72 — Сумма меньше или равна 0

49 — Устройство не активно

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

GET cashin/list?device={device}

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

Тело ответа

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

Поле Result

Тип: массив CashIn

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

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

GET cashin?id={id}

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

Тело ответа

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

Поле Result

Тип: CashIn

Тип: DocumentHeader

Тип: deviceInfo

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

72 — Не указан id

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

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

POST cashout

Тело запроса

Тип: Cashier

Тело ответа

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

Поле Result

Тип: CashOut

Тип: DocumentHeader

Тип: deviceInfo

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

78 — Недостаточно денег в денежном ящике

POST `cash/open`

GET `cash?device={device}`

POST `cashin`

POST `cashin/async`

GET `cashin/list?device={device}`

GET `cashin?id={id}`

POST `cashout`

POST `cashout/async`

GET `cashout?id={id}`