更改多个订单的状态

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<int64>

活动ID。

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

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

⚠️ 不要发送商店ID，这是在市场上的卖家帐户旁边的商店名称和一些报告。

Min value: 1

Body

application/json

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

Name

Description

orders*

Type: object[]

订单列表。
订单信息。

Min items: 1

Max items: 30

Responses

200 OK

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

Body

application/json

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

Name

Description

status*

Type: string

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

result

Type: object

orders*

Type: object[]

更新订单的列表。
订单列表。

状态已更新的订单列表。

400 Bad Request

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

Body

application/json

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

Name

Description

errors

Type: object[]

错误列表。
一般错误格式。

Min items: 1

status

Type: string

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

401 Unauthorized

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

Body

application/json

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

Name

Description

errors

Type: object[]

错误列表。
一般错误格式。

Min items: 1

status

Type: string

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

403 Forbidden

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

Body

application/json

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

Name

Description

errors

Type: object[]

错误列表。
一般错误格式。

Min items: 1

status

Type: string

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

404 Not Found

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

Body

application/json

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

Name

Description

errors

Type: object[]

错误列表。
一般错误格式。

Min items: 1

status

Type: string

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

420 Method Failure

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

Body

application/json

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

Name

Description

errors

Type: object[]

错误列表。
一般错误格式。

Min items: 1

status

Type: string

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

500 Internal Server Error

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

Body

application/json

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

Name

Description

errors

Type: object[]

错误列表。
一般错误格式。

Min items: 1

status

Type: string

响应的类型。可能的值:

OK — 没有错误。
ERROR — 处理请求时出错。

Enum: OK, ERROR

这篇文章是否有用？

更改订单的状态

标记代码的传输