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

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

POST `cash/open`

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

URL: {{HTTPRoot}}/cash/open

Тело запроса

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

Имя поля	Тип	Обяз	Назначение	Пример
DeviceName	string	+	Имя устройства	“Atol”
Cashier	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	-	Заголовок документа	“DocumentHeader”:
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”
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	-	Часовая зона: 0 — Авто; 1 — 1 часовая зона (МСК-1 / UTC+2); 2 — 2 часовая зона (МСК / UTC+3); 3 — 3 часовая зона (МСК+1 / UTC+4); 4 — 4 часовая зона (МСК+2 / UTC+5); 5 — 5 часовая зона (МСК+3 / UTC+6); 6 — 6 часовая зона (МСК+4 / UTC+7); 7 — 7 часовая зона (МСК+5 / UTC+8); 8 — 8 часовая зона (МСК+6 / UTC+9); 9 — 9 часовая зона (МСК+7 / UTC+10); 10 — 10 часовая зона (МСК+8 / UTC+11); 11 — 11 часовая зона (МСК+9 / UTC+12)	7
KktLicenses	Массив KktLicenseInfo	-	Массив лицензий ККТ	[]
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”

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

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

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

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

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

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

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

GET `cash?device=Atol`

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

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

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

Имя параметра	Тип	Обяз	Назначение	Пример
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 = atol",
    "Success": false
}

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

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

POST `cashin`

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

URL: {{HTTPRoot}}/cashin

Тело запроса

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

Имя поля	Тип	Обяз	Назначение	Пример
DeviceName	string	+	Имя устройства	“Atol”
Sum	decimal	+	Сумма внесения. Если указано значение меньше или равное 0, запрос завершается ошибкой	5
Cashier	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	-	Заголовок документа	“DocumentHeader”:
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	+	Идентификатор операции внесения наличных. Передайте в GET-запрос cashin, чтобы получить результат внесения наличных.	“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	-	Часовая зона: 0 — Авто; 1 — 1 часовая зона (МСК-1 / UTC+2); 2 — 2 часовая зона (МСК / UTC+3); 3 — 3 часовая зона (МСК+1 / UTC+4); 4 — 4 часовая зона (МСК+2 / UTC+5); 5 — 5 часовая зона (МСК+3 / UTC+6); 6 — 6 часовая зона (МСК+4 / UTC+7); 7 — 7 часовая зона (МСК+5 / UTC+8); 8 — 8 часовая зона (МСК+6 / UTC+9); 9 — 9 часовая зона (МСК+7 / UTC+10); 10 — 10 часовая зона (МСК+8 / UTC+11); 11 — 11 часовая зона (МСК+9 / UTC+12)	7
KktLicenses	Массив KktLicenseInfo	-	Массив лицензий ККТ	[]
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”

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

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

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

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

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

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

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

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

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

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

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

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

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

POST `cashin/async`

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

URL: {{HTTPRoot}}/cashin/async

Тело запроса

