查询海运运单轨迹
# 接口地址
POST https://api.track123.com/gateway/open-api/tk/v1/ocean/track/query
# 接口描述
每批操作不超过100个单号。
# 请求参数
参数名称 | 参数说明 | 必须 | 数据类型 |
---|---|---|---|
orderNo | 唯一订单号(由track123生成的订单编号,从注册接口的响应参数获取) | true | string |
trackingNo | 查询单号 | true | string |
type | 单号类型(1.订舱号 2.提单号 3.箱号) | true | integer |
# 请求示例
[
{
"trackingNo": "MATS5217756000",
"type": 2,
"orderNo": "11111111"
},
{
"trackingNo": "MATS5217756002",
"type": 2,
"orderNo": "11111112"
}
]
# 响应参数
参数名称 | 参数说明 | 类型 |
---|---|---|
code | 业务状态码 | string |
msg | 业务状态码对应的描述信息或者其他辅助的描述信息 | string |
data | 返回体 | object |
accepted | 查询成功的单号 | array[object] |
id | 主键 | String |
trackingNo | 单号 | String |
type | 单号类型(1.订舱号 2.提单号 3.箱号) | number |
searchStatus | 查询状态 | String |
createTime | 创建时间 | string |
customerEmail | 用户邮箱 | string |
orderNo | 唯一订单号(由track123生成的订单编号,从注册接口的响应参数获取) | string |
carrierInfo | 承运人信息 | object |
carrierCode | 承运人对应的唯一简码 | string |
carrierHomePage | 承运人官网链接 | string |
carrierNameCN | 承运人中文名称 | string |
carrierNameEN | 承运人英文名称 | string |
containerInfo | 箱信息 | array[object] |
containerNo | 箱号 | string |
containerSize | 箱高度 | string |
containerType | 箱型号 | string |
currentStatus | 当前运输状态 | object |
eventDetails | 状态详情 | string |
eventTime | 状态更新时间 | string |
eventTimeUTC | 状态更新时间UTC | string |
locationName | 状态发生地 | string |
locationType | 状态发生地类型 | string |
transitStatus | 运输状态 | string |
transitSubStatus | 运输子状态 | string |
vesselName | 船名 | string |
voyage | 航线+航次 | string |
receipt | 接货地信息 | object |
locationName | 接货地址名称 | string |
estimateDepartTime | 预计离港时 | string |
estimateDepartTimeUTC | 预计离港时间UT | string |
departTime | 离港时间 | string |
departTimeUTC | 离港时间UTC | string |
delivery | 交货地信息 | object |
locationName | 交货地址名称 | string |
estimateArriveTime | 预计到港时 | string |
estimateArriveTimeUTC | 预计到港时间UT | string |
arriverTime | 到港时间 | string |
arriverTimeUTC | 到港时间UTC | string |
lastTrackingTime | 最近一条轨迹的时间 | string |
nextUpdateTime | 下次更新时间,为null则表示不会再更新了 | string |
trackingDetails | 轨迹明细,根据时间倒序排列 | array[object] |
eventDetails | 状态详情 | string |
eventTime | 状态更新时间 | string |
eventStatus | 轨迹状态 | string |
eventTimeUTC | 状态更新时间UTC | string |
locationName | 状态发生地 | string |
locationType | 状态发生地类型 | string |
transitStatus | 运输状态 | string |
transitSubStatus | 运输子状态 | string |
vesselName | 船名字 | string |
voyage | 航线+航次 | string |
rejected | 查询失败的单号 | array[object] |
carrierCode | 承运人对应的唯一简码 | String |
orderNo | 唯一订单号(由track123生成的订单编号,从注册接口的响应参数获取) | String |
trackingNo | 查询单号 | String |
type | 单号类型(1.订舱号 2.提单号 3.箱号) | integer |
error | 错误 | object |
code | 错误码 | String |
msg | 业务状态码对应的描述信息或者其他辅助的描述信息 | String |
# 响应示例
{
"code": "00000",
"data": {
"accepted": [
{
"trackingNo": "MATS5217756000",
"type": 2,
"searchStatus": "SUCCESS_FINAL",
"orderNo": "11111111",
"createTime": "2022-12-13 20:07:58",
"customerEmail": "lvsupport@track123.com",
"carrierInfo": {
"carrierCode": "matson",
"carrierNameCN": "Matson",
"carrierNameEN": "Matson",
"carrierHomePage": "https://www.matson.com/shipment-tracking.html"
},
"containerInfo": [
{
"containerNo": "MATU272542",
"containerType": "Dry Container 40' Hi-cube",
"containerSize": "Dry Container 40' Hi-cube",
"containerDetails": "Dry Container 40' Hi-cube",
"lastTrackingTime": "2022-09-28 09:03:00",
"receipt": {
"locationName": "LONG BEACH",
"arriverTime": "2022-09-19 00:00:00"
},
"delivery": {
"locationName": "SHANGHAI"
},
"transitStatus": "DELIVERED",
"currentStatus": {
"eventDetails": "RETURNED FROM CONSIGNEE",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-28 09:03:00",
"eventTimeUTC": "2022-09-29 01:03:00",
"locationName": "LONG BEACH (CA)"
},
"trackingDetails": [
{
"eventDetails": "RETURNED FROM CONSIGNEE",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-28 09:03:00",
"eventTimeUTC": "2022-09-29 01:03:00",
"locationName": "LONG BEACH (CA)"
},
{
"eventDetails": "OUTGATE to HONG ANDA LOGISTICS INC",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-22 08:59:00",
"eventTimeUTC": "2022-09-23 00:59:00",
"locationName": "SHIPPERS TRANSPORT ALAMEDA (CA)"
},
{
"eventDetails": "AVAILABLE",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-21 13:42:01",
"eventTimeUTC": "2022-09-22 05:42:01",
"locationName": "SHIPPERS TRANSPORT ALAMEDA (CA)"
},
{
"eventDetails": "HOLD RELEASED - Customs Clearance",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-21 13:42:00",
"eventTimeUTC": "2022-09-22 05:42:00",
"locationName": ""
},
{
"eventDetails": "INGATE Full by SHIPPERS TRANSPORT EXPRESS",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-20 23:24:00",
"eventTimeUTC": "2022-09-21 15:24:00",
"locationName": "SHIPPERS TRANSPORT ALAMEDA (CA)"
},
{
"eventDetails": "OUTGATE to SHIPPERS TRANSPORT EXPRESS",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-20 23:08:00",
"eventTimeUTC": "2022-09-21 15:08:00",
"locationName": "LONG BEACH (CA)"
},
{
"eventDetails": "DISCHARGE FROM VESSEL MANUKAI 229",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-20 07:38:00",
"eventTimeUTC": "2022-09-20 23:38:00",
"locationName": "LONG BEACH (CA)"
},
{
"eventDetails": "HOLD RELEASED - Order Bill of Lading",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-15 01:23:00",
"eventTimeUTC": "2022-09-15 17:23:00",
"locationName": ""
},
{
"eventDetails": "HOLD RELEASED - Hold for Payment",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-14 07:37:00",
"eventTimeUTC": "2022-09-14 23:37:00",
"locationName": ""
},
{
"eventDetails": "CONTAINER ON HOLD - Hold for Payment",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-09 21:56:00",
"eventTimeUTC": "2022-09-10 13:56:00",
"locationName": ""
},
{
"eventDetails": "CONTAINER ON HOLD - Order Bill of Lading",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-09 21:56:00",
"eventTimeUTC": "2022-09-10 13:56:00",
"locationName": ""
},
{
"eventDetails": "LOAD TO VESSEL MANUKAI 229",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-09 10:30:00",
"eventTimeUTC": "2022-09-10 02:30:00",
"locationName": "SHANGHAI"
},
{
"eventDetails": "CONTAINER ON HOLD - Customs Clearance",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-09 02:02:00",
"eventTimeUTC": "2022-09-09 18:02:00",
"locationName": ""
},
{
"eventDetails": "INGATE Full by SHANGHAI",
"eventStatus": "GTOT",
"vesselName": "MKI",
"voyage": "229",
"eventTime": "2022-09-06 06:39:00",
"eventTimeUTC": "2022-09-06 22:39:00",
"locationName": "SHANGHAI"
}
]
}
]
}
],
"rejected": [
{
"trackingNo": "MATS5217756002",
"type": 2,
"orderNo": "11111112",
"error": {
"msg": "该运单尚未注册",
"code": "A0400"
}
}
]
},
"msg": "成功",
"traceId": "6058fd26a116449899a3b98c6a52547a.151.16709335122540597"
}