买方取消订单
Info
Console
方法适用于模式DBS.
如果您使用API-Key令牌,调用该方法时需要具备列表中可用权限之一
- inventory-and-order-processing — 订单处理和商品核算
- all-methods — 全面管理账户
确认或拒绝买方取消订单的请求,该订单已发送到送货服务。
买方可以在订单处理或交付过程中取消订单。 如果订单仍在处理中(状态 PROCESSING),您不需要确认取消订单 — 它将自动取消。
如果订单已发送到送货服务(状态 DELIVERY 或 PICKUP)并且用户取消了它,您可以在48小时内通知取消服务。
- 送货服务在将订单交给买家之前发现了取消 — 通过请求确认取消 PUT v2/campaigns/{campaignId}/orders/{orderId}/cancellation/accept.
- 订单已经交付 — 使用相同的请求拒绝取消。 然后客户仍然会有订单,并且它的钱不会退还。
如何了解已取消的订单:
- 传递参数
onlyWaitingForCancellationApprove在请求 POST v1/businesses/{businessId}/orders. - 在办公室或通过电子邮件 — 将向其发送取消通知。
- 启用API通知。 燕基科斯.Market会向您发送请求。 POST 通知书 当有一个新的请求取消订单。 如何使用通知
如果您在48小时内未确认或拒绝取消订单,订单将自动取消。
| ⚙️ 限制: 每小时500个请求 |
|---|
Request
PUT
https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/orders/{orderId}/cancellation/accept
Path parameters
|
Name |
Description |
|
campaignId |
Type: integer 广告系列(商店)的ID — 通过API工作时,代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接,但仅用于自动交互。 您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ 设置 在左边的菜单中,选择 Api和模块:
⚠️ 不要把它与:
Min value: |
|
orderId |
Type: integer 的订单ID。 |
Body
application/json
{
"accepted": true,
"reason": "ORDER_DELIVERED"
}
|
Name |
Description |
|
accepted |
Type: boolean 取消订单的决定:
|
|
reason |
Type: string 订单无法取消的可能原因。
Enum: |
Responses
200 OK
对订单取消的响应已成功传输。
Body
application/json
{
"status": "OK"
}
Type: object
500 Internal Server Error
Yandex中的内部错误。 市场。 有关错误的更多信息
Body
application/json
{
"status": "OK"
}
Type: object
No longer supported, please use an alternative and newer version.