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

Приложение

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

Входные типы данных

DeviceSettings

Имя поля Тип Обяз Назначение Пример
DeviceName string + Имя устройства. Должно совпадать со значением поля DeviceName, указанным непосредственно в теле запроса. “Atol”
DeviceType int + Тип драйвера:
1 — Shtrih;
2 — 1С(4.7);
3 — Atol;
4 — RrElectro;
5 — 1С(5.0);
100 — Эмулятор.		 1
Available bool - Признак доступности устройства. Если указано значение true, сервер немедленно предпринимает попытку подключения к устройству. Если подключиться не удалось, значение автоматически сбрасывается в false, при этом запрос на добавление устройства всё равно завершается успешно. true
MethodConnection int + Метод подключения: 0 — COM;
1 — TCP/IP		 0
PortNumber int - Номер COM-порта.
Обязателен при MethodConnection=0		 1
BaudRate int - Скорость COM-порта.
Обязателен при MethodConnection=0		 9600
IpAddress string - IP-адрес.
Обязателен при MethodConnection=1		 “192.168.0.109”
TcpPort int - TCP-порт.
Обязателен при MethodConnection=1		 7778
Password string + Пароль устройства (пароль доступа к драйверу ККТ) “30”
AccessPassword string - Пароль доступа к настройкам устройства (не путать с паролем устройства Password) “0000”
SerialNumber string - Серийный номер устройства “0392790042005043”
Vatin string - ИНН организации “7722345678”
OrganizationName string - Название организации “ООО Ромашка”
SaleAddress string - Адрес расчётов “г.Улан-Удэ, ул.Виноградная, д11А, офис 25”
ClientSaleLocation string - Место расчётов “Офис”
Cashier string - ФИО кассира по умолчанию “Иванов А.И.”
CashierVatin string - ИНН кассира “7722345678”
SenderEmail string - Email отправителя чека “ivanov@mail.ru”
TimeoutConnection int - Таймаут подключения к устройству, в миллисекундах.

Если не указан или указано значение 0 — применяется значение по умолчанию, равное 5000 мс.		 5000
TimeoutWaitForPrinting int - Таймаут ожидания завершения печати, в миллисекундах.

Если не указан или указано значение 0 — применяется значение по умолчанию, равное 5000 мс.		 60000
OfdAddress string - Адрес ОФД “ofd.example.ru”
OfdPort int - Порт ОФД 7777
Pool string - Имя пула, в который включается устройство.

Если не указано — устройство не входит ни в один пул.		 “pool”

DeviceSettings

Имя поля Тип Обяз Назначение Пример
Name string + Название шаблона “lines2”
TemplateSettingH1 string - Номер шрифта заголовка H1. Если не указано — ранее сохранённое значение стирается. “1”
TemplateSettingH2 string - Номер шрифта заголовка H2. Если не указано — ранее сохранённое значение стирается. “1”
TemplateSettingH3 string - Номер шрифта заголовка H3. Если не указано — ранее сохранённое значение стирается. “2”
TemplateSettingH4 string - Номер шрифта заголовка H4. Если не указано — ранее сохранённое значение стирается. “2”
TemplateSettingH5 string - Номер шрифта заголовка H5. Если не указано — ранее сохранённое значение стирается. “2”

ProxyConfig

Имя поля Тип Обяз Назначение Пример
IsUseProxy bool - Признак использования прокси-сервера.

Если указано значение true, а поля IsUseProxyService и IsUseProxyMarking не переданы (или оба переданы как false), сервер принудительно устанавливает оба этих поля в true		 false
IsUseProxyService bool - Признак использования прокси-сервера непосредственно для работы сервера ККМ false
IsUseProxyMarking bool - Признак использования прокси-сервера для обращения к сервисам проверки кодов маркировки false
IpAddress string - IP-адрес прокси-сервера “193.148.21.111”
Port int - Порт прокси-сервера 67
Name string - Логин доступа к прокси-серверу.

Если поле не передано, ранее сохранённый логин будет затёрт пустым значением.		 “ProxyServer”
Password string - Пароль доступа к прокси-серверу.

Если поле не передано, ранее сохранённый пароль будет затёрт пустым значением.		 “ProxyPassword”

Cashier

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

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

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

Обязателен для POST correction105,POST correction105/async и POST fiscalization, POST fiscaliztion/async иначе операция завершиться с ошибкой.

Customer

Имя поля Тип Обяз Назначение Пример
Info string - Наименование организации или фамилия, имя, отчество (при наличии).

Если не указано — в чек не попадает.		 “ООО ‘Рога и Копыта’“
Email string - Электронная почта покупателя.

Если не указана — используется Phone (если указан).		 “kuznicov@mail.ru“
Vatin string - ИНН покупателя.

Если не указан — ИНН покупателя в чек не попадает.		 “500100732259”
Phone string - Номер телефона.

Если не указан — используется Email (если указан).		 “+79021456776”
DateOfBirth string - Дата рождения покупателя (клиента) в формате “DD.MM.YYYY”.

Если не указана — в чек не попадает.		 01.01.1990
Citizenship string - Код страны (ОКСМ).

Если не указан — в чек не попадает.		 “643”
DocumentTypeCode string - Числовой код вида документа, удостоверяющего личность (ФФД, Таблица 116).

Если не указан — в чек не попадает.		 “21”
DocumentData string - Данные документа, удостоверяющего личность.

Если не указаны — в чек не попадают.		 “Серия: 60 18 Номер: 345678”
Address string - Адрес покупателя.

Если не указан — в чек не попадает.		 “г.Иркутск, ул.Апельсиновая, д31А, офис 15”

ApiPayments

Имя поля Тип Обяз Назначение Пример
Cash decimal - Сумма наличной оплаты.

Если не указана — считается 0.		 50
ElectronicPayment decimal - Сумма безналичными средствами.

Если не указана — считается 0.		 0
AdvancePayment decimal - Сумма предоплатой (зачетом аванса).

Если не указана — считается 0.		 0
Credit decimal - Сумма постоплатой (в кредит).

Если не указана — считается 0.		 0
CashProvision decimal - Сумма встречным предоставлением.

Если не указана — считается 0.		 0

Position / CheckTemplateDocumentParameters

Поле Тип Обяз Назначение Пример
FiscalString FiscalString - Фискальная позиция. Участвует в расчёте суммы чека и передаётся в ФН. Name обязателен.

Обязателен в фискальных операциях.		 “FiscalString”:
TextString TextString - Нефискальная текстовая строка — печатается в чеке, на сумму не влияет. “TextString”:
SeparatorLine SeparatorLine - Нефискальная горизонтальная линия на всю ширину чека. “SeparatorLine”:
Barcode ApiBarcode - Штрихкод или QR-код. “Barcode”: {
“Type”: “QR”,
“Value”: “https://roga-i-kopyta.ru",
“Alignment”: “center” }
Picture Picture - Нефискальная картинка в кодировке Base64. “Picture”:

FiscalString

Имя поля Тип Обяз Назначение Пример
Name string + Название товара или услуги “Бутылка с водой 1л.”
Quantity decimal - Количество товара.

Если указано 0 или не указано — автоматически устанавливается 1.		 1
ProductCode string - Код товара “6404 11 000 0”
PriceWithDiscount decimal + Цена единицы товара с учетом скидок/наценок 30
SumWithDiscount decimal + Конечная сумма по позиции чека с учетом всех скидок/наценок 30
Department int Отдел, по которому ведется продажа 0
Tax string + Ставка НДС “20”
MeasurementUnit string + Единица измерения предмета расчета “шт”
DiscountSum string - Сумма скидок и наценок 0
TaxSum decimal + Сумма НДС за предмет расчета 0
SignMethodCalculation int + Признак способа расчета:
0 — Не применяется;
1 — Предоплата полная;
2 — Предоплата частичная;
3 — Аванс;
4 — Полная оплата;
5 — Частичная оплата и кредит;
6 — Передача в кредит;
7 — Оплата кредита.

