更改多个订单的状态

Info

Console

方法适用于模式：FBS, Express 和 DBS.

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

inventory-and-order-processing — 订单处理和商品核算
all-methods — 全面管理账户

更改多个订单的状态。

可能的状态更改:

如果商店已确认并准备装运订单，则订单从状态 "status": "PROCESSING"和处理阶段 "substatus": "STARTED" 它需要转换为状态 "status": "PROCESSING" 和处理阶段 "substatus": "READY_TO_SHIP".
如果商店已确认订单，但无法发货（例如，产品已在数据库中列出，但没有库存或没有所需的颜色），则订单状态为 "status": "PROCESSING" 和处理阶段 "substatus": "STARTED" 它需要转换为状态 "status": "CANCELLED" 与取消订单的原因 "substatus": "SHOP_FAILED".
如果商店已准备装运订单，但无法完成订单（例如，最后一件商品已损坏或有缺陷），则订单状态为 "status": "PROCESSING" 和处理阶段 "substatus": "READY_TO_SHIP" 它需要转换为状态 "status": "CANCELLED" 与取消订单的原因 "substatus": "SHOP_FAILED".

⚙️ 限制: 每小时100,000份订单

Request

POST

https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/orders/status-update

Path parameters

Name

Description

campaignId

Type: integer

广告系列（商店）的ID — 通过API工作时，代表您在Yandex市场系统中的商店的技术标识符。它与您的商店唯一链接，但仅用于自动交互。

您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到它。点击您的帐户图标→ 设置在左边的菜单中，选择 Api和模块:

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

⚠️ 不要把它与:

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

Min value: 1

Body

application/json

{
  "orders": [
    {
      "id": 0,
      "status": "PLACING",
      "substatus": "RESERVATION_EXPIRED"
    }
  ]
}

Name

Description

orders

Type: object[]

Type: integer

的订单ID。

status

Type: string

订单状况:

PLACING — 它正在处理，准备预订。
RESERVED — 预订，但预订不足。
UNPAID — 已发出，但尚未付款（如果在结账时选择付款）。
PROCESSING — 它正在处理中。
DELIVERY — 转移到送货服务。
PICKUP — 送到取件点。
DELIVERED — 由买方接收。
CANCELLED — 取消。
PENDING — 等待卖方处理。
PARTIALLY_RETURNED — 部分退款。
RETURNED — 全额回来了。
UNKNOWN — 状态不明。

也可以返回其他值。您不需要处理它们。

Enum: PLACING, RESERVED, UNPAID, PROCESSING, DELIVERY, PICKUP, DELIVERED, CANCELLED, PENDING, PARTIALLY_RETURNED, RETURNED, UNKNOWN

substatus

Type: string

订单处理阶段（状态 PROCESSING）或取消订单的原因（状态 CANCELLED).

状态中的订单值 PROCESSING:
- STARTED — 订单已确认，可以处理。
- READY_TO_SHIP — 订单已组装并准备装运。
状态中的订单值 CANCELLED:
- RESERVATION_EXPIRED — 客户没有在10分钟内完成预订订单。
- USER_NOT_PAID — 买方没有支付订单（对于付款类型 PREPAID）30分钟。
- USER_UNREACHABLE — 无法联系买家。为此取消，必须满足以下条件:
  - 至少3个电话从8到21在买方的时区;
  - 第一次和第三次通话之间的休息时间至少为90分钟;
  - 连接不短于5秒。
  如果不满足其中至少一个条件（号码不可用时除外），您将无法取消订单。将返回带有错误代码400的响应。
