更改多个订单的状态
如果您使用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<int64> 活动ID。 您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到 — 点击您的帐户图标→ 设置 在左边的菜单中,选择 Api和模块:
⚠️ 不要发送商店ID,这是在市场上的卖家帐户旁边的商店名称和一些报告。
Min value: |
Body
application/json
{
"orders": [
{
"id": 0,
"status": "PLACING",
"substatus": "RESERVATION_EXPIRED"
}
]
}
|
Name |
Description |
|
orders* |
Type: OrderStateDTO[] 订单列表。 Min items: Max items: |
OrderStateDTO
订单信息。
|
Name |
Description |
|
id* |
Type: integer<int64> 的订单ID。 |
|
status* |
Type: OrderStatusType 订单状况:
也可以返回其他值。 您不需要处理它们。 Enum: |
|
substatus |
Type: OrderSubstatusType 订单处理的阶段(如果它具有状态
也可以返回其他值。 您不需要处理它们。 Enum: |
OrderStatusType
订单状况:
-
PLACING— 它正在处理,准备预订。 -
RESERVED— 预订,但预订不足。 -
UNPAID— 已发出,但尚未付款(如果在结账时选择付款)。 -
PROCESSING— 它正在处理中。 -
DELIVERY— 转移到送货服务。 -
PICKUP— 送到取件点。 -
DELIVERED— 由买方接收。 -
CANCELLED— 取消。 -
PENDING— 等待卖方处理。 -
PARTIALLY_RETURNED— 部分退款。 -
RETURNED— 全额回来了。 -
UNKNOWN— 状态不明。
也可以返回其他值。 您不需要处理它们。
|
Type |
Description |
|
Enum: |
OrderSubstatusType
订单处理的阶段(如果它具有状态 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— 订单在PVZ中的存储期已过期。 -
TOO_MANY_DELIVERY_DATE_CHANGES— 订单被推迟了太多次。 -
TOO_LONG_DELIVERY— 订单太长时间无法交付。 -
INCORRECT_PERSONAL_DATA— 对于来自国外的订单,收件人的信息不正确,订单将不会在海关检查。
-
-
TECHNICAL_ERROR— 市场方面的技术错误。 联系支持。
也可以返回其他值。 您不需要处理它们。
|
Type |
Description |
|
Enum: |
Responses
200 OK
返回有关更新的订单状态的信息。
Body
application/json
{
"status": "OK",
"result": {
"orders": [
{
"id": 0,
"status": "PLACING",
"substatus": "RESERVATION_EXPIRED",
"updateStatus": "OK",
"errorDetails": "string"
}
]
}
}
|
Name |
Description |
|
status* |
Type: ApiResponseStatusType 响应的类型。 可能的值:
Enum: |
|
result |
Type: UpdateOrderStatusesDTO 状态已更新的订单列表。 |
ApiResponseStatusType
响应的类型。 可能的值:
OK— 没有错误。ERROR— 处理请求时出错。
|
Type |
Description |
|
Enum: |
UpdateOrderStatusesDTO
状态已更新的订单列表。
|
Name |
Description |
|
orders* |
Type: UpdateOrderStatusDTO[] 更新订单的列表。 |
UpdateOrderStatusDTO
订单列表。
|
Name |
Description |
|
errorDetails |
Type: string 更改订单状态时出错。 它包含错误的描述和订单ID。 如果参数返回 |
|
id |
Type: integer<int64> 的订单ID。 |
|
status |
Type: OrderStatusType 订单状况:
也可以返回其他值。 您不需要处理它们。 Enum: |
|
substatus |
Type: OrderSubstatusType 订单处理的阶段(如果它具有状态
也可以返回其他值。 您不需要处理它们。 Enum: |
|
updateStatus |
Type: OrderUpdateStatusType Статус обновления. Enum: |
OrderUpdateStatusType
订单状态是否已更改:
-
OK— 状态已更改。 -
ERROR— 状态未更改。 在这种情况下,参数中会出现错误消息errorDetails.
|
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: |
500 Internal Server Error
市场的内部错误。 有关错误的更多信息
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.