- 通用接口
- 海运数据接口
- 船期表接口
- 港到港船期
- 航线规划路径
- 航次挂靠路径
- 空运数据接口
- 陆运数据接口
- 关务数据接口
- 快递数据接口
- 其他接口
推送运单动态接口
POST
2.推送的数据结构改成首字母小写仅对于新用户，原已配置好的用户如果首字母大写，保持不变，已做兼容处理。
3.所有的时间字段都是字符串类型，格式为 "yyyy-MM-dd HH:mm:ss"， 如果时间没有值则为空字符串""。
请求参数
Body 参数application/json
array of:
id
string <uuid>
云端运单关键字
referenceNo
string
订阅单号
<= 32 字符
referenceCtnrNo
string
订阅箱号
<= 12 字符
deliveryNo
string
交货单号
<= 38 字符
orderNo
string
需货单号
<= 600 字符
localKey
string
客户本地关键字
<= 38 字符
blNo
string
提单号
<= 128 字符
bkgNo
string
订舱号
<= 128 字符
ctnrNo
string
箱号
<= 11 字符
carrierCd
string
云当船东代码
<= 18 字符
carrier
string
船东简称
<= 164 字符
vesselName
string
起运港船名
<= 64 字符
voyage
string
起运港航次
<= 32 字符
plrCd
string
收货地代码
<= 8 字符
plr
string
收货地名称
<= 164 字符
polCd
string
起运港代码
<= 8 字符
pol
string
起运港名称
<= 164 字符
podCd
string
目的港代码
<= 8 字符
pod
string
目的港名称
<= 164 字符
pldCd
string
交货地代码
<= 8 字符
pld
string
交货地名称
<= 164 字符
cyOpenTime
string <date-time>
开港日期
cyCutOffTime
string <date-time>
截港日期
dlptTime
string <date-time>
实际离港（开航）时间
etd
string <date-time>
预计离开起运港时间
eta
string <date-time>
预计到达目的港时间
ata
string <date-time>
实际抵达目的港时间
firstETA
string <date-time>
开航后第一次获取到的预计抵港时间
etaPLD
string <date-time>
预计抵达交货地时间
ataPLD
string <date-time>
实际抵达交货地时间
dschTime
string <date-time>
卸船时间
endTrackTime
string <date-time>
结束时间
dataUpdateTime
string <date-time>
数据更新时间
endStatus
string
结束状态
<= 20 字符
trackStatus
string
跟踪状态中文描述
<= 20 字符
trackStatusCd
string
跟踪状态
<= 20 字符
errorStatus
string
异常状态
<= 20 字符
errorMessage
string
异常备注
<= 255 字符
dataStatus
string
数据状态
<= 20 字符
billCreateTime
string <date-time>
运单订阅时间
customer
string
客户
<= 128 字符
deliveryAddress
string
派送地址
<= 255 字符
estDelTime
string
预计派送时间
<= 30 字符
actDelTime
string
实际派送完成时间
<= 30 字符
custReqDate
string
客户要求交期
<= 30 字符
status
string
订阅状态
<= 10 字符
errorDes
string
订阅失败信息
<= 255 字符
firstUpdateTime
string <date-time>
首次获取数据时间
requestId
string
请求号
<= 64 字符
batchId
string
批次号
<= 64 字符
ctnrInfos
array [object {15}]
箱子信息数组
ctnrNo
string
箱号
<= 11 字符
sealNo
string
铅封号
<= 18 字符
ctnrSize
string
尺寸
<= 3 字符
ctnrType
string
箱型
<= 3 字符
pkgs
string
件数
<= 20 字符
gwgt
string
毛重（KGS）
<= 20 字符
vgm
string
VGM
<= 20 字符
currentStatusCd
string
当前动态代码
<= 8 字符
currentStatus
string
当前动态
<= 255 字符
currentStatusTime
string <date-time>
当前动态时间
currentPlaceCd
string
当前动态地点代码
<= 8 字符
currentPlace
string
当前动态地点
<= 164 字符
isRolled
string
甩柜标识
ctnrStatus
array [object {13}]
该箱子的动态节点数组
deleteStatus
array [object {13}]
该箱子删除的动态节点数组
carriges
array [object {14}]
航程数据节点数组
sno
integer
航程序号
polCd
string
起运港代码
<= 8 字符
polNameEn
string
起运港英文名称
<= 128 字符
polNameCn
string
起运港中文名称
<= 128 字符
podCd
string
卸货港代码
<= 8 字符
podNameEn
string
卸货港英文名称
<= 128 字符
podNameCn
string
卸货港中文名称
<= 128 字符
etd
string <date-time>
预离时间
atd
string <date-time>
实离时间
eta
string <date-time>
预抵时间
ata
string <date-time>
实抵时间
type
string
类型
<= 20 字符
vesselName
string
英文船名
<= 128 字符
voy
string
航次
<= 64 字符
oceanNodes
array [object {9}]
关键流程结点数据组
stateCode
string
动态代码
<= 8 字符
stateDesc
string
动态描述
<= 255 字符
stateDescCN
string
动态中文描述
<= 255 字符
count
integer
箱子已发生动态数量
total
integer
箱子总数量
planTime
string <date-time>
计划动态发生时间
estimateTime
string <date-time>
预计动态发生时间
actualityTime
string <date-time>
实际动态发生时间
number
integer
动态序号
示例
[
{
"id": "1915644276168069120",
"referenceNo": "BMOU5314710",
"referenceCtnrNo": "",
"deliveryNo": "",
"orderNo": "",
"localKey": "",
"blNo": "",
"bkgNo": "",
"ctnrNo": "BMOU5314710",
"carrierCd": "OOCL",
"carrier": "东方海外货柜航运有限公司",
"vesselName": "CMA CGM LA TRAVIATA",
"voyage": "296E",
"plrCd": "CNYTN",
"plr": "Yantian,Shenzhen,Guangdong,China",
"polCd": "CNYTN",
"pol": "Yantian,Shenzhen,Guangdong,China",
"podCd": "USORF",
"pod": "Norfolk,Virginia,United States",
"pldCd": "USORF",
"pld": "Norfolk,Virginia,United States",
"cyOpenTime": "",
"cyCutOffTime": "",
"dlptTime": "2025-04-03 19:15:00",
"etd": "2025-04-03 19:15:00",
"eta": "2025-05-10 09:30:00",
"ata": "",
"firstETA": "2025-05-10 09:30:00",
"etaPLD": "2025-05-11 12:00:00",
"ataPLD": "",
"dschTime": "",
"endTrackTime": "",
"dataUpdateTime": "2025-04-27 09:00:24",
"endStatus": "",
"trackStatus": "跟踪中",
"trackStatusCd": "T",
"errorStatus": "",
"errorMessage": "",
"dataStatus": "Y",
"billCreateTime": "2025-04-25 13:49:21",
"status": "S",
"errorDes": "",
"customer": "",
"deliveryAddress": "",
"estDelTime": "",
"actDelTime": "",
"custReqDate": "",
"firstUpdateTime": "2025-04-25 13:50:21",
"requestId":"",
"batchId":"",
"ctnrInfos": [
{
"ctnrNo": "BMOU5314710",
"sealNo": "",
"ctnrSize": "40",
"ctnrType": "HQ",
"pkgs": "",
"gwgt": "",
"vgm": "",
"currentStatusCd": "DLPT",
"currentStatus": "离港",
"currentStatusTime": "2025-04-03 19:15:00",
"currentPlaceCd": "CNYTN",
"currentPlace": "Yantian,Shenzhen,Guangdong,China",
"isRolled": "",
"ctnrStatus": [
{
"statusCd": "STSP",
"statusDesc": "提空箱",
"statusDescEn": "Container Picked Up(Facility)",
"vesselName": "",
"voyage": "",
"eventTime": "2025-03-25 23:49:00",
"place": "Yantian Port,Yantian,Shenzhen,Guangdong,China",
"placeCd": "CNYTN",
"transportMode": "TRUCK",
"isEstimate": false,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": false
},
{
"statusCd": "",
"statusDesc": "Arrived(Port of Load)",
"statusDescEn": "Arrived(Port of Load)",
"vesselName": "",
"voyage": "",
"eventTime": "2025-03-26 17:56:00",
"place": "Yantian,Shenzhen,Guangdong,China",
"placeCd": "CNYTN",
"transportMode": "TRUCK",
"isEstimate": false,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": false
},
{
"statusCd": "GITM",
"statusDesc": "码头进场",
"statusDescEn": "Container Received by Carrier(Origin)",
"vesselName": "",
"voyage": "",
"eventTime": "2025-03-26 17:56:00",
"place": "Yantian Port,Yantian,Shenzhen,Guangdong,China",
"placeCd": "CNYTN",
"transportMode": "TRUCK",
"isEstimate": false,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": false
},
{
"statusCd": "LOBD",
"statusDesc": "装船",
"statusDescEn": "Loaded(Port of Load)",
"vesselName": "CMA CGM LA TRAVIATA",
"voyage": "296E",
"eventTime": "2025-04-03 17:29:00",
"place": "Yantian,Shenzhen,Guangdong,China",
"placeCd": "CNYTN",
"transportMode": "VESSEL",
"isEstimate": false,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": false
},
{
"statusCd": "DLPT",
"statusDesc": "离港",
"statusDescEn": "DEPARTURE FROM LOAD PORT",
"vesselName": "CMA CGM LA TRAVIATA",
"voyage": "296E",
"eventTime": "2025-04-03 19:15:00",
"place": "Yantian,Shenzhen,Guangdong,China",
"placeCd": "CNYTN",
"transportMode": "VESSLE",
"isEstimate": false,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": false
},
{
"statusCd": "BDAR",
"statusDesc": "目的港抵港",
"statusDescEn": "BOARD ARRIVE",
"vesselName": "CMA CGM LA TRAVIATA",
"voyage": "296E",
"eventTime": "2025-05-10 09:30:00",
"place": "Norfolk,Virginia,United States",
"placeCd": "USORF",
"transportMode": "VESSLE",
"isEstimate": true,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": true
},
{
"statusCd": "PDAR",
"statusDesc": "抵达交货地",
"statusDescEn": "PLACE OF DELIVERY ARRIVAL",
"vesselName": "",
"voyage": "",
"eventTime": "2025-05-11 12:00:00",
"place": "Norfolk,Virginia,United States",
"placeCd": "USORF",
"transportMode": "",
"isEstimate": true,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": true
}
],
"deleteStatus": []
}
],
"carriges": [
{
"sno": 1,
"polCd": "CNYTN",
"polNameEn": "Yantian,Shenzhen,Guangdong,China",
"polNameCn": "盐田",
"podCd": "USORF",
"podNameEn": "Norfolk,Virginia,United States",
"podNameCn": "诺福克",
"etd": "2025-04-03 19:15:00",
"atd": "2025-04-03 19:15:00",
"eta": "2025-05-10 09:30:00",
"ata": "",
"type": "",
"vesselName": "CMA CGM LA TRAVIATA",
"voy": "296E"
}
],
"oceanNodes": [
{
"stateCode": "STSP",
"stateDesc": "Empty Pickup",
"stateDescCN": "提空箱",
"count": 1,
"total": 1,
"planTime": "",
"estimateTime": "",
"actualityTime": "2025-03-25 23:49:00",
"number": 3
},
{
"stateCode": "GITM",
"stateDesc": "FGate In to Outbound Terminal",
"stateDescCN": "码头进场",
"count": 1,
"total": 1,
"planTime": "",
"estimateTime": "",
"actualityTime": "2025-03-26 17:56:00",
"number": 12
},
{
"stateCode": "PASS",
"stateDesc": "Customs Release",
"stateDescCN": "海关放行",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 13
},
{
"stateCode": "LOBD",
"stateDesc": "Loaded on Board at Port of Loading",
"stateDescCN": "装船",
"count": 1,
"total": 1,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 18
},
{
"stateCode": "DLPT",
"stateDesc": "Departure from Port of Loading",
"stateDescCN": "离港",
"count": 1,
"total": 1,
"planTime": "2025-04-03 19:15:00",
"estimateTime": "2025-04-03 19:15:00",
"actualityTime": "2025-04-03 19:15:00",
"number": 19
},
{
"stateCode": "TSBA",
"stateDesc": "Arrived at Transhipment Port",
"stateDescCN": "中转抵港",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 20
},
{
"stateCode": "BDAR",
"stateDesc": "Arrived at Port of Discharge",
"stateDescCN": "目的港抵港",
"count": 0,
"total": 1,
"planTime": "2025-05-10 09:30:00",
"estimateTime": "2025-05-10 09:30:00",
"actualityTime": "",
"number": 24
},
{
"stateCode": "DSCH",
"stateDesc": "Discharged at Port of Discharge",
"stateDescCN": "目的港卸船",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 25
},
{
"stateCode": "STCS",
"stateDesc": "Gate Out from Inbound CY for Delivery to Consignee",
"stateDescCN": "提重柜/提货",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 34
},
{
"stateCode": "RCVE",
"stateDesc": "Empty Container Returned",
"stateDescCN": "还空箱",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 35
},
{
"stateCode": "END",
"stateDesc": "Tracking Finished",
"stateDescCN": "结束跟踪",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 36
}
]
}
]示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.trackingeyes.com' \
--header 'Content-Type: application/json' \
--data-raw '[
{
"id": "1915644276168069120",
"referenceNo": "BMOU5314710",
"referenceCtnrNo": "",
"deliveryNo": "",
"orderNo": "",
"localKey": "",
"blNo": "",
"bkgNo": "",
"ctnrNo": "BMOU5314710",
"carrierCd": "OOCL",
"carrier": "东方海外货柜航运有限公司",
"vesselName": "CMA CGM LA TRAVIATA",
"voyage": "296E",
"plrCd": "CNYTN",
"plr": "Yantian,Shenzhen,Guangdong,China",
"polCd": "CNYTN",
"pol": "Yantian,Shenzhen,Guangdong,China",
"podCd": "USORF",
"pod": "Norfolk,Virginia,United States",
"pldCd": "USORF",
"pld": "Norfolk,Virginia,United States",
"cyOpenTime": "",
"cyCutOffTime": "",
"dlptTime": "2025-04-03 19:15:00",
"etd": "2025-04-03 19:15:00",
"eta": "2025-05-10 09:30:00",
"ata": "",
"firstETA": "2025-05-10 09:30:00",
"etaPLD": "2025-05-11 12:00:00",
"ataPLD": "",
"dschTime": "",
"endTrackTime": "",
"dataUpdateTime": "2025-04-27 09:00:24",
"endStatus": "",
"trackStatus": "跟踪中",
"trackStatusCd": "T",
"errorStatus": "",
"errorMessage": "",
"dataStatus": "Y",
"billCreateTime": "2025-04-25 13:49:21",
"status": "S",
"errorDes": "",
"customer": "",
"deliveryAddress": "",
"estDelTime": "",
"actDelTime": "",
"custReqDate": "",
"firstUpdateTime": "2025-04-25 13:50:21",
"requestId":"",
"batchId":"",
"ctnrInfos": [
{
"ctnrNo": "BMOU5314710",
"sealNo": "",
"ctnrSize": "40",
"ctnrType": "HQ",
"pkgs": "",
"gwgt": "",
"vgm": "",
"currentStatusCd": "DLPT",
"currentStatus": "离港",
"currentStatusTime": "2025-04-03 19:15:00",
"currentPlaceCd": "CNYTN",
"currentPlace": "Yantian,Shenzhen,Guangdong,China",
"isRolled": "",
"ctnrStatus": [
{
"statusCd": "STSP",
"statusDesc": "提空箱",
"statusDescEn": "Container Picked Up(Facility)",
"vesselName": "",
"voyage": "",
"eventTime": "2025-03-25 23:49:00",
"place": "Yantian Port,Yantian,Shenzhen,Guangdong,China",
"placeCd": "CNYTN",
"transportMode": "TRUCK",
"isEstimate": false,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": false
},
{
"statusCd": "",
"statusDesc": "Arrived(Port of Load)",
"statusDescEn": "Arrived(Port of Load)",
"vesselName": "",
"voyage": "",
"eventTime": "2025-03-26 17:56:00",
"place": "Yantian,Shenzhen,Guangdong,China",
"placeCd": "CNYTN",
"transportMode": "TRUCK",
"isEstimate": false,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": false
},
{
"statusCd": "GITM",
"statusDesc": "码头进场",
"statusDescEn": "Container Received by Carrier(Origin)",
"vesselName": "",
"voyage": "",
"eventTime": "2025-03-26 17:56:00",
"place": "Yantian Port,Yantian,Shenzhen,Guangdong,China",
"placeCd": "CNYTN",
"transportMode": "TRUCK",
"isEstimate": false,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": false
},
{
"statusCd": "LOBD",
"statusDesc": "装船",
"statusDescEn": "Loaded(Port of Load)",
"vesselName": "CMA CGM LA TRAVIATA",
"voyage": "296E",
"eventTime": "2025-04-03 17:29:00",
"place": "Yantian,Shenzhen,Guangdong,China",
"placeCd": "CNYTN",
"transportMode": "VESSEL",
"isEstimate": false,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": false
},
{
"statusCd": "DLPT",
"statusDesc": "离港",
"statusDescEn": "DEPARTURE FROM LOAD PORT",
"vesselName": "CMA CGM LA TRAVIATA",
"voyage": "296E",
"eventTime": "2025-04-03 19:15:00",
"place": "Yantian,Shenzhen,Guangdong,China",
"placeCd": "CNYTN",
"transportMode": "VESSLE",
"isEstimate": false,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": false
},
{
"statusCd": "BDAR",
"statusDesc": "目的港抵港",
"statusDescEn": "BOARD ARRIVE",
"vesselName": "CMA CGM LA TRAVIATA",
"voyage": "296E",
"eventTime": "2025-05-10 09:30:00",
"place": "Norfolk,Virginia,United States",
"placeCd": "USORF",
"transportMode": "VESSLE",
"isEstimate": true,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": true
},
{
"statusCd": "PDAR",
"statusDesc": "抵达交货地",
"statusDescEn": "PLACE OF DELIVERY ARRIVAL",
"vesselName": "",
"voyage": "",
"eventTime": "2025-05-11 12:00:00",
"place": "Norfolk,Virginia,United States",
"placeCd": "USORF",
"transportMode": "",
"isEstimate": true,
"dateUpdateTime": "2025-04-29 10:49:20",
"sourceCd": "1",
"dataState": "add",
"estimate": true
}
],
"deleteStatus": []
}
],
"carriges": [
{
"sno": 1,
"polCd": "CNYTN",
"polNameEn": "Yantian,Shenzhen,Guangdong,China",
"polNameCn": "盐田",
"podCd": "USORF",
"podNameEn": "Norfolk,Virginia,United States",
"podNameCn": "诺福克",
"etd": "2025-04-03 19:15:00",
"atd": "2025-04-03 19:15:00",
"eta": "2025-05-10 09:30:00",
"ata": "",
"type": "",
"vesselName": "CMA CGM LA TRAVIATA",
"voy": "296E"
}
],
"oceanNodes": [
{
"stateCode": "STSP",
"stateDesc": "Empty Pickup",
"stateDescCN": "提空箱",
"count": 1,
"total": 1,
"planTime": "",
"estimateTime": "",
"actualityTime": "2025-03-25 23:49:00",
"number": 3
},
{
"stateCode": "GITM",
"stateDesc": "FGate In to Outbound Terminal",
"stateDescCN": "码头进场",
"count": 1,
"total": 1,
"planTime": "",
"estimateTime": "",
"actualityTime": "2025-03-26 17:56:00",
"number": 12
},
{
"stateCode": "PASS",
"stateDesc": "Customs Release",
"stateDescCN": "海关放行",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 13
},
{
"stateCode": "LOBD",
"stateDesc": "Loaded on Board at Port of Loading",
"stateDescCN": "装船",
"count": 1,
"total": 1,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 18
},
{
"stateCode": "DLPT",
"stateDesc": "Departure from Port of Loading",
"stateDescCN": "离港",
"count": 1,
"total": 1,
"planTime": "2025-04-03 19:15:00",
"estimateTime": "2025-04-03 19:15:00",
"actualityTime": "2025-04-03 19:15:00",
"number": 19
},
{
"stateCode": "TSBA",
"stateDesc": "Arrived at Transhipment Port",
"stateDescCN": "中转抵港",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 20
},
{
"stateCode": "BDAR",
"stateDesc": "Arrived at Port of Discharge",
"stateDescCN": "目的港抵港",
"count": 0,
"total": 1,
"planTime": "2025-05-10 09:30:00",
"estimateTime": "2025-05-10 09:30:00",
"actualityTime": "",
"number": 24
},
{
"stateCode": "DSCH",
"stateDesc": "Discharged at Port of Discharge",
"stateDescCN": "目的港卸船",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 25
},
{
"stateCode": "STCS",
"stateDesc": "Gate Out from Inbound CY for Delivery to Consignee",
"stateDescCN": "提重柜/提货",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 34
},
{
"stateCode": "RCVE",
"stateDesc": "Empty Container Returned",
"stateDescCN": "还空箱",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 35
},
{
"stateCode": "END",
"stateDesc": "Tracking Finished",
"stateDescCN": "结束跟踪",
"count": 0,
"total": 0,
"planTime": "",
"estimateTime": "",
"actualityTime": "",
"number": 36
}
]
}
]'返回响应
🟢200sucess
application/json
Body
code
integer
状态码
type
string
类型
message
string
错误信息
time
string
时间
示例
{
"code": 200,
"type": "S",
"message": null,
"time": "2023-12-13 01:20:38"
}