API 適用的买方用户區域：韓國、台灣
將訂單狀態從「付款完成」變更為「商品準備中」。如果在請求狀態變更的訂單中有取消 的商品，則傳回部分錯誤（Partial Error）。
※如果訂單中包含正在透過取消全部或部分付款而進行的退款的商品時，則該訂單將返回「無法更改配送狀態，請查看訂單歷史記錄。」的訊息。
退款完成時，包含其它未申請取消商品的訂單可以更改為「商品準備中」。
僅適用於付款完成階段的合併配送號碼（shippingBoxIds）。
如果合併配送號碼（shippingBoxIds）清單資料很多，可能會出現逾時錯誤，因此請求須少於50件，或僅要求單件。
<注意！ > 因為顧客可能在付款完成時更改收貨地址，因此一定要在「商品準備中「狀態之後，透過單件查詢訂單來確認收貨地址資訊是否發生變化，若有變化，須進行相應更新。
路徑
PATCH PUT
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/ordersheets/acknowledgement
範例
請求參數
| 名稱 | 必須 | 資料型別 | 描述 |
| vendorId | O | String |
賣家ID 酷澎分配給賣家的固有代碼 e.g. A00123ABC |
請求體參數
| 名稱 | 必須 | 資料型別 | 描述 |
| vendorId | O | String |
賣家ID 酷澎分配給賣家的固有代碼 e.g. A00123ABC |
| shipmentBoxIds | O | Array |
若要變更為「商品準備中」狀態的捆綁配送號碼列表 最多請求50 件 |
請求體範例
{
"vendorId": "A00123ABC",
"shipmentBoxIds": [
123456789012345678,
123456789012345679
]
}返回訊息
| 名稱 | 資料型別 | 描述 | ||||||||||||
| 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": 123456789012345678,
"succeed": true,
"resultCode": "OK",
"retryRequired": false,
"resultMessage": "request succeeded."
},
{
"shipmentBoxId": 123456789012345679,
"succeed": false,
"resultCode": "NOT_FOUND_SHIPMENT_BOX",
"retryRequired": true,
"resultMessage": "shipmentBoxId (123456789012345679) 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