{
  "DeviceName": "Atol",
  "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	+	Идентификатор документа операции внесения наличных. Данный идентфикатор можно использовать для GET-запроса cashin, чтобы получить более подробную информацию.	“788eeda8-c2aa-4b51-8f39-db93d8e79b91”

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

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

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

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

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

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

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

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

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

GET `cashin/list?device=Atol`

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

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

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

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

Тело ответа

200 OK

{
    "Result": [
        {
            "Sum": 5,
            "CashSum": 4688.81,
            "ShiftNumber": 9,
            "DocNumber": 108,
            "DocNumberInShift": 0,
            "FiscalSign": "4087338768",
            "Fn": "9999078902012910",
            "FiscalDate": "2026-05-13T17:05:05",
            "CashierName": "Иванов А.И.",
            "CashierVatin": "7722345678",
            "DocumentHeader": {
                "OrganizationInfo": "ООО 'Ромашка'",
                "SerialNumber": "00109325182732",
                "Vatin": "0326031413",
                "Cashier": "Иванов А.И.",
                "RnNumber": "0000000001002520",
                "Fn": "9999078902012910",
                "FnsUrl": "nalog.ru",
                "ShiftNumber": 9,
                "DocNumber": 108,
                "OfdOrganizationName": "Тестовый ОФД",
                "OfdVatin": "7709364346"
            },
            "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": "0161695416",
            "Fn": "9999078902012910",
            "FiscalDate": "2026-05-13T12:49:24",
            "CashierName": "Иванов А.И.",
            "DocumentHeader": {
                "OrganizationInfo": "ООО 'Ромашка'",
                "SerialNumber": "00109325182732",
                "Vatin": "7722345678",
                "Cashier": "Иванов А.И.",
                "RnNumber": "0000000001002520",
                "Fn": "9999078902012910",
                "FnsUrl": "nalog.ru",
                "ShiftNumber": 9,
                "DocNumber": 103,
                "OfdOrganizationName": "Тестовый ОФД",
                "OfdVatin": "7709364346"
            },
            "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=b0ce9370-4435-49f8-a5e8-9bc267a26f77`

Возвращает результат операции внесения наличных по идентификатору операции (docId), полученному в POST-запросе cashin.

URL: {{HTTPRoot}}/cashin?id=b0ce9370-4435-49f8-a5e8-9bc267a26f77

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

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

Тело ответа

200 OK

{
    "Result": {
        "Sum": 5,
        "CashSum": 2019.85,
        "ShiftNumber": 41,
        "DocNumber": 369,
        "DocNumberInShift": 0,
        "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)

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

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

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

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

72 Не указан id

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

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

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

POST `cashout`

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

URL: {{HTTPRoot}}/cashout

Тело запроса

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

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

Cashier

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

Тело ответа

200 OK

{
    "Result": {
        "Sum": 5,
        "CashSum": 4683.81,
        "ShiftNumber": 9,
        "DocNumber": 108,
        "DocNumberInShift": 0,
        "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”:
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	-	Тип чека: 0 — Текст 1 — Приход 2 — Возврат прихода 3 — Расход 4 — Возврат расхода 5 — Коррекция прихода 6 — Коррекция возврата прихода 7 — Коррекция расхода 8 — Коррекция возврата расхода 9 — Слип 10 — Фискализация 11 — Открытие смены 12 — Z-отчет 13 — X-отчет 14 — Отчет о состоянии расчетов 20 — Выемка 21 — Внесение 22 — Открытие денежного ящика	11
DocId	string	+	Идентификатор операции выемки наличных. Передайте в GET-запрос cashout, чтобы получить результат выемки наличных.	“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	-	Часовая зона: 0 — Авто; 1 — 1 часовая зона (МСК-1 / UTC+2); 2 — 2 часовая зона (МСК / UTC+3); 3 — 3 часовая зона (МСК+1 / UTC+4); 4 — 4 часовая зона (МСК+2 / UTC+5); 5 — 5 часовая зона (МСК+3 / UTC+6); 6 — 6 часовая зона (МСК+4 / UTC+7); 7 — 7 часовая зона (МСК+5 / UTC+8); 8 — 8 часовая зона (МСК+6 / UTC+9); 9 — 9 часовая зона (МСК+7 / UTC+10); 10 — 10 часовая зона (МСК+8 / UTC+11); 11 — 11 часовая зона (МСК+9 / UTC+12)	7
KktLicenses	-	Массив KktLicenseInfo	Массив лицензий ККТ	[]
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”

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

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

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

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

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

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

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

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

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

49 Устройство не найдено

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

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

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

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

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

POST `cashout/async`

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

URL: {{HTTPRoot}}/cashout/async

Тело запроса

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

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

Тело ответа

200 OK

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

Result

Имя поля	Тип	Обяз	Назначение	Пример
Result	string	+	Идентификатор документа операции выемки наличных. Данный идентфикатор можно использовать для GET-запроса cashout, чтобы получить более подробную информацию.	“788eeda8-c2aa-4b51-8f39-db93d8e79b91”

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

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

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

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

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

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

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

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

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

GET `cashout?id=b0ce9370-4435-49f8-a5e8-9bc267a26f77`

Возвращает результат операции выемки наличных по идентификатору операции (docId), полученному в POST-запросе cashout.

URL: {{HTTPRoot}}/cashout?id=b0ce9370-4435-49f8-a5e8-9bc267a26f77

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

Имя параметра	Тип	Обяз	Назначение	Пример
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)

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

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

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

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

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

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

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

GET cash?device=Atol

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

Тело ответа

200 OK

Result (CashSum)

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

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

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

POST cashin

Тело запроса

Cashier

Тело ответа

200 OK

Result (CashIn)

DocumentHeader

DeviceInfo

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

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

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

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

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

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

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

POST cashin/async

Тело запроса

Тело ответа

200 OK

Result

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

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

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

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

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

GET cashin/list?device=Atol

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

Тело ответа

200 OK

Result (массив CashIn)

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

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

GET cashin?id=b0ce9370-4435-49f8-a5e8-9bc267a26f77

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

Тело ответа

200 OK

Result (CashIn)

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

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

72 Не указан id

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

POST cashout

Тело запроса

Cashier

Тело ответа

200 OK

Result (CashOut)

DocumentHeader

DeviceInfo

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

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

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

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

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

49 Устройство не найдено

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

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

POST cashout/async

Тело запроса

POST `cash/open`

GET `cash?device=Atol`

POST `cashin`

POST `cashin/async`

GET `cashin/list?device=Atol`

GET `cashin?id=b0ce9370-4435-49f8-a5e8-9bc267a26f77`

POST `cashout`

POST `cashout/async`

GET `cashout?id=b0ce9370-4435-49f8-a5e8-9bc267a26f77`