- USER_CHANGED_MIND — 客户因个人原因取消了订单。
- USER_REFUSED_DELIVERY — 买方对交货条件不满意.
- USER_REFUSED_PRODUCT — 该产品不适合买方。
- SHOP_FAILED — 商店无法完成订单。
- USER_REFUSED_QUALITY — 买方对产品的质量不满意。
- REPLACING_ORDER — 买方决定主动更换另一种产品。
- PROCESSING_EXPIRED — 值不再使用。
- PICKUP_EXPIRED — 取货点的订单保质期已过期。
- TOO_MANY_DELIVERY_DATE_CHANGES — 订单被推迟了太多次。
- TOO_LONG_DELIVERY — 订单太长时间无法交付。
- INCORRECT_PERSONAL_DATA — 对于来自国外的订单，收件人的信息不正确，订单将不会在海关检查。
TECHNICAL_ERROR — 市场方面的技术错误。联系支持。

也可以返回其他值。您不需要处理它们。

Enum: RESERVATION_EXPIRED, USER_NOT_PAID, USER_UNREACHABLE, USER_CHANGED_MIND, USER_REFUSED_DELIVERY, USER_REFUSED_PRODUCT, SHOP_FAILED, USER_REFUSED_QUALITY, REPLACING_ORDER, PROCESSING_EXPIRED, PENDING_EXPIRED, SHOP_PENDING_CANCELLED, PENDING_CANCELLED, USER_FRAUD, RESERVATION_FAILED, USER_PLACED_OTHER_ORDER, USER_BOUGHT_CHEAPER, MISSING_ITEM, BROKEN_ITEM, WRONG_ITEM, PICKUP_EXPIRED, DELIVERY_PROBLEMS, LATE_CONTACT, CUSTOM, DELIVERY_SERVICE_FAILED, WAREHOUSE_FAILED_TO_SHIP, DELIVERY_SERVICE_UNDELIVERED, PREORDER, AWAIT_CONFIRMATION, STARTED, PACKAGING, READY_TO_SHIP, SHIPPED, ASYNC_PROCESSING, WAITING_USER_INPUT, WAITING_BANK_DECISION, BANK_REJECT_CREDIT_OFFER, CUSTOMER_REJECT_CREDIT_OFFER, CREDIT_OFFER_FAILED, AWAIT_DELIVERY_DATES_CONFIRMATION, SERVICE_FAULT, DELIVERY_SERVICE_RECEIVED, USER_RECEIVED, WAITING_FOR_STOCKS, AS_PART_OF_MULTI_ORDER, READY_FOR_LAST_MILE, LAST_MILE_STARTED, ANTIFRAUD, DELIVERY_USER_NOT_RECEIVED, DELIVERY_SERVICE_DELIVERED, DELIVERED_USER_NOT_RECEIVED, USER_WANTED_ANOTHER_PAYMENT_METHOD, USER_RECEIVED_TECHNICAL_ERROR, USER_FORGOT_TO_USE_BONUS, DELIVERY_SERVICE_NOT_RECEIVED, DELIVERY_SERVICE_LOST, SHIPPED_TO_WRONG_DELIVERY_SERVICE, DELIVERED_USER_RECEIVED, WAITING_TINKOFF_DECISION, COURIER_SEARCH, COURIER_FOUND, COURIER_IN_TRANSIT_TO_SENDER, COURIER_ARRIVED_TO_SENDER, COURIER_RECEIVED, COURIER_NOT_FOUND, COURIER_NOT_DELIVER_ORDER, COURIER_RETURNS_ORDER, COURIER_RETURNED_ORDER, WAITING_USER_DELIVERY_INPUT, PICKUP_SERVICE_RECEIVED, PICKUP_USER_RECEIVED, CANCELLED_COURIER_NOT_FOUND, COURIER_NOT_COME_FOR_ORDER, DELIVERY_NOT_MANAGED_REGION, INCOMPLETE_CONTACT_INFORMATION, INCOMPLETE_MULTI_ORDER, INAPPROPRIATE_WEIGHT_SIZE, TECHNICAL_ERROR, SORTING_CENTER_LOST, COURIER_SEARCH_NOT_STARTED, LOST, AWAIT_PAYMENT, AWAIT_LAVKA_RESERVATION, USER_WANTS_TO_CHANGE_ADDRESS, FULL_NOT_RANSOM, PRESCRIPTION_MISMATCH, DROPOFF_LOST, DROPOFF_CLOSED, DELIVERY_TO_STORE_STARTED, USER_WANTS_TO_CHANGE_DELIVERY_DATE, WRONG_ITEM_DELIVERED, DAMAGED_BOX, AWAIT_DELIVERY_DATES, LAST_MILE_COURIER_SEARCH, PICKUP_POINT_CLOSED, LEGAL_INFO_CHANGED, USER_HAS_NO_TIME_TO_PICKUP_ORDER, DELIVERY_CUSTOMS_ARRIVED, DELIVERY_CUSTOMS_CLEARED, FIRST_MILE_DELIVERY_SERVICE_RECEIVED, AWAIT_AUTO_DELIVERY_DATES, AWAIT_USER_PERSONAL_DATA, NO_PERSONAL_DATA_EXPIRED, CUSTOMS_PROBLEMS, AWAIT_CASHIER, WAITING_POSTPAID_BUDGET_RESERVATION, AWAIT_SERVICEABLE_CONFIRMATION, POSTPAID_BUDGET_RESERVATION_FAILED, AWAIT_CUSTOM_PRICE_CONFIRMATION, READY_FOR_PICKUP, TOO_MANY_DELIVERY_DATE_CHANGES, TOO_LONG_DELIVERY, DEFERRED_PAYMENT, POSTPAID_FAILED, INCORRECT_PERSONAL_DATA, UNKNOWN

