Tracks Query
Brief
referenceNo is mandatory
URL
/v1/order/tracks/{referenceNo}
Method
get
Sample of sussess return
{
“msg”: “操作成功”,
“code”: 200,
“data”: {
“id”: 23,
“serviceProvider”: “Track718”,
“trackNum”: “0012312312”,
“innerNum”: “FO2406030071-XXXX”,
“code”: “XOD”,
“result”: “40”,
“resultView”: “签收成功”,
“subResult”: “40”,
“subResultView”: “签收成功”,
“shipType”: “1”,
“shipTypeView”: “小包”,
“country”: “DE”,
“originCountry”: “DE”,
“estimatedDelivery”: “”,
“logisTimeZone”: “+01:00”,
“logisWebsite”: “”,
“logisTel”: “”,
“logisEmail”: “”,
“logisName”: “XOD”,
“residenceTime”: “7”,
“haulageTime”: “2”,
“onlineDate”: “2024-06-03T14:37:00.000+08:00”,
“onlineStatus”: “The shipment has been processed in the parcel center of origin”,
“onlineAddress”: “”,
“onlineResult”: “11”,
“onlineResultView”: “签收成功”,
“onlineResultDate”: “2024-06-03 16:37:00”,
“signDate”: “2024-06-06T12:02:00.000+08:00”,
“signStatus”: “The shipment has been successfully delivered”,
“signAddress”: “”,
“signResult”: “40”,
“signResultView”: “签收成功”,
“signResultDate”: “2024-06-06 14:02:00”,
“latestDate”: “2024-06-06T12:02:00.000+08:00”,
“latestStatus”: “The shipment has been successfully delivered”,
“latestAddress”: “”,
“latestResult”: “40”,
“latestResultView”: “签收成功”,
“latestResultDate”: “2024-06-06 14:02:00”,
“trackDetails”: [
{
“id”: 85,
“orderTrackId”: 23,
“type”: 0,
“date”: “2024-06-06T12:02:00.000+08:00”,
“status”: “The shipment has been successfully delivered”,
“address”: “”,
“result”: 40,
“resultView”: “签收成功”,
“subResult”: 40,
“subResultView”: “签收成功”,
“resultDate”: “2024-06-06T12:02:00.000+08:00”,
“country”: “”,
“state”: “”,
“city”: “”,
“street”: “”,
“zipCode”: “”,
“timeZone”: “+02:00”,
“coordinatesLongitude”: “”,
“coordinatesLatitude”: “”
},
{
“id”: 86,
“orderTrackId”: 23,
“type”: 0,
“date”: “2024-06-06T05:21:00.000+08:00”,
“status”: “The shipment has been loaded onto the delivery vehicle”,
“address”: “”,
“result”: 8,
“resultView”: “运输途中”,
“subResult”: 8,
“subResultView”: “运输途中”,
“resultDate”: “2024-06-04T09:28:00.000+08:00”,
“country”: “”,
“state”: “”,
“city”: “”,
“street”: “”,
“zipCode”: “”,
“timeZone”: “+02:00”,
“coordinatesLongitude”: “”,
“coordinatesLatitude”: “”
},
{
“id”: 87,
“orderTrackId”: 23,
“type”: 0,
“date”: “2024-06-04T09:28:00.000+08:00”,
“status”: “The shipment arrived in the region of recipient and will be transported to the delivery base in the next step.”,
“address”: “”,
“result”: 8,
“resultView”: “运输途中”,
“subResult”: 8,
“subResultView”: “运输途中”,
“resultDate”: “2024-06-04T09:28:00.000+08:00”,
“country”: “”,
“state”: “”,
“city”: “”,
“street”: “”,
“zipCode”: “”,
“timeZone”: “+02:00”,
“coordinatesLongitude”: “”,
“coordinatesLatitude”: “”
},
{
“id”: 88,
“orderTrackId”: 23,
“type”: 0,
“date”: “2024-06-03T17:28:00.000+08:00”,
“status”: “The instruction data for this shipment have been provided by the sender to DHL electronically”,
“address”: “”,
“result”: 8,
“resultView”: “运输途中”,
“subResult”: 8,
“subResultView”: “运输途中”,
“resultDate”: “2024-06-03T17:28:00.000+08:00”,
“country”: “”,
“state”: “”,
“city”: “”,
“street”: “”,
“zipCode”: “”,
“timeZone”: “+02:00”,
“coordinatesLongitude”: “”,
“coordinatesLatitude”: “”
},
{
“id”: 89,
“orderTrackId”: 23,
“type”: 0,
“date”: “2024-06-03T14:37:00.000+08:00”,
“status”: “The shipment has been processed in the parcel center of origin”,
“address”: “”,
“result”: 11,
“resultView”: “已上网”,
“subResult”: 11,
“subResultView”: “已上网”,
“resultDate”: “2024-06-03T14:37:00.000+08:00”,
“country”: “”,
“state”: “”,
“city”: “”,
“street”: “”,
“zipCode”: “”,
“timeZone”: “+02:00”,
“coordinatesLongitude”: “”,
“coordinatesLatitude”: “”
}
]
}
}
Instructions of sample of success return
| Parameter Name | Type | Instructions |
|---|---|---|
| serviceProvider | string | service provider |
| msg | string | Message |
| code | string | code |
| data | string | tracks data |
| id | string | tracks id |
| trackNum | string | track number |
| innerNum | string | inner number |
| result | string | logistics status |
| resultView | string | logistics status view |
| subResult | string | status |
| subResultView | string | substatus view |
| shipType | string | service provider type: 1.parcel,2.sea,3.air |
| shipTypeView | string | service provider type view: 1.parcel,2.sea,3.air |
| country | string | distance country |
| originCountry | string | origin country |
| estimatedDelivery | string | estimated delivery |
| logisTimeZone | string | logistics time zone |
| logisWebsite | string | logistics website |
| logisTel | string | logistics tel |
| logisEmail | string | logistics email |
| logisName | string | logistics name |
| residenceTime | string | residence time |
| haulageTime | string | haulage time |
| onlineDate | string | online date |
| onlineStatus | string | online status |
| onlineAddress | string | online address |
| onlineResult | string | online result |
| onlineResultView | string | online result view |
| onlineResultDate | string | online result date |
| signDate | string | sign date |
| signStatus | string | sign Status |
| signAddress | string | sign Address |
| signResult | string | sign Result |
| signResultView | string | sign ResultView |
| signResultDate | string | sign ResultDate |
| latestDate | string | latest Date |
| latestStatus | string | latest Status |
| latestAddress | string | latest Address |
| latestResult | string | latest Result |
| latestResultView | string | latest Result View |
| latestResultDate | string | latest Result Date |
| trackDetails | array | trackDetails |
| trackDetails.id | string | trackDetails.id |
| trackDetails.orderTrackId | string | trackDetails.orderTrackId |
| trackDetails.type | string | trackDetails.type |
| trackDetails.date | string | trackDetails.date |
| trackDetails.status | string | trackDetails.status |
| trackDetails.address | string | trackDetails.address |
| trackDetails.result | string | trackDetails.result |
| trackDetails.resultView | string | trackDetails.resultView |
| trackDetails.subResult | string | trackDetails.subResult |
| trackDetails.subResultView | string | trackDetails.subResultView |
| trackDetails.resultDate | string | trackDetails.resultDate |
| trackDetails.country | string | trackDetails.country |
| trackDetails.state | string | trackDetails.state |
| trackDetails.city | string | trackDetails.city |
| trackDetails.street | string | trackDetails.street |
| trackDetails.zipCode | string | trackDetails.zipCode |
| trackDetails.timeZone | string | trackDetails.timeZone |
| trackDetails.coordinatesLongitude | string | trackDetails.coordinatesLongitude |
| trackDetails.coordinatesLatitude | string | trackDetails.coordinatesLatitude |
Sample of failure return
{
“errcode”: “00000”,
“msg”: “服务名未配置:API_SERVICE_NAME”,
“code”: 500
}
Instructions of sample of failure return
| Parameter Name | Type | Instructions |
|---|---|---|
| errcode | string | error code |
| msg | string | message |
最后编辑:关冲 更新时间:2025-11-14 17:06