Передача кодов маркировки единиц товара
Метод доступен для модели DBS.
Если вы используете API-Key-токен, для вызова метода необходим один из доступов в списке
- inventory-and-order-processing — Обработка заказов и учёт товаров
- all-methods — Полное управление кабинетом
Если вы работаете по модели 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: |
|
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
|
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). Не экранируйте косую черту в коде символа-разделителя ✅ ❌ Косые черты и кавычки в других местах экранируйте по правилам JSON: Example: |
|
countryCode |
Type: CountryCode Страна производства в формате ISO 3166-1 alpha-2. Как получить Min length: Max length: Pattern: Example: |
|
gtd |
Type: string Грузовая таможенная декларация. Представляет собой строку из трех чисел, разделенных косой чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ. Первая часть — код таможни, которая зарегистрировала декларацию на ввезенные товары. Далее — дата и номер декларации. Example: |
|
rnpt |
Type: string Регистрационный номер партии товара. Представляет собой строку из четырех чисел, разделенных косой чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ/ХХХ. Первая часть — код таможни, которая зарегистрировала декларацию на партию товара. Далее — дата, номер декларации и номер маркированного товара в декларации. Example: |
|
uin |
Type: string Уникальный идентификационный номер ювелирного изделия. Представляет собой число из 16 цифр. Example: |
Example
{
"cis": "example",
"uin": "example",
"rnpt": "example",
"gtd": "example",
"countryCode": "RU"
}
OrderItemInstanceModificationDTO
Позиция в корзине, требующая маркировки.
|
Name |
Description |
|
id |
Type: integer Идентификатор товара в заказе. Он приходит в ответе метода POST v1/businesses/{businessId}/orders — параметр |
|
instances |
Type: BriefOrderItemInstanceDTO[] Список кодов маркировки единиц товара. Example
|
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 Тип ответа. Возможные значения:
Enum: |
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: |
|
cisFull |
Type: string Код идентификации единицы товара в системе «Честный ЗНАК» с криптохвостом. Example: |
|
countryCode |
Type: CountryCode Страна производства в формате ISO 3166-1 alpha-2. Как получить Min length: Max length: Pattern: Example: |
|
gtd |
Type: string Грузовая таможенная декларация. Представляет собой строку из трех чисел, разделенных косой чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ. Первая часть — код таможни, которая зарегистрировала декларацию на ввезенные товары. Далее — дата и номер декларации. Example: |
|
rnpt |
Type: string Регистрационный номер партии товара. Представляет собой строку из четырех чисел, разделенных косой чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ/ХХХ. Первая часть — код таможни, которая зарегистрировала декларацию на партию товара. Далее — дата, номер декларации и номер маркированного товара в декларации. Example: |
|
uin |
Type: string УИН ювелирного изделия (16-значный код) Производитель получает УИН, когда регистрирует изделие в системе контроля за оборотом драгоценных металлов и камней — ГИИС ДМДК. 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: Example
|
|
offerId |
Type: ShopSku Ваш идентификатор товара. Ваш SKU — идентификатор товара в вашей системе. Правила использования SKU:
SKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте в Справке Маркета для продавцов. Важно Пробельные символы в начале и конце значения автоматически удаляются. Например, Что такое SKU и как его назначать Min length: Max length: Pattern: Example: |
|
offerName |
Type: string Название товара. Example: |
|
price |
Type: number Цена товара. Указана в той валюте, которая была задана в каталоге. Разделитель целой и дробной части — точка. |
|
vat |
Type: OrderVatType Налог на добавленную стоимость (НДС) на услугу доставки заказа. НДС на товар или доставку:
Enum: |
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
|
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: |
|
message |
Type: string Описание ошибки. 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:
1Example
[ { "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}))$.