订单列表。

Min items: 1

Max items: 30

Example

[
  {
    "id": 0,
    "status": "PLACING",
    "substatus": "RESERVATION_EXPIRED"
  }
]

Responses

200 OK

返回有关更新的订单状态的信息。

Body

application/json

{
  "status": "OK",
  "result": {
    "orders": [
      {
        "id": 0,
        "status": "PLACING",
        "substatus": "RESERVATION_EXPIRED",
        "updateStatus": "OK",
        "errorDetails": "example",
        "operation": {}
      }
    ]
  }
}

Type: object

All of 2 types

Type: object
status

Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

result

Type: object

orders

Type: object[]

errorDetails

Type: string

更改订单状态时出错。它包含错误的描述和订单ID。

如果参数返回 updateStatus 取值 ERROR.

Example: example

Type: integer

的订单ID。

operation

Type: object

Type: string

操作的ID。

Min length: 1

Max length: 1000

Example: example

type

Type: string

操作类型:

ORDER_RECIPIENT_UPDATE — 更改收件人的数据。
ORDER_DELIVERY_INTERVAL_UPDATE — 更改交货日期间隔。
ORDER_STATUS_UPDATE — 更新订单状态以取消它。
RETURN_CANCELLATION — 取消退款。

Enum: ORDER_RECIPIENT_UPDATE, ORDER_DELIVERY_INTERVAL_UPDATE, ORDER_STATUS_UPDATE, RETURN_CANCELLATION

操作的信息。

Example

{
  "id": "example",
  "type": "ORDER_RECIPIENT_UPDATE"
}

status

Type: string

订单状况:

PLACING — 它正在处理，准备预订。
RESERVED — 预订，但预订不足。
UNPAID — 已发出，但尚未付款（如果在结账时选择付款）。
PROCESSING — 它正在处理中。
DELIVERY — 转移到送货服务。
PICKUP — 送到取件点。
DELIVERED — 由买方接收。
CANCELLED — 取消。
PENDING — 等待卖方处理。
PARTIALLY_RETURNED — 部分退款。
RETURNED — 全额回来了。
UNKNOWN — 状态不明。

也可以返回其他值。您不需要处理它们。

Enum: PLACING, RESERVED, UNPAID, PROCESSING, DELIVERY, PICKUP, DELIVERED, CANCELLED, PENDING, PARTIALLY_RETURNED, RETURNED, UNKNOWN

substatus

Type: string

订单处理阶段（状态 PROCESSING）或取消订单的原因（状态 CANCELLED).