Если не указано или значение некорректно — по умолчанию 4 (полная оплата).

Если в настройках ККТ, во вкладке “Автозамена” выставлен флаг “Заменять принудительно”, значение признака предмета расчета и признака способа расчета из запроса заменяется значением из настроек ККТ.		 4
SignCalculationObject int + Признак предмета расчета:
0 — Не применяется;
1 — Товар (товар, за исключением подакцизного товара);
2 — Подакцизный товар;
3 — Работа;
4 — Услуга;
5 — Ставка (приём ставок при деятельности по организации и проведению азартных игр);
6 — Выигрыш (выплата выигрышей в азартных играх);
7 — Лотерея (реализация лотерейных билетов или ставок при деятельности по организации и проведению лотерей);
8 — Выигрыш в лотерее (выплата выигрышей в лотереях);
9 — Право (прав на использование результатов интеллектуальной деятельности или средств индивидуализации);
10 — Аванс (аванс, задаток, предоплата, кредит, взнос в счет оплаты, пени, штраф, вознаграждение, бонус и иной аналогичный предмет расчета);
11 — Агентское вознаграждение (о вознаграждении пользователя, являющегося платежным агентом (субагентом), банковским платежным агентом (субагентом), комиссионером, поверенным или иным агентом);
12 — Выплата (о взносе в счет оплаты, пени, штрафе, вознаграждении, бонусе и ином аналогичном предмете расчета);
13 — Иной предмет расчета (о предмете расчета, не относящемуся к предметам расчета, которым может быть присвоено значение от “1” до “11” и от “14” до “26”);
14 — Имущественное право;
15 — Внереализационный доход;
16 — Иные платежи и взносы;
17 — Торговый сбор;
18 — Туристический налог;
19 — Залог;
20 — Расход;
21 — Взносы на ОПС ИП (взносы на обязательное пенсионное страхование ИП);
22 — Взносы на ОПС (взносы на обязательное пенсионное страхование);
23 — Взносы на ОМС ИП (взносы на обязательное медицинское страхование ИП);
24 — Взносы на ОМС (взносы на обязательное медицинское страхование);
25 — Взносы на ОСС (взносы на обязательное социальное страхование);
26 — Платеж казино (о приеме и выплате денежных средств при осуществлении казино и залами игровых автоматов расчетов с использованием обменных знаков игорного заведения — максимальное значение для ФФД 1.05);
27 — Выдача ДС (выдача денежных средств банковским платежным агентом);
30 — АТНМ (подакцизный товар, подлежащий маркировке средством идентификации, не имеющим кода маркировки);
31 — АТМ (подакцизный товар, подлежащий маркировке средством идентификации, имеющим код маркировки);
32 — ТНМ (товар, подлежащий маркировке средством идентификации, не имеющим кода маркировки, за исключением подакцизного товара);
33 — ТМ (товар, подлежащий маркировке средством идентификации, имеющим код маркировки, за исключением подакцизного товара);

Если не указано или значение некорректно — по умолчанию 1 (Товар).

Если в настройках ККТ, во вкладке “Автозамена” выставлен флаг “Заменять принудительно”, значение признака предмета расчета и признака способа расчета из запроса заменяется из настроек ККТ.		 10
SignSubjectCalculationAgent int - Признак агента по предмету расчета:
0 — Банковский платежный агент;
1 — Банковский платежный субагент;
2 — Платежный агент;
3 — Платежный субагент;
4 — Поверенный;
5 — Комиссионер;
6 — Агент (иной тип).

Если не указан в позиции — используется значение AgentSign из заголовка чека.

Если не указан ни в позиции, ни в заголовке — признак агента в позиции не передаётся.		 5
AgentData AgentData - Данные агента по позиции.

Если в позиции не указаны — используются данные AgentData из тела чека.

Если не указаны ни в позиции, ни в теле — данные агента не передаются.

Обязательно вместе с SignSubjectCalculationAgent.		 “AgentData”:
Vendor VendorData - Данные поставщика по позиции.

Если в позиции не указаны — используются данные Vendor из тела чека.

Если не указаны ни в позиции, ни в теле — данные поставщика не передаются.		 “Vendor”:
GoodCodeData CommodityNomenclatureCode - Данные кода товарной номенклатуры.

Если не указан — можно передать код маркировки через поле MarkingCode.

Если не указано ни GoodCodeData, ни MarkingCode — код товара в позиции не передаётся.		 “GoodCodeData”:
MarkingCode string - Код контрольной марки.

Если не указан — код маркировки в позицию не передаётся (если не задан GoodCodeData.MarkingCode).		 “MDEwNDYxMDE0NDA4NTM0MjIxNSVvIS1MVEVsQ2dBTB05MUVFMDkdOTJtdTlXR3VGK0hyQlFCR3ZUMTNneVc0d29uRmVqZ2FZd1YzSkhkN0U1VHhnPQ==”
AdditionalAttribute string - Дополнительный реквизит предмета расчет “Доп информация: вода из Байкала”
CountryOfOrigin string - Цифровой код страны происхождения товара(ОКСМ) “994”
CustomsDeclaration string - Регистрационный номер таможенной декларации “06532/220211/0001122”
MeasureOfQuantity int - Мера количества предмета расчета. Значение из таблицы 114 (ФФД) 10
IndustryAttribute IndustryAttribute - Отраслевой реквизит предмета расчёта.

Если не указан — в позицию не попадает. Отдельные поля внутри объекта необязательны.

Если для позиции передан код маркировки в AttributeValue, сервер считает, что проверка этого кода маркировки уже была выполнена внешней системой, и не выполняет собственную проверку кода при печати чека.		 “IndustryAttribute”:
ExciseAmount decimal Сумма акциза с учетом копеек 1
FractionalQuantity FractionalQuantity Дробное количество предмета расчёта. Задаётся числителем и знаменателем. “FractionalQuantity”:
#### CorrectionData
Имя поля Тип Обяз Назначение Пример
Type int - Тип коррекции:
0 — самостоятельно (коррекция по собственной инициативе);
1 — по предписанию (коррекция по предписанию налогового органа).

Если указано значение 1, рекомендуется заполнять поле Number.		 1
Description string - Описание (основание) коррекции. “Основание коррекции”
Date DateTime - Дата совершения корректируемого расчета. “2026-03-30T00:00:00”
Number string - Номер предписания налогового органа. Если коррекция самостоятельная (Type = 0), поле можно заполнить значением “0”. “0”

GoodCodeData

Имя поля Тип Обяз Назначение Пример
MarkingCode string - Код контрольной марки в кодировке Base64.

Если не указан — используется MarkingCode из FiscalString (если задан).		 “MDEwNDYxMDE0NDA4NTM0MjIxNSVvIS1MVEVsQ2dBTB05MUVFMDkdOTJtdTlXR3VGK0hyQlFCR3ZUMTNneVc0d29uRmVqZ2FZd1YzSkhkN0U1VHhnPQ==”
Gtin string - GTIN.

Если не указан — в чек не попадает.		 “04601234567890”
StampType string - Тип маркировки:
“02” — мех;
“05” — табак;
“1520” — обувь.

Если не указан — тег не передаётся.		 “05”
Stamp string - КиЗ.

Если не указан — тег не передаётся.		 “RU-ABC/1234567890123456”
SerialNumber string - Серийный номер.

