Статусы проверки кодов маркировки

Метод доступен для моделей: FBS и Экспресс.

Если вы используете API-Key-токен, для вызова метода необходим один из доступов в списке

Возвращает статусы проверки кодов маркировки в заказе.

Заказ, в котором есть ювелирные изделия или товары с обязательной маркировкой в системе «Честный ЗНАК», можно перевести в статус READY_TO_SHIP, только когда:

  1. В методе PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes вы передадите Маркету:

    • УИНы по каждому ювелирному изделию в заказе;

    • коды маркировки в системе «Честный ЗНАК» по всем товарам в заказе, для которых она обязательна.

  2. Все коды маркировки успешно пройдут проверку.

⚙️ Лимит: 100 000 запросов в час

Request

POST

https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/orders/{orderId}/identifiers/status

Path parameters

Name

Description

campaignId

Type: integer

Идентификатор кампании (магазина) — технический идентификатор, который представляет ваш магазин в системе Яндекс Маркета при работе через API. Он однозначно связывается с вашим магазином, но предназначен только для автоматизированного взаимодействия.

Его можно узнать с помощью запроса GET v2/campaigns или найти в кабинете продавца на Маркете. Нажмите на иконку вашего аккаунта → Настройки и в меню слева выберите API и модули:

  • блок Идентификатор кампании;
  • вкладка Лог запросов → выпадающий список в блоке Показывать логи.

⚠️ Не путайте его с:

  • идентификатором магазина, который отображается в личном кабинете продавца;
  • рекламными кампаниями.

Min value: 1

orderId

Type: integer

Идентификатор заказа.

Responses

200 OK

Информация по проверке кодов маркировки.

Body

application/json
{
  "status": "OK"
}

Type: object

ApiResponseStatusType

Тип ответа. Возможные значения:

  • OK — ошибок нет.
  • ERROR — при обработке запроса произошла ошибка.

Type: string

Enum: OK, ERROR

ApiResponse

Стандартная обертка для ответов сервера.

Name

Description

status

Type: ApiResponseStatusType

Тип ответа. Возможные значения:

  • OK — ошибок нет.
  • ERROR — при обработке запроса произошла ошибка.

Enum: OK, ERROR
Example
{
  "status": "OK"
}

UinStatusType

Статус проверки УИНа:

  • FAILED — не прошел проверку.

  • IN_PROGRESS — в процессе проверки.

  • NOT_ON_VALIDATION — УИН не отправлен на проверку или переданы не все УИНы в заказе.

  • OK — проверка успешно пройдена.

Type: string

Enum: OK, IN_PROGRESS, FAILED, NOT_ON_VALIDATION

UinSubstatusType

Детализация ошибки при проверке УИНа.

  • UIN_MERCHANT_MISMATCH — УИН не принадлежит вашему магазину.

  • UIN_MERCHANT_UNREGISTERED — магазин не подключен к системе ГИИС ДМДК.

  • UIN_NO_DATA — УИН не найден или заблокирован.

Возвращается только для статуса FAILED.

Type: string

Enum: UIN_MERCHANT_MISMATCH, UIN_MERCHANT_UNREGISTERED, UIN_NO_DATA

UinDTO

Статус проверки и УИН.

Name

Description

status

Type: UinStatusType

Статус проверки УИНа:

  • FAILED — не прошел проверку.

  • IN_PROGRESS — в процессе проверки.

  • NOT_ON_VALIDATION — УИН не отправлен на проверку или переданы не все УИНы в заказе.

  • OK — проверка успешно пройдена.

Enum: OK, IN_PROGRESS, FAILED, NOT_ON_VALIDATION

value

Type: string

УИН товара.

Example: example

substatus

Type: UinSubstatusType

Детализация ошибки при проверке УИНа.

  • UIN_MERCHANT_MISMATCH — УИН не принадлежит вашему магазину.

  • UIN_MERCHANT_UNREGISTERED — магазин не подключен к системе ГИИС ДМДК.

  • UIN_NO_DATA — УИН не найден или заблокирован.

