Лимит на установку кванта продажи и минимального количества товаров в заказе
Возвращает лимит на установку кванта и минимального количества товаров в заказе, которые вы можете задать для товаров указанных категорий.
Если вы передадите значение кванта или минимального количества товаров выше установленного Маркетом ограничения, товар будет скрыт с витрины.
Подробнее о том, как продавать товары по несколько штук, читайте в Справке Маркета для продавцов.
⚙️ Лимит: 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: Min 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[] Категории и лимит на установку кванта и минимального количества товаров. |
errors |
Type: CategoryErrorDTO[] Ошибки, которые появились из-за переданных категорий. |
status |
Type: ApiResponseStatusType Тип ответа. Enum: |
MaxSaleQuantumDTO
Лимит на установку кванта и минимального количества товаров по категориям.
Name |
Description |
id* |
Type: integer<int64> Идентификатор категории. |
maxSaleQuantum |
Type: integer Лимит на установку кванта и минимального количества товаров. |
name |
Type: string Название категории. |
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[] Список ошибок. |
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[] Список ошибок. |
status |
Type: ApiResponseStatusType Тип ответа. Enum: |
403 Forbidden
Данные для авторизации неверны или доступ к ресурсу запрещен.
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. |
status |
Type: ApiResponseStatusType Тип ответа. Enum: |
404 Not Found
Запрашиваемый ресурс не найден.
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. |
status |
Type: ApiResponseStatusType Тип ответа. Enum: |
420 Method Failure
Превышено ограничение на доступ к ресурсу.
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. |
status |
Type: ApiResponseStatusType Тип ответа. Enum: |
500 Internal Server Error
Внутренняя ошибка сервера.
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
Name |
Description |
errors |
Type: ApiErrorDTO[] Список ошибок. |
status |
Type: ApiResponseStatusType Тип ответа. Enum: |
No longer supported, please use an alternative and newer version.
Если задан квант продажи, покупатель сможет добавить в заказ только кратное ему число товаров.
Например, если квант продажи равен 5, покупатель сможет добавить в корзину 5, 10, 15 и т. д. штук товара, а 1, 2 или 7 — не сможет.