更改商店内商品的销售条款
Info
Console
方法适用于模式:FBY, FBS, Express 和 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 广告系列(商店)的ID — 通过API工作时,代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接,但仅用于自动交互。 您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ 设置 在左边的菜单中,选择 Api和模块:
⚠️ 不要把它与:
Min value: |
Body
application/json
{
"offers": [
{
"offerId": "example",
"quantum": {
"minQuantity": 1,
"stepQuantity": 1
},
"available": true
}
]
}
|
Name |
Description |
|
offers |
Type: object[] 指定商店中的产品放置参数。 Min items: Max items: Example
|
Responses
200 OK
回答 200 表示新参数已被Yandex接收。市场,并将很快生效。
Body
application/json
{
"status": "OK"
}
Type: object
500 Internal Server Error
Yandex的内部错误。 市场。 有关错误的更多信息
Body
application/json
{
"status": "OK"
}
Type: object
pathParams:
- description: "广告系列(商店)的ID — 通过API工作时,代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接,但仅用于自动交互。\n\n您可以使用查询找到它 [GET\_v2/campaigns](../../reference/campaigns/getCampaigns.md) 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ **设置** 在左边的菜单中,选择 **Api和模块**:\n\n* 座 **运动ID**;\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 —\_系统中的产品ID。\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:
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
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年到2026年1月1日。
* `10` — 增值税是5%。 简化税制(USN)的增值税。
* `11` — 增值税是7%。 简化税制(USN)的增值税。
* `14` — 增值税是22%。
基本增值税从2026年1月1日开始。
如果省略该参数,则使用机柜中设置的增值税。
**卖家须知 Market Yandex Go**不提供增值税的转让和收据。
type: integer
format: int32
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.