场站数据推送接口 - Trackingeyes数据接口

1.请贵司提供接收推送数据的API地址，谢谢！
2.所有的时间字段都是字符串类型，格式为 "yyyy-MM-dd HH:mm:ss"，如果时间没有值则为空字符串""。

请求参数

Body 参数application/json

array of:

integer

运单Id

必需

订阅接口返回的运单Id

depotCd

string

场站代码

必需

<= 12 字符

portCd

string

港口代码

必需

<= 12 字符

referenceNo

string

订阅号(提单号)

必需

<= 32 字符

extendNo

string

拓展字段

必需

<= 255 字符

localKey

string

客户本地关键字

必需

<= 38 字符

orgCode

string

所属组织代码

必需

<= 64 字符

customer

string

客户

必需

<= 128 字符

subscribeStatus

string

订阅状态

必需

S=成功，F=失败

<= 8 字符

subscribeErro

string

订阅异常信息

必需

<= 255 字符

subscribeTime

string <date-time>

订阅时间

必需

endStatus

string

结束状态

必需

空值‘’=未结束，E=正常结束，EF=强制结束

<= 20 字符

endId

integer

结束标记Id

必需

0=未结束，其他=已结束；雪花id的Long类型，内部使用字段

trackStatus

string

跟踪状态

必需

T=跟踪中、E=跟踪结束、F=跟踪失败

<= 20 字符

errorStatus

string

异常状态

必需

T=提示、E=错误，空值

<= 20 字符

errorMessage

string

异常备注

必需

<= 255 字符

dataStatus

string

数据状态

必需

Y=有数据，B=场站无数据，空值

<= 20 字符

firstUpdateTime

string <date-time>

首次数据更新时间

必需

dataUpdateTime

string <date-time>

数据更新时间

必需

subBills

array [object {54}]

分单表信息

可选

vslName

string

船名

可选

<= 64 字符

vslNameCn

string

中文船名

可选

<= 64 字符

voy

string

航次

可选

<= 32 字符

carrierCd

string

船东代码

可选

<= 18 字符

carrier

string

船东

可选

<= 64 字符

depotCd

string

场站代码

可选

<= 10 字符

depot

string

场站名称

可选

<= 64 字符

terminalCd

string

码头代码

可选

<= 12 字符

terminal

string

码头名称

可选

<= 64 字符

blNo

string

（分）单号

可选

<= 32 字符

mblNo

string

主单号

可选

<= 32 字符

declarationNo

string

报关单号

可选

<= 32 字符

tspCd

string

中转港代码

可选

<= 18 字符

tsp

string

中转港名称

可选

<= 64 字符

dtpCd

string

目的港代码

可选

<= 18 字符

dtp

string

目的港

可选

<= 64 字符

podCd

string

卸货港代码

可选

<= 18 字符

pod

string

卸货港

可选

<= 64 字符

getdepotCd

string

提箱堆场代码

可选

<= 18 字符

getdepot

string

提箱堆场

可选

<= 64 字符

returndepotCd

string

返回堆场代码

可选

<= 18 字符

returndepot

string

返回堆场

可选

<= 64 字符

dgId

string

危品标识

可选

Y=是；N=否

<= 1 字符

dgLevel

string

危品等级

可选

<= 5 字符

dgunNo

string

国际危品码

可选

<= 10 字符

rfid

string

冻柜标识

可选

Y=是；N=否

<= 1 字符

rftmp

string

冷藏温度

可选

<= 56 字符

vent

string

通风口

可选

<= 32 字符

humidity

string

湿度

可选

<= 32 字符

owId

string

超重标识

可选

Y=是；N=否

<= 1 字符

poundWgt

string

磅重（箱货重）

可选

<= 11 字符

vgm

string

VGM重量

可选

<= 11 字符

pieces

string

件数

可选

<= 18 字符

grossWgt

string

毛重

可选

<= 18 字符

volume

string

体积

可选

<= 18 字符

bkgVolumn

string

订舱箱量

可选

<= 128 字符

ctnrPassId

string

是否放箱

可选

Y=是；N=否

<= 1 字符

ctnrPassRemark

string

放箱备注

可选

<= 64 字符

customStatus

string

海关是否放行

可选

Y=放行；N=未放行

<= 1 字符

customTime

string <date-time>

海关放行时间

可选

customPieces

string

放行件数

可选

<= 18 字符

customWgt

string

放行重量

可选

<= 18 字符

cyOpenTime

string <date-time>

集港开始时间

可选

cyCloseTime

string <date-time>

