查看特定订单的配送状态历史记录。
路径
GET
/v2/providers/openapi/apis/api/v4/vendors/{vendorId}/ordersheets/{shipmentBoxId}/history
示例
请求参数
|
名称 |
必须 |
数据类型 |
描述 |
|
vendorId |
O |
String |
卖家ID 酷澎分配给卖家的固有代码 e.g. A00012345 |
|
shipmentBoxId |
O |
Number |
合并配送号码 通过“订单列表查看API”确认 |
请求体
无
返回消息
|
名称 |
数据类型 |
描述 |
|||||
|
code |
Number |
服务器响应代码 |
|||||
|
message |
String |
服务器响应信息 |
|||||
|
data |
Array |
结算完成列表 |
|||||
|
j |
shipmentBoxId |
Number |
捆绑配送号码 |
||||
|
|
details |
Array |
详细历史记录 |
||||
|
|
|
deliveryStatus |
String |
配送状态 |
|||
|
|
参数名 |
状态 |
|
||||
|
ACCEPT |
结算完成 |
||||||
|
INSTRUCT |
商品准备中 |
||||||
|
DEPARTURE |
待配送 |
||||||
|
DELIVERING |
配送中 |
||||||
|
FINAL_DELIVERY |
配送完成 |
||||||
|
NONE_TRACKING |
卖家直接配送（未使用配送对接），无法追踪 |
||||||
|
|
|
deliveryStatusDesc |
String |
配送状态说明 |
|||
|
|
|
updatedAt |
String |
变更时间 yyyy-MM-dd'T'hh:mm:ss |
|||
返回消息示例
{
"shipmentBoxId": 396844285,
"details": [
{
"deliveryStatus": "FINAL_DELIVERY",
"deliveryStatusDesc": "배송완료",
"updatedAt": "2017-06-08T14:03:06"
},
{
"deliveryStatus": "DELIVERING",
"deliveryStatusDesc": "배송중",
"updatedAt": "2017-06-07T10:12:56"
},
{
"deliveryStatus": "DEPARTURE",
"deliveryStatusDesc": "배송지시",
"updatedAt": "2017-06-07T09:52:30"
},
{
"deliveryStatus": "INSTRUCT",
"deliveryStatusDesc": "상품준비중",
"updatedAt": "2017-06-02T16:17:04"
},
{
"deliveryStatus": "ACCEPT",
"deliveryStatusDesc": "결제완료",
"updatedAt": "2017-06-02T15:36:31"
}
]
}错误代码
|
HTTP Status code (error type) |
Error message |
Solution |
|
400 (check request variable) |
无效卖家ID |
查看输入的卖家ID (vendorId)值是否正确。 |
|
500 (check request variable) |
内部异常 |
查看输入的捆绑配送号码(shipmentBoxId)是否正确。 |
接口名称
GET_ORDERSHEET_HISTORY