为特定商店中的产品设置价格
如果您使用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<int64> 活动ID。 您可以使用查询找到它 :no-translate[GET v2/campaigns] 或者在市场上的卖家办公室找到它-点击您的企业名称并转到页面:
,不要发送商店ID,而不是,这是在卖方的帐户在市场上的商店名称旁边和一些报告。
Min value: |
Body
application/json
{
"offers": [
{
"offerId": "string",
"price": {
"value": 0,
"discountBase": 0,
"currencyId": "RUR",
"vat": 0
}
}
]
}
Name |
Description |
offers* |
Type: OfferPriceDTO[] 的产品清单。 Min items: Max items: |
OfferPriceDTO
有关新价格的信息的项目。
Name |
Description |
offerId |
Type: string 你的 SKU -系统中的产品ID。 使用规则 SKU:
SKU 产品可以在市场上的卖方帐户中更改。 阅读有关如何做到这一点。 在市场对卖家的帮助. Min length: Max length: Pattern: |
price |
Type: PriceDTO 价格包括折扣、货币和上次更新的时间. |
PriceDTO
价格包括折扣、货币和上次更新的时间.
Name |
Description |
currencyId |
Type: CurrencyType Валюта, в которой указана цена товара. Enum: |
discountBase |
Type: number 划掉的价格。 数字必须是整数。 您可以指定折扣从5到99%的价格。 如果您提供产品折扣,则在每次更新价格时传递此参数。 Min value (exclusive): |
value |
Type: number 品的价格。 Min value (exclusive): |
vat |
Type: integer<int32> 用于产品的增值税标识符:
如果省略该参数,则使用机柜中设置的增值税。 卖家须知 Market Yandex Go不提供增值税的转让和收据。 |
CurrencyType
货币代码:
RUR
-俄罗斯卢布。UAH
-乌克兰格里夫纳。BYR
-白俄罗斯卢布。KZT
-哈萨克斯坦坚戈。UZS
-乌兹别克总和。
Type |
Description |
Enum: |
Responses
200 OK
市场已接受有关新价格的信息。
Body
application/json
{
"status": "OK"
}
Name |
Description |
status* |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
ApiResponseStatusType
响应的类型。 可能的值:
OK
-没有错误。ERROR
-处理请求时发生错误。
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: |
423 Locked
指定的方法不能应用于资源。 有关错误的更多信息
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
Yandex中的内部错误。 市场。 有关错误的更多信息
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.