Возвращается только для статуса FAILED.

Enum: UIN_MERCHANT_MISMATCH, UIN_MERCHANT_UNREGISTERED, UIN_NO_DATA
Example
{
  "value": "example",
  "status": "OK",
  "substatus": "UIN_MERCHANT_MISMATCH"
}

CisStatusType

Статус проверки кода маркировки в системе «Честный ЗНАК»:

  • FAILED — не удалось проверить код.

    Повторите попытку позже или удалите код маркировки.

  • IN_PROGRESS — в процессе проверки.

  • NOT_ON_VALIDATION — код маркировки не отправлен на проверку.

  • OK — проверка успешно пройдена.

  • INVALID — проверка не пройдена. Продажа товара с этим кодом запрещена.

Type: string

Enum: OK, FAILED, IN_PROGRESS, INVALID, NOT_ON_VALIDATION

CisSubstatusType

Детализация ошибки при проверке кода маркировки в системе «Честный ЗНАК»:

  • WRONG_OWNER_INN — проверка не пройдена. ИНН владельца кода отличается от ИНН продавца.

  • CIS_VALIDATION_ERROR — проверка не пройдена.

  • CIS_GTIN_NOT_FOUND — код маркировки не содержит GTIN.

  • CIS_SERIAL_NUMBER_NOT_FOUND — код маркировки не содержит серийный номер.

  • INVALID_SYMBOLS_FOUND — код маркировки содержит недопустимые символы.

  • CRYPTO_TAIL_FORMAT_MISMATCH_CIS_TYPE — формат криптоподписи не соответствует типу кода маркировки.

  • INVALID_CRYPTO_TAIL — криптоподпись не валидна.

  • INVALID_CRYPTO_KEY — криптоключ не валиден.

  • VERIFICATION_FAILED_IN_EMITTER_COUNTRY — код маркировки не прошел верификацию в стране эмитента.

  • UNSUPPORTED_AI_FOUND — найденные в коде маркировки AI не поддерживаются.

  • CIS_NOT_FOUND_IN_GIS_MT — код маркировки не найден в ГИС МТ.

  • NOT_PLACED_ON_MARKET — код маркировки не введен в оборот.

  • NOT_PRINTED_ON_PACKAGE — код маркировки не нанесен на упаковку.

  • EXPIRED_ITEM — у маркированного товара истек срок годности.

  • SALE_BLOCKED_BY_OGB — розничная продажа продукции заблокирована по решению ОГВ.

  • ITEM_SOLD — маркированный товар был продан.

Возвращается только для статуса INVALID.

Type: string

Enum: WRONG_OWNER_INN, CIS_VALIDATION_ERROR, CIS_GTIN_NOT_FOUND, CIS_SERIAL_NUMBER_NOT_FOUND, INVALID_SYMBOLS_FOUND, CRYPTO_TAIL_FORMAT_MISMATCH_CIS_TYPE, INVALID_CRYPTO_TAIL, INVALID_CRYPTO_KEY, VERIFICATION_FAILED_IN_EMITTER_COUNTRY, UNSUPPORTED_AI_FOUND, CIS_NOT_FOUND_IN_GIS_MT, NOT_PLACED_ON_MARKET, NOT_PRINTED_ON_PACKAGE, EXPIRED_ITEM, SALE_BLOCKED_BY_OGB, ITEM_SOLD

CisDTO

Статус проверки и код маркировки в системе «Честный ЗНАК».

Name

Description

status

Type: CisStatusType

Статус проверки кода маркировки в системе «Честный ЗНАК»:

  • FAILED — не удалось проверить код.

    Повторите попытку позже или удалите код маркировки.

  • IN_PROGRESS — в процессе проверки.

  • NOT_ON_VALIDATION — код маркировки не отправлен на проверку.

  • OK — проверка успешно пройдена.

  • INVALID — проверка не пройдена. Продажа товара с этим кодом запрещена.

Enum: OK, FAILED, IN_PROGRESS, INVALID, NOT_ON_VALIDATION