Если не указан — тег не передаётся.		 “5kX9mP2vQ7nR”
Barcode string - Штрихкод.

Если не указан — тег не передаётся.		 “4601234567890”
NotIdentified string - Код неидентифицированного формата в кодировке Base64.

Если не указан — не используется.		 “U0tVLUxPQ0FMLTg4NDIx”
EAN8 string - EAN-8 в кодировке Base64.

Если не указан — не используется.		 “NDYwMTIzNDU=”
EAN13 string - EAN-13 в кодировке Base64.

Если не указан — не используется.		 “NDYwMTIzNDU2Nzg5MA==”
ITF14 string - ITF-14 в кодировке Base64.

Если не указан — не используется.		 “MTQ2MDEyMzQ1Njc4OTM=”
GS10 string - GS10 (без маркировки) в кодировке Base64.

Если не указан — не используется.		 “MDEwNDYwNDA2MDAwMzAxNQ==”
GS1M string - GS1 (с маркировкой) в кодировке Base64.

Если не указан — не используется.		 “OTEwMjM0NTY3ODkwMTIzNDU2Nzg5MDEyMzQ1Ng==”
KMK string - Короткий код маркировки в кодировке Base64.

Если не указан — не используется.		 “MDEwNDYwNDA2MDAwMzAxNTIxQWJDZEVm”
MI string - КиЗ мехового изделия.

Если не указан — не используется.		 “UlUtQUJDLzEyMzQ1Njc4OTAxMjM0NTY=”
EGAIS20 string - ЕГАИС-2.0 в кодировке Base64.

Если не указан — не используется.		 “MDEwMDAwMDAwMDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTIzNDU2Nzg5MDEyMzQ=”
EGAIS30 string - ЕГАИС-3.0 в кодировке Base64.

Если не указан — не используется.		 “MDMwMDAwMDAwMDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI=”
F1–F6 string - Код формата Ф.1–Ф.6 в кодировке Base64.

Если не указан — не используется.		 “RjEtREFUQS0wMDE=”

FractionalQuantity

Имя поля Тип Обяз Назначение Пример
Numerator int + Числитель.

Обязателен, если передан FractionalQuantity.

Если 0 или не указан — дробное количество не применяется.		 208
Denominator int + Знаменатель.

Обязателен, если передан FractionalQuantity. Не должен быть 0.		 1

OperationalAttribute

Имя поля Тип Обяз Назначение Пример
DateTime string - Дата и время операции.

Если не указано — тег не передаётся.		 “03.07.2026”
OperationId string - Идентификатор операции.

Если не указан — тег не передаётся.		 “24f4bffe-98ef-4627-846c-b1f74c5a495b”
OperationData string - Данные операции.

Если не указаны — тег не передаётся.		 “Оплата по договору №784/2026”

VendorData

Имя поля Тип Обяз Назначение Пример
Phones string[] + Телефоны поставщика. Должен быть хотя бы один корректный российский номер (11 цифр). Сервер автоматически исправляет формат (удаляет лишние символы, заменяет 8 на 7).

Если после исправления ни одного валидного номера не осталось — ошибка “Телефон поставщика в строке чека N не некорректен”.		 [
“+79031234567”,
“+79169876543”
]
Name string + Наименование поставщика.

Если пустой — ошибка “Наименование поставщика отсутствует в строке чека N”.		 “ИП ‘Ромашка’“
Vatin string + ИНН поставщика.

Если пустой — ошибка “ИНН поставщика отсутствует в строке чека N”.		 “5262107639”

TextString

Имя поля Тип Обяз Назначение Пример
Text string - Текст строки. Поддерживает префиксы перед текстом: [big], [small], [bold], [H1]–[H5], [left], [right], [center], [QR], [line], [line,dotted]. Префикс [line] печатает разделительную линию вместо текста. URL в Text автоматически печатается как QR-код. Если пустой — строка пропускается (кроме префикса [line]). “[big, center]Добро пожаловать”
Font string - Шрифт: Normal, Bold, Small, Medium, Big, H1–H5.

Если не указан — Normal. Префикс в Text имеет приоритет над Font.		 “Big”
Alignment string - Выравнивание: left, right, center, width.

Если не указано — left. Префикс в Text имеет приоритет над Alignment.		 “left”

ApiElectronicPayment

Имя поля Тип Обяз Назначение Пример
Amount decimal + Сумма безналичной оплаты по данной транзакции.

Если не указана — передаётся 0.		 50
PaymentMethod int - Признак способа оплаты:
0 — предоплата 100%;
1 — предоплата;
2 — аванс;
3 — полный расчёт;
4 — частичный расчёт и кредит;
5 — передача в кредит;
6 — оплата кредита.

Если не указан — не передаётся.		 3
Identifiers string - Идентификаторы безналичной оплаты (RRN, номер транзакции и т.п.).

Если не указан — тег не передаётся.		 “RRN=123456789012”
AdditionalInformation string - Доп. сведения об оплате.

Если не указаны — тег не передаётся.		 “Терминал №1, карта *1234”

IndustryAttribute

Имя поля Тип Обяз Назначение Пример
IdentifierFoiv string - Идентификатор ФОИВ (тег 1262). Сервер дополняет 2-символьный код нулём слева до 3 символов (“30” станет “030”).

Если не указан — тег не передаётся.		 “3”
DocumentDate string - Дата документа-основания в формате “DD.MM.YYYY”.

Если не указана — тег не передаётся.		 “01.07.2026”
DocumentNumber string - Номер документа-основания.

Если не указан — тег не передаётся.		 “6”
AttributeValue string - Идентификатор проверки кода маркировки. Для онлайн-проверки содержит параметры UUID и Time. Для офлайн-проверки дополнительно включает параметры Inst и Ver. Если значение не указано, тег не передаётся. Онлайн: “UUID=fff5db9c-c0cb-4b1f-ac4b-8f0b92879780&Time=1746530733410”.

Офлайн: “UUID=2ecabfd9-e863-46a4-aa4e-23b96508d804&Time=1784090059735&Inst=6e7ff224-0e08-41ed-844c-d386675f4e50&Ver=1ebf3971-5b24-403b-ae6d-8bb5a0383c14”

AgentData

Имя поля Тип Обяз Назначение Пример
PayingAgentOperation string - Операция платежного агента (тег 1044).

Если не указана — в чек не попадает.		 “Прием платежей”
PayingAgentPhone string[] - Телефон платежного агента (тег 1073).

Если не указан или массив пустой — тег не передаётся.

Некорректный формат — сервер попытается исправить; при неудаче — ошибка.		 [“+79021654832”]
ReceivePaymentsOperatorPhone string[] - Телефон оператора по приёму платежей (тег 1074).

Если не указан — тег не передаётся.

Некорректный формат — сервер попытается исправить; при неудаче — ошибка.		 [“+790216748367”]
MoneyTransferOperatorPhone string[] - Телефон оператора перевода (тег 1075).

Если не указан — тег не передаётся ( и если не заполнены другие поля группы MoneyTransferOperator).		 [“+790216702167”]
MoneyTransferOperatorName string - Наименование оператора перевода (тег 1026).

Если не указано — тег не передаётся ( и если не заполнены другие поля группы MoneyTransferOperator).		 “Иванов И.И.”
MoneyTransferOperatorAddress string - Адрес оператора перевода (тег 1005).

Если не указан — тег не передаётся ( и если не заполнены другие поля группы MoneyTransferOperator).		 “г.Улан-Удэ, ул.Виноградная, д11А, офис 25”
MoneyTransferOperatorVatin string - ИНН оператора перевода (тег 1016).

Если не указан — тег не передаётся ( и если не заполнены другие поля группы MoneyTransferOperator).		 “7722345678”

