Изменение условий продажи товаров в магазине
Метод доступен для моделей: FBY, FBS, Экспресс и DBS.
Если вы используете API-Key-токен, для вызова метода необходим один из доступов в списке
- offers-and-cards-management — Управление товарами и карточками
- all-methods — Полное управление кабинетом
Изменяет параметры размещения товаров в конкретном магазине: доступность товара, продажа квантами и применяемый НДС.
| ⚙️ Лимит: 10 000 товаров в минуту |
|---|
Request
POST
https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/offers/update
Path parameters
|
Name |
Description |
|
campaignId |
Type: integer Идентификатор кампании (магазина) — технический идентификатор, который представляет ваш магазин в системе Яндекс Маркета при работе через API. Он однозначно связывается с вашим магазином, но предназначен только для автоматизированного взаимодействия. Его можно узнать с помощью запроса GET v2/campaigns или найти в кабинете продавца на Маркете. Нажмите на иконку вашего аккаунта → Настройки и в меню слева выберите API и модули:
⚠️ Не путайте его с:
Min value: |
Body
application/json
{
"offers": [
{
"offerId": "example",
"quantum": {
"minQuantity": 1,
"stepQuantity": 1
},
"available": true
}
]
}
|
Name |
Description |
|
offers |
Type: UpdateCampaignOfferDTO[] Параметры размещения товаров в заданном магазине. Min items: Max items: Example
|
ShopSku
Ваш SKU — идентификатор товара в вашей системе.
Правила использования SKU:
-
У каждого товара SKU должен быть свой.
-
Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге.
SKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте в Справке Маркета для продавцов.
Важно
Пробельные символы в начале и конце значения автоматически удаляются. Например, " SKU123 " и "SKU123" будут обработаны как одинаковые значения.
Что такое SKU и как его назначать
Type: string
Min length: 1
Max length: 255
Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$
Example: example
QuantumDTO
Deprecated
Настройка продажи квантами.
Чтобы сбросить установленные ранее значения, передайте пустой параметр quantum.
Пример
{
"offers": [
{
"offerId": "08e35dc1-89a2-11e3-8055-0015e9b8c48d",
"quantum": {}
}
]
}
|
Name |
Description |
|
minQuantity |
Type: integer Минимальное количество единиц товара в заказе. Например, если указать 10, покупатель сможет добавить в корзину не меньше 10 единиц. ⚠️ Если количество товара на складе меньше заданного, ограничение не сработает и покупатель сможет его заказать. Min value: |
|
stepQuantity |
Type: integer На сколько единиц покупатель сможет увеличить количество товара в корзине. Например, если задать 5, покупатель сможет добавить к заказу только 5, 10, 15, ... единиц товара. ⚠️ Если количество товара на складе не дотягивает до кванта, ограничение не сработает и покупатель сможет заказать количество, не кратное кванту. Min value: Max value: |
Example
{
"minQuantity": 1,
"stepQuantity": 1
}
BaseCampaignOfferDTO
Информация о новой цене на товар.
|
Name |
Description |
|
offerId |
Type: ShopSku Ваш SKU — идентификатор товара в вашей системе. Правила использования SKU:
SKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте в Справке Маркета для продавцов. Важно Пробельные символы в начале и конце значения автоматически удаляются. Например, Что такое SKU и как его назначать Min length: Max length: Pattern: Example: |
|
available |
Type: boolean Вместо него используйте методы скрытия товаров с витрины
Есть ли товар в продаже. |
|
quantum |
Type: QuantumDTO Настройка продажи квантами. Что это значит? Настройка продажи квантами. Чтобы сбросить установленные ранее значения, передайте пустой параметр Пример
Example
|
Example
{
"offerId": "example",
"quantum": {
"minQuantity": 1,
"stepQuantity": 1
},
"available": true
}
VatType
Идентификатор НДС, применяемый для товара:
2— НДС 10%. Например, используется при реализации отдельных продовольственных и медицинских товаров.5— НДС 0%. Например, используется при продаже товаров, вывезенных в таможенной процедуре экспорта, или при оказании услуг по международной перевозке товаров.6— НДС не облагается, используется только для отдельных видов услуг.7— НДС 20%. Основной НДС с 2019 года до 1 января 2026 года.10— НДС 5%. НДС для упрощенной системы налогообложения (УСН).11— НДС 7%. НДС для упрощенной системы налогообложения (УСН).14— НДС 22%. Основной НДС с 1 января 2026 года.
Если параметр не указан, используется НДС, установленный в кабинете.
Для продавцов Market Yandex Go недоступна передача и получение НДС.
Type: integer
UpdateCampaignOfferDTO
Параметры размещения товара в магазине.
Type: object
All of 2 types
-
Type: BaseCampaignOfferDTO
Информация о новой цене на товар.
Example
{ "offerId": "example", "quantum": { "minQuantity": 1, "stepQuantity": 1 }, "available": true } -
Type: object
vat
Type: VatType
Идентификатор НДС, применяемый для товара:
2— НДС 10%. Например, используется при реализации отдельных продовольственных и медицинских товаров.5— НДС 0%. Например, используется при продаже товаров, вывезенных в таможенной процедуре экспорта, или при оказании услуг по международной перевозке товаров.6— НДС не облагается, используется только для отдельных видов услуг.7— НДС 20%. Основной НДС с 2019 года до 1 января 2026 года.10— НДС 5%. НДС для упрощенной системы налогообложения (УСН).11— НДС 7%. НДС для упрощенной системы налогообложения (УСН).14— НДС 22%. Основной НДС с 1 января 2026 года.
Если параметр не указан, используется НДС, установленный в кабинете.
Для продавцов Market Yandex Go недоступна передача и получение НДС.
Example:
0Example
{ "vat": 0 }
Example
{
"offerId": "example",
"quantum": {
"minQuantity": 1,
"stepQuantity": 1
},
"available": true
}
Responses
200 OK
Ответ 200 обозначает, что новые параметры получены Маркетом и скоро вступят в силу.
Body
application/json
{
"status": "OK"
}
Type: object
ApiResponseStatusType
Тип ответа. Возможные значения:
OK— ошибок нет.ERROR— при обработке запроса произошла ошибка.
Type: string
Enum: OK, ERROR
ApiResponse
Стандартная обертка для ответов сервера.
|
Name |
Description |
|
status |
Type: ApiResponseStatusType Тип ответа. Возможные значения:
Enum: |
Example
{
"status": "OK"
}
400 Bad Request
Запрос содержит неправильные данные. Подробнее об ошибках при работе с ценами
Body
application/json
{
"status": "OK"
}
Type: object
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"
}
401 Unauthorized
В запросе не указаны данные для авторизации. Подробнее об ошибке
Body
application/json
{
"status": "OK"
}
Type: object
403 Forbidden
Данные для авторизации неверны или доступ к ресурсу запрещен. Подробнее об ошибке
Body
application/json
{
"status": "OK"
}
Type: object
404 Not Found
Запрашиваемый ресурс не найден. Подробнее об ошибке
Body
application/json
{
"status": "OK"
}
Type: object
420 Method Failure
Превышено ограничение на доступ к ресурсу. Подробнее об ошибке
Body
application/json
{
"status": "OK"
}
Type: object
423 Locked
К ресурсу нельзя применить указанный метод. Подробнее об ошибке
Body
application/json
{
"status": "OK"
}
Type: object
500 Internal Server Error
Внутренняя ошибка Маркета. Подробнее об ошибке
Body
application/json
{
"status": "OK"
}
Type: object
pathParams:
- description: "Идентификатор кампании (магазина) — технический идентификатор, который представляет ваш магазин в системе Яндекс Маркета при работе через API. Он однозначно связывается с вашим магазином, но предназначен только для автоматизированного взаимодействия.\n\nЕго можно узнать с помощью запроса [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md) или найти в кабинете продавца на Маркете. Нажмите на иконку вашего аккаунта → **Настройки** и в меню слева выберите **API и модули**:\n\n* блок **Идентификатор кампании**;\n* вкладка **Лог запросов** → выпадающий список в блоке **Показывать логи**.\n\n⚠️ Не путайте его с:\n- идентификатором магазина, который отображается в личном кабинете продавца;\n- рекламными кампаниями.\n"
name: campaignId
in: path
required: true
schema:
type: integer
format: int64
minimum: 1
searchParams: []
headers: []
body: |-
{
"offers": [
{
"offerId": "example",
"quantum": {
"minQuantity": 1,
"stepQuantity": 1
},
"available": true
}
]
}
schema:
description: Запрос на обновление предложений товаров магазина.
type: object
required:
- offers
properties:
offers:
description: Параметры размещения товаров в заданном магазине.
type: array
minItems: 1
maxItems: 500
items:
description: Параметры размещения товара в магазине.
type: object
allOf:
- description: Информация о новой цене на товар.
type: object
required:
- offerId
properties:
offerId:
description: "Ваш SKU —\_идентификатор товара в вашей системе.\n\nПравила использования SKU:\n\n* У каждого товара SKU должен быть свой.\n\n* Уже заданный SKU нельзя освободить и использовать заново для другого товара. Каждый товар должен получать новый идентификатор, до того никогда не использовавшийся в вашем каталоге.\n\nSKU товара можно изменить в кабинете продавца на Маркете. О том, как это сделать, читайте [в Справке Маркета для продавцов](https://yandex.ru/support2/marketplace/ru/assortment/operations/edit-sku).\n\n{% note warning %}\n\nПробельные символы в начале и конце значения автоматически удаляются. Например, `\" SKU123 \"` и `\"SKU123\"` будут обработаны как одинаковые значения.\n\n{% endnote %}\n\n[Что такое SKU и как его назначать](https://yandex.ru/support/marketplace/assortment/add/index.html#fields)\n"
type: string
pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$
x-transform: trim
minLength: 1
maxLength: 255
quantum:
description: >-
Настройка продажи квантами. [Что это
значит?](https://yandex.ru/support/marketplace/assortment/fields/quantum.html)
$ref: '#/$defs/QuantumDTO'
available:
description: "{% note warning \"Вместо него используйте методы скрытия товаров с витрины\" %}\n\n* [GET\_v2/campaigns/{campaignId}/hidden-offers](../../reference/assortment/getHiddenOffers.md) — просмотр скрытых товаров;\n* [POST\_v2/campaigns/{campaignId}/hidden-offers](../../reference/assortment/addHiddenOffers.md) — скрытие товаров;\n* [POST\_v2/campaigns/{campaignId}/hidden-offers/delete](../../reference/assortment/deleteHiddenOffers.md) — возобновление показа.\n\n{% endnote %}\n\nЕсть ли товар в продаже.\n"
deprecated: true
type: boolean
- properties:
vat:
description: >
Идентификатор НДС, применяемый для товара:
* `2` — НДС 10%. Например, используется при реализации
отдельных продовольственных и медицинских товаров.
* `5` — НДС 0%. Например, используется при продаже товаров,
вывезенных в таможенной процедуре экспорта, или при оказании
услуг по международной перевозке товаров.
* `6` — НДС не облагается, используется только для отдельных
видов услуг.
* `7` — НДС 20%. Основной НДС с 2019 года до 1 января 2026
года.
* `10` — НДС 5%. НДС для упрощенной системы налогообложения
(УСН).
* `11` — НДС 7%. НДС для упрощенной системы налогообложения
(УСН).
* `14` — НДС 22%. Основной НДС с 1 января 2026 года.
Если параметр не указан, используется НДС, установленный в
кабинете.
**Для продавцов Market Yandex Go** недоступна
передача и получение НДС.
type: integer
format: int32
$defs:
/home/sandbox/.ya/build/build_root/4217/00000b/market/mbi/docs/partner-api/docfiles/__docsbuild/.tmp_input/ru/openapi/partner-api-spec/offers/schemas.yaml#/QuantumDTO:
deprecated: true
description: >
Настройка продажи квантами.
Чтобы сбросить установленные ранее значения, передайте пустой параметр
`quantum`.
{% cut "Пример" %}
```json translate=no
{
"offers": [
{
"offerId": "08e35dc1-89a2-11e3-8055-0015e9b8c48d",
"quantum": {}
}
]
}
```
{% endcut %}
type: object
properties:
minQuantity:
description: >
Минимальное количество единиц товара в заказе. Например, если
указать 10, покупатель сможет добавить в корзину не меньше 10
единиц.
⚠️ Если количество товара на складе меньше заданного, ограничение не
сработает и покупатель сможет его заказать.
type: integer
format: int32
minimum: 1
stepQuantity:
description: >
На сколько единиц покупатель сможет увеличить количество товара в
корзине.
Например, если задать 5, покупатель сможет добавить к заказу только
5, 10, 15, ... единиц товара.
⚠️ Если количество товара на складе не дотягивает до кванта,
ограничение не сработает и покупатель сможет заказать количество, не
кратное кванту.
type: integer
format: int32
minimum: 1
maximum: 100
bodyType: application/json
method: post
security:
- type: apiKey
name: Api-Key
in: header
- type: oauth2
x-inline: true
flows:
implicit:
authorizationUrl: https://oauth.yandex.ru/authorize
scopes:
market:partner-api: API Яндекс.Маркета / Поиска по товарам для партнеров
path: v2/campaigns/{campaignId}/offers/update
host: https://api.partner.market.yandex.ru
No longer supported, please use an alternative and newer version.