Лимит на установку кванта продажи и минимального количества товаров в заказе
Метод доступен для всех моделей.
Если вы используете 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/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[] Категории и лимит на установку кванта и минимального количества товаров. |
errors |
Type: CategoryErrorDTO[] Ошибки, которые появились из-за переданных категорий. Min items: |
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: |
ApiResponseStatusType
Тип ответа. Возможные значения:
OK
— ошибок нет.ERROR
— при обработке запроса произошла ошибка.
Type |
Description |
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 — не сможет.