Coupang Developer Center

API 適用的买方用户區域：韓國、台灣

將訂單狀態從「付款完成」變更為「商品準備中」。如果在請求狀態變更的訂單中有取消的商品，則傳回部分錯誤（Partial Error）。

※如果訂單中包含正在透過取消全部或部分付款而進行的退款的商品時，則該訂單將返回「無法更改配送狀態，請查看訂單歷史記錄。」的訊息。

退款完成時，包含其它未申請取消商品的訂單可以更改為「商品準備中」。

僅適用於付款完成階段的合併配送號碼（shippingBoxIds）。

如果合併配送號碼（shippingBoxIds）清單資料很多，可能會出現逾時錯誤，因此請求須少於50件，或僅要求單件。

<注意！ > 因為顧客可能在付款完成時更改收貨地址，因此一定要在「商品準備中「狀態之後，透過單件查詢訂單來確認收貨地址資訊是否發生變化，若有變化，須進行相應更新。

路徑

PATCH PUT

/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/ordersheets/acknowledgement

範例

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v4/vendors/A00012345/ordersheets/acknowledgement

請求參數

名稱

必須

資料型別

描述

vendorId

String

賣家ID 酷澎分配給賣家的固有代碼

e.g. A00123ABC

請求體參數

名稱

必須

資料型別

描述

vendorId

String

賣家ID 酷澎分配給賣家的固有代碼

e.g. A00123ABC

shipmentBoxIds

Array

若要變更為「商品準備中」狀態的捆綁配送號碼列表

最多請求50 件

請求體範例

{
  "vendorId": "A00123ABC",
  "shipmentBoxIds": [
    123456789012345678,
    123456789012345679
  ]
}

返回訊息

名稱

資料型別

描述

code

Number

伺服器回應代碼

message

String

伺服器回應資訊

data

OrderSheetResponse

Ordersheet狀態變更api呼叫結果物件

responseKey

Number

Request的區分值

系統元數據

responseCode

Number

request所有結果值的狀態碼

代碼	資訊
-1	None
0	All succeeded.
1	Partial errors.
99	All Failed.

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, 1240026, 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

訂單狀態變更為準備中

簡介

詳細內容

路徑

範例