UserAttribute

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

Если не указано — реквизит не передаётся.		 “НомерЗаказа”
Value string + Значение реквизита.

Если не указано — реквизит не передаётся.		 “ORD-2026-0042”

ApiBarcode

Имя поля Тип Обяз Назначение Пример
Type string + Тип штрихкода: UPCA,
CODE39,
EAN13,
EAN8,
UPCE,
ITF,
CODABAR,
CODE93,
CODE128,
PDF417,
CODE32,
QR.

Если не указан — позиция пропускается.		 “QR”
Value string - Значение штрихкода в текстовом виде.

Обязательно Value или ValueBase64.

Если оба пустые — позиция пропускается.		 “https://roga-i-kopyta.ru"
ValueBase64 string - Значение штрихкода в кодировке Base64. “c2VjdXJlLXJhbmRvbS12YWx1ZS0xMjM0NTY3ODkw”
Alignment string - Выравнивание штрихкода:
left,
right,
center.

Если не указано — center.		 “center”

Picture

Имя поля Тип Обяз Назначение Пример
Value string + Изображение в Base64.

Если пустой — позиция пропускается.		 “iVBORw0KGgo…”
Alignment int - Выравнивание:
0 — слева,
1 — по центру (по умолчанию),
2 — справа.

Если не указано — 1 (центр).		 1

SeparatorLine

Имя поля Тип Обяз Назначение Пример
lineStyle int - Стиль разделительной линии:
0 — Solid (сплошная, по умолчанию);
1 — Bold (жирная);
2 — Dashed (штриховая);
3 — Dotted (пунктирная);
4 — Double (двойная).

Если не указан — сплошная линия.		 3

AdvItem

Имя поля Тип Обяз Назначение Пример
PrintLine PrintLine + Строка печати “PrintLine”:

PrintLine

Имя поля Тип Обяз Назначение Пример
Type int + Тип строки.
0 — фискальная строка;
1 — текстовая строка;
2 — штрихкод;
3 — изображение;
4, Line — линия.

Если не указано — принимается значение 1 (TextString).		 1
Width int - Ширина.

Если не указано — 0 (ширина по содержимому).		 0
Scale int - Масштаб.

Если не указано — применяется масштаб 100%.		 100
Line string - Текст строки (левая часть) “Текст”
LineRight string - Текст строки (правая часть) “Информация”
Alignment int - Выравнивание.
0 — выравнивание по левому краю;
1 — Выравнивание по центру;
2 — Выравнивание по правому краю;
3 — По ширине.

Если не указано — по левому краю.		 1
Font int - Шрифт.
0 — Шрифт для обычных строк;
1 — Жирный шрифт;
2 — Мелкий шрифт;
3 — Средний шрифт;
4 — Крупный шрифт ;
5 — Стиль заголовка первого уровня (H1);
6 — Стиль заголовка второго уровня (H2);
7 — Стиль заголовка третьего уровня (H3);
8 — Стиль заголовка четвёртого уровня (H4);
9 — Стиль заголовка пятого уровня (H5).

Если не указано — 0 (Normal).		 0
Wrap bool - Признак переноса строк.
false - строка обрезается;
true - строка переносится. Если не указано — принимается значение true.		 true
Barcode Barcode - Штрихкод “Barcode”: {
“Type”: “QR”,
“Value”: “https://www.rbsoft.ru/”,
“PrintText”: 0,
“Height”: 30,
“BarWidth”: 6
}
SeparatorLine SeparatorLine - Разделительная линия “SeparatorLine”:
Picture Picture - Картинка “Picture”:

Barcode

Имя поля Тип Обяз Назначение Пример
Type string + Тип штрихкода.
Возможные значения:
UPCA,
CODE39,
EAN13,
EAN8,
UPCE,
ITF,
CODABAR,
CODE93,
CODE128,
PDF417,
CODE32,
QR		 “QR”
Value string + Значение штрихкода “t=20260522T1506&s=50.00&fn=9999078902010507&i=343&fp=1352614355&n=1”
PrintText int - Задает способ печати текста штрихкода(только для одномерных штрихкодов).
0 — не печатать
1 — печатать снизу
2 — печатать сверху
3 — печатать сверху и снизу. Если не указано — 0.		 1
Height int - Высота штрихкода в точках.
Допустимые значения свойства: 0..1199		 100
BarWidth int - Ширина штриха в точках
Допустимые значения свойства: 0..1199
Рекомендуемое значение – 2.		 100

RequestKM

Имя поля Тип Обяз Назначение Пример
Guid string - Уникальный код запроса. Его можно описать для дальнейшего применения в запросе marking/km/confirm. “46dc63e5-8efa-4da6-b8ee-d6188da7b26a”
NotSendToServer bool - Признак того, что результат проверки не нужно отправлять на сервер ОИСМ. Применяется, если при продаже маркированного товара указывать код маркировки в чеке необязательно.

Если не указано — принимается значение false.		 false
WaitForResult bool - Признак ожидания ответа ОИСМ.

Если не указано — принимается значение false.		 false
MarkingCode string + Код маркировки в кодировке Base64. “MDEwNDY3MDU0MDE3NjA5OTIxNSdXOVVtHTkzZEdWeg==”
PlannedStatus int + Планируемый статус (таблица 105 ФФД):
1 — реализован,
2 — мерный в стадии реализации,
3 — возвращён,
4 — часть возвращена,
255 — статус не изменился		 1
Quantity decimal - Количество товара. 1
MeasureOfQuantity int - Мера количества товара (таблица 114 ФФД).

Если не указано — 0.		 0
FractionalQuantityNumerator int - Числитель дробного количества товара. Указывается вместе с FractionalQuantityDenominator. 0
FractionalQuantityDenominator int - Знаменатель дробного количества товара. 0

Выходные типы данных

Barcode

Имя параметра Тип Обяз Назначение Пример
Type string - Тип штрихкода.
Возможные значения:
UPCA,
CODE39,
EAN13,
EAN8,
UPCE,
ITF,
CODABAR,
CODE93,
CODE128,
PDF417,
CODE32,
QR		 “QR”
Value string - Значение штрихкода “t=20260522T1506&s=50.00&fn=9999078902010507&i=343&fp=1352614355&n=1”
PictureBase64 string - Изображение штрихкода, закодированное в Base64 “iVBORw0KGgoAAAANSUhEUgAAAH0AAAB9CAIAAAAA4vtyAAAA…”
PrintText int - Задает способ печати текста штрихкода(только для одномерных штрихкодов).
0 — не печатать
1 — печатать снизу
2 — печатать сверху
3 — печатать сверху и снизу		 1
Height int - Высота штрихкода в точках.
Допустимые значения свойства: 0..1199		 100
BarWidth int - Ширина штриха в точках.
Допустимые значения свойства: 0..1199
Рекомендуемое значение – 2.		 100

SeparatorLine

Имя параметра Тип Обяз Назначение Пример
LineStyle int - Стиль разделительной линии:
0 — сплошная линия;
1 — жирная линия;
2 — штриховая линия;
3 — пунктирная линия;
4 — двойная линия		 1

FnInfo

