从订单中删除项目或减少其数量
方法适用于模式DBS.
如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一
- inventory-and-order-processing — 订单处理和商品核算
- all-methods — 全面管理账户
如果你按照模型工作 FBS
如果商店无法全部交付，则从订单中删除一个或多个项目。
订单必须具有状态 "status": "PROCESSING" 处理阶段 "substatus": "STARTED". 状态转移后无法更改组成 "substatus": "READY_TO_SHIP".
减少相同产品的数量
在参数中传递更新的值 count.
从订单中删除项目
传递值 0 在参数中 count 或者不要传递它 item.
您不能删除或减少项目的数量，如果它:
- 特别优惠增加;
- 相当于订单价值的99%;
- 订单中唯一的产品。
在这种情况下，取消订单。 — 在方法 PUT v2/campaigns/{campaignId}/orders/{orderId}/status 发送订单状态 CANCELLED 与取消的原因 SHOP_FAILED.
这笔钱将如何退还
如果客户在结账时支付了产品，市场将在两天内退还从订单中移除的物品的钱:
-
使用银行卡付款时 — 从商店将订单转移到状态的那一刻起
SHIPPED; -
通过支付时 Apple Pay 或 Google Pay — 从商店从订单中删除产品的那一刻起。
| ⚙️ 限制: 每小时100,000次请求 |
|---|
Request
PUT
https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/orders/{orderId}/items
Path parameters
|
Name |
Description |
|
campaignId* |
Type: integer<int64> 活动ID。 您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到 — 点击您的帐户图标→ 设置 在左边的菜单中，选择 Api和模块:
⚠️ 不要发送商店ID，这是在市场上的卖家帐户旁边的商店名称和一些报告。
Min value: |
|
orderId* |
Type: integer<int64> 的订单ID。 |
Body
application/json
{
"items": [
{
"id": 0,
"count": 0,
"instances": [
{
"cis": "string",
"uin": "string",
"rnpt": "string",
"gtd": "string",
"countryCode": "RU"
}
]
}
],
"reason": "PARTNER_REQUESTED_REMOVE"
}
|
Name |
Description |
|
items* |
Type: object[] 订单中的产品列表。 如果商店没有在输入数据中提供有关产品的信息，它将从订单中删除。 所需参数。
如果商店没有在输入数据中提供有关产品的信息，它将从订单中删除。 所需参数。 Min items: |
|
reason |
Type: string 订单组成已更新的原因:
Enum: |
Responses
200 OK
燕基科斯. 市场已成功处理您的要求. 预计没有输出。
400 Bad Request
请求包含不正确的数据。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
401 Unauthorized
请求中未指定授权数据。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
403 Forbidden
授权数据不正确或禁止访问资源。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
404 Not Found
找不到请求的资源。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
420 Method Failure
已超出资源访问限制。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
500 Internal Server Error
市场的内部错误。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "string",
"message": "string"
}
]
}
|
Name |
Description |
|
errors |
Type: object[] 错误列表。 Min items: |
|
status |
Type: string 响应的类型。 可能的值:
Enum: |
No longer supported, please use an alternative and newer version.
意义 cis 必须匹配正则表达式 ^(?=.{1,256}$）\u001D？(\(?01\)?\d{14}\（？21\)?([!-~]{6,8}|[!-~]{13}|[!-~]{20}）（\u001D\（？240\)?.{1,30})?\u001D\（？9[1,3]\)?.+)$.
没有密码 — ^(?=[!-~]{1,256}$)(\(?01\)?\d{14}\（？21\)?(.{6,8}|.{13}|.{20}))$.