商品 API 品類 API 品牌 API 運輸 / 訂單 API 退貨 API 換貨 API 促銷 / 優惠券物流資訊客服 / 諮詢結算 CGF / CGF lite Rocket Growth

運輸 / 訂單 API

GET/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/ordersheets/{shipmentBoxId}/history2609170000

檢視訂單配送狀態歷史記錄

KRTW

# 01

簡介

檢視訂單配送狀態歷史記錄

# 02

詳細內容

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

檢視特定訂單的配送狀態歷史記錄。

路徑

GET/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/ordersheets/{shipmentBoxId}/history

範例端點

https://api-gateway.coupang.com/v2/providers/openapi/apis/api/v5/vendors/A00012345/ordersheets/{shipmentBoxId}/history

# 03

Path 參數

Name	Type	Description
vendorId*	string	vendorId
shipmentBoxId*	string	shipmentBoxId

# 04

回應內容

回應訊息

Name	Type	Description
code	number	伺服器響應程式碼
message	string	伺服器響應資訊
data	object[]	結算完成陣列
shipmentBoxId data[].shipmentBoxId	number	捆綁配送號碼
details data[].details	object[]	詳細歷史記錄
deliveryStatus data[].details[].deliveryStatus	string	配送狀態
引數名 data[].引數名	string
ACCEPT	string	結算完成
INSTRUCT	string	商品準備中
DEPARTURE	string	待配送
DELIVERING	string	待配送
FINAL_DELIVERY	string	結算完成
NONE_TRACKING	string	賣家直接配送（請使用配送對接），無法追蹤
NONE_TRACKING.	object
deliveryStatusDesc NONE_TRACKING..deliveryStatusDesc	string	配送狀態說明
updatedAt NONE_TRACKING..updatedAt	string	變更時間 (符合ISO-8601標準) 格式： YYYY-MM-DDThh:mm:ss.ssssss±hh:mm

Response Example

{
  "shipmentBoxId": 123456789012345680,
  "data": [
    {
      "deliveryStatus": "FINAL_DELIVERY",
      "deliveryStatusDesc": "배송완료",
      "updatedAt": "2025-01-15T14:17:13.973885-08:00"
    },
    {
      "deliveryStatus": "DELIVERING",
      "deliveryStatusDesc": "배송중",
      "updatedAt": "2025-01-15T14:17:13.973885-08:00"
    },
    {
      "deliveryStatus": "DEPARTURE",
      "deliveryStatusDesc": "배송지시",
      "updatedAt": "2025-01-15T14:17:13.973885-08:00"
    },
    {
      "deliveryStatus": "INSTRUCT",
      "deliveryStatusDesc": "상품준비중",
      "updatedAt": "2025-01-15T14:17:13.973885-08:00"
    },
    {
      "deliveryStatus": "ACCEPT",
      "deliveryStatusDesc": "결제완료",
      "updatedAt": "2025-01-15T14:17:13.973885-08:00"
    }
  ]
}

# 05

錯誤碼

HTTP	代碼	訊息
400	HTTP_400	Bad Request

錯誤說明

HTTP	類型	錯誤訊息	解決方案
400	400 (check request variable)	無效賣家ID	檢視輸入的賣家ID (vendorId)值是否正確。
500	500 (check request variable)	內部異常	檢視輸入的捆綁配送號碼(shipmentBoxId)是否正確。