Request
Responses
200 OK
400 Bad Request
- Body
- ApiErrorDTO
401 Unauthorized
- Body
403 Forbidden
- Body
404 Not Found
- Body
420 Method Failure
- Body
500 Internal Server Error
- Body

Передача уникальных кодов маркировки единиц товара (DBS)

Info

Console

Этот запрос только для DBS

Если вы работаете по модели FBS, пользуйтесь PUT campaigns/{campaignId}/orders/{orderId}/boxes.

Передает Маркету коды маркировки для единиц товара в указанном заказе.

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

Коды «Честного знака».
УИН для ювелирных изделий.
РНПТ и ГТД для импортных прослеживаемых товаров.

Важно

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

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

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

Request

PUT

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

Path parameters

Name

Type

Description

campaignId*

integer<int64>

Идентификатор кампании в API и магазина в кабинете. Каждая кампания в API соответствует магазину в кабинете.

Чтобы узнать идентификаторы своих магазинов, воспользуйтесь запросом GET campaigns.

ℹ️ Что такое кабинет и магазин на Маркете

orderId*

integer<int64>

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

Body

application/json

{
    "items": [
        {
            "id": 0,
            "instances": [
                {
                    "cis": "string",
                    "uin": "string",
                    "rnpt": "string",
                    "gtd": "string"
                }
            ]
        }
    ]
}

Name	Type	Description
items*	OrderItemInstanceModificationDTO[]	Список позиций, требующих маркировки. Позиция в корзине, требующая маркировки.

OrderItemInstanceModificationDTO

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

Name

Type

Description

id*

integer<int64>

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

Он приходит в ответе на запрос GET campaigns/{campaignId}/orders/{orderId} и в запросе Маркета POST order/accept — параметр id в items.

instances*

BriefOrderItemInstanceDTO[]

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

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

Подробно о работе с маркируемыми товарами рассказано в Справке.

BriefOrderItemInstanceDTO

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

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

Подробно о работе с маркируемыми товарами рассказано в Справке.

Name	Type	Description
cis	string	Код «Честного знака» для единицы товара. Важно Не экранируйте косую черту в коде символа-разделителя `\u001d`! ✅ `01030410947874432155Qbag!\u001d93Zjqw` ❌ `01030410947874432155Qbag!\\u001d93Zjqw` Косые черты и кавычки в других местах экранируйте по правилам JSON: `\\` и `\"`
uin	string	Уникальный идентификационный номер ювелирного изделия. Представляет собой число из 16 цифр.
rnpt	string	Регистрационный номер партии товара. Представляет собой строку из четырех чисел, разделенных косой чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ/ХХХ. Первая часть — код таможни, которая зарегистрировала декларацию на партию товара. Далее — дата, номер декларации и номер маркированного товара в декларации.
gtd	string	Грузовая таможенная декларация. Представляет собой строку из трех чисел, разделенных косой чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ. Первая часть — код таможни, которая зарегистрировала декларацию на ввезенные товары. Далее — дата и номер декларации.

Responses

200 OK

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

Body

application/json

{
    "status": "OK",
    "result": {
        "items": [
            {
                "id": 0,
                "vat": "VAT_18",
                "count": 0,
                "price": 0,
                "feedCategoryId": "string",
                "offerName": "string",
                "offerId": "string",
                "instances": [
                    {
                        "cis": "string",
                        "cisFull": "string",
                        "uin": "string",
                        "rnpt": "string",
                        "gtd": "string"
                    }
                ]
            }
        ]
    }
}

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
result	OrderItemsModificationResultDTO	Краткие сведения о промаркированных товарах — возвращаются, если ответ `OK`.

ApiResponseStatusType

Тип ответа.

Type	Description
ApiResponseStatusType	Enum: `OK`, `ERROR`

OrderItemsModificationResultDTO

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

Name	Type	Description
items	BriefOrderItemDTO[]	Список позиций в заказе, подлежащих маркировке. Информация о маркированном товаре.

BriefOrderItemDTO

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

Name	Type	Description
id	integer<int64>	Идентификатор товара в заказе.
vat	OrderVatType	Ставка налога на добавленную стоимость (НДС) на услугу доставки заказа. Enum: `VAT_18`, `VAT_10`, `VAT_18_118`, `VAT_10_110`, `VAT_0`, `NO_VAT`, `VAT_20`, `VAT_20_120`, `UNKNOWN_VALUE`
count	integer<int32>	Количество единиц товара.
price	number	Цена на товар. Указана в той валюте, которая была задана в каталоге. Разделитель целой и дробной части — точка.
feedCategoryId	string	Идентификатор категории, в которую входит товар.
offerName	string	Название товара.
offerId	string	Ваш идентификатор товара.
instances	OrderItemInstanceDTO[]	Переданные вами коды маркировки. Переданные вами для данной позиции коды маркировки или УИНы. Коды «Честного знака» возвращаются в двух вариантах — с криптохвостом и без.

