/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/ordersheets/acknowledgement2609170000订单状态更改为准备中
简介
订单状态更改为准备中
详细内容
API支持的买家用户地区：韩国、台湾
将订单状态从“付款完成”更改为“商品准备中”。如果在请求状态更改的订单中有取消的商品，则返回部分错误（Partial Error）。
※如果订单中包含正在通过取消全部或部分付款而进行的退款的商品时，则该订单将返回“无法更改配送状态，请查看订单历史记录。”的消息。
退款完成时，包含其它未申请取消商品的订单可以更改为“商品准备中”。
仅适用于付款完成阶段的合并配送号码（shippingBoxIds）。
如果合并配送号码（shippingBoxIds）列表数据很多，可能会出现超时错误，因此请求须少于50件，或仅请求单件。
<注意！> 因为顾客可能在付款完成时更改收货地址，因此一定要在“商品准备中“状态之后，通过单件查询订单来确认收货地址信息是否发生变化，若有变化，须进行相应更新。
路径
示例端点
https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/ordersheets/acknowledgementPath 参数
| Name | Type | Description |
|---|---|---|
| vendorId* | string | 卖家ID 酷澎分配给卖家的固有代码 e.g. A00012345 |
请求体参数
请求参数
请求体参数
| Name | Type | Description |
|---|---|---|
| vendorId* | string | 卖家ID 酷澎分配给卖家的固有代码 e.g. A00012345 |
| shipmentBoxIds* | object[] | 要更改为“商品准备中”状态的捆绑配送号码列表 最多请求50 件 |
| code | string | 服务器响应代码
|
| message | string | 服务器响应信息
|
| data | string | Ordersheet状态变更api调用结果对象
|
| responseKey data.responseKey | string | Request的区分值 系统元数据 |
| responseCode data.responseCode | string | request所有结果值的
|
| responseMessage data.responseMessage | string | request所有结果值的状态信息
|
| responseList data.responseList | string | 单件的结果组
|
| shipmentBoxId data.responseList.shipmentBoxId | string | 捆绑配送号码
|
| succeed data.responseList.succeed | string | 成功与否
|
| resultCode data.responseList.resultCode | string | 结果代码
|
| resultMessage data.responseList.resultMessage | string | 结果信息
|
| retryRequired data.responseList.retryRequired | string | 是否可以Retry
|
| 200 (check request variable) | string | 查看显示的捆绑配送号码（shipmentBoxIds）是否为商品准备中或待配送状态的订单。
|
| 500 (sever error) | string | 由于内部系统负载增加而导致的临时错误。稍后请重试。
|
| 504 (sever error) | string | 由于内部系统负载增加而导致的临时错误。通过单笔订单查询API查看订单状态是否已经转为商品准备中，如果没有变更，请稍后重试。
|
| 521 (sever error) | string | 由于内部系统负载增加而导致的临时错误。通过单笔订单查询API查看订单状态是否已经转为商品准备中，如果没有变更，请稍后重试。
|
{
"vendorId": "A00012345",
"shipmentBoxIds": [
123456789012345680,
123456789012345680
]
}响应体
响应消息
| Name | Type | Description |
|---|---|---|
| code | string | 服务器响应代码
|
| message | string | 服务器响应信息
|
| data | object | Ordersheet状态变更api调用结果对象
|
| responseKey data.responseKey | integer | Request的区分值 系统元数据 |
| responseCode data.responseCode | integer | request所有结果值的
|
| responseMessage data.responseMessage | string | request所有结果值的状态信息
|
| responseList data.responseList | object[] | 单件的结果组
|
| shipmentBoxId data.responseList[].shipmentBoxId | integer | 捆绑配送号码
|
| succeed data.responseList[].succeed | boolean | 成功与否
|
| resultCode data.responseList[].resultCode | string | 结果代码
|
| retryRequired data.responseList[].retryRequired | boolean | 是否可以Retry
|
| resultMessage data.responseList[].resultMessage | string | 结果信息
|
Response Example
{
"code": "200",
"message": "OK",
"data": {
"responseKey": -7326489997410940000,
"responseCode": 1,
"responseMessage": "apply instructStatus result - Partial errors.",
"responseList": [
{
"shipmentBoxId": 123456789012345680,
"succeed": true,
"resultCode": "OK",
"retryRequired": false,
"resultMessage": "request succeeded."
},
{
"shipmentBoxId": 123456789012345680,
"succeed": false,
"resultCode": "NOT_FOUND_SHIPMENT_BOX",
"retryRequired": true,
"resultMessage": "shipmentBoxId (123456789012345679) is not found."
}
]
}
}错误码
| HTTP | 代码 | 消息 |
|---|---|---|
| 400 | HTTP_400 | Bad Request |
错误说明
| HTTP | 类型 | 错误消息 | 解决方案 |
|---|---|---|---|
| 500 | 500 (sever error) | "code":500, "message" : "com.coupang.apigateway.pylon.ApiPreconditionException: Timeout waiting for connection from pool" | 由于内部系统负载增加而导致的临时错误。稍后请重试。 |
| 504 | 504 (sever error) | "code" : "ERROR", "message" : "请求超时，如果情况继续考虑使用超时扩展." | 由于内部系统负载增加而导致的临时错误。通过单笔订单查询API查看订单状态是否已经转为商品准备中，如果没有变更，请稍后重试。 |
| 521 | 521 (sever error) | "code" : "ERROR", "message" : "connection timed out: aws-openapi.coupang.net/10.211.51.172:80" | 由于内部系统负载增加而导致的临时错误。通过单笔订单查询API查看订单状态是否已经转为商品准备中，如果没有变更，请稍后重试。 |