Лимит на установку кванта продажи и минимального количества товаров в заказе

Возвращает лимит на установку кванта и минимального количества товаров в заказе, которые вы можете задать для товаров указанных категорий.

Если вы передадите значение кванта или минимального количества товаров выше установленного Маркетом ограничения, товар будет скрыт с витрины.

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

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

Request

POST

https://api.partner.market.yandex.ru/categories/max-sale-quantum

Body

application/json
{
    "marketCategoryIds": [
        0
    ]
}

Name

Description

marketCategoryIds*

Type: integer<int64>[]

Идентификаторы листовых категории на Маркете — тех, у которых нет дочерних категорий.

Max items: 1500

Min items: 1

Unique items: true

Responses

200 OK

Лимит на установку кванта и минимального количества товаров.

Body

application/json
{
    "status": "OK",
    "results": [
        {
            "id": 0,
            "name": "string",
            "maxSaleQuantum": 0
        }
    ],
    "errors": [
        {
            "categoryId": 0,
            "type": "UNKNOWN_CATEGORY"
        }
    ]
}

Name

Description

results*

Type: MaxSaleQuantumDTO[]

Категории и лимит на установку кванта и минимального количества товаров.
Лимит на установку кванта и минимального количества товаров по категориям.

errors

Type: CategoryErrorDTO[]

Ошибки, которые появились из-за переданных категорий.
Текст ошибки.

status

Type: ApiResponseStatusType

Тип ответа.

Enum: OK, ERROR

MaxSaleQuantumDTO

Лимит на установку кванта и минимального количества товаров по категориям.

Name

Description

id*

Type: integer<int64>

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

maxSaleQuantum

Type: integer

Лимит на установку кванта и минимального количества товаров.

name

Type: string

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

CategoryErrorDTO

Текст ошибки.

Name

Description

categoryId

Type: integer<int64>

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

type

Type: CategoryErrorType

Типы ошибок:

  • UNKNOWN_CATEGORY — указана неизвестная категория.
  • CATEGORY_IS_NOT_LEAF — указана нелистовая категория. Укажите ту, которая не имеет дочерних категорий.

Enum: UNKNOWN_CATEGORY, CATEGORY_IS_NOT_LEAF

ApiResponseStatusType

Тип ответа.

Type

Description

ApiResponseStatusType

Enum: OK, ERROR

CategoryErrorType

Типы ошибок:

  • UNKNOWN_CATEGORY — указана неизвестная категория.
  • CATEGORY_IS_NOT_LEAF — указана нелистовая категория. Укажите ту, которая не имеет дочерних категорий.

Type

Description

CategoryErrorType

Enum: UNKNOWN_CATEGORY, CATEGORY_IS_NOT_LEAF

400 Bad Request

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

Body

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

Name

Description

errors

Type: ApiErrorDTO[]

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

status

Type: ApiResponseStatusType

Тип ответа.

Enum: OK, ERROR

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[]

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

status

Type: ApiResponseStatusType

Тип ответа.

Enum: OK, ERROR

403 Forbidden

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

Body

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

Name

Description

errors

Type: ApiErrorDTO[]

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

status

Type: ApiResponseStatusType

Тип ответа.

Enum: OK, ERROR

404 Not Found

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

Body

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

Name

Description

errors

Type: ApiErrorDTO[]

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

status

Type: ApiResponseStatusType

Тип ответа.

Enum: OK, ERROR

420 Method Failure

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

Body

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

Name

Description

errors

Type: ApiErrorDTO[]

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

status

Type: ApiResponseStatusType

Тип ответа.

Enum: OK, ERROR

500 Internal Server Error

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

Body

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

Name

Description

errors

Type: ApiErrorDTO[]

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

status

Type: ApiResponseStatusType

Тип ответа.

Enum: OK, ERROR