集港结束时间

可选

cyOpenTime2

string <date-time>

集港开始时间2

可选

cyCloseTime2

string <date-time>

集港结束时间2

可选

cyOpenTime3

string <date-time>

集港开始时间3

可选

cyCloseTime3

string <date-time>

集港结束时间3

可选

lobdtime

string <date-time>

装船时间

可选

eta

string <date-time>

预抵时间

可选

etd

string <date-time>

预离时间

可选

ata

string <date-time>

实际抵达

可选

atd

string <date-time>

实际离开

可选

remarks

string

备注

可选

<= 255 字符

ctnrInfos

array [object {22}]

箱子表信息

可选

blNo

string

提单号

可选

<= 32 字符

ctnrNo

string

箱号

可选

<= 11 字符

sealNo

string

铅封号

可选

<= 18 字符

csize

string

尺寸

可选

<= 2 字符

ctype

string

箱型

可选

<= 4 字符

ieid

string

内装/外点

可选

I=内装;E=外点

<= 1 字符

owner

string

箱主

可选

<= 64 字符

truckNo

string

车牌号

可选

<= 20 字符

poundWgt

string

磅重/箱货重

可选

<= 11 字符

vgm

string

VGM重量

可选

<= 11 字符

pieces

string

件数

可选

<= 18 字符

grossWgt

string

毛重

可选

<= 18 字符

tareWgt

string

箱皮重

可选

<= 11 字符

volume

string

体积

可选

<= 18 字符

pkgClass

string

包装类型

可选

<= 16 字符

customPieces

string

放行件数

可选

<= 18 字符

customWgt

string

放行重量

可选

<= 18 字符

stsptime

string <date-time>

提箱时间(外点)

可选

fcgitime

string <date-time>

返场时间(外点)

可选

cggitime

string <date-time>

入货时间(内点/装)

可选

cloadTime

string <date-time>

封箱时间(内点/装)

可选

cyTime

string <date-time>

集港时间

可选

示例