Имя параметра Тип Обяз Назначение Пример
Execution string - Исполнение ФН ”“
FnContainsKeysUpdaterServerUri bool - ФН содержит URI сервера ОКП false
FiscalizationsCount int - Количество проведенных регистраций 0
FiscalizationsFree int - Количество оставшихся регистраций 0
FiscalizationDocumentNumber string - Номер документа регистрация фискального накопителя “0”
FiscalizationDateTime datetime - Дата и время операции регистрации фискального накопителя “2026-02-15T00:00:00”
ReasonCode int - Код причины перерегистрации: 0 — Нет причины / первичная регистрация (не перерегистрация);
1 — Замена ФН;
2 — Замена ОФД;
3 — Изменение реквизитов;
4 — Изменение настроек ККТ		 0
LivePhase string - Фаза жизни ФН:
init - настройка ФН;
configured - настроен, готов в активации;
fiscalMode - фискальный режим;
postFiscalMode - постфискальный режим;
accessArchive - доступ к архиву ФН;
unknown - неизвестная фаза жизни		 “fiscalMode”
Version string - Версия ФН “1.0”
RnNumber string - Регистрационный номер ККТ “00031415926”
FnsUrl string - Адрес сайта уполномоченного органа(ФНС) в сети «Интернет» “nalog.ru”
SenderEmail string - Адрес электронной почты отправителя чека “ivanov@mail.ru”
FfdVersion string - Версия ФФД ФН “1.2”
SerialNumber string - Серийный номер ФН “0123123123123”
OrganizationName string - Название организации “ООО ‘Ромашка’“
Vatin string - ИНН организации “7722345678”
ValidityDate datetime - Срок действия ФН “2027-06-08T17:22:38.2396579+08:00”
SaleAddress string - Адрес установки ККТ для проведения расчетов “г.Улан-Удэ, ул.Виноградная, д11А, офис 25”
SaleLocation string - Место проведения расчетов “Офис”
TaxVariant int - Коды систем налогообложения:
1 — Общая (ОСН);
2 — Упрощенная Доход(УСН);
3 — Упрощенная Доход минус Расход(УСНД_Р);
4 — Единый налог на вмененный доход(ЕНВД);
5 — Единый сельскохозяйственный налог(ЕСН);
6 — Патентная система налогообложения(ПСН)		 63
SignOfAgent int - Коды признаков агента.
0 — Банковский платежный агент;
1 — Банковский платежный субагент;
2 — Платежный агент;
3 — Платежный субагент;
4— Поверенный;
5 — Комиссионер;
6 — Агент;
 127

Ofd

Имя параметра Тип Обяз Назначение Пример
Name string - Имя ОФД “Тестовый ОФД”
Vatin string - ИНН ОФД “1234554321”
Host string - Адрес сервера ОФД “ofd.example.ru”
Port int - Порт сервера ОФД 7777

Warnings / FnWarnings

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

FnModes

Имя параметра Тип Обяз Назначение Пример
PrinterAutomatic bool - Признак установки принтера в автомате false
OfflineMode bool - Признак автономного режима false
ServiceSign bool - Признак расчетов за услуги false
BsoSign bool - Признак формирования только БСО false
CalcOnlineSign bool - Признак ККТ для расчетов только в Интернет false
DataEncryption bool - Признак шифрование данных false
SaleExcisableGoods bool - Продажа подакцизного товара false
SignOfGambling bool - Признак проведения азартных игр false
SignOfLottery bool - Признак проведения лотереи false
Pawnshop bool - Признак применения при осуществлении ломбардами кредитования граждан false
Assurance bool - Признак применения при осуществлении деятельности по страхованию false
Marking bool - Признак применения при осуществлении торговли товарами, подлежащими обязательной маркировке средствами идентификации false
VendingMachine bool - Признак применения в автоматическом торговом автомате false
CateringServices bool - Признак применения при оказании услуг общественного питания false
WholesaleTrade bool - Признак применения о оптовой торговле с организациями и ИП false
AutomaticMode bool - Признак автоматического режима false

KktInfo

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

DriverInfo

Имя параметра Тип Обяз Назначение Пример
Type string - Тип драйвера “Atol”
Version string - Версия драйвера “26.01.27”
Vendor string - Данные поставщика “Atol”

KktStatus

Имя параметра Тип Обяз Назначение Пример
IsFnPresent bool - Присутствует ли фискальный накопитель false
IsFnError bool - Находится ли фискальный накопитель в состоянии ошибки false
IsIsmDisconnected bool - Доступен ли информационной системы маркировки false
IsOfdDisconnected bool - Доступен ли оператор информационной системы маркировки false
Backlog Backlog - Данные о непереданных документах “Backlog”:
Ism ExchangeStatusIsm - Состояние обмена с ИСМ “ExchangeStatusIsm”: {
“AddressIsm”: “testism.ru”,
“PortIsm”: 20,
“Errors”: {
“FnCommandCode”: 0,
“DocumentNumber”: 0,
“LastSuccessConnectionDateTime”: “0001-01-01T00:00:00”,
“Fn”: {
“Code”: 0
},
“Network”: {
“Code”: 0
},
“Ism”: {
“Code”: 0
}
},
“Status”: {
“DocumentsCounter”: 0,
“DocumentFirstNumber”: 0,
“DocumentFirstDateTime”: “0001-01-01T00:00:00”
},
“Warnings”: {
“DataForSendIsEmpty”: false
}
}
Warnings Warnings - Предупреждения ФН “Warnings”:
ShiftNumber int - Номер смены 17
DocNumber int - Номер фискального документа 98
DocNumberInShift int - Номер фискального документа за смену 3
CashSum decimal - Сумма наличных в денежном ящике 2128.0
TotalSum decimal - Сумма выручки 0.0
IsFiscal bool - Фискальный true
OpenShiftTime DateTime - Время открытия кассовой смены “0001-01-01T00:00:00”
IsShiftOpened bool - Смена открыта false
IsShiftExpired bool - Смена истекла false
ComputerTime DateTime - Время получения данных “2026-05-23T19:50:04.7531056+08:00”
DeviceTime DateTime - Время в часах устройства “2026-05-23T19:50:04.7531056+08:00”
IsDrawerOpened bool - Открыт денежный ящик false
IsCheckPaperPresent bool - Наличие чековой ленты false
IsControlPaperPresent bool - Наличие контрольной ленты false
IsWaitContinuePrint bool - Ожидание продолжения печати false
IsCoverOpened bool - Открыта ли крышка false
IsBatteryLow bool - Аккумулятор разряжен false
IsOpenDocument bool - Открытый документ false
LineLength int - Ширина чековой ленты 42
LineLengthPixels int - Ширина чековой ленты в пикселях 512
TaskId string - Идентификатор текущей задачи “00000000-0000-0000-0000-000000000000”
Error int - Код ошибки 0
ErrorCodeDescription string - Описание ошибки устройства по данным драйвера “OK”
DriverMode int - Режим по данным драйвера 0
DriverModeDescription string - Описание режима Mode по данным драйвера ”“
DriverAdvancedMode int - Специальный режим по данным драйвера 0
DriverAdvancedModeDescription string - Описание режима AdvancedMode по данным драйвера 0
LicenseStatus int - Статус состояния лицензии 0
License License - Описание лицензии “License”:
LicenseUpdated DateTime - Время последней проверке лицензии “0001-01-01T00:00:00”

ExchangeStatusIsm

Имя параметра Тип Обяз Назначение Пример
Address string - Адрес сервера информационной системы маркировки “ism.example.ru”
Port int - Порт сервера информационной системы маркировки 8888
Errors ErrorsIsm - Сведения об ошибках обмена данными “Errors”: {
“FnCommandCode”: 0,
“DocumentNumber”: 0,
“LastSuccessConnectionDateTime”: “0001-01-01T00:00:00”,
“Fn”: {
“Code”: 0
},
“Network”: {
“Code”: 0
},
“Ism”: {
“Code”: 0,
“Description”: “”
}
}
Backlog Backlog - Сведения о непереданных документах “Backlog”:

ErrorsIsm

