Статусы проверки УИНов
Метод доступен для моделей: FBS и Экспресс.
Если вы используете API-Key-токен, для вызова метода необходим один из доступов в списке
- inventory-and-order-processing — Обработка заказов и учёт товаров
- inventory-and-order-processing:read-only — Просмотр информации о заказах
- all-methods — Полное управление кабинетом
- all-methods:read-only — Просмотр всех данных
Возвращает статусы проверки УИНов в заказе.
Заказ, в котором есть ювелирные изделия, перейдет в статус READY_TO_SHIP
, только когда:
- Вы передадите Маркету УИНы по каждому ювелирному изделию в заказе — метод PUT campaigns/{campaignId}/orders/{orderId}/boxes.
- Все УИНы успешно пройдут проверку.
⚙️ Лимит: 100 000 запросов в час |
---|
Request
POST
https://api.partner.market.yandex.ru/campaigns/{campaignId}/orders/{orderId}/identifiers/status
Path parameters
Name |
Description |
campaignId* |
Type: integer<int64> Идентификатор кампании. Его можно узнать с помощью запроса GET campaigns или найти в кабинете продавца на Маркете — нажмите на название своего бизнеса и перейдите на страницу:
⚠️ Не передавайте вместо него идентификатор магазина, который указан в кабинете продавца на Маркете рядом с названием магазина и в некоторых отчетах.
Min value: |
orderId* |
Type: integer<int64> Идентификатор заказа. |
Responses
200 OK
Информация по проверке УИНов.
Body
application/json
{
"status": "OK",
"result": {
"items": [
{
"id": 0,
"uin": [
{
"value": "string",
"status": "OK"
}
]
}
]
}
}
Name |
Description |
result |
Type: GetOrderIdentifiersStatusDTO Список идентификаторов товаров и статусы проверки УИНов. |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
GetOrderIdentifiersStatusDTO
Список идентификаторов товаров и статусы проверки УИНов.
Name |
Description |
items* |
Type: OrderItemValidationStatusDTO[] Список идентификаторов товаров и статусы проверки УИНов. |
ApiResponseStatusType
Тип ответа. Возможные значения:
OK
— ошибок нет.ERROR
— при обработке запроса произошла ошибка.
Type |
Description |
Enum: |
OrderItemValidationStatusDTO
Идентификатор товара и статус проверки его УИНа.
Name |
Description |
id* |
Type: integer<int64> Идентификатор товара в заказе. |
uin |
Type: UinDTO[] Статусы проверки УИНов. Min items: |
UinDTO
Статус проверки УИНа.
Name |
Description |
status* |
Type: UinStatusType Статус проверки УИНа:
Enum: |
value* |
Type: string УИН товара. |
UinStatusType
Статус проверки УИНа:
-
FAILED
— не прошел проверку. -
IN_PROGRESS
— в процессе проверки. -
NOT_ON_VALIDATION
— УИН не отправлен на проверку или переданы не все УИНы в заказе. -
OK
— проверка успешно пройдена.
Type |
Description |
Enum: |
400 Bad Request
Запрос содержит неправильные данные. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. Min items: |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
ApiErrorDTO
Общий формат ошибки.
Name |
Description |
code* |
Type: string Код ошибки. |
message |
Type: string Описание ошибки. |
401 Unauthorized
В запросе не указаны данные для авторизации. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. Min items: |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
403 Forbidden
Данные для авторизации неверны или доступ к ресурсу запрещен. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. Min items: |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
404 Not Found
Запрашиваемый ресурс не найден. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. Min items: |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
420 Method Failure
Превышено ограничение на доступ к ресурсу. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. Min items: |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
500 Internal Server Error
Внутренняя ошибка Маркета. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. Min items: |
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
No longer supported, please use an alternative and newer version.
Уникальный идентификационный номер для ювелирных изделий.
Производитель получает УИН, когда регистрирует изделие в системе контроля за оборотом драгоценных металлов и камней — ГИИС ДМДК.