更改多个订单的状态
如果您使用API-Key令牌,调用该方法时需要具备列表中可用权限之一
- inventory-and-order-processing — 订单处理和商品核算
- all-methods — 全面管理账户
更改多个订单的状态。
可能的状态更改:
- 如果商店已确认并准备装运订单,则订单从状态
"状态":"处理中"
和处理阶段"substatus":"开始"
它需要转换为状态"状态":"处理中"
和处理阶段"substatus":"READY_TO_SHIP"
. - 如果商店已确认订单,但无法发货(例如,产品已在数据库中列出,但没有库存或没有所需的颜色),则订单状态为
"状态":"处理中"
和处理阶段"substatus":"开始"
它需要转换为状态"状态":"已取消"
与取消订单的原因"substatus":"SHOP_FAILED"
. - 如果商店已准备装运订单,但无法完成订单(例如,最后一件商品已损坏或有缺陷),则订单状态为
"状态":"处理中"
和处理阶段"substatus":"READY_TO_SHIP"
它需要转换为状态"状态":"已取消"
与取消订单的原因"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。 您可以使用查询找到它 :no-translate[GET v2/campaigns] 或者在市场上的卖家办公室找到它-点击您的企业名称并转到页面:
,不要发送商店的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
Yandex的内部错误。 市场。 有关错误的更多信息
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.