value

Type: string

Код маркировки в системе «Честный ЗНАК».

Example: example

crptRequestDateTime

Type: string<date-time>

Время проверки кода маркировки в ЦРПТ, на основании которой принято решение о продаже товара.

Актуально только для модели LaaS.

Example: 2025-01-01T00:00:00Z

crptRequestId

Type: string

Идентификатор запроса проверки кода маркировки в ЦРПТ, на основании которой принято решение о продаже товара.

Актуально только для модели LaaS.

Example: example

substatus

Type: CisSubstatusType

Детализация ошибки при проверке кода маркировки в системе «Честный ЗНАК»:

  • WRONG_OWNER_INN — проверка не пройдена. ИНН владельца кода отличается от ИНН продавца.

  • CIS_VALIDATION_ERROR — проверка не пройдена.

  • CIS_GTIN_NOT_FOUND — код маркировки не содержит GTIN.

  • CIS_SERIAL_NUMBER_NOT_FOUND — код маркировки не содержит серийный номер.

  • INVALID_SYMBOLS_FOUND — код маркировки содержит недопустимые символы.

  • CRYPTO_TAIL_FORMAT_MISMATCH_CIS_TYPE — формат криптоподписи не соответствует типу кода маркировки.

  • INVALID_CRYPTO_TAIL — криптоподпись не валидна.

  • INVALID_CRYPTO_KEY — криптоключ не валиден.

  • VERIFICATION_FAILED_IN_EMITTER_COUNTRY — код маркировки не прошел верификацию в стране эмитента.

  • UNSUPPORTED_AI_FOUND — найденные в коде маркировки AI не поддерживаются.

  • CIS_NOT_FOUND_IN_GIS_MT — код маркировки не найден в ГИС МТ.

  • NOT_PLACED_ON_MARKET — код маркировки не введен в оборот.

  • NOT_PRINTED_ON_PACKAGE — код маркировки не нанесен на упаковку.

  • EXPIRED_ITEM — у маркированного товара истек срок годности.

  • SALE_BLOCKED_BY_OGB — розничная продажа продукции заблокирована по решению ОГВ.

  • ITEM_SOLD — маркированный товар был продан.

Возвращается только для статуса INVALID.

Enum: WRONG_OWNER_INN, CIS_VALIDATION_ERROR, CIS_GTIN_NOT_FOUND, CIS_SERIAL_NUMBER_NOT_FOUND, INVALID_SYMBOLS_FOUND, CRYPTO_TAIL_FORMAT_MISMATCH_CIS_TYPE, INVALID_CRYPTO_TAIL, INVALID_CRYPTO_KEY, VERIFICATION_FAILED_IN_EMITTER_COUNTRY, UNSUPPORTED_AI_FOUND, CIS_NOT_FOUND_IN_GIS_MT, NOT_PLACED_ON_MARKET, NOT_PRINTED_ON_PACKAGE, EXPIRED_ITEM, SALE_BLOCKED_BY_OGB, ITEM_SOLD
Example
{
  "value": "example",
  "status": "OK",
  "substatus": "WRONG_OWNER_INN",
  "crptRequestId": "example",
  "crptRequestDateTime": "2025-01-01T00:00:00Z"
}

OrderItemValidationStatusDTO

Идентификаторы товаров и информация по проверке их кодов.

Name

Description

id

Type: integer

Идентификатор товара в заказе.

cis

Type: CisDTO[] | null

Информация по проверке кодов маркировки в системе «Честный ЗНАК».

Min items: 1

Example
[
  {
    "value": "example",
    "status": "OK",
    "substatus": "WRONG_OWNER_INN",
    "crptRequestId": "example",
    "crptRequestDateTime": "2025-01-01T00:00:00Z"
  }
]

uin

Type: UinDTO[] | null

Информация по проверке УИНов.

Min items: 1

