更改商店内商品的销售条款
如果您使用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<int64> 活动ID。 您可以使用查询找到它 :no-translate[GET v2/campaigns] 或者在市场上的卖家办公室找到它-点击您的企业名称并转到页面:
,不要发送商店的ID,而不是,这是在卖方的帐户在市场上的商店名称旁边和一些报告。
Min value: |
Body
application/json
{
"offers": [
{
"offerId": "string",
"quantum": {
"minQuantity": 0,
"stepQuantity": 0
},
"available": false,
"vat": 0
}
]
}
Name |
Description |
offers* |
Type: UpdateCampaignOfferDTO[] 指定商店中的产品放置参数。 Min items: Max items: |
UpdateCampaignOfferDTO
商店中的产品放置参数。
Name |
Description |
offerId* |
Type: string 你的 SKU -系统中的产品ID。 使用规则 SKU:
SKU 产品可以在市场上的卖方帐户中更改。 阅读如何做到这一点。 在市场对卖家的帮助. Min length: Max length: Pattern: |
available ⦸
|
Type: boolean 相反,使用方法从展柜中隐藏商品。 品是否在售。 |
quantum ⦸
|
Type: QuantumDTO Настройка продажи квантами. Что это значит? |
vat |
Type: integer<int32> 用于产品的增值税标识符:
如果省略该参数,则使用机柜中设置的增值税。 卖家须知 Market Yandex Go不提供增值税的转让和收据。 |
QuantumDTO
建立量子销售。
要重置先前设置的值,请传递一个空参数 quantum
.
例子:
{
"offers": [
{
"offerId": "08e35dc1-89a2-11e3-8055-0015e9b8c48d",
"quantum": {}
}
]
}
Name |
Description |
minQuantity |
Type: integer<int32> 订单中产品单位的最小数量。 例如,如果您指定10,客户将能够将至少10个商品添加到购物车。 如果库存商品数量少于指定数量,则限制将不起作用,买方将能够订购。 Min value: |
stepQuantity |
Type: integer<int32> 由多少单位的买方将能够增加货物在篮子里的数量。 例如,如果您设置5,买方将能够添加只有5,10,15,。.. 订单的项目。 如果库存货物的数量没有达到数量,限制将不起作用,买方将能够订购数量不是数量的倍数。 Min value: Max value: |
Responses
200 OK
回答 200
表示新参数已被Yandex接收。市场,并将很快生效。
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.