买方取消订单

方法适用于模式DBS.

如果您使用API-Key令牌,调用该方法时需要具备列表中可用权限之一

确认或拒绝买方取消订单的请求,该订单已发送到送货服务。

买方可以在订单处理或交付过程中取消订单。 如果订单仍在处理中(状态 PROCESSING),您不需要确认取消订单 — 它将自动取消。

如果订单已发送到送货服务(状态 DELIVERYPICKUP)并且用户取消了它,您可以在48小时内通知取消服务。

如何了解已取消的订单:

如果您在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和模块:

  • 运动ID;
  • 标签 查询日志 →块中的下拉列表 显示日志.

⚠️ 不要把它与:

  • 商店的标识符,显示在商家的个人帐户中。
  • 广告活动。

Min value: 1

orderId

Type: integer

的订单ID。

Body

application/json
{
  "accepted": true,
  "reason": "ORDER_DELIVERED"
}

Name

Description

accepted

Type: boolean

取消订单的决定:

  • true — 订单被取消,送货服务在将订单交给买家之前发现了取消。
  • false — 订单不会被取消,因为它已经通过快递交付给买方或转移到订单提货点。

reason

Type: string

订单无法取消的可能原因。

  • ORDER_DELIVERED — 订单已经交付。
  • ORDER_IN_DELIVERY — 订单已经与快递。

Enum: ORDER_DELIVERED, ORDER_IN_DELIVERY

Responses

200 OK

对订单取消的响应已成功传输。

Body

application/json
{
  "status": "OK"
}

Type: object

400 Bad Request

请求包含不正确的数据。 有关错误的更多信息

Body

application/json
{
  "status": "OK"
}

Type: object

401 Unauthorized

请求中未指定授权数据。 有关错误的更多信息

Body

application/json
{
  "status": "OK"
}

Type: object

403 Forbidden

授权数据不正确或禁止访问资源。 有关错误的更多信息

Body

application/json
{
  "status": "OK"
}

Type: object

404 Not Found

找不到请求的资源。 有关错误的更多信息

Body

application/json
{
  "status": "OK"
}

Type: object

420 Method Failure

已超出资源访问限制。 有关错误的更多信息

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.