状态中的订单值 PROCESSING:
- STARTED — 订单已确认，可以处理。
- READY_TO_SHIP — 订单已组装并准备装运。
状态中的订单值 CANCELLED:
- RESERVATION_EXPIRED — 客户没有在10分钟内完成预订订单。
- USER_NOT_PAID — 买方没有支付订单（对于付款类型 PREPAID）30分钟。
- USER_UNREACHABLE — 无法联系买家。为此取消，必须满足以下条件:
  - 至少3个电话从8到21在买方的时区;
  - 第一次和第三次通话之间的休息时间至少为90分钟;
  - 连接不短于5秒。
  如果不满足其中至少一个条件（号码不可用时除外），您将无法取消订单。将返回带有错误代码400的响应。
- USER_CHANGED_MIND — 客户因个人原因取消了订单。
- USER_REFUSED_DELIVERY — 买方对交货条件不满意.
- USER_REFUSED_PRODUCT — 该产品不适合买方。
- SHOP_FAILED — 商店无法完成订单。
- USER_REFUSED_QUALITY — 买方对产品的质量不满意。
- REPLACING_ORDER — 买方决定主动更换另一种产品。
- PROCESSING_EXPIRED — 值不再使用。
- PICKUP_EXPIRED — 取货点的订单保质期已过期。
- TOO_MANY_DELIVERY_DATE_CHANGES — 订单被推迟了太多次。
- TOO_LONG_DELIVERY — 订单太长时间无法交付。
- INCORRECT_PERSONAL_DATA — 对于来自国外的订单，收件人的信息不正确，订单将不会在海关检查。
TECHNICAL_ERROR — 市场方面的技术错误。联系支持。

也可以返回其他值。您不需要处理它们。

updateStatus

Type: string

订单状态是否已更改:

OK — 状态已更改。
ERROR — 状态未更改。在这种情况下，参数中会出现错误消息 errorDetails.

Enum: OK, ERROR

更新订单的列表。

Example

[
  {
    "id": 0,
    "status": "PLACING",
    "substatus": "RESERVATION_EXPIRED",
    "updateStatus": "OK",
    "errorDetails": "example",
    "operation": {
      "id": "example",
      "type": "ORDER_RECIPIENT_UPDATE"
    }
  }
]

状态已更新的订单列表。

Example

{
  "orders": [
    {
      "id": 0,
      "status": "PLACING",
      "substatus": "RESERVATION_EXPIRED",
      "updateStatus": "OK",
      "errorDetails": "example",
      "operation": {
        "id": "example",
        "type": "ORDER_RECIPIENT_UPDATE"
      }
    }
  ]
}

Example

{
  "result": {
    "orders": [
      {
        "id": 0,
        "status": "PLACING",
        "substatus": "RESERVATION_EXPIRED",
        "updateStatus": "OK",
        "errorDetails": "example",
        "operation": {
          "id": "example",
          "type": "ORDER_RECIPIENT_UPDATE"
        }
      }
    ]
  }
}

400 Bad Request

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

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

401 Unauthorized

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

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

403 Forbidden

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

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

404 Not Found

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

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

420 Method Failure

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

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

500 Internal Server Error

Yandex中的内部错误。市场。有关错误的更多信息

Body

application/json

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

Type: object

All of 1 type

Type: object

All of 2 types

Type: object
status
Type: string

响应的类型。可能的值:

OK — 没有错误。

ERROR — 处理请求时出错。

Enum: OK, ERROR
服务器响应的标准包装器。
Example
```
{
  "status": "OK"
}
```

Type: object

errors

Type: object[]

code

Type: string

的错误代码。

Example: example

message

Type: string

错误的描述。

Example: example

错误列表。

Min items: 1

Example

[
  {
    "code": "example",
    "message": "example"
  }
]

Example

{
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

服务器错误的标准包装器。

Example

{
  "status": "OK",
  "errors": [
    {
      "code": "example",
      "message": "example"
    }
  ]
}

这篇文章是否有用？

更改订单的状态

标记代码的传输