订单轨迹查询
接口描述
通过订单号查询对应的跟踪信息。通过创建时间查询范围内对应的所有订单数据。
| HTTP Verb | URL |
|---|---|
| POST | /api/supplier-service/v1/b2b/ |
| OrderList |
Example:
| 代码块 |
|---|
POST /api/supplier-service/v1/b2b/OrderTrack OrderList HTTP/1.1 Host: http://cfs-qa.etowertech.com/ Content-Type: application/json Accept: application/json Authorization:WallTech etotest8xkIIphLnbkjRACNj4P:pc9H97D-_b2_TSCVvNj81A X-WallTech-Date:Tue, 02 Aug 2022 06:43:37 GMT |
请求样例
使用JSON列表格式拼接订单号数据进行查询，最多支持单次查询30个订单。
样例:
| 代码块 |
|---|
["JDQ002445001000931503"] |
返回内容
...
| 代码块 |
|---|
{
"status "startTime": "Success"2024-03-01 00:00:00",
"data": {
"event": [
{
"eventdetail": [
{
"activity": "到达目的港",
"city": "",
"code": "2080",
"country": "US",
"eventTime": "2024-03-25 12 "endTime":"2024-04-01 00:00:00",
"shippedDateStart":"2024-03-01 00:00:00",
"shippedDateEnd":"2024-04-01 00:00:00",
"statusList": [133, 155]
"pageNum":1
} |
请求字段描述
字段名 | 必填性 | 类型 | 描述 |
startTime | M | dataTime | 订单创建起始时间 |
endTime | O | dataTime | 订单创建结束时间 |
pageNum | M | int | 查询的页数，从1开始，每页固定100条数据 |
| shippedDateStart | O | dataTime | 出库起始时间 |
| shippedDateEnd | O | dataTime | 出库结束时间 |
| statusList | O | List<Integer> | 订单状态 0 已创建 |
返回内容
成功样例
| 代码块 |
|---|
{ "orderNo"status": "ETO2403180023Success", "data": { "referenceNoOrder":{ "jw20240318110003", "remark"pageSize":100, "" } ], "orderNoOrReferenceNo": "ETO2403180023", "referenceNo": "ETO2403180023",pageNumber":1, "list": [ { "orderNo":"order13344389", "referenceNo":"ref13344389" "shipper": 12283 } ] } }, "totalPage":20 ] }, "errors": "", "message": "", "messageId": "", "success": true, "warnList": "" } |
失败样例
| 代码块 |
|---|
{
"status": "Failed",
"errors": [
{
"code": 100009100010,
"message": "OrderField 13344389startTime notis foundnecessary"
}
],
"data": [
{
"status": "Failure",
"errors": [
{
"code": 100009,
"message": "Order 13344389 not found"
}
],
"orderId": "13344389",
"trackingNo": null
}
]
} |
字段描述
字段名 | 类型 | 最大长度 | 描述 |
event.eventdetail
事件详情
event.eventdetail.activity
varchar
事件名称
event.eventdetail.city
varchar
事件发生城市
event.eventdetail.code
varchar
事件代码
event.eventdetail.country
varchar
事件发生国家
event.eventdetail.eventTime
datetime
事件时间，精确到分
event.eventdetail.orderNo
varchar
订单号
event.eventdetail.referenceNo
varchar
订单参考号
event.eventdetail.remark
varchar
status | varchar | 20 | 接口调用状态 |
data | 返回信息 | ||
data.order | 订单信息 | ||
data.order.pageSize | int | 每页容量 | |
data.order.pageNum | int | 页码 | |
data.order.list | 订单列表 | ||
data.order.list.orderNo | varchar | 128 | 订单号 |
data.order.list.referenceNo | varchar | 128 | 订单参考号 |
| data.totalPage | int | 总页数 | |
error | varchar | 256 | 报错信息 |
| message | varchar | 256 | 返回信息简述 |
| messageId | varchar | 32 | 返回信息ID |
| success | varchar | 20 | 接口调用是否成功 |
| warnList | varchar | 256 | 报警信息 |