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

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

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

POST cash/open

Запрос: cash/open

URL: {{HTTPRoot}}/cash/open

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

Тело запроса

{
    "DeviceName": "{device}",
    "Cashier": {
        "Name": "First",
        "Vatin": ""
    }
}
Имя поля Тип Обяз Назначение Пример
DeviceName string + Название устройства “Shtrih”

Поле Cashier

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

Тело ответа

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

{
    "Result": {
        "DrawerNumber": 1,
        "ShiftNumber": 41,
        "DocNumber": 369,
        "DocNumberInShift": 0,
        "FiscalSign": "3411863455",
        "Fn": "9999078902010507",
        "FiscalDate": "2026-05-24T11:58:50",
        "CashierName": "First",
        "CashierVatin": "",
        "DocumentHeader": {
            "OrganizationInfo": "РБ-Софт",
            "SerialNumber": "00106305393630",
            "Vatin": "0326031413",
            "Cashier": "First",
            "RnNumber": "0000000002005725",
            "Fn": "9999078902010507",
            "FnsUrl": "www.nalog.gov.ru",
            "ShiftNumber": 41,
            "DocNumber": 369,
            "FiscalSign": "3411863455",
            "OfdOrganizationName": "Один ОФД тест ру 1-ofd-test.ru",
            "OfdVatin": "7709364346"
        },
        "SaleAddress": "Улан-Удэ, Балтахинова, 17",
        "SaleLocation": "Офис на 2 этаже",
        "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
}

Тип: объект OpenDrawer

OpenDrawer

Имя поля Тип Назначение Пример
DrawerNumber int Номер денежного ящика 1
ShiftNumber int Номер сессии 41
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 ИНН кассира “Иванов”
SaleAddress string Адрес проведения расчетов “г.Улан-Удэ, ул.Балтахинова, д17Е, офис 215”
SaleLocation string Место проведения расчетов “Офис”
FfdVersion string Версия ФФД “1.2”
TaskType enum Тип чека 11
DocId guid Идентификатор документа “7ccfb3d4-bc93-40c7-9e4d-aa1c8b0261b6”
Date DateTime Дата создания документа “2026-05-24T00:11:23.5221437+08:00”
TerminalId string Идентификатор терминала, с которго пришел документ ”“
DeviceName string Имя устройства “Emu”
PoolId string Пул, который назначен чеку ”“
ResultCode enum Результат 0
ResultDescription string Описания результата “OK”
Processed bool Признак удачного завершения обработки true
ServerVersion string Версия сервера “4.0.62.521”

Поле DocumentHeader

Имя поля Тип Назначение Пример
OrganizationInfo string Информация об организации “”ООО РБ-Софт”“
SerialNumber string Заводской номер ККТ “”0020260207”
Vatin string ИНН Организации “0326012345”
Cashier string Кассир “Иванов”
RnNumber string Регистрационный номер ККТ “00031415926”
Fn string Фискальный накопитель “0123123123123”
FnsUrl string Сайт ФНС “nalog.ru”
ShiftNumber int Номер смены 3
DocNumber int Номер фискального документа 5
FiscalSign string Фискальный признак документа “4988644533”
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”

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

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

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

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

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

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

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

GET cash?device={device}

Запрос: cash

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

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

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

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

Тело ответа

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

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

Тип: объект CashSum

CashSum

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

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

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

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

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

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

POST cashin

Запрос: cashin

URL: {{HTTPRoot}}/cashin

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

Тело запроса

{
  "DeviceName": "{device}",
  "Cashier": {
    "Name": "Иван",
    "Vatin": "",
  },
  "Sum": 5
}
Имя поля Тип Обяз Назначение Пример
DeviceName string + Название устройства “Shtrih”
Sum decimal + Сумма внесения 5

Поле Cashier

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

Тело ответа

Успешный ответ (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": "",
        "DocumentHeader": {
            "OrganizationInfo": "РБ-Софт",
            "SerialNumber": "00109325182732",
            "Vatin": "0326031413",
            "Cashier": "Иван",
            "RnNumber": "0000000001002520",
            "Fn": "9999078902012910",
            "FnsUrl": "www.nalog.gov.ru",
            "ShiftNumber": 9,
            "DocNumber": 108,
            "OfdOrganizationName": "Один ОФД тест ру 1-ofd-test.ru",
            "OfdVatin": "7709364346"
        },
        "SaleAddress": "Улан-Удэ, Балтахинова, 17",
        "SaleLocation": "Офис на 2 этаже",
        "FfdVersion": "1.0.5",
        "TaskType": 21,
        "DocId": "c9a7edab-5a0f-42a9-9ab4-937ad9990cc6",
        "Date": "2026-05-13T17:04:53.2838562+08:00",
        "TerminalId": "",
        "DeviceName": "atol2",
        "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
}

Тип: объект CashIn

CashIn

Имя поля Тип Назначение Пример
Sum decimal Фактическая сумма внесения 5.0
CashSum decimal Сумма наличных в денежном ящике 5.0
ShiftNumber int Номер сессии 41
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 ИНН кассира “Иванов”
SaleAddress string Адрес проведения расчетов “г.Улан-Удэ, ул.Балтахинова, д17Е, офис 215”
SaleLocation string Место проведения расчетов “Офис”
FfdVersion string Версия ФФД “1.2”
TaskType enum Тип чека 11
DocId guid Идентификатор документа “7ccfb3d4-bc93-40c7-9e4d-aa1c8b0261b6”
Date DateTime Дата создания документа “2026-05-24T00:11:23.5221437+08:00”
TerminalId string Идентификатор терминала, с которго пришел документ ”“
DeviceName string Имя устройства “Emu”
PoolId string Пул, который назначен чеку ”“
ResultCode enum Результат 0
ResultDescription string Описания результата “OK”
Processed bool Признак удачного завершения обработки true
ServerVersion string Версия сервера “4.0.62.521”

Поле DocumentHeader

Имя поля Тип Назначение Пример
OrganizationInfo string Информация об организации “”ООО РБ-Софт”“
SerialNumber string Заводской номер ККТ “”0020260207”
Vatin string ИНН Организации “0326012345”
Cashier string Кассир “Иванов”
RnNumber string Регистрационный номер ККТ “00031415926”
Fn string Фискальный накопитель “0123123123123”
FnsUrl string Сайт ФНС “nalog.ru”
ShiftNumber int Номер смены 3
DocNumber int Номер фискального документа 5
FiscalSign string Фискальный признак документа “4988644533”
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”

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

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

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

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

{
    "Code": 55,
    "Description": "Попытка обращения к отключенному устройству: Устройство 'Emu' не активно.",
    "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

Запрос: cashin/async

URL: {{HTTPRoot}}/cashin/async

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

Тело запроса

{
    "DeviceName": "Atol",
    "Cashier": {
        "Name": "Иван",
        "Vatin": ""
    },
    "Sum": 5
}
Имя поля Тип Обяз Назначение Пример
DeviceName string + Название устройства “Shtrih”
Sum decimal + Сумма внесения 5

Поле Cashier

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

Тело ответа

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

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

Поле Result

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

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

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

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

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

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

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

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

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

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

GET cashin/list?device={device}

Запрос: cashin/list

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

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

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

Параметр Обяз Пример Описание
device + atol2 Название устройства

Тело ответа

Успешный ответ (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": "",
            "DocumentHeader": {
                "OrganizationInfo": "РБ-Софт",
                "SerialNumber": "00109325182732",
                "Vatin": "0326031413",
                "Cashier": "Иван",
                "RnNumber": "0000000001002520",
                "Fn": "9999078902012910",
                "FnsUrl": "www.nalog.gov.ru",
                "ShiftNumber": 9,
                "DocNumber": 108,
                "OfdOrganizationName": "Один ОФД тест ру 1-ofd-test.ru",
                "OfdVatin": "7709364346"
            },
            "SaleAddress": "Улан-Удэ, Балтахинова, 17",
            "SaleLocation": "Офис на 2 этаже",
            "FfdVersion": "1.0.5",
            "TaskType": 21,
            "DocId": "c9a7edab-5a0f-42a9-9ab4-937ad9990cc6",
            "Date": "2026-05-13T17:04:53.2838562+08:00",
            "TerminalId": "",
            "DeviceName": "atol2",
            "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": "0326031413",
                "Cashier": "кассир",
                "RnNumber": "0000000001002520",
                "Fn": "9999078902012910",
                "FnsUrl": "www.nalog.gov.ru",
                "ShiftNumber": 9,
                "DocNumber": 103,
                "OfdOrganizationName": "Один ОФД тест ру 1-ofd-test.ru",
                "OfdVatin": "7709364346"
            },
            "SaleAddress": "Улан-Удэ, Балтахинова, 17",
            "SaleLocation": "Офис на 2 этаже",
            "FfdVersion": "1.0.5",
            "TaskType": 21,
            "DocId": "c6bdec98-c3a9-42f1-9950-19cfd35c3c36",
            "Date": "2026-05-13T12:49:11.8767798+08:00",
            "TerminalId": "",
            "DeviceName": "atol2",
            "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
}

Тип: массив объектов CashIn

CashIn

Имя поля Тип Назначение Пример
Sum decimal Фактическая сумма внесения 5.0
CashSum decimal Сумма наличных в денежном ящике 5.0
ShiftNumber int Номер сессии 41
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 ИНН кассира “Иванов”
SaleAddress string Адрес проведения расчетов “г.Улан-Удэ, ул.Балтахинова, д17Е, офис 215”
SaleLocation string Место проведения расчетов “Офис”
FfdVersion string Версия ФФД “1.2”
TaskType enum Тип чека 11
DocId guid Идентификатор документа “7ccfb3d4-bc93-40c7-9e4d-aa1c8b0261b6”
Date DateTime Дата создания документа “2026-05-24T00:11:23.5221437+08:00”
TerminalId string Идентификатор терминала, с которго пришел документ ”“
DeviceName string Имя устройства “Emu”
PoolId string Пул, который назначен чеку ”“
ResultCode enum Результат 0
ResultDescription string Описания результата “OK”
Processed bool Признак удачного завершения обработки true
ServerVersion string Версия сервера “4.0.62.521”

Поле DocumentHeader

Имя поля Тип Назначение Пример
OrganizationInfo string Информация об организации “”ООО РБ-Софт”“
SerialNumber string Заводской номер ККТ “”0020260207”
Vatin string ИНН Организации “0326012345”
Cashier string Кассир “Иванов”
RnNumber string Регистрационный номер ККТ “00031415926”
Fn string Фискальный накопитель “0123123123123”
FnsUrl string Сайт ФНС “nalog.ru”
ShiftNumber int Номер смены 3
DocNumber int Номер фискального документа 5
FiscalSign string Фискальный признак документа “4988644533”
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”

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

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

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

GET cashin?id={id}

Запрос: cashin

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

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

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

Параметр Обяз Пример Описание
id + 40b5b4c1-0040-4559-93e8-4e647f4a860b идентификатор задачи

Тело ответа

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

{
    "Result": {
        "Sum": 5,
        "CashSum": 2019.85,
        "ShiftNumber": 41,
        "DocNumber": 369,
        "DocNumberInShift": 0,
        "FiscalSign": "3411863455",
        "Fn": "9999078902010507",
        "FiscalDate": "2026-05-24T12:17:41",
        "CashierName": "Иван",
        "CashierVatin": "",
        "DocumentHeader": {
            "OrganizationInfo": "РБ-Софт",
            "SerialNumber": "00106305393630",
            "Vatin": "0326031413",
            "Cashier": "Иван",
            "RnNumber": "0000000002005725",
            "Fn": "9999078902010507",
            "FnsUrl": "www.nalog.gov.ru",
            "ShiftNumber": 41,
            "DocNumber": 369,
            "FiscalSign": "3411863455",
            "OfdOrganizationName": "Один ОФД тест ру 1-ofd-test.ru",
            "OfdVatin": "7709364346"
        },
        "SaleAddress": "Улан-Удэ, Балтахинова, 17",
        "SaleLocation": "Офис на 2 этаже",
        "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
}

Тип: объект CashIn

CashIn

Имя поля Тип Назначение Пример
Sum decimal Фактическая сумма внесения 5.0
CashSum decimal Сумма наличных в денежном ящике 5.0
ShiftNumber int Номер сессии 41
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 ИНН кассира “Иванов”
SaleAddress string Адрес проведения расчетов “г.Улан-Удэ, ул.Балтахинова, д17Е, офис 215”
SaleLocation string Место проведения расчетов “Офис”
FfdVersion string Версия ФФД “1.2”
TaskType enum Тип чека 11
DocId guid Идентификатор документа “7ccfb3d4-bc93-40c7-9e4d-aa1c8b0261b6”
Date DateTime Дата создания документа “2026-05-24T00:11:23.5221437+08:00”
TerminalId string Идентификатор терминала, с которго пришел документ ”“
DeviceName string Имя устройства “Emu”
PoolId string Пул, который назначен чеку ”“
ResultCode enum Результат 0
ResultDescription string Описания результата “OK”
Processed bool Признак удачного завершения обработки true
ServerVersion string Версия сервера “4.0.62.521”

Поле DocumentHeader

Имя поля Тип Назначение Пример
OrganizationInfo string Информация об организации “”ООО РБ-Софт”“
SerialNumber string Заводской номер ККТ “”0020260207”
Vatin string ИНН Организации “0326012345”
Cashier string Кассир “Иванов”
RnNumber string Регистрационный номер ККТ “00031415926”
Fn string Фискальный накопитель “0123123123123”
FnsUrl string Сайт ФНС “nalog.ru”
ShiftNumber int Номер смены 3
DocNumber int Номер фискального документа 5
FiscalSign string Фискальный признак документа “4988644533”
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”

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

72 — Не указан id

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

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

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

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

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

POST cashout

Запрос: cashout

URL: {{HTTPRoot}}/cashout

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

Тело запроса

{
    "DeviceName": "{device}",
    "Cashier": {
        "Name": "Кассир",
        "Vatin": ""
    },
    "Sum": 100
}
Имя поля Тип Обяз Назначение Пример
DeviceName string + Название устройства “Shtrih”
Sum decimal + Сумма внесения 5

Поле Cashier

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

Тело ответа

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

{
    "Result": {
        "Sum": 5,
        "CashSum": 4683.81,
        "ShiftNumber": 9,
        "DocNumber": 108,
        "DocNumberInShift": 0,
        "FiscalSign": "4087338768",
        "Fn": "9999078902012910",
        "FiscalDate": "2026-05-13T17:16:46",
        "CashierName": "Кассир",
        "CashierVatin": "",
        "DocumentHeader": {
            "OrganizationInfo": "РБ-Софт",
            "SerialNumber": "00109325182732",
            "Vatin": "0326031413",
            "Cashier": "Кассир",
            "RnNumber": "0000000001002520",
            "Fn": "9999078902012910",
            "FnsUrl": "www.nalog.gov.ru",
            "ShiftNumber": 9,
            "DocNumber": 108,
            "OfdOrganizationName": "Один ОФД тест ру 1-ofd-test.ru",
            "OfdVatin": "7709364346"
        },
        "SaleAddress": "Улан-Удэ, Балтахинова, 17",
        "SaleLocation": "Офис на 2 этаже",
        "FfdVersion": "1.0.5",
        "TaskType": 20,
        "DocId": "5f5e1295-1af8-4656-9e10-bcec64af0b72",
        "Date": "2026-05-13T17:16:34.5626773+08:00",
        "TerminalId": "",
        "DeviceName": "atol2",
        "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
}

Тип: CashOut

CashOut

Имя поля Тип Назначение Пример
Sum decimal Фактическая сумма внесения 5.0
CashSum decimal Сумма наличных в денежном ящике 5.0
ShiftNumber int Номер сессии 41
DocNumber int Номер фискального документа 5
DocNumberInShift int Номер фискального документа за смену 1
FiscalSign string Фискальный признак документа “4988644533”
Fn string Серийный номер фискального накопителя “0123123123123”
FiscalDate DateTime Время регистрации операции по часам ККМ. “2026-05-24T00:11:23.5505769+08:00”
SaleAddress string Адрес проведения расчетов “г.Улан-Удэ, ул.Балтахинова, д17Е, офис 215”
SaleLocation string Место проведения расчетов “Офис”
FfdVersion string Версия ФФД “1.2”
TaskType enum Тип чека 11
DocId guid Идентификатор документа “7ccfb3d4-bc93-40c7-9e4d-aa1c8b0261b6”
Date DateTime Дата создания документа “2026-05-24T00:11:23.5221437+08:00”
TerminalId string Идентификатор терминала, с которго пришел документ ”“
DeviceName string Имя устройства “Emu”
PoolId string Пул, который назначен чеку ”“
ResultCode enum Результат 0
ResultDescription string Описания результата “OK”
Processed bool Признак удачного завершения обработки true
ServerVersion string Версия сервера “4.0.62.521”

Поле DocumentHeader

Имя поля Тип Назначение Пример
OrganizationInfo string Информация об организации “”ООО РБ-Софт”“
SerialNumber string Заводской номер ККТ “”0020260207”
Vatin string ИНН Организации “0326012345”
Cashier string Кассир “Иванов”
RnNumber string Регистрационный номер ККТ “00031415926”
Fn string Фискальный накопитель “0123123123123”
FnsUrl string Сайт ФНС “nalog.ru”
ShiftNumber int Номер смены 3
DocNumber int Номер фискального документа 5
FiscalSign string Фискальный признак документа “4988644533”
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”

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

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

Запрос: cashout/async

URL: {{HTTPRoot}}/cashout/async

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

Тело запроса

{
    "DeviceName": "Emu",
    "Cashier": {
        "Name": "Кассир",
        "Vatin": ""
    },
    "Sum": 5
}
Имя поля Тип Обяз Назначение Пример
DeviceName string + Название устройства “Shtrih”
Sum decimal + Сумма внесения 5

Поле Cashier

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

Тело ответа

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

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

Поле Result

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

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

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

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

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

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

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

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

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

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

GET cashout?id={id}

Запрос: cashout

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

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

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

Параметр Обяз Пример Описание
id + f26c26eb-720b-49d3-a5c5-7c9cafdd1e28 Идентификатор задачи

Тело ответа

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

{
    "Result": {
        "Sum": 5,
        "CashSum": 0,
        "ShiftNumber": 0,
        "DocNumber": 0,
        "DocNumberInShift": 0,
        "Fn": "",
        "FiscalDate": "0001-01-01T00:00:00",
        "CashierName": "Кассир",
        "CashierVatin": "",
        "DocumentHeader": {
            "OrganizationInfo": "",
            "SerialNumber": "",
            "Vatin": "",
            "Cashier": "",
            "RnNumber": "",
            "Fn": "",
            "FnsUrl": "www.nalog.ru",
            "ShiftNumber": 0,
            "OfdOrganizationName": "",
            "OfdVatin": ""
        },
        "TaskType": 20,
        "DocId": "f26c26eb-720b-49d3-a5c5-7c9cafdd1e28",
        "Date": "2026-05-24T12:34:20.7516238+08:00",
        "TerminalId": "",
        "DeviceName": "Emu",
        "PoolId": "",
        "ResultCode": 55,
        "ResultDescription": "Требуется открытая смена",
        "Processed": false,
        "ServerVersion": "4.0.62.521",
        "DeviceInfo": {
            "FfdVersion": "1.2",
            "FnFfdVersion": "1.2",
            "TimeZone": 7,
            "KktLicenses": [],
            "IsFiscal": true,
            "LineLength": 64,
            "LineLengthPixels": 512,
            "DeviceClass": 4,
            "Model": "РБ-Софт:Эмулятор ККМ",
            "SerialNumber": "0020260207",
            "FirmwareVersion": "2026",
            "ConfigurationVersion": "02.07"
        }
    },
    "Code": 0,
    "Description": "OK",
    "Success": true
}

CashOut

Имя поля Тип Назначение Пример
Sum decimal Фактическая сумма внесения 5.0
CashSum decimal Сумма наличных в денежном ящике 5.0
ShiftNumber int Номер сессии 41
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 ИНН кассира “Иванов”
SaleAddress string Адрес проведения расчетов “г.Улан-Удэ, ул.Балтахинова, д17Е, офис 215”
SaleLocation string Место проведения расчетов “Офис”
FfdVersion string Версия ФФД “1.2”
TaskType enum Тип чека 11
DocId guid Идентификатор документа “7ccfb3d4-bc93-40c7-9e4d-aa1c8b0261b6”
Date DateTime Дата создания документа “2026-05-24T00:11:23.5221437+08:00”
TerminalId string Идентификатор терминала, с которго пришел документ ”“
DeviceName string Имя устройства “Emu”
PoolId string Пул, который назначен чеку ”“
ResultCode enum Результат 0
ResultDescription string Описания результата “OK”
Processed bool Признак удачного завершения обработки true
ServerVersion string Версия сервера “4.0.62.521”

Поле DocumentHeader

Имя поля Тип Назначение Пример
OrganizationInfo string Информация об организации “”ООО РБ-Софт”“
SerialNumber string Заводской номер ККТ “”0020260207”
Vatin string ИНН Организации “0326012345”
Cashier string Кассир “Иванов”
RnNumber string Регистрационный номер ККТ “00031415926”
Fn string Фискальный накопитель “0123123123123”
FnsUrl string Сайт ФНС “nalog.ru”
ShiftNumber int Номер смены 3
DocNumber int Номер фискального документа 5
FiscalSign string Фискальный признак документа “4988644533”
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”

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

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

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

72 — Не указан id

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

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

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