Имя параметра Тип Обяз Назначение Пример
FnCommandCode int - Код команды фискального накопителя 0
DocumentNumber int - Номер документа 0
LastSuccessConnectionDateTime DateTime - Время последнего успешного подключения “0001-01-01T00:00:00”
Fn FnErrors - Код ошибки фискального накопителя “Fn”: {
“Code”: 0
},
Network NetworkErrors - Код ошибки сети “Network”:
Ism IsmErrors - Код ошибки информационной системы маркировки “Ism”:

FnErrors

Имя параметра Тип Обяз Назначение Пример
Code int - Код ошибки ФН 0

NetworkErrors

Имя параметра Тип Обяз Назначение Пример
Code int - Код ошибки сети 0

IsmErrors

Имя параметра Тип Обяз Назначение Пример
Code int - Код ошибки ИСМ 0
Description string - Описание ошибки “Нет ошибок”

Backlog

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

License

Имя параметра Тип Обяз Назначение Пример
code int - Код ошибки 0
isEndUser bool - Признак лицензии на конечного пользователя.
true — лицензия выдана конечному пользователю.
false — лицензия выдана партнеру для перепродажи		 false
isActivated bool - Признак активации false
isBlocked bool - Признак блокировки 0
blockDate DateTime - Дата блокировки “0001-01-01T00:00:00”
date DateTime - Дата продажи “0001-01-01T00:00:00”
expired DateTime - Дата истечения срока действия “0001-01-01T00:00:00”
updateExpired DateTime - Дата истечения доступа к обновлениям “0001-01-01T00:00:00”
limitInstalls int - Количество разрешенных привязок равно числу ККМ, которые можно привязать к одной лицензии 0
needObjectActivation bool - Признак необходимости привязки объектов лицензирования после привязки. 0
limitObjects int - Количество объектов привязки на каждую установку 0
setupTokenIndex int - Индекс установочного токена 0
LicenseUpdated DateTime - Время последней проверке лицензии “0001-01-01T00:00:00”

CashDrawer

Имя параметра Тип Обяз Назначение Пример
Sum decimal - Сумма 1365.68
Count int - Количество 7

ShiftIncome

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

ShiftCounters

Имя параметра Тип Обяз Назначение Пример
SumCorrection decimal - Сумма коррекций 0.0
NumberCorrections int - Количество коррекций 0
Sales DocData - Чеки прихода “Sales”: {
“Count”: 0,
“Sum”: 50,
“Payments”: {
“Sum”: 24739.54,
“Cash”: 25163.08,
“Credit”: 9400.00,
“Electronically”: 4949.54,
“Barter”: 2350.00,
“Prepaid”: 4700.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_20”: 93.03,
“TaxVat_7”: 1536.90
}
}
SalesReturn DocData Чеки возврата прихода “SalesReturn”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
SalesCorrection DocData - Чеки прихода “SalesCorrection”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
SalesReturnCorrection DocData - Чеки возврата прихода “SalesReturnCorrection”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
Purchases DocData - Чеки расхода “Purchases”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
PurchasesReturn DocData - Чеки возврата расхода “PurchasesReturn”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
PurchasesCorrection DocData - Чеки расхода “PurchasesCorrection”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
},
PurchasesReturnCorrection DocData - Чеки возврата расхода “PurchasesReturnCorrection”: {
“Count”: 45,
“Sum”: 4500.0,
“Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
“Discount”: {
“Count”: 0,
“Sum”: 0.0
},
“Adding”: {
“Count”: 0,
“Sum”: 0.0
},
“Tax”: {
“TaxVat_7”: 294.30
}
}

DocData

Имя параметра Тип Обяз Назначение Пример
Count int - Количество 0
Sum decimal - Сумма 50.0
Payments DocDataPayments - Оплаты “Payments”: {
“Sum”: 4500.0,
“Cash”: 4500.00,
“Credit”: 1800.00,
“Electronically”: 900.00,
“Barter”: 450.00,
“Prepaid”: 900.00
},
Discount RegData - Скидка Discount”:
Adding RegData - Надбавки “Adding”:
Tax Taxes - Налоги “Tax”:

DocDataPayments

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

RegData

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

Taxes

Имя поля Тип Обяз Назначение Пример
TaxVat_10 decimal - Ставка НДС 10% 0
TaxVat_110 decimal - Ставка 10/110 0
TaxVat_0 decimal - Ставка НДС 0 0
TaxVat_NO decimal - Ставка без НДС 0
TaxVat_20 decimal - Ставка НДС 20% 0
TaxVat_120 decimal - Ставка 20/120 0
TaxVat_22 decimal - Ставка НДС 22% 0
TaxVat_122 decimal - Ставка 22/122 0
TaxVat_5 decimal - Ставка НДС 5% 0
TaxVat_105 decimal - Ставка НДС 5/105 0
TaxVat_7 decimal - Ставка НДС 7% 0
TaxVat_107 decimal - Ставка НДС 7/107 0

ProxyConfig

Имя поля Тип Обяз Назначение Пример
IsUseProxy bool - Использовать прокси-сервер false
IsUseProxyService bool - Использовать прокси-сервер для работы сервера ККМ false
IsUseProxyMarking bool - Использовать прокси-сервер для работы с сервисами по проверки маркировки false
IpAddress string - IP-адрес прокси “193.148.21.111”
Port int - Порт прокси 67
Name string - Логин к прокси-серверу “ProxyName”
Password string - Пароль к прокси-серверу “ProxyPassword”

OutputParametersV4

Имя поля Тип Обяз Назначение Пример
NumberOfChecks int - Количество кассовых чеков за смену 1
NumberOfDocuments int - Количество общее ФД за смену 1
ResourcesFn int - Срок действия ключей фискального признака 365
ShiftNumber int - Номер открытой смены/Номер закрытой смены 2
CheckNumber int - Номер последнего фискального документа 3
ShiftClosingCheckNumber int - Номер последнего чека за смену 1
DateTime DateTime - Дата и время формирования фискального документа “2026-05-23T23:45:15.6391315+08:00”
ShiftState int - Состояние смены:
1 — Закрыта;
2 - Открыта;
3 — Истекла		 2
CashBalance decimal - Остаток наличных денежных средств в кассе 0.0
FnValidityDate DateTime - Срок действия ФН “2027-05-23T23:45:15.6391315+08:00”
Backlog Backlog - Данные о непереданных документах “Backlog”:
FnWarnings FnWarnings Флаги состояния ФН “FnWarnings”:

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
Model string - Название модели АТОЛ FPrint-22ПТК
SerialNumber string - Заводской номер ККТ “0020260207”
FirmwareVersion string - Версия прошивки “2026”
ConfigurationVersion string - Версия конфигурации прошивки устройства “02.07”

KktLicenseInfo

Имя поля Тип Обяз Назначение Пример
Number int - Номер лицензии “1”
Name string - Наименование лицензии “Лицензия №1”
ValidFrom DateTime - Дата начала действия лицензии “2026-06-17T06:23:45”
ValidUntil DateTime - Дата окончания действия лицензии “2027-06-17T06:23:45”
UnitVersion string - Максимально поддерживаемая конфигурация. “5.14”
Description string - Описание последствий окончания лицензии “Лицензия истекла!”
IsActive bool - Лицензия действует для текущей прошивки “true”

OutputParameters

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

DocumentHeader

Имя параметра Тип Обяз Назначение Пример
OrganizationInfo string - Название организации “ООО ‘Ромашка’“
SerialNumber string - Заводской номер ККТ “00106305393630”
Vatin string - ИНН Организации “7722345678”
Cashier string - Кассир “Иванов А.И.”
RnNumber string - Регистрационный номер ККТ “0000000002005725”
Fn string - Фискальный накопитель “0123123123123”
FnsUrl string - Адрес сайта уполномоченного органа (ФНС) в сети «Интернет» “nalog.ru”
ShiftNumber int - Номер смены 39
DocNumber int - Номер фискального документа 343
FiscalSign string - Фискальный признак документа “1352614355”
OfdOrganizationName string - Наименование провайдера ОФД Тестовый ОФД
OfdVatin string - ИНН провайдера ОФД 7709364346

