Лимит на установку кванта продажи и минимального количества товаров в заказе
Метод доступен для всех моделей.
Если вы используете API-Key-токен, для вызова метода необходим один из доступов в списке
- offers-and-cards-management — Управление товарами и карточками
- offers-and-cards-management:read-only — Просмотр товаров и карточек
- all-methods — Полное управление кабинетом
- all-methods:read-only — Просмотр всех данных
Возвращает лимит на установку кванта и минимального количества товаров в заказе, которые вы можете задать для товаров указанных категорий.
Если вы передадите значение кванта или минимального количества товаров выше установленного Маркетом ограничения, товар будет скрыт с витрины.
Подробнее о том, как продавать товары по несколько штук, читайте в Справке Маркета для продавцов.
| ⚙️ Лимит: 5 000 запросов в час | 
|---|
Request
POST
https://api.partner.market.yandex.ru/v2/categories/max-sale-quantum
Body
application/json
{
    "marketCategoryIds": [
        0
    ]
}
| Name | Description | 
| marketCategoryIds* | Type: integer<int64>[] Идентификаторы листовых категорий на Маркете. Min items:  Max items:  Unique items | 
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[] Категории и лимит на установку кванта и минимального количества товаров. | 
| status* | Type: ApiResponseStatusType Тип ответа. Возможные значения: 
 Enum:  | 
| errors | Type: CategoryErrorDTO[] Ошибки, которые появились из-за переданных категорий. Min items:  | 
MaxSaleQuantumDTO
Лимит на установку кванта и минимального количества товаров по категориям.
| Name | Description | 
| id* | Type: integer<int64> Идентификатор категории. | 
| maxSaleQuantum | Type: integer Лимит на установку кванта и минимального количества товаров. | 
| name | Type: string Название категории. | 
ApiResponseStatusType
Тип ответа. Возможные значения:
- OK— ошибок нет.
- ERROR— при обработке запроса произошла ошибка.
| Type | Description | 
| Enum:  | 
CategoryErrorDTO
Текст ошибки.
| Name | Description | 
| categoryId | Type: integer<int64> Идентификатор категории. | 
| type | Type: CategoryErrorType Типы ошибок: 
 Enum:  | 
CategoryErrorType
Типы ошибок:
- UNKNOWN_CATEGORY— указана неизвестная категория.
- CATEGORY_IS_NOT_LEAF— указана нелистовая категория. Укажите ту, которая не имеет дочерних категорий.
| 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.
Если задан квант продажи, покупатель сможет добавить в заказ только кратное ему число товаров.
Например, если квант продажи равен 5, покупатель сможет добавить в корзину 5, 10, 15 и т. д. штук товара, а 1, 2 или 7 — не сможет.
Категории, у которых нет дочерних.