OrderVatType

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

NO_VAT — НДС не облагается, используется только для отдельных видов услуг.
VAT_0 — НДС 0%. Например, используется при продаже товаров, вывезенных в таможенной процедуре экспорта, или при оказании услуг по международной перевозке товаров.
VAT_10_110 — НДС 10/110. Расчетная ставка НДС 10%, применяется только для случая предоплаты.
VAT_20_120 — НДС 20/120. Расчетная ставка НДС 20%, применяется только для случая предоплаты.
VAT_18_118 — НДС 18/118. Ставка использовалась до 1 января 2019 года.

Используется только совместно с параметром payment-method=YANDEX.

Type	Description
OrderVatType	Enum: `VAT_18`, `VAT_10`, `VAT_18_118`, `VAT_10_110`, `VAT_0`, `NO_VAT`, `VAT_20`, `VAT_20_120`, `UNKNOWN_VALUE`

OrderItemInstanceDTO

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

Name	Type	Description
cis	string	Код «Честного знака» без криптохвоста.
cisFull	string	Код «Честного знака» с криптохвостом.
uin	string	УИН ювелирного изделия (16-значный код) Производитель получает УИН, когда регистрирует изделие в системе контроля за оборотом драгоценных металлов и камней — ГИИС ДМДК.
rnpt	string	Регистрационный номер партии товара. Представляет собой строку из четырех чисел, разделенных косой чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ/ХХХ. Первая часть — код таможни, которая зарегистрировала декларацию на партию товара. Далее — дата, номер декларации и номер маркированного товара в декларации.
gtd	string	Грузовая таможенная декларация. Представляет собой строку из трех чисел, разделенных косой чертой: ХХХХХХХХ/ХХХХХХ/ХХХХХХХ. Первая часть — код таможни, которая зарегистрировала декларацию на ввезенные товары. Далее — дата и номер декларации.

400 Bad Request

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

Body

application/json

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

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

ApiErrorDTO

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

Name	Type	Description
code*	string	Код ошибки.
message	string	Описание ошибки.

401 Unauthorized

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

Body

application/json

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

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

403 Forbidden

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

Body

application/json

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

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

404 Not Found

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

Body

application/json

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

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

420 Method Failure

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

Body

application/json

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

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

500 Internal Server Error

Внутренняя ошибка сервера.

Body

application/json

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

Name	Type	Description
status	ApiResponseStatusType	Тип ответа. Enum: `OK`, `ERROR`
errors	ApiErrorDTO[]	Список ошибок. Общий формат ошибки.

Передача уникальных кодов маркировки единиц товара (DBS)

RequestRequest

Path parametersPath parameters

BodyBody

OrderItemInstanceModificationDTOOrderItemInstanceModificationDTO

BriefOrderItemInstanceDTOBriefOrderItemInstanceDTO

ResponsesResponses

200 OK200 OK

BodyBody

ApiResponseStatusTypeApiResponseStatusType

OrderItemsModificationResultDTOOrderItemsModificationResultDTO

BriefOrderItemDTOBriefOrderItemDTO

OrderVatTypeOrderVatType

OrderItemInstanceDTOOrderItemInstanceDTO

400 Bad Request400 Bad Request

BodyBody

ApiErrorDTOApiErrorDTO

401 Unauthorized401 Unauthorized

BodyBody

403 Forbidden403 Forbidden

BodyBody

404 Not Found404 Not Found

BodyBody

420 Method Failure420 Method Failure

BodyBody

500 Internal Server Error500 Internal Server Error

BodyBody

Была ли статья полезна?

Request

Path parameters

Body

OrderItemInstanceModificationDTO

BriefOrderItemInstanceDTO

Responses

200 OK

Body

ApiResponseStatusType

OrderItemsModificationResultDTO

BriefOrderItemDTO

OrderVatType

OrderItemInstanceDTO

400 Bad Request

Body

ApiErrorDTO

401 Unauthorized

Body

403 Forbidden

Body

404 Not Found

Body

420 Method Failure

Body

500 Internal Server Error

Body