ShiftTotal

Имя поля Тип Обяз Назначение Пример
IsCountersReaded bool - Прочитаны ли дополнительные счетчики ККМ true
ShiftNumber double + Номер смены 3.0
CashDrawer CashDrawer - Детали ленежного ящиика “CashDrawer”: {
“Sum”: 0,
“Count”: 0
},
ShiftIncome ShiftIncome - Внесение “ShiftIncome”: {
“Count”: 0,
“Sum”: 0
},
ShiftOutcome ShiftIncome - Выемка “ShiftOutcome”: {
“Count”: 0,
“Sum”: 0
},
Counters ShiftCounters - Счётчики за кассовую смену “Counters”:

ShiftCounters

Имя поля Тип Обяз Назначение Пример
SumCorrection decimal - Сумма коррекций 0.0
NumberCorrections int - Количество коррекций 0

overallTotals

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

CheckItem

Имя поля Тип Обяз Назначение Пример
Name string - Название Бутылка с водой 1л.”
Quantity decimal - Количество товара 1
Price decimal - Цена позиции 50.0
Department int - Отдел 0
Sum decimal - Сумма с учетом скидки 50.0
IsFiscal bool - Фискальный режим true
TaxValue int - Ставка НДС 20
PaymentMode int - Признак способа расчёта:
0 — Не Применяется,
1 — Полная предварительная оплата до момента передачи предмета расчета,
2 — Частичная предварительная оплата до момента передачи предмета расчета,
3 — Аванс,
4 — Полная оплата, в том числе с учетом аванса (предварительной оплаты) в момент передачи предмета расчета,
5 — Частичная оплата предмета расчета в момент его передачи с последующей оплатой в кредит,
6 — Передача предмета расчета без его оплаты в момент его передачи с последующей оплатой в кредит,
7 — Оплата предмета расчета после его передачи с оплатой в кредит (оплата кредита)		 3
ItemType int - Признак предмета расчёта(тег 1030) 10
ExciseAmount decimal - Сумма акциза с учетом копеек, включенная в стоимость предмета расчета 0.0
MeasureOfQuantity int - Мера количества предмета расчета 20

CustomerDetail

Имя поля Тип Обяз Назначение Пример
Info string - Наименование организации или фамилия, имя, отчество (при наличии) “ООО ‘Рога и Копыта’“
Inn string - ИНН организации или покупателя (клиента) “500100732259”
Email string - Электронная почта “kuznicov@mail.ru”

QrCheckData

Имя поля Тип Обяз Назначение Пример
Date DateTime - Дата создания документа “2026-05-24T00:11:23.5221437+08:00”
Amount decimal - Сумма чека 50.0
Fn string - Фискальный накопитель “1234554321”
Fd int - Фискальный документ 370
Fp string - Фискальный признак “2928907410”
Fd int - Фискальный документ 370
N int - Тип операции:
1 - Приход;
2 - Возврат прихода;
4 - Расход;
5 - Возврат расхода;
7 - Коррекция прихода;
9 - Коррекция расхода		 370

Payments

Имя поля Тип Обяз Назначение Пример
Cash decimal - Сумма наличной оплаты 0.0
Barter decimal - Сумма встречным предоставлением) 10.0
PrePaid decimal - Сумма предоплатой (зачетом аванса) 0.0
Credit decimal - Сумма постоплатой (в кредит) 0.0
Electronic decimal - Сумма безналичными средствами 0.0

PrintLine

Имя поля Тип Обяз Назначение Пример
Type int - Тип строки.
0 — фискальная строка;
1 — текстовая строка;
2 — штрихкод;
3 — изображение;
4 — разделительная линия		 1
Width int - Ширина 0
Scale int - Масштаб 100
Line string - Текст строки (левая часть) “Кассовый чек”
LineRight string - Текст строки (правая часть) ”“
Alignment int - Выравнивание.
0 — выравнивание по левому краю;
1 — Выравнивание по центру;
2 — Выравнивание по правому краю;
3 — По ширине		 1
Font int - Шрифт.
Normal — Шрифт для обычных строк;
Bold — Жирный шрифт;
Small — Мелкий шрифт;
Medium — Средний шрифт;
Big — Крупный шрифт;
H1 — Стиль заголовка первого уровня (название документа);
H2 — Стиль заголовка второго уровня (раздел документа);
H3 — Стиль заголовка третьего уровня (подраздел);
H4 — Стиль заголовка четвёртого уровня (детализация подраздела);
H5 — Стиль заголовка пятого уровня (дополнительная детализация);		 0
Wrap bool - Признак переноса строк.
false - строка обрезается;
true - строка переносится		 true
IsFontSpecified bool - Признак, что шрифт задан явно во входящих данных или при создании строки true
SeparatorLine SeparatorLine - Разделительная линия “SeparatorLine”: {
“lineStyle”: 3
Barcode Barcode - Штрихкод “Barcode”: {
“Type”: “QR”,
“Value”: “t=20260524T1252&s=50.00&fn=9999078902010507&i=370&fp=2928907410&n=1”,
“PictureBase64”: “iVBORw0KGgoAA…”,
“PrintText”: 1,
“Height”: 100,
“BarWidth”: 100
},
Picture Picture - Картинка “Picture”:
IsCreateFromTemplate bool - Создано из шаблона.
true - создано из печатного шаблона;
false — не создан из печатного шаблона		 false
BarcodeLines Список строк - Список строк, выводимые спрва или слева от штрихакодв “ЗН ККТ: 00106305393630”,
“РН ККТ: 0000000002005725”,
“ИНН 0326031413”,
“ФН: 9999078902010507”,
“ФД: 343”,
“ФП: 1352614355”,
“ПРИХОД”,
“22.05.26 15:06”,
“Сайт ФНС:
http://www.nalog.gov.ru

CorrectionData

Имя поля Тип Обяз Назначение Пример
Type int - Тип коррекции:
0 — самостоятельно;
1 — по предписанию		 1
Description string - Описание коррекции “Основание”
Date DateTime - Дата совершения корректируемого расчета “2026-05-24T00:11:23.5221437+08:00”
Number string - Номер предписания налогового органа “0”

ApiPayments

Имя поля Тип Обяз Назначение Пример
Cash decimal - Сумма наличной оплаты 0.0
Barter decimal - Сумма встречным предоставлением) 10.0
PrePaid decimal - Сумма предоплатой (зачетом аванса) 0.0
Credit decimal - Сумма постоплатой (в кредит) 0.0
Electronic decimal - Сумма безналичными средствами 0.0

Picture

Имя поля Тип Обяз Назначение Пример
PictureBase64 string + Изображение закодированное в Base64 “iVBORw0KGgoAAAANSUhEUgA…”
Alignment int - Выравнивание:
1 - по левому краю;
2 - по центру;
3 - по правому краю.		 2
Width int - Ширина изображения при печати, в точках 200
Height int - Высота изображения при печати, в точках 80
StartLineNumber int - Номер первой строки печати изображения 0
EndLineNumber int - Номер последней строки печати изображения 0
IsUploaded bool - Признак загрузки изображения в память ККТ false
Override bool - Признак перезаписи изображения в памяти ККТ false

DocumentHistory