[
    {
        "id": 1877538329499668500,
        "depotCd": "TAOGLJD",
        "portCd": "CNTAO",
        "referenceNo": "AQDJT1E5014052",
        "extendNo": "",
        "localKey": "",
        "orgCode": "",
        "customer": "",
        "subscribeStatus": "S",
        "subscribeErro": "",
        "subscribeTime": "2025-01-10 10:09:55",
        "endStatus": "",
        "endId": 0,
        "trackStatus": "T",
        "errorStatus": "",
        "errorMessage": "",
        "dataStatus": "Y",
        "firstUpdateTime": "2025-01-10 10:10:00",
        "dataUpdateTime": "2025-01-10 10:10:00",
        "subBills": [
            {
                "vslName": "EASLINE LIANYUNGANG",
                "vslNameCn": "大通连云港",
                "voy": "2501E",
                "carrierCd": "ASL",
                "carrier": "ASL",
                "depotCd": "TAOGLJD",
                "depot": "港联捷场站",
                "terminalCd": "",
                "terminal": "",
                "blNo": "AQDJT1E5014052",
                "mblNo": "AQDJT1E5014052",
                "declarationNo": "",
                "tspCd": "",
                "tsp": "JPTYO",
                "dtpCd": "",
                "dtp": "TOKYO",
                "podCd": "",
                "pod": "",
                "getdepotCd": "",
                "getdepot": "",
                "returndepotCd": "",
                "returndepot": "",
                "dgId": "",
                "dgLevel": "",
                "dgunNo": "",
                "rfid": "",
                "rftmp": "",
                "vent": "",
                "humidity": "",
                "owId": "",
                "poundWgt": "",
                "vgm": "",
                "pieces": "1100",
                "grossWgt": "22330",
                "volume": "55",
                "bkgVolumn": "1X40HC",
                "ctnrPassId": "Y",
                "ctnrPassRemark": "有放箱指令可以放箱;受船期控制，该提单所含箱型不能放箱；",
                "customStatus": "",
                "customTime": "",
                "customPieces": "",
                "customWgt": "",
                "cyOpenTime": "2025-01-04 15:30:00",
                "cyCloseTime": "2025-01-05 04:00:00",
                "cyOpenTime2": "2025-01-05 12:00:00",
                "cyCloseTime2": "2025-01-05 13:00:00",
                "cyOpenTime3": "",
                "cyCloseTime3": "",
                "lobdtime": "2025-01-06 00:00:00",
                "eta": "",
                "etd": "",
                "ata": "",
                "atd": "",
                "remarks": ""
            }
        ],
        "ctnrInfos": [
            {
                "blNo": "AQDJT1E5014052",
                "ctnrNo": "AXEU6029575",
                "sealNo": "ASL3046150",
                "csize": "40",
                "ctype": "HC",
                "ieid": "E",
                "owner": "ASL",
                "truckNo": "浙B5P079",
                "poundWgt": "",
                "vgm": "26030",
                "pieces": "1100",
                "grossWgt": "22330",
                "tareWgt": "3700",
                "volume": "55",
                "pkgClass": "",
                "customPieces": "",
                "customWgt": "",
                "stsptime": "2025-01-01 18:23:16",
                "fcgitime": "2025-01-03 05:35:45",
                "cggitime": "",
                "cloadTime": "",
                "cyTime": "2025-01-04 19:56:57"
            }
        ]
    }
]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.trackingeyes.com' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "id": 1877538329499668500,
        "depotCd": "TAOGLJD",
        "portCd": "CNTAO",
        "referenceNo": "AQDJT1E5014052",
        "extendNo": "",
        "localKey": "",
        "orgCode": "",
        "customer": "",
        "subscribeStatus": "S",
        "subscribeErro": "",
        "subscribeTime": "2025-01-10 10:09:55",
        "endStatus": "",
        "endId": 0,
        "trackStatus": "T",
        "errorStatus": "",
        "errorMessage": "",
        "dataStatus": "Y",
        "firstUpdateTime": "2025-01-10 10:10:00",
        "dataUpdateTime": "2025-01-10 10:10:00",
        "subBills": [
            {
                "vslName": "EASLINE LIANYUNGANG",
                "vslNameCn": "大通连云港",
                "voy": "2501E",
                "carrierCd": "ASL",
                "carrier": "ASL",
                "depotCd": "TAOGLJD",
                "depot": "港联捷场站",
                "terminalCd": "",
                "terminal": "",
                "blNo": "AQDJT1E5014052",
                "mblNo": "AQDJT1E5014052",
                "declarationNo": "",
                "tspCd": "",
                "tsp": "JPTYO",
                "dtpCd": "",
                "dtp": "TOKYO",
                "podCd": "",
                "pod": "",
                "getdepotCd": "",
                "getdepot": "",
                "returndepotCd": "",
                "returndepot": "",
                "dgId": "",
                "dgLevel": "",
                "dgunNo": "",
                "rfid": "",
                "rftmp": "",
                "vent": "",
                "humidity": "",
                "owId": "",
                "poundWgt": "",
                "vgm": "",
                "pieces": "1100",
                "grossWgt": "22330",
                "volume": "55",
                "bkgVolumn": "1X40HC",
                "ctnrPassId": "Y",
                "ctnrPassRemark": "有放箱指令可以放箱;受船期控制，该提单所含箱型不能放箱；",
                "customStatus": "",
                "customTime": "",
                "customPieces": "",
                "customWgt": "",
                "cyOpenTime": "2025-01-04 15:30:00",
                "cyCloseTime": "2025-01-05 04:00:00",
                "cyOpenTime2": "2025-01-05 12:00:00",
                "cyCloseTime2": "2025-01-05 13:00:00",
                "cyOpenTime3": "",
                "cyCloseTime3": "",
                "lobdtime": "2025-01-06 00:00:00",
                "eta": "",
                "etd": "",
                "ata": "",
                "atd": "",
                "remarks": ""
            }
        ],
        "ctnrInfos": [
            {
                "blNo": "AQDJT1E5014052",
                "ctnrNo": "AXEU6029575",
                "sealNo": "ASL3046150",
                "csize": "40",
                "ctype": "HC",
                "ieid": "E",
                "owner": "ASL",
                "truckNo": "浙B5P079",
                "poundWgt": "",
                "vgm": "26030",
                "pieces": "1100",
                "grossWgt": "22330",
                "tareWgt": "3700",
                "volume": "55",
                "pkgClass": "",
                "customPieces": "",
                "customWgt": "",
                "stsptime": "2025-01-01 18:23:16",
                "fcgitime": "2025-01-03 05:35:45",
                "cggitime": "",
                "cloadTime": "",
                "cyTime": "2025-01-04 19:56:57"
            }
        ]
    }
]'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

200=成功

type

string

类型

必需

S=成功、W=警告、E=异常

message

string

错误信息

必需

<= 255 字符

time

string

时间

必需

示例

{
    "code": 200,
    "type": "S",
    "message": null,
    "time": "2023-12-13 01:20:38"
}