Передача кодов маркировки единиц товара

Метод доступен для модели DBS.

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

Если вы работаете по модели FBS

Используйте метод PUT v2/campaigns/{campaignId}/orders/{orderId}/boxes.

Передает Маркету коды маркировки для единиц товара в указанном заказе. Подробнее о работе с маркируемыми товарами читайте в Справке продавца на Маркете.

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

Для модели DBS коды маркировки в системе «Честный ЗНАК» не проверяются в ГИС МТ — проверка выполняется только для моделей FBS и Экспресс.

Принимаются коды следующих типов:

  • Коды в системе «Честный ЗНАК» или «ASL BELGISI» (для продавцов Market Yandex Go).
  • УИН для ювелирных изделий.
  • РНПТ и ГТД для импортных прослеживаемых товаров.

Для каждой позиции в заказе, требующей маркировки, нужно передать список кодов — по одному для каждой единицы товара. Например, если в заказе две пары тапочек и одна пара туфель, получится список из двух кодов для первой позиции и список из одного кода для второй.

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

Request

PUT

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

Path parameters

Name

Description

campaignId

Type: integer

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

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

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

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

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

Min value: 1

orderId

Type: integer

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

Body

application/json
{
  "items": [
    {
      "id": 0,
      "instances": [
        {
          "cis": "example",
          "uin": "example",
          "rnpt": "example",
          "gtd": "example",
          "countryCode": "RU"
        }
      ]
    }
  ]
}

Name

Description

items

Type: OrderItemInstanceModificationDTO[]

Список позиций, требующих маркировки.

Example
[
  {
    "id": 0,
    "instances": [
      {
        "cis": "example",
        "uin": "example",
        "rnpt": "example",
        "gtd": "example",
        "countryCode": "RU"
      }
    ]
  }
]

Cis

Код идентификации единицы товара в системе «Честный ЗНАК» или «ASL BELGISI» (для продавцов Market Yandex Go).

Не экранируйте косую черту в коде символа-разделителя \u001d

01030410947874432155Qbag!\u001d93Zjqw

01030410947874432155Qbag!\\u001d93Zjqw

Косые черты и кавычки в других местах экранируйте по правилам JSON: \\ и \"

Type: string

Example: example

CountryCode

Страна производства в формате ISO 3166-1 alpha-2. Как получить

Type: string

Min length: 2

Max length: 2

Pattern: ^[A-Z]{2}$

Example: RU

BriefOrderItemInstanceDTO

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

Заполните только одно поле в зависимости от того, в какой системе маркирован товар.

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

Name

Description

cis

Type: Cis

Код идентификации единицы товара в системе «Честный ЗНАК» или «ASL BELGISI» (для продавцов Market Yandex Go).

Не экранируйте косую черту в коде символа-разделителя \u001d

01030410947874432155Qbag!\u001d93Zjqw

01030410947874432155Qbag!\\u001d93Zjqw

Косые черты и кавычки в других местах экранируйте по правилам JSON: \\ и \"

Example: example

countryCode

Type: CountryCode

Страна производства в формате ISO 3166-1 alpha-2. Как получить

Min length: 2

Max length: 2

Pattern: ^[A-Z]{2}$

Example: RU

gtd

Type: string

Грузовая таможенная декларация.

Представляет собой строку из трех чисел, разделенных косой чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ.

Первая часть — код таможни, которая зарегистрировала декларацию на ввезенные товары. Далее — дата и номер декларации.

Example: example

rnpt

Type: string

Регистрационный номер партии товара.

Представляет собой строку из четырех чисел, разделенных косой чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ/ХХХ.

Первая часть — код таможни, которая зарегистрировала декларацию на партию товара. Далее — дата, номер декларации и номер маркированного товара в декларации.

Example: example

uin

Type: string

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

Представляет собой число из 16 цифр.

Example: example

Example
{
  "cis": "example",
  "uin": "example",
  "rnpt": "example",
  "gtd": "example",
  "countryCode": "RU"
}

OrderItemInstanceModificationDTO

Позиция в корзине, требующая маркировки.

Name

Description

id

Type: integer

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

Он приходит в ответе метода POST v1/businesses/{businessId}/orders — параметр id в items.

instances

Type: BriefOrderItemInstanceDTO[]

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