Имя поля Тип Обяз Назначение Пример
Time datetime - Время события “2026-05-21T16:57:25”
State int - Код состояния задачи на момент события. 4
Description string - Описание события “Добавление в очередь”
Info string - Дополнительная информация ”“

CodeMarkInfo

Имя поля Тип Назначение Пример
cis string - Полный код маркировки
valid bool - Результат проверки валидности структуры кода идентификации (КИ) / кода маркировки (КиЗ).
true — структура валидна,
false — не валидна.
printView string - Код маркировки без крипто-подписи
groupIds int[] - Массив идентификаторов товарных групп.
1 (lp) — Предметы одежды, бельё постельное, столовое, туалетное и кухонное
2 (shoes) — Обувные товары
3 (tobacco) — Табачная продукция
4 (perfumery) — Духи и туалетная вода
5 (tires) — Шины и покрышки пневматические резиновые новые
6 (electronics) — Фотокамеры (кроме кинокамер), фотовспышки и лампы-вспышки
8 (milk) — Молочная продукция
9 (bicycle) — Велосипеды и велосипедные рамы
10 (wheelchairs) — Медицинские изделия
12 (otp) — Альтернативная табачная продукция
13 (water) — Упакованная вода
14 (furs) — Товары из натурального меха
15 (beer) — Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки
16 (ncp) — никотиносодержащая продукция
17 (bio) — Биологически активные добавки к пище
19 (antiseptic) — Антисептики и дезинфицирующие средства
20 (petfood) — Корма для животных
21 (seafood) — Морепродукты
22 (nabeer) — Безалкогольное пиво
23 (softdrinks) — Соковая продукция и безалкогольные напитки
26 (vetpharma) — Ветеринарные препараты
27 (toys) — Игры и игрушки для детей
28 (radio) — Радиоэлектронная продукция
31 (titan) — Титановая металлопродукция
32 (conserve) — Консервированная продукция
33 (vegetableoil) — Растительные масла
34 (opticfiber) — Оптоволокно и оптоволоконная продукция
35 (chemistry) — Парфюмерные и косметические средства и бытовая химия
38 (pharmaraw) — Фармацевтическое сырьё, лекарственные средства
verified bool - Результат криптографической проверки кода. Для всех товарных групп, кроме “Товары из натурального меха”:
true — проверка крипто-подписи успешна,
false — проверка крипто-подписи завершилась с ошибкой.

Для “Товаров из натурального меха”: true — КиЗ найден в “ИР Маркировки”.
false — КиЗ не найден в “ИР Маркировки”.
realizable bool - Признак того, что код находится в статусе “В обороте”
utilised bool - Признак нанесения кода на упаковку товара
found bool - Признак того, что код найден в ГИС МТ
errorCode int - Код ошибки.
0 — ошибки отсутствуют;
1 — «Ошибка валидации КМ»;
2 — “КМ не содержит GTIN”;
3 — “КМ не содержит серийный номер”;
4 — “КМ содержит недопустимые символы”;
5 — “Ошибка верификации крипто-подписи КМ(формат крипто-подписи не соответствует типу КМ)”;
6 — “Ошибка верификации крипто-подписи КМ(крипто-подпись не валидная)”;
7 — “Ошибка верификации крипто-подписи КМ(крипто-ключ не валиден)”;
8 — “КМ не прошел верификацию в стране эмитента”;
9 — “Найденные AI в КМ не поддерживаются”;
10 — “КМ не найден в ГИС МТ”
message string - Сообщение об ошибке
isTracking bool - Признак старта прослеживаемости в товарной группе.
true — прослеживаемость в товарной группе для данного КИ / КиЗ включена;
false — прослеживаемость в товарной группе для данного КИ /КиЗ не включена
sold bool - Признак того, что товар с данным кодом уже продан
gtin string - Код товара (GTIN)
packageType string - Тип упаковки.
Для товарной группы “Товары из натурального меха” значение всегда UNIT.

UNIT, Единица товара (КИ) — Пачка, Потребительская упаковка;
GROUP, Групповая — упаковка (КИГУ);
SET — Набор (КИН);
BUNDLE, Комплект (КИК) — Комплект (КИК). Используется только для товарной группы “Предметы одежды, бельё постельное, столовое, туалетное и кухонное”;
BOX — Транспортная упаковка (КИТУ);
ATK — Агрегированный таможенный код (АТК).
В составе АТК может быть:
- КИ;
- КИК;
- КИГУ (кроме товарной группы “Медицинские изделия”);
- КИТУ (только для товарных групп “Антисептики и дезинфицирующие средства”, “Биологически активные добавки к пище”, “Медицинские изделия”, “Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки”, “Соковая продукция и безалкогольные напитки”, “Упакованная вода”).

Возвращаются в ответе:
LEVEL1 — Транспортная упаковка 1-го уровня (КИТУ). Также может быть групповой упаковкой (КИГУ) —  блок.
LEVEL2 — Транспортная упаковка 2-го уровня(КИТУ), Короб.
LEVEL3 — Транспортная упаковка 3-го уровня (КИТУ), Палета.
LEVEL4 — Транспортная упаковка 4-го уровня(КИТУ).
LEVEL5 — Транспортная упаковка 5-го уровня(КИТУ)
producerInn string - ИНН производителя
grayZone bool - Признак нахождения продукции в “серой зоне” (только для товарных групп “Альтернативная табачная продукция”, “Никотиносодержащая продукция”, “Табачная продукция”).
Возможные значения:
true —  находится в серой зоне;
false —  не находится в серой зоне.
isBlocked bool - Признак блокировки кода по решению органа государственной власти (ОГВ)
isGreyGtin bool - Признак некорректного (не зарегистрированного в справочниках) GTIN в составе кода
ogvs string[] - Органы государственной власти, установившие блокировку кода (заполняется при isBlocked = true):
RAR — Росалкогольрегулирование;
FTS — ФТС России;
FNS — ФНС России;
RSHN — Россельхознадзор;
RPN — Роспотребнадзор;
MVD — МВД России;
RZN — Росздравнадзор.
found bool - Признак наличия КМ в ГИС МТ.
true — КМ найден;
false —  КМ не найден
packageQuantity int - Ёмкость КИГУ.
Количество потенциально вмещаемых вложений

CheckTemplateDocument

Имя поля Тип Обяз Назначение Пример
TaskType int - Тип чека.
0 — Текст;
1 — Продажа;
2 — Возврат;
3 — Покупка;
4 — ВозвратПокупки;
5 — ЧекКоррекцииПрихода;
6 — ЧекКоррекцииВозвратаПрихода;
7 — ЧекКоррекцииРасхода;
8 — ЧекКоррекцииВозвратаРасхода		 1
TaxType int - Система налогообложения:
0 — Общая (ОСН);
1 — Упрощенная Доход(УСН);
2 — Упрощенная Доход минус Расход(УСНД_Р);
3 — Единый налог на вмененный доход(ЕНВД);
4 — Единый сельскохозяйственный налог(ЕСН);
5 — Патентная система налогообложения(ПСН)		 0
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)		 9
OperationOnline bool - Признак применения ККТ при расчёте в безналичном порядке в сети «Интернет» false
IsReplaceTax bool - Признак замены системы налогообложения настройками ККТ true
TrustedInFn bool - Подтвержден в ФН false
Sum decimal - Сумма с учетом скидки 0.0
Change decimal - Сдача 0
Electronically bool - Регистрация чека без печати на ленте false
IsFiscal bool - Фискальный режим true
MtNumber int - Номер документа “Уведомление о реализации МТ” в который включается данные чека 0
PrintError bool - Ошибка при печати бумажной формы чека false
CheckItems Список CheckItem - Позиции шаблона []
Payments Payments - Способы оплаты “Payments”: