为特定商店中的产品设置价格
方法适用于模式：FBY, FBS, Express 和 DBS.
如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一
- pricing — 价格管理
- all-methods — 全面管理账户
设置商店商品的价格。 要获得市场关于价格的建议，请提出要求 POST v2/businesses/{businessId}/offers/recommendations.
该方法仅适用于个别商店
如果可以在市场上卖家办公室的个别商店中设置独特的价格，则可以使用此方法。 如何检查 — 在方法 POST v2/businesses/{businessId}/settings 在参数中 onlyDefaultPrice 值返回 false.
否则，请使用适用于所有商店的价格管理方法。, — POST v2/businesses/{businessId}/offer-prices/updates.
目录中的数据不会立即更新
最多需要几分钟。
| ⚙️ 限制: 每分钟10,000件物品 |
|---|
Request
POST
https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/offer-prices/updates
Path parameters
|
Name |
Description |
|
campaignId |
Type: integer 广告系列（商店）的ID — 通过API工作时，代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接，但仅用于自动交互。 您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ 设置 在左边的菜单中，选择 Api和模块:
⚠️ 不要把它与:
Min value: |
Body
application/json
{
"offers": [
{
"offerId": "example",
"price": {
"value": 0,
"discountBase": 0,
"currencyId": "RUR",
"vat": 0
},
"id": "example",
"shopSku": "example"
}
]
}
|
Name |
Description |
||||||||||||||||
|
offers |
Type: object[]
的产品清单。 Min items: Max items: Example |
Responses
200 OK
市场已接受有关新价格的信息。
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",
"price": {
"value": 0,
"discountBase": 0,
"currencyId": "RUR",
"vat": 0
},
"id": "example",
"shopSku": "example"
}
]
}
schema:
description: 设定商品价格的请求。
type: object
required:
- offers
properties:
offers:
description: 的产品清单。
type: array
minItems: 1
maxItems: 2000
items:
description: 有关新价格的信息的项目。
type: object
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
price:
description: 价格包括折扣、货币和上次更新的时间.
type: object
properties:
value:
description: 品的价格。
type: number
minimum: 0
exclusiveMinimum: true
discountBase:
description: |
划掉的价格。
数字必须是整数。 您可以指定折扣从5到99％的价格。
如果您提供产品折扣，则在每次更新价格时传递此参数。
type: number
minimum: 0
exclusiveMinimum: true
currencyId:
type: string
description: |
货币代码:
* `RUR` — 俄罗斯卢布。
* `UAH` — 乌克兰格里夫纳。
* `BYR` — 白俄罗斯卢布。
* `KZT` — 哈萨克斯坦坚戈。
* `UZS` — 乌兹别克总和。
enum:
- RUR
- USD
- EUR
- UAH
- AUD
- GBP
- BYR
- BYN
- DKK
- ISK
- KZT
- CAD
- CNY
- NOK
- XDR
- SGD
- TRY
- SEK
- CHF
- JPY
- AZN
- ALL
- DZD
- AOA
- ARS
- AMD
- AFN
- BHD
- BGN
- BOB
- BWP
- BND
- BRL
- BIF
- HUF
- VEF
- KPW
- VND
- GMD
- GHS
- GNF
- HKD
- GEL
- AED
- EGP
- ZMK
- ILS
- INR
- IDR
- JOD
- IQD
- IRR
- YER
- QAR
- KES
- KGS
- COP
- CDF
- CRC
- KWD
- CUP
- LAK
- LVL
- SLL
- LBP
- LYD
- SZL
- LTL
- MUR
- MRO
- MKD
- MWK
- MGA
- MYR
- MAD
- MXN
- MZN
- MDL
- MNT
- NPR
- NGN
- NIO
- NZD
- OMR
- PKR
- PYG
- PEN
- PLN
- KHR
- SAR
- RON
- SCR
- SYP
- SKK
- SOS
- SDG
- SRD
- TJS
- THB
- TWD
- BDT
- TZS
- TND
- TMM
- UGX
- UZS
- UYU
- PHP
- DJF
- XAF
- XOF
- HRK
- CZK
- CLP
- LKR
- EEK
- ETB
- RSD
- ZAR
- KRW
- NAD
- TL
- UE
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
id:
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
shopSku:
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
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}/offer-prices/updates
host: https://api.partner.market.yandex.ru
No longer supported, please use an alternative and newer version.