Example
[
  {
    "value": "example",
    "status": "OK",
    "substatus": "UIN_MERCHANT_MISMATCH"
  }
]
Example
{
  "id": 0,
  "uin": [
    {
      "value": "example",
      "status": "OK",
      "substatus": "UIN_MERCHANT_MISMATCH"
    }
  ],
  "cis": [
    {
      "value": "example",
      "status": "OK",
      "substatus": "WRONG_OWNER_INN",
      "crptRequestId": "example",
      "crptRequestDateTime": "2025-01-01T00:00:00Z"
    }
  ]
}

GetOrderIdentifiersStatusDTO

Информация по проверке кодов маркировки.

Name

Description

items

Type: OrderItemValidationStatusDTO[]

Список идентификаторов товаров и информация по проверке кодов.

Example
[
  {
    "id": 0,
    "uin": [
      {
        "value": "example",
        "status": "OK",
        "substatus": "UIN_MERCHANT_MISMATCH"
      }
    ],
    "cis": [
      {
        "value": "example",
        "status": "OK",
        "substatus": "WRONG_OWNER_INN",
        "crptRequestId": "example",
        "crptRequestDateTime": "2025-01-01T00:00:00Z"
      }
    ]
  }
]
Example
{
  "items": [
    {
      "id": 0,
      "uin": [
        {
          "value": "example",
          "status": "OK",
          "substatus": "UIN_MERCHANT_MISMATCH"
        }
      ],
      "cis": [
        {
          "value": "example",
          "status": "OK",
          "substatus": "WRONG_OWNER_INN",
          "crptRequestId": "example",
          "crptRequestDateTime": "2025-01-01T00:00:00Z"
        }
      ]
    }
  ]
}

400 Bad Request

Запрос содержит неправильные данные. Подробнее об ошибке

Body

application/json
{
  "status": "OK"
}

Type: object

ApiErrorDTO

Общий формат ошибки.

Name

Description

code

Type: string

Код ошибки.

Example: example

message

Type: string

Описание ошибки.

Example: example
Example
{
  "code": "example",
  "message": "example"
}

ApiErrorResponse

Стандартная обертка для ошибок сервера.

Type: object

All of 2 types

  • Type: ApiResponse

    Стандартная обертка для ответов сервера.

    Example
    {
  "status": "OK"
}
  • Type: object

    errors

    Type: ApiErrorDTO[] | null

    Список ошибок.

    Min items: 1

    Example
    [
  {
    "code": "example",
    "message": "example"
  }
]
    Example
    {
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}
Example
{
  "status": "OK"
}

401 Unauthorized

В запросе не указаны данные для авторизации. Подробнее об ошибке

Body

application/json
{
  "status": "OK"
}

Type: object

403 Forbidden

Данные для авторизации неверны или доступ к ресурсу запрещен. Подробнее об ошибке

Body

application/json
{
  "status": "OK"
}

Type: object

404 Not Found

Запрашиваемый ресурс не найден. Подробнее об ошибке

Body

application/json
{
  "status": "OK"
}

Type: object

420 Method Failure

Превышено ограничение на доступ к ресурсу. Подробнее об ошибке

Body

application/json
{
  "status": "OK"
}

Type: object

500 Internal Server Error

Внутренняя ошибка Маркета. Подробнее об ошибке

Body

application/json
{
  "status": "OK"
}

Type: object

No longer supported, please use an alternative and newer version.

Уникальный идентификационный номер для ювелирных изделий.

Производитель получает УИН, когда регистрирует изделие в системе контроля за оборотом драгоценных металлов и камней — ГИИС ДМДК.

Что такое GTIN
GTIN — это уникальный номер, присвоенный товару в единой международной базе GS1. Из этого номера получается штрихкод формата EAN, UPC или ISBN.

Как убедиться, что товар есть в базе
Проверить код можно на странице проверки на сайте ассоциации GS1. Если товар не находится, запросите код GTIN у вашего поставщика.

Как получить GTIN для своих товаров
Чтобы получить коды GTIN, производителю нужно вступить в ассоциацию GS1 и зарегистрировать товары.

Предыдущая
Передача кодов маркировки
Следующая
Передача кода подтверждения