Лимит на установку кванта продажи и минимального количества товаров в заказе
Deprecated
Метод доступен для моделей: FBY, FBS, Экспресс и DBS.
Если вы используете API-Key-токен, для вызова метода необходим один из доступов в списке
- offers-and-cards-management — Управление товарами и карточками
- offers-and-cards-management:read-only — Просмотр товаров и карточек
- all-methods — Полное управление кабинетом
- all-methods:read-only — Просмотр всех данных
Метод устарел и будет отключен 5 апреля 2027.
Возвращает лимит на установку кванта и минимального количества товаров в заказе, которые вы можете задать для товаров указанных категорий.
Если вы передадите значение кванта или минимального количества товаров выше установленного Маркетом ограничения, товар будет скрыт с витрины.
Подробнее о том, как продавать товары по несколько штук, читайте в Справке Маркета для продавцов.
⚙️ Лимит: 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[] Идентификаторы листовых категорий на Маркете. Min items: Max items: Unique items: Example
|
Responses
200 OK
Лимит на установку кванта и минимального количества товаров.
Body
application/json
{
"status": "OK",
"results": [
{
"id": 0,
"name": "example",
"maxSaleQuantum": 0
}
],
"errors": [
{
"categoryId": 0,
"type": "UNKNOWN_CATEGORY"
}
]
}
Type: object
All of 2 types
-
Type: ApiResponse
Стандартная обертка для ответов сервера.
Example
{ "status": "OK" } -
Type: GetCategoriesMaxSaleQuantumDTO
Категории и лимит на установку кванта и минимального количества товаров.
Example
{ "results": [ { "id": 0, "name": "example", "maxSaleQuantum": 0 } ], "errors": [ { "categoryId": 0, "type": "UNKNOWN_CATEGORY" } ] }
ApiResponseStatusType
Тип ответа. Возможные значения:
OK— ошибок нет.ERROR— при обработке запроса произошла ошибка.
Type: string
Enum: OK, ERROR
ApiResponse
Стандартная обертка для ответов сервера.
|
Name |
Description |
|
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
Example
{
"status": "OK"
}
MaxSaleQuantumDTO
Лимит на установку кванта и минимального количества товаров по категориям.
|
Name |
Description |
|
id |
Type: integer Идентификатор категории. |
|
maxSaleQuantum |
Type: integer Лимит на установку кванта и минимального количества товаров. |
|
name |
Type: string Название категории. Example: |
Example
{
"id": 0,
"name": "example",
"maxSaleQuantum": 0
}
CategoryErrorType
Типы ошибок:
UNKNOWN_CATEGORY— указана неизвестная категория.CATEGORY_IS_NOT_LEAF— указана нелистовая категория. Укажите ту, которая не имеет дочерних категорий.
Type: string
Enum: UNKNOWN_CATEGORY, CATEGORY_IS_NOT_LEAF
CategoryErrorDTO
Текст ошибки.
|
Name |
Description |
|
categoryId |
Type: integer Идентификатор категории. |
|
type |
Type: CategoryErrorType Типы ошибок:
Enum: |
Example
{
"categoryId": 0,
"type": "UNKNOWN_CATEGORY"
}
GetCategoriesMaxSaleQuantumDTO
Категории и лимит на установку кванта и минимального количества товаров.
|
Name |
Description |
|
results |
Type: MaxSaleQuantumDTO[] Категории и лимит на установку кванта и минимального количества товаров. Example
|
|
errors |
Type: CategoryErrorDTO[] | null Ошибки, которые появились из-за переданных категорий. Min items: Example
|
Example
{
"results": [
{
"id": 0,
"name": "example",
"maxSaleQuantum": 0
}
],
"errors": [
{
"categoryId": 0,
"type": "UNKNOWN_CATEGORY"
}
]
}
400 Bad Request
Запрос содержит неправильные данные. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: ApiErrorResponse
Стандартная обертка для ошибок сервера.
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] }
ApiErrorDTO
Общий формат ошибки.
|
Name |
Description |
|
code |
Type: string Код ошибки. Example: |
|
message |
Type: string Описание ошибки. Example: |
Example
{
"code": "example",
"message": "example"
}
ApiErrorResponse
Стандартная обертка для ошибок сервера.
Type: object
All of 2 types
-
Type: ApiResponse
Стандартная обертка для ответов сервера.
Example
{ "status": "OK" } -
Type: object
errors
Type: ApiErrorDTO[] | null
Список ошибок.
Min items:
1Example
[ { "code": "example", "message": "example" } ]Example
{ "errors": [ { "code": "example", "message": "example" } ] }
Example
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
401 Unauthorized
В запросе не указаны данные для авторизации. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: ApiErrorResponse
Стандартная обертка для ошибок сервера.
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] }
403 Forbidden
Данные для авторизации неверны или доступ к ресурсу запрещен. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: ApiErrorResponse
Стандартная обертка для ошибок сервера.
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] }
404 Not Found
Запрашиваемый ресурс не найден. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: ApiErrorResponse
Стандартная обертка для ошибок сервера.
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] }
420 Method Failure
Превышено ограничение на доступ к ресурсу. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: ApiErrorResponse
Стандартная обертка для ошибок сервера.
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] }
500 Internal Server Error
Внутренняя ошибка Маркета. Подробнее об ошибке
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: ApiErrorResponse
Стандартная обертка для ошибок сервера.
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] }
No longer supported, please use an alternative and newer version.
Если задан квант продажи, покупатель сможет добавить в заказ только кратное ему число товаров.
Например, если квант продажи равен 5, покупатель сможет добавить в корзину 5, 10, 15 и т. д. штук товара, а 1, 2 или 7 — не сможет.
Категории, у которых нет дочерних.