Example
[
  {
    "cis": "example",
    "uin": "example",
    "rnpt": "example",
    "gtd": "example",
    "countryCode": "RU"
  }
]
Example
{
  "id": 0,
  "instances": [
    {
      "cis": "example",
      "uin": "example",
      "rnpt": "example",
      "gtd": "example",
      "countryCode": "RU"
    }
  ]
}

Responses

200 OK

Ответ 200 обозначает, что коды успешно записались. Ответ содержит краткие сведения о промаркированных товарах.

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"
}

OrderVatType

НДС на товар или доставку:

  • NO_VAT — НДС не облагается, используется только для отдельных видов услуг.

  • VAT_0 — НДС 0%. Например, используется при продаже товаров, вывезенных в таможенной процедуре экспорта, или при оказании услуг по международной перевозке товаров.

  • VAT_10 — НДС 10%. Например, используется при реализации отдельных продовольственных и медицинских товаров.

  • VAT_10_110 — НДС 10/110. НДС 10%, применяется только при предоплате.

  • VAT_20 — НДС 20%. Основной НДС с 2019 года до 1 января 2026 года.

  • VAT_20_120 — НДС 20/120. НДС 20%, применяется только при предоплате.

  • VAT_18 — НДС 18%. Основной НДС до 2019 года.

  • VAT_18_118 — НДС 18/118. НДС использовался до 1 января 2019 года при предоплате.

  • VAT_12 — НДС 12%. Используется только в Узбекистане.

  • VAT_05 — НДС 5%. НДС для упрощенной системы налогообложения (УСН).

  • VAT_07 — НДС 7%. НДС для упрощенной системы налогообложения (УСН).

  • VAT_22 — НДС 22%. Основной НДС с 1 января 2026 года.

  • UNKNOWN_VALUE — неизвестный тип.

Type: string

Enum: NO_VAT, VAT_0, VAT_10, VAT_10_110, VAT_20, VAT_20_120, VAT_18, VAT_18_118, VAT_12, VAT_05, VAT_07, VAT_22, UNKNOWN_VALUE

ShopSku

Ваш SKU — идентификатор товара в вашей системе.

Правила использования SKU:

  • У каждого товара SKU должен быть свой.

  • Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге.

SKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте в Справке Маркета для продавцов.

Важно

Пробельные символы в начале и конце значения автоматически удаляются. Например, " SKU123 " и "SKU123" будут обработаны как одинаковые значения.

Что такое SKU и как его назначать

Type: string

Min length: 1

Max length: 255

Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

Example: example

OrderItemInstanceDTO

Переданные для данной позиции коды маркировки или УИНы. Коды «Честного знака» возвращаются в двух вариантах — с криптохвостом и без.

Name

Description

cis

Type: string

Код идентификации единицы товара в системе «Честный ЗНАК» без криптохвоста или «ASL BELGISI» (для продавцов Market Yandex Go).

Example: example

cisFull

Type: string

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

Example: example

countryCode

Type: CountryCode

Страна производства в формате ISO 3166-1 alpha-2. Как получить

Min length: 2

Max length: 2

Pattern: ^[A-Z]{2}$

Example: RU

gtd

Type: string

Грузовая таможенная декларация.

Представляет собой строку из трех чисел, разделенных косой чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ.

Первая часть — код таможни, которая зарегистрировала декларацию на ввезенные товары. Далее — дата и номер декларации.

Example: example

rnpt

Type: string

Регистрационный номер партии товара.

Представляет собой строку из четырех чисел, разделенных косой чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ/ХХХ.

Первая часть — код таможни, которая зарегистрировала декларацию на партию товара. Далее — дата, номер декларации и номер маркированного товара в декларации.

Example: example

uin

Type: string

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

Example: example

Example
{
  "cis": "example",
  "cisFull": "example",
  "uin": "example",
  "rnpt": "example",
  "gtd": "example",
  "countryCode": "RU"
}

BriefOrderItemDTO

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

Name

Description

count

Type: integer

Количество единиц товара.

id

Type: integer

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

Позволяет идентифицировать товар в рамках заказа.

instances

Type: OrderItemInstanceDTO[] | null

Переданные коды маркировки.

Min items: 1

Example
[
  {
    "cis": "example",
    "cisFull": "example",
    "uin": "example",
    "rnpt": "example",
    "gtd": "example",
    "countryCode": "RU"
  }
]

