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 15:41
最后编辑:关冲  更新时间:2025-11-14 17:06