Работа с маркировкой
> СерверККМ V4 > REST API > Работа с ККМДата обновления: 7 августа 2026 г.
POST marking/session/open
Открытие сессии регистрации (проверки) кодов маркировки на ККТ.
URL: {{HTTPRoot}}/marking/session/open
Тело запроса
{
"DeviceName": "Atol"
}
| Имя поля | Тип | Обяз | Назначение | Пример |
|---|---|---|---|---|
| DeviceName | string | + | Название устройства | “Atol” |
Тело ответа
200 ОК
{
"Code": 0,
"Description": "OK",
"Success": true
}
Result (BooleanResponse)
| Имя поля | Тип | Обяз | Назначение | Пример |
|---|---|---|---|---|
| Code | int | - | Код ошибки | 0 |
| Description | string | - | Описание результата | “Ok” |
| Success | bool | - | Признак успешного открытия сессии. true — сессия открыта. |
true |
Примеры ошибок
-1 Не удалось найти устройство
{
"Code": -1,
"Description": "Не удалось найти устройство atol",
"Success": false
}
POST marking/session/close
Закрытие сессии регистрации (проверки) кодов маркировки на ККТ.
URL: {{HTTPRoot}}/marking/session/close
Тело запроса
{
"DeviceName": "Atol"
}
Смотрите документацию POST-запроса marking/session/open
Тело ответа
200 ОК
{
"Code": 0,
"Description": "OK",
"Success": true
}
Result (BooleanResponse)
Смотрите документацию POST-запроса marking/session/open
Примеры ошибок
-1 Не удалось найти устройство
{
"Code": -1,
"Description": "Не удалось найти устройство atol",
"Success": false
}
POST marking/km/request
Локальная проверка кода маркировки на ККТ (ФФД 1.2).
URL: {{HTTPRoot}}/marking/km/request
Тело запроса
{
"RequestKM": {
"Guid": "46dc63e5-8efa-4da6-b8ee-d6188da7b26a",
"NotSendToServer": true,
"WaitForResult": true,
"MarkingCode": "MDEwNDgxMTY0NDAwMDkwNzIxMkhMclVhY0hIS1ZqeR05MVYwMDMdOTJxdGxrdUltRjFINFBteT04U3NROjF5WC08dXN5JUpLMSY2Wk96ZEEwZmVOKQ==",
"PlannedStatus": 0,
"Quantity": 0,
"MeasureOfQuantity": 0,
"FractionalQuantityNumerator": 0,
"FractionalQuantityDenominator": 0
},
"DeviceName": "Atol"
}
| Имя поля | Тип | Обяз | Назначение | Пример |
|---|---|---|---|---|
| DeviceName | string | + | Название устройства | “Atol” |
| RequestKM | RequestKM | + | Параметры проверяемого кода маркировки. | “RequestKM”: |
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 |
Тело ответа
200 ОК
{
"ISMConnected": true,
"FormatChecking": true,
"Checking": true,
"CheckingResult": false,
"Code": 0,
"Description": "Ошибок нет"
}
Result (RequestKMResult)
| Имя поля | Тип | Обяз | Назначение | Пример |
|---|---|---|---|---|
| ISMConnected | bool | - | Признак наличия связи с ОИСМ на момент отправки запроса | true |
| FormatChecking | bool | - | Признак того, что проверка формата кода маркировки прошла успешно | true |
| Checking | bool | - | Признак того, что проверка кода маркировки поставлена в обработку | true |
| CheckingResult | bool | - | Результат проверки, если он уже доступен на момент ответа. | false |
| Code | int | - | Код ошибки. 0 — Проверка была проведена успешна |
0 |
| Description | string | - | Описание | “Ошибок нет” |
Примеры ошибок
68 Драйвер не загружен
{
"ISMConnected": false,
"FormatChecking": false,
"Checking": false,
"CheckingResult": false,
"Code": 68,
"Description": "Драйвер не загружен"
}
414 Операция не разрешена
{
"ISMConnected": false,
"FormatChecking": false,
"Checking": false,
"CheckingResult": false,
"Code": 414,
"Description": "Операция не разрешена, при регистрации не был установлен признак ТМТ"
}
-1 Не удалось найти устройство
{
"ISMConnected": false,
"FormatChecking": false,
"Checking": false,
"CheckingResult": false,
"Code": -1,
"Description": "Не удалось найти устройство "
}
-1 можно применять только для ФФД 1.2
{
"ISMConnected": false,
"FormatChecking": false,
"Checking": false,
"CheckingResult": false,
"Code": -1,
"Description": "RequestKM() можно применять только для ФФД 1.2. У ККМ 'Atol' версия ФФД "
}
404 некорректное значение статуса КМ
{
"Result": {
"ISMConnected": false,
"FormatChecking": false,
"Checking": false,
"CheckingResult": false
},
"Code": 404,
"Description": "Некорректное значение статуса КМ",
"Success": false
}
GET marking/km/result?device=Atol
Получение результата проверки кода маркировки в ОИСМ.
URL: {{HTTPRoot}}/marking/km/result?device=Atol
Параметры запроса
| Имя параметра | Тип | Обяз | Назначение | Пример |
|---|---|---|---|---|
| device | string | + | Имя устройства | “Atol” |
Тело ответа
200 OK
{
"Guid": "3a9b9d1f-c14b-474b-99f3-e09ee9c87620",
"Result": true,
"ResultCode": 0,
"StatusInfo": 1,
"HandleCode": 0,
"RequestStatus": 0,
"Code": 0,
"Description": "OK"
}
200 Результат ещё не получен
{
"Result": {
"Guid": "3a9b9d1f-c14b-474b-99f3-e09ee9c87620",
"RequestStatus": 1,
"Result": false,
"ResultCode": 0,
"StatusInfo": 0,
"HandleCode": 0
},
"Code": 0,
"Description": "OK",
"Success": true
}
Result (ProcessingKMResult)
| Имя поля | Тип | Обяз | Назначение | Пример |
|---|---|---|---|---|
| Result | bool | - | Итог проверки кода маркировки | false |
| ResultCode | int | - | Код результата проверки (тег 2106 ФФД) | 5 |
| HandleCode | int | - | Код обработки запроса (тег 2105 ФФД) | 2 |
| RequestStatus | int | - | Статус получения результата от ОИСМ: 0 — результат получен; 1 — результат ещё не получен; 2 — результат не может быть получен. |
0 |
| Code | int | - | Код ошибки. 0 — Проверка была проведена успешна |
0 |
| Description | string | - | Описание | “Ошибок нет” |
Примеры ошибок
-1 Не удалось найти устройство
{
"Result": false,
"ResultCode": 0,
"HandleCode": 0,
"RequestStatus": 0,
"Code": -1,
"Description": "Не удалось найти устройство atol"
}
-99 Не найден результат последней проверки
{
"Code": -99,
"Description": "Не найден результат последней проверки",
"Success": false
}
4 Не указано имя ККТ
{
"Code": 4,
"Description": "Не указано имя ККТ",
"Success": false
}
-1 Ссылка на объект не указывает на экземпляр объекта.
{
"Result": false,
"ResultCode": 0,
"HandleCode": 0,
"RequestStatus": 0,
"Code": -1,
"Description": "Ссылка на объект не указывает на экземпляр объекта."
}
-1 Метод или операция не реализована
{
"Result": false,
"ResultCode": 0,
"HandleCode": 0,
"RequestStatus": 0,
"Code": -1,
"Description": "Метод или операция не реализована."
}
POST marking/km/confirm
Подтверждение, будет ли ранее проверенный код маркировки фактически включён в документ реализации. Подтверждение действительно только в рамках открытой сессии регистрации кодов маркировки.
URL: {{HTTPRoot}}/marking/km/confirm
Тело запроса
{
"DeviceName": "Atol",
"GUID": "46dc63e5-8efa-4da6-b8ee-d6188da7b26a",
"ConfirmationType": 0
}
| Имя поля | Тип | Обяз | Назначение | Пример |
|---|---|---|---|---|
| DeviceName | string | + | Имя устройства | “Atol” |
| GUID | string | + | Код запроса. Его ранее передавали в marking/km/request. | “46dc63e5-8efa-4da6-b8ee-d6188da7b26a” |
| ConfirmationType | int | + | Признак подтверждения: 0 — код маркировки включён в документ реализации; 1 — код маркировки не включён. Если поле не передано в запросе, оно принимает значение 0 — то есть отсутствие поля равносильно явному подтверждению продажи. |
1 |
Тело ответа
200 OK
{
"Code": 0,
"Description": "OK",
"Success": true
}
Result (BooleanResponse)
Смотрите документацию POST-запроса marking/session/open
Примеры ошибок
-1 Не найдено устройство
{
"Code": -1,
"Description": "Не удалось найти устройство atol",
"Success": false
}
-1 Ссылка на объект не указывает на экземпляр объекта
{
"Code": -1,
"Description": "Ссылка на объект не указывает на экземпляр объекта.",
"Success": false
}
4 Порт недоступен
{
"Code": 4,
"Description": "Порт недоступен",
"Success": false
}
63 Не открыта сессия регистрации КМ
{
"Response": false,
"Code": 63,
"Description": "НеОткрытаСессияРегистрацииКм"
}
422 Данный КМ отсутствует в таблице
{
"Code": 422,
"Description": "Данный КМ отсутствует в таблице",
"Success": false
}
POST marking/km/verify
Проверка кодов маркировки. Метод проверки выбирается в настройках устройства, во вкладке “Маркировка”, категория “Способ проверки маркировки”.
Если выбрана проверка “Автоматически”, сервер последовательно пробует ТС ПИоТ (если для устройства настроен адрес), затем ГИС МТ (если настроена учётная запись ОФД), затем локальный модуль ЧЗ (если он готов), и использует первый доступный способ.
По умолчанию используется ГИС МТ и ЛМ ЧЗ.
URL: {{HTTPRoot}}/marking/km/verify
Тело запроса
{
"DeviceName": "Atol",
"Codes": [
"MDEwNDY3MDU0MDE3NjA5OTIxNSdXOVVtHTkzZEdWeg=="
]
}
| Имя поля | Тип | Обяз | Назначение | Пример |
|---|---|---|---|---|
| DeviceName | string | + | Название устройства | “Atol” |
| Codes | string[] | + | Массив проверяемых кодов маркировки в кодировке Base64. | [“MDEwNDY3MDU0MDE3NjA5OTIxNSdXOVVtHTkzZEdWeg==”] |
Тело ответа
200 OK
{
"Result": {
"code": 0,
"description": "ok",
"codes": [
{
"cis": "0104670540176099215'W9Um?93dGVz",
"valid": true,
"printView": "0104670540176099215'W9Um",
"groupIds": [
8
],
"verified": true,
"realizable": false,
"utilised": false,
"errorCode": 0,
"message": null,
"isTracking": false,
"sold": false,
"gtin": "04670540176099",
"packageType": "UNIT",
"producerInn": "7725344604",
"grayZone": false,
"isBlocked": false,
"isGreyGtin": false,
"ogvs": [],
"found": true,
"packageQuantity": 0
}
],
"reqId": "2c3ec23e-da52-4f28-aa10-1b27e77e36c2",
"reqTimestamp": 1784078114481,
"isCheckedOffline": false,
"status": 0,
"requiresDownload": false,
"lastUpdate": 0,
"lastSync": 0
},
"Code": 0,
"Description": "OK",
"Success": true
}
Result (CheckCodeMarkAnswer)
| Имя поля | Тип | Обяз | Назначение | Пример |
|---|---|---|---|---|
| code | int | - | Код результата обращения к API «Честного Знака» | 0 |
| description | string | - | Описание результата | “OK” |
| reqId | string | + | Идентификатор запроса в сервисе «Честного Знака» | “a1b2c3d4-e5f6-7890-abcd-ef1234567890” |
| reqTimestamp | long | - | Время выполнения проверки КМ (Unix-время в миллисекундах) | 1781076703146 |
| status | int | - | Статус локального модуля ЧЗ, используемого ТС ПИоТ для офлайн-проверки: 0 — unknown(неизвестно); 1 — ready(готов); 2 — initialization(инициализован); 3 — failure(ошибка); 4 — not_configured(не настроен). |
“OK” |
| requiresDownload | bool | - | Признак необходимости скачать или обновить локальную базу данных модуля ЧЗ перед офлайн-проверкой | false |
| lastUpdate | long | - | Время последнего обновления локальной базы данных модуля. 0 — нет данных / не актуально. |
0 |
| lastSync | long | - | Время последней синхронизации модуля с ГИС МТ. 0 — нет данных. |
0 |
| codes | Массив CodeMarkInfo | + | Данные проверки кода маркировки. | “codes”: [ { “Cis”: “0104670540176099215’W9Um93dGVz”, “valid”: true, “verified”: true, “realizable”: true, “utilised”: true, “found”: true, “sold”: true, “isBlocked”: true, “isGreyGtin”: true, “gtin”: “04670540176099”, “groupIds”: [8] } ] |
CodeMarkInfo
| Имя поля | Тип | Назначение | Пример | |
|---|---|---|---|---|
| cis | string | - | Полный код маркировки | “0104670540176099215’W9Um93dGVz” |
| valid | bool | - | Результат проверки валидности структуры кода идентификации (КИ) / кода маркировки (КиЗ). true — структура валидна, false — не валидна. |
true |
| printView | string | - | Код маркировки без крипто-подписи | “0104670540176099215’W9Um” |
| 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) — Фармацевтическое сырьё, лекарственные средства |
[8] |
| verified | bool | - | Результат криптографической проверки кода. Для всех товарных групп, кроме “Товары из натурального меха”: true — проверка крипто-подписи успешна, false — проверка крипто-подписи завершилась с ошибкой. Для “Товаров из натурального меха”: true — КиЗ найден в “ИР Маркировки”. false — КиЗ не найден в “ИР Маркировки”. |
true |
| realizable | bool | - | Признак того, что код находится в статусе “В обороте” | true |
| utilised | bool | - | Признак нанесения кода на упаковку товара | true |
| found | bool | - | Признак того, что код найден в ГИС МТ | true |
| errorCode | int | - | Код ошибки. 0 — ошибки отсутствуют; 1 — «Ошибка валидации КМ»; 2 — “КМ не содержит GTIN”; 3 — “КМ не содержит серийный номер”; 4 — “КМ содержит недопустимые символы”; 5 — “Ошибка верификации крипто-подписи КМ(формат крипто-подписи не соответствует типу КМ)”; 6 — “Ошибка верификации крипто-подписи КМ(крипто-подпись не валидная)”; 7 — “Ошибка верификации крипто-подписи КМ(крипто-ключ не валиден)”; 8 — “КМ не прошел верификацию в стране эмитента”; 9 — “Найденные AI в КМ не поддерживаются”; 10 — “КМ не найден в ГИС МТ” |
0 |
| message | string | - | Сообщение об ошибке | null |
| isTracking | bool | - | true | Признак старта прослеживаемости в товарной группе. true — прослеживаемость в товарной группе для данного КИ / КиЗ включена; false — прослеживаемость в товарной группе для данного КИ /КиЗ не включена |
| sold | bool | - | Признак того, что товар с данным кодом уже продан | true |
| gtin | string | - | Код товара (GTIN) | “04670540176099” |
| packageType | string | - | Тип упаковки. Для товарной группы “Товары из натурального меха” значение всегда UNIT. UNIT, Единица товара (КИ) — Пачка, Потребительская упаковка; GROUP, Групповая — упаковка (КИГУ); SET — Набор (КИН); BUNDLE, Комплект (КИК) — Комплект (КИК). Используется только для товарной группы “Предметы одежды, бельё постельное, столовое, туалетное и кухонное”; BOX — Транспортная упаковка (КИТУ); ATK — Агрегированный таможенный код (АТК). В составе АТК может быть: - КИ; - КИК; - КИГУ (кроме товарной группы “Медицинские изделия”); - КИТУ (только для товарных групп “Антисептики и дезинфицирующие средства”, “Биологически активные добавки к пище”, “Медицинские изделия”, “Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки”, “Соковая продукция и безалкогольные напитки”, “Упакованная вода”). Возвращаются в ответе: LEVEL1 — Транспортная упаковка 1-го уровня (КИТУ). Также может быть групповой упаковкой (КИГУ) — блок. LEVEL2 — Транспортная упаковка 2-го уровня(КИТУ), Короб. LEVEL3 — Транспортная упаковка 3-го уровня (КИТУ), Палета. LEVEL4 — Транспортная упаковка 4-го уровня(КИТУ). LEVEL5 — Транспортная упаковка 5-го уровня(КИТУ) |
“UNIT” |
| producerInn | string | - | ИНН производителя | “7725344604” |
| grayZone | bool | - | Признак нахождения продукции в “серой зоне” (только для товарных групп “Альтернативная табачная продукция”, “Никотиносодержащая продукция”, “Табачная продукция”). Возможные значения: true — находится в серой зоне; false — не находится в серой зоне. |
false |
| isBlocked | bool | - | Признак блокировки кода по решению органа государственной власти (ОГВ) | true |
| isGreyGtin | bool | - | Признак некорректного (не зарегистрированного в справочниках) GTIN в составе кода | true |
| ogvs | string[] | - | Органы государственной власти, установившие блокировку кода (заполняется при isBlocked = true): RAR — Росалкогольрегулирование; FTS — ФТС России; FNS — ФНС России; RSHN — Россельхознадзор; RPN — Роспотребнадзор; MVD — МВД России; RZN — Росздравнадзор. |
[] |
| found | bool | - | Признак наличия КМ в ГИС МТ. true — КМ найден; false — КМ не найден |
true |
| packageQuantity | int | - | Ёмкость КИГУ. Количество потенциально вмещаемых вложений |
0 |
Примеры ошибок
522 Не найдена учётная запись ГИС МТ
{
"Result": {
"code": 522,
"description": "Не найдена учётная запись ГИС МТ",
"reqId": "00000000-0000-0000-0000-000000000000",
"reqTimestamp": 0,
"status": 0,
"requiresDownload": false,
"lastUpdate": 0,
"lastSync": 0
},
"Code": 0,
"Description": "OK",
"Success": true
}
POST marking/km/tspiot/verify
Проверка кодов маркировки через ТС ПИоТ.
Для работы запроса на устройстве должен быть настроен адрес ТС ПИоТ
URL: {{HTTPRoot}}/marking/km/tspiot/verify
Тело запроса
{
"DeviceName": "Atol",
"Codes": [
"MDEwNDY3MDU0MDE3NjA5OTIxNSdXOVVtHTkzZEdWeg=="
]
}
Смотрите документацию POST-запроса marking/km/verify
Тело ответа
200 OK
{
"Result": {
"code": 0,
"description": "ok",
"codes": [
{
"cis": "0104670540176099215'W9Um?93dGVz",
"valid": true,
"printView": "0104670540176099215'W9Um",
"groupIds": [
8
],
"verified": true,
"realizable": false,
"utilised": false,
"errorCode": 0,
"message": null,
"isTracking": false,
"sold": false,
"gtin": "04670540176099",
"packageType": "UNIT",
"producerInn": "7725344604",
"grayZone": false,
"isBlocked": false,
"isGreyGtin": false,
"ogvs": [],
"found": true,
"packageQuantity": 0
}
],
"reqId": "360fa86e-699e-43c5-bf48-67c4c083f470",
"reqTimestamp": 1784078640671,
"isCheckedOffline": false,
"status": 0,
"requiresDownload": false,
"lastUpdate": 0,
"lastSync": 0
},
"Code": 0,
"Description": "OK",
"Success": true
}
Result (CheckCodeMarkAnswer)
Смотрите документацию POST-запроса marking/km/verify
Примеры ошибок
-1 Для устройства не настроен адрес ТС ПИоТ
{
"Code": -1,
"Description": "Для устройства 'Atol' не настроен адрес ТС ПИоТ",
"Success": false
}
-1 Не заполнено поле DeviceName
{
"Code": -1,
"Description": "Не заполнено поле DeviceName",
"Success": false
}
-1 Устройство не найдено
{
"Code": -1,
"Description": "Устройство 'Atol' не найдено",
"Success": false
}
POST marking/km/lmcz/verify
Проверка кодов маркировки через локальный модуль “Честного Знака” (ЛМ ЧЗ).
URL: {{HTTPRoot}}/marking/km/lmcz/verify
Тело запроса
{
"DeviceName": "Atol",
"Codes": [
"MDEwNDY3MDU0MDE3NjA5OTIxNSdXOVVtHTkzZEdWeg=="
]
}
Смотрите документацию POST-запроса marking/km/verify
Тело ответа
200 OK
{
"Result": {
"code": 0,
"description": "OK",
"codes": [
{
"cis": "0104670540176099215'W9Um",
"valid": false,
"verified": false,
"realizable": false,
"utilised": false,
"isTracking": false,
"sold": false,
"gtin": "04670540176099",
"grayZone": false,
"isBlocked": false,
"isGreyGtin": false,
"found": false,
"packageQuantity": 0
}
],
"reqId": "b0bbb45a-e773-8b63-32e6-da06f1002466",
"reqTimestamp": 1781077845362,
"isCheckedOffline": true,
"version": "019e978f-e682-7b78-8127-e7cf95b63586",
"status": 0,
"serviceUrl": "127.0.0.1:5995",
"requiresDownload": false,
"lastUpdate": 0,
"lastSync": 0,
"inst": "019eb008-c2d2-7889-b91a-a3455dc42384"
},
"Code": 0,
"Description": "OK",
"Success": true
}
Result (CheckCodeMarkAnswer)
| Имя поля | Тип | Обяз | Назначение | Пример |
|---|---|---|---|---|
| code | int | - | Код результата проверки (0 — без ошибок) | 0 |
| description | string | - | Описание результата | “OK” |
| reqId | string | + | Идентификатор запроса | “b0bbb45a-e773-8b63-32e6-da06f1002466” |
| reqTimestamp | long | - | Время выполнения проверки кода маркировки (Unix-время в миллисекундах) | 1781077845362 |
| isCheckedOffline | bool | - | Признак офлайн-проверки через локальный модуль | true |
| status | enum | - | Статус локального модуля ЧЗ: 0 — unknown; 1 — ready; 2 — initialization; 3 — failure; 4 — not_configured. |
0 |
| requiresDownload | bool | - | Признак необходимости скачать или обновить локальную базу данных модуля перед офлайн-проверкой | false |
| lastUpdate | long | - | Время последнего обновления локальной базы данных модуля. 0 — данных нет или неактуально. | 0 |
| lastSync | long | - | Время последней синхронизации модуля с ГИС МТ. 0 — данных нет. | 0 |
| version | string | - | Версия локального модуля | “019e978f-e682-7b78-8127-e7cf95b63586” |
| inst | string | - | Идентификатор экземпляра локального модуля ЧЗ | “019eb008-c2d2-7889-b91a-a3455dc42384” |
| serviceUrl | string | - | Адрес локального модуля ЧЗ, к которому фактически было выполнено обращение | “127.0.0.1:5995” |
| codes | Массив CodeMarkInfo | - | Данные проверки кода маркировки | “codes”: [ { “cis”: “0104670540176099215’W9Um”, “valid”: false, “verified”: false, “realizable”: false, “utilised”: false, “isTracking”: false, “sold”: false, “gtin”: “04670540176099”, “grayZone”: false, “isBlocked”: false, “isGreyGtin”: false, “found”: false, “packageQuantity”: 0 } ] |
CodeMarkInfo
| Имя поля | Тип | Назначение | Пример | |
|---|---|---|---|---|
| cis | string | + | Полный код маркировки | “0104670540176099215’W9Um93dGVz” |
| valid | bool | - | Результат проверки валидности структуры кода идентификации (КИ) / кода маркировки (КиЗ). true — структура валидна, false — не валидна. |
true |
| printView | string | - | Код маркировки без крипто-подписи | “0104670540176099215’W9Um” |
| 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) — Фармацевтическое сырьё, лекарственные средства |
[8] |
| verified | bool | - | Результат криптографической проверки кода. Для всех товарных групп, кроме “Товары из натурального меха”: true — проверка крипто-подписи успешна, false — проверка крипто-подписи завершилась с ошибкой. Для “Товаров из натурального меха”: true — КиЗ найден в “ИР Маркировки”. false — КиЗ не найден в “ИР Маркировки”. |
true |
| realizable | bool | - | Признак того, что код находится в статусе “В обороте” | true |
| utilised | bool | - | Признак нанесения кода на упаковку товара | true |
| found | bool | - | Признак того, что код найден в ГИС МТ | true |
| errorCode | int | - | Код ошибки. 0 — ошибки отсутствуют; 1 — «Ошибка валидации КМ»; 2 — “КМ не содержит GTIN”; 3 — “КМ не содержит серийный номер”; 4 — “КМ содержит недопустимые символы”; 5 — “Ошибка верификации крипто-подписи КМ(формат крипто-подписи не соответствует типу КМ)”; 6 — “Ошибка верификации крипто-подписи КМ(крипто-подпись не валидная)”; 7 — “Ошибка верификации крипто-подписи КМ(крипто-ключ не валиден)”; 8 — “КМ не прошел верификацию в стране эмитента”; 9 — “Найденные AI в КМ не поддерживаются”; 10 — “КМ не найден в ГИС МТ” |
0 |
| message | string | - | Сообщение об ошибке | null |
| isTracking | bool | - | Признак старта прослеживаемости в товарной группе. true — прослеживаемость в товарной группе для данного КИ / КиЗ включена; false — прослеживаемость в товарной группе для данного КИ /КиЗ не включена |
true |
| sold | bool | - | Признак того, что товар с данным кодом уже продан | - |
| gtin | string | - | Код товара (GTIN) | “04670540176099” |
| packageType | string | - | Тип упаковки. Для товарной группы “Товары из натурального меха” значение всегда UNIT. UNIT, Единица товара (КИ) — Пачка, Потребительская упаковка; GROUP, Групповая — упаковка (КИГУ); SET — Набор (КИН); BUNDLE, Комплект (КИК) — Комплект (КИК). Используется только для товарной группы “Предметы одежды, бельё постельное, столовое, туалетное и кухонное”; BOX — Транспортная упаковка (КИТУ); ATK — Агрегированный таможенный код (АТК). В составе АТК может быть: - КИ; - КИК; - КИГУ (кроме товарной группы “Медицинские изделия”); - КИТУ (только для товарных групп “Антисептики и дезинфицирующие средства”, “Биологически активные добавки к пище”, “Медицинские изделия”, “Пиво, напитки, изготавливаемые на основе пива, слабоалкогольные напитки”, “Соковая продукция и безалкогольные напитки”, “Упакованная вода”). Возвращаются в ответе: LEVEL1 — Транспортная упаковка 1-го уровня (КИТУ). Также может быть групповой упаковкой (КИГУ) — блок. LEVEL2 — Транспортная упаковка 2-го уровня(КИТУ), Короб. LEVEL3 — Транспортная упаковка 3-го уровня (КИТУ), Палета. LEVEL4 — Транспортная упаковка 4-го уровня(КИТУ). LEVEL5 — Транспортная упаковка 5-го уровня(КИТУ) |
“UNIT” |
| producerInn | string | - | ИНН производителя | “7725344604” |
| grayZone | bool | - | Признак нахождения продукции в “серой зоне” (только для товарных групп “Альтернативная табачная продукция”, “Никотиносодержащая продукция”, “Табачная продукция”). Возможные значения: true — находится в серой зоне; false — не находится в серой зоне. |
false |
| isBlocked | bool | - | Признак блокировки кода по решению органа государственной власти (ОГВ) | true |
| isGreyGtin | bool | - | Признак некорректного (не зарегистрированного в справочниках) GTIN в составе кода | true |
| ogvs | string[] | - | Органы государственной власти, установившие блокировку кода (заполняется при isBlocked = true): RAR — Росалкогольрегулирование; FTS — ФТС России; FNS — ФНС России; RSHN — Россельхознадзор; RPN — Роспотребнадзор; MVD — МВД России; RZN — Росздравнадзор. |
[] |
| found | bool | - | Признак наличия КМ в ГИС МТ. true — КМ найден; false — КМ не найден |
true |
| packageQuantity | int | - | Ёмкость КИГУ. Количество потенциально вмещаемых вложений |
0 |
Примеры ошибок
11 Не найден доступный и готовый локальный модуль ЧЗ
{
"Code": 11,
"Description": "Не найден доступный и готовый локальный модуль ЧЗ",
"Success": false
}