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