API支持的买家用户地区：韩国、台湾
查看特定订单的配送状态历史记录。
路径
GET
/v2/providers/openapi/apis/api/v5/vendors/{vendorId}/ordersheets/{shipmentBoxId}/history
示例
请求参数
|
名称 |
必须 |
数据类型 |
描述 |
|
vendorId |
O |
String |
卖家ID 酷澎分配给卖家的固有代码 e.g. A00012345 |
|
shipmentBoxId |
O |
Number |
合并配送号码 通过“订单列表查看API”确认 |
请求体
无
返回消息
|
名称 |
数据类型 |
描述 |
|||||
|
code |
Number |
服务器响应代码 |
|||||
|
message |
String |
服务器响应信息 |
|||||
|
data |
Array |
结算完成列表 |
|||||
|
|
shipmentBoxId |
Number |
捆绑配送号码 |
||||
|
|
details |
Array |
详细历史记录 |
||||
|
|
|
deliveryStatus |
String |
配送状态 |
|||
|
|
参数名 |
状态 |
|
||||
|
ACCEPT |
结算完成 |
||||||
|
INSTRUCT |
商品准备中 |
||||||
|
DEPARTURE |
待配送 |
||||||
|
DELIVERING |
配送中 |
||||||
|
FINAL_DELIVERY |
配送完成 |
||||||
|
NONE_TRACKING |
卖家直接配送（未使用配送对接），无法追踪 |
||||||
|
|
|
deliveryStatusDesc |
String |
配送状态说明 |
|||
|
|
|
updatedAt |
String |
变更时间 (符合ISO-8601標準) 格式： YYYY-MM-DDThh:mm:ss.ssssss±hh:mm |
|||
返回消息示例
{
"shipmentBoxId": 123456789012345678,
"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"
}
]
}
错误代码
|
HTTP Status code (error type) |
Error message |
Solution |
|
400 (check request variable) |
无效卖家ID |
查看输入的卖家ID (vendorId)值是否正确。 |
|
500 (check request variable) |
内部异常 |
查看输入的捆绑配送号码(shipmentBoxId)是否正确。 |
接口名称
GET_ORDERSHEET_HISTORY