offerId

Type: ShopSku

Ваш идентификатор товара.

Ваш SKU — идентификатор товара в вашей системе.

Правила использования SKU:

  • У каждого товара SKU должен быть свой.

  • Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге.

SKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте в Справке Маркета для продавцов.

Важно

Пробельные символы в начале и конце значения автоматически удаляются. Например, " SKU123 " и "SKU123" будут обработаны как одинаковые значения.

Что такое SKU и как его назначать

Min length: 1

Max length: 255

Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

Example: example

offerName

Type: string

Название товара.

Example: example

price

Type: number

Цена товара. Указана в той валюте, которая была задана в каталоге. Разделитель целой и дробной части — точка.

vat

Type: OrderVatType

Налог на добавленную стоимость (НДС) на услугу доставки заказа.

НДС на товар или доставку:

  • NO_VAT — НДС не облагается, используется только для отдельных видов услуг.

  • VAT_0 — НДС 0%. Например, используется при продаже товаров, вывезенных в таможенной процедуре экспорта, или при оказании услуг по международной перевозке товаров.

  • VAT_10 — НДС 10%. Например, используется при реализации отдельных продовольственных и медицинских товаров.

  • VAT_10_110 — НДС 10/110. НДС 10%, применяется только при предоплате.

  • VAT_20 — НДС 20%. Основной НДС с 2019 года до 1 января 2026 года.

  • VAT_20_120 — НДС 20/120. НДС 20%, применяется только при предоплате.

  • VAT_18 — НДС 18%. Основной НДС до 2019 года.

  • VAT_18_118 — НДС 18/118. НДС использовался до 1 января 2019 года при предоплате.

  • VAT_12 — НДС 12%. Используется только в Узбекистане.

  • VAT_05 — НДС 5%. НДС для упрощенной системы налогообложения (УСН).

  • VAT_07 — НДС 7%. НДС для упрощенной системы налогообложения (УСН).

  • VAT_22 — НДС 22%. Основной НДС с 1 января 2026 года.

  • UNKNOWN_VALUE — неизвестный тип.

Enum: NO_VAT, VAT_0, VAT_10, VAT_10_110, VAT_20, VAT_20_120, VAT_18, VAT_18_118, VAT_12, VAT_05, VAT_07, VAT_22, UNKNOWN_VALUE

Example
{
  "id": 0,
  "vat": "NO_VAT",
  "count": 0,
  "price": 0.5,
  "offerName": "example",
  "offerId": "example",
  "instances": [
    {
      "cis": "example",
      "cisFull": "example",
      "uin": "example",
      "rnpt": "example",
      "gtd": "example",
      "countryCode": "RU"
    }
  ]
}

OrderItemsModificationResultDTO

Краткие сведения о промаркированных товарах. Параметр возвращается, если ответ OK.

Name

Description

items

Type: BriefOrderItemDTO[]

Список позиций в заказе, подлежащих маркировке.

Example
[
  {
    "id": 0,
    "vat": "NO_VAT",
    "count": 0,
    "price": 0.5,
    "offerName": "example",
    "offerId": "example",
    "instances": [
      {
        "cis": "example",
        "cisFull": "example",
        "uin": "example",
        "rnpt": "example",
        "gtd": "example",
        "countryCode": "RU"
      }
    ]
  }
]
Example
{
  "items": [
    {
      "id": 0,
      "vat": "NO_VAT",
      "count": 0,
      "price": 0.5,
      "offerName": "example",
      "offerId": "example",
      "instances": [
        {
          "cis": "example",
          "cisFull": "example",
          "uin": "example",
          "rnpt": "example",
          "gtd": "example",
          "countryCode": "RU"
        }
      ]
    }
  ]
}

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

pathParams:
  - description: "Идентификатор кампании (магазина) — технический идентификатор, который представляет ваш магазин в системе Яндекс Маркета при работе через API. Он однозначно связывается с вашим магазином, но предназначен только для автоматизированного взаимодействия.\n\nЕго можно узнать с помощью запроса [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md) или найти в кабинете продавца на Маркете. Нажмите на иконку вашего аккаунта → **Настройки** и в меню слева выберите **API и модули**:\n\n* блок **Идентификатор кампании**;\n* вкладка **Лог запросов** → выпадающий список в блоке **Показывать логи**.\n\n⚠️ Не путайте его с:\n- идентификатором магазина, который отображается в личном кабинете продавца;\n- рекламными кампаниями.\n"
    name: campaignId
    in: path
    required: true
    schema:
      type: integer
      format: int64
      minimum: 1
  - description: Идентификатор заказа.
    name: orderId
    in: path
    required: true
    schema:
      type: integer
      format: int64
searchParams: []
headers: []
body: |-
  {
    "items": [
      {
        "id": 0,
        "instances": [
          {
            "cis": "example",
            "uin": "example",
            "rnpt": "example",
            "gtd": "example",
            "countryCode": "RU"
          }
        ]
      }
    ]
  }
schema:
  type: object
  required:
    - items
  properties:
    items:
      description: |
        Список позиций, требующих маркировки.
      type: array
      items:
        description: Позиция в корзине, требующая маркировки.
        type: object
        required:
          - id
          - instances
        properties:
          id:
            description: "Идентификатор товара в заказе.\n\nОн приходит в ответе метода [POST\_v1/businesses/{businessId}/orders](../../reference/orders/getBusinessOrders.md) — параметр `id` в `items`.\n"
            type: integer
            format: int64
          instances:
            description: |
              Список кодов маркировки единиц товара.
            type: array
            items:
              description: >
                Идентификатор единицы товара.


                Заполните только одно поле в зависимости от того, в какой
                системе маркирован товар.


                Подробно о работе с маркируемыми товарами читайте [в Справке
                Маркета для
                продавцов](https://yandex.ru/support/marketplace/orders/cz.html).
              type: object
              properties:
                cis:
                  description: >
                    Код идентификации единицы товара в
                    системе [«Честный ЗНАК»](https://честныйзнак.рф/) или [«ASL
                    BELGISI»](https://aslbelgisi.uz) (для продавцов Market
                    Yandex Go).


                    {% note warning "Не экранируйте косую черту в коде
                    символа-разделителя `\u001d`" %}


                    ✅ `01030410947874432155Qbag!\u001d93Zjqw`


                    ❌ `01030410947874432155Qbag!\\u001d93Zjqw`


                    Косые черты и кавычки в других местах экранируйте по
                    правилам JSON: `\\` и `\"`


                    {% endnote %}
                  type: string
                uin:
                  description: |
                    Уникальный идентификационный номер ювелирного изделия.

                    Представляет собой число из 16 цифр.
                  type: string
                rnpt:
                  description: >
                    Регистрационный номер партии товара.


                    Представляет собой строку из четырех чисел, разделенных
                    косой чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ/ХХХ.


                    Первая часть — код таможни, которая зарегистрировала
                    декларацию на партию товара. Далее — дата, номер декларации
                    и номер маркированного товара в декларации.
                  type: string
                gtd:
                  description: >
                    Грузовая таможенная декларация.


                    Представляет собой строку из трех чисел, разделенных косой
                    чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ.


                    Первая часть — код таможни, которая зарегистрировала
                    декларацию на ввезенные товары. Далее — дата и номер
                    декларации.
                  type: string
                countryCode:
                  description: >
                    Страна производства в формате ISO 3166-1 alpha-2. [Как
                    получить](../../reference/regions/getRegionsCodes.md)
                  type: string
                  minLength: 2
                  maxLength: 2
                  pattern: ^[A-Z]{2}$
                  example: RU
bodyType: application/json
method: put
security:
  - type: apiKey
    name: Api-Key
    in: header
  - type: oauth2
    x-inline: true
    flows:
      implicit:
        authorizationUrl: https://oauth.yandex.ru/authorize
        scopes:
          market:partner-api: API Яндекс.Маркета / Поиска по товарам для партнеров
path: v2/campaigns/{campaignId}/orders/{orderId}/identifiers
host: https://api.partner.market.yandex.ru

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

Значение cis должно соответствовать регулярному выражению ^(?=.{1,256}$)\u001D?(\(?01\)?\d{14}\(?21\)?([!-~]{6,8}|[!-~]{13}|[!-~]{20})(\u001D\(?240\)?.{1,30})?\u001D\(?9[1,3]\)?.+)$.

Без криптохвоста — ^(?=[!-~]{1,256}$)(\(?01\)?\d{14}\(?21\)?(.{6,8}|.{13}|.{20}))$.