海运跟踪下载（按提单号/订舱号订阅）

调用该接口前，需要先使用[获取Token API]获取token。token 有效期是2小时，超过了2小时得重新获取。

请求参数

Query 参数

companyid

string

企业编号

必需

示例值:

1000

token

string

必需

Token（请先通过获取token接口获取token）

示例值:

d450e2c1-0699-4521-a73a-4f053b04f0ba

Body 参数application/x-www-form-urlencoded

data

string

必需

示例值:

[{"keyid":"123","carriercd":"COSCO","referenceno":"6135761320","pol":"CNNGB","dtp":""}]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

array of:

objlinertracking

object

海运订阅线性表(Shipping subscription linear table)

可选

keyid

string

主键(Primary key)

必需

云当网业务主键(Yundang Network Business Key)

>= 36 字符<= 36 字符

localkeyid

string

订阅参数keyid的值(The value of subscription parameter keyid)

可选

订阅时传上来的参数keyid的值，会做回传(The value of the keyid parameter passed during subscription will be returned)

>= 18 字符

blprefix

string

提单前缀(Bill of Lading Prefix)

可选

例如COSU, ONEY ,OOLU, KMTC等提单前缀(For example, bill of lading prefixes such as COSU, ONEY, OOLU, KMTC, etc)

>= 6 字符<= 6 字符

blno

string

船东返回的提单号(Bill of lading number returned by the shipowner)

可选

>= 128 字符<= 128 字符

bkgno

string

船东返回的订舱号(The booking number returned by the shipowner)

可选

>= 128 字符<= 128 字符

trfsno

string

港区返回的提单号(Bill of lading number returned from the port area)

可选

>= 32 字符<= 32 字符

ctnrno

string

箱号(Container Number)

可选

集装箱号，4位英文+7位数字，标准的11位，百度有具体的箱号校验规则，可以自行查阅(Container number, 4 digits in English+7 digits, standard 11 digits. Baidu has specific container number verification rules, which can be consulted by oneself)

>= 11 字符<= 11 字符

bkgvolumn

string

订舱箱量(Booking container quantity)

可选

>= 128 字符<= 128 字符

plr

string

收货地(Place of receipt)

可选

>= 164 字符<= 164 字符

plrcd

string

收货地代码(Place code of receipt)

可选

>= 8 字符<= 8 字符

pol

string

起运港(Port of departure)

可选

>= 164 字符<= 164 字符

polcd

string

起运港代码(Port of departure code)

可选

>= 8 字符<= 8 字符

dtp

string

卸货港(Discharge Port)

可选

>= 164 字符<= 164 字符

dtpcd

string

卸货港代码(Discharge Port Code)

可选

>= 8 字符<= 8 字符

pld

string

交货地(Delivery location)

可选

>= 164 字符<= 164 字符

pldcd

string

交货地代码(Delivery location code)

可选

>= 8 字符<= 8 字符

stsptime

string <date-time>

提空时间(Empty time)

可选

stspplace

string

提空地点(Empty location)

可选

>= 164 字符<= 164 字符

fcgitime

string <date-time>

返场时间(外/拖装)(Return time (external/towing))

可选

cggitime

string <date-time>

入货时间(内/场装)(Delivery time (internal/on-site))

可选

cloadtime

string <date-time>

封箱时间(内/场装)(Sealing time (inside/on site))

可选

cytctime

string <date-time>

集港时间(Port arrival time)

可选

cytcplace

string

集港地点(Gathering port location)

可选

>= 164 字符<= 164 字符

gitmtime

string <date-time>

进场时间(Entry time)

可选

gitmplace

string

进场地点(Entry location)

可选

>= 164 字符<= 164 字符

passtime

string <date-time>

海放时间(Sea release time)

可选

passplace

string

海放地点(Sea release location)

可选

>= 164 字符<= 164 字符

ispass

string

海关是否放行（Y=放行；N=未放行；C=退关）(Customs release (Y=release; N=not released; C=exit))

可选

>= 2 字符<= 2 字符

ispreload

string

是否预配（Y=已预配；N=未预配；)(Pre configured (Y=pre configured; N=not pre configured;))

可选

>= 2 字符<= 2 字符

lobdtime

string <date-time>

装船时间(Loading time)

可选

lobdplace

string

装船地点(Loading location)

可选

>= 164 字符<= 164 字符

dlpttime

string <date-time>

离港（开航）时间(Departure time)

可选

dlptplace

string

离港（开航）地点(Departure location)

可选

>= 164 字符<= 164 字符

etdpol

string <date-time>

预离时间(Estimated Time of Departure)

可选

trsptime

string <date-time>

中转时间(Transit time)

可选

trspplace

string

中转地点(Transfer location)

可选

>= 164 字符<= 164 字符

etapld

string

预计到港时间(Estimated time of arrival)

可选

dschtime

string <date-time>

卸船时间(Unloading time)

可选

dschplace

string

卸船地点(Unloading location)

可选

>= 164 字符<= 164 字符

terminalpld

string

交货地码头(Delivery port)

可选

>= 164 字符<= 164 字符

terminaldtp

string

目的港码头(Destination port terminal)

可选

>= 164 字符<= 164 字符

stcstime

string <date-time>

提货时间(Delivery time)

可选

stcsplace

string

提货地点(Delivery location)

可选

>= 164 字符<= 164 字符

rcvetime

string <date-time>

还空时间(Still available time)

可选

rcveplace

string

还空地点(Still available location)

可选

>= 164 字符<= 164 字符

currentnode

string

当前节点代码(Current node code)

可选

>= 18 字符<= 18 字符

currentnodetime

string <date-time>

当前节点时间(Current node time)

可选

currentnodeplace

string

当前节点地点(Current node location)

可选

>= 164 字符<= 164 字符

depotcd

string

云当标准场站代码(Yundang Standard Station Code)

可选

>= 12 字符<= 12 字符

depot

string

云当标准场站名称(Yundang Standard Station Name)

可选

>= 164 字符<= 164 字符

terminalcd

string

云当标准码头代码(Yundang Standard dock code)

可选

>= 12 字符<= 12 字符

terminal

string

云当标准码头名称(Yundang Standard dock name)

可选

>= 164 字符<= 164 字符

vslname

string

一程船名(Ship name for the first voyage)

可选

>= 64 字符<= 64 字符

voy

string

一程航次(One voyage)

可选

>= 32 字符<= 32 字符

carriercd

string

云当标准船东代码(Yundang Standard Shipowner Code)

可选

>= 18 字符<= 18 字符

carrier

string

云当标准船东名称(Yundang Standard Shipowner Name)

可选

>= 164 字符<= 164 字符

updatetime

string <date-time>

更新时间(Update time)

可选

createtime

string <date-time>

订阅时间(Subscription time)

可选

declarationno

string

报关单号(Customs declaration number)

可选

>= 18 字符<= 18 字符

referenceno

string

订阅时上传的单号(The tracking number uploaded during subscription)

可选

>= 32 字符<= 32 字符

isctnr

string

是否是箱号订阅（0=否;1=是）(Is it a container number subscription (0=no; 1=yes))

可选

>= 2 字符<= 2 字符

currentvslname

string

当前船名(Current ship name)

可选

>= 64 字符<= 64 字符

currentvoy

string

当前航次(Current voyage)

可选

>= 32 字符<= 32 字符

companycd

string

企业编号(Enterprise ID)

可选

>= 8 字符<= 8 字符

endtime

string <date-time>

结束时间(End time)

可选

isendforce

string

是否强制结束（Y=是，N=否）(Is it forced to end (Y=Yes, N=No))

可选

>= 2 字符<= 2 字符

tmpstime

string <date-time>

码头放行时间(Terminal release time)

可选

istmps

string

是否码头放行（Y=放行；N=未放行；）(Is the port released (Y=released; N=not released;))

可选

>= 2 字符<= 2 字符

pickupreference

string

提货信息（Firms code等）(Pickup information (Firms code, etc.))

可选

>= 128 字符<= 128 字符

railcode

string

铁路公司代码(Railway company code)

可选

>= 12 字符<= 12 字符

lstlinertrackingctnrinfo

array [object {14}]

海运订阅线性箱信息表(Shipping subscription linear box information table)

可选

datatime

string <date-time>

第一次获取到数据的时间(The first time data was obtained)

可选

success

boolean

是否成功（true=成功，false=失败）(Whether successful (true=successful, false=failed))

可选

status

string

状态码，0=成功；1=失败；1000=查无数据；1005=未订阅;(Status code, 0=successful; 1=failed; 1000=no data found; 1005=unsubscribed)

可选

>= 11 字符<= 11 字符

message

string

错误描述(Error description)

可选

>= 256 字符<= 256 字符

示例

[
    {
        "objlinertracking": {
            "keyid": "5294ee29-b4f2-47f9-a917-66ea4a641761",
            "localkeyid": null,
            "blprefix": null,
            "blno": "E470020041",
            "bkgno": "E470020041",
            "trfsno": null,
            "ctnrno": "TCNU3053817",
            "bkgvolumn": "4 units (4 * 40')",
            "plr": "PORT KLANG (MYPKG)",
            "plrcd": "MYLPK",
            "pol": "PORT KLANG (MYPKG)",
            "polcd": "MYLPK",
            "dtp": "NORFOLK",
            "dtpcd": "USORF",
            "pld": "CHICAGO, IL (USCHI)",
            "pldcd": "USCHI",
            "stsptime": "2023/10/16 21:29:00",
            "stspplace": "PORT KLANG - G-fortune depot",
            "fcgitime": null,
            "cggitime": null,
            "cloadtime": null,
            "cytctime": null,
            "cytcplace": null,
            "gitmtime": null,
            "gitmplace": null,
            "passtime": null,
            "passplace": null,
            "ispass": null,
            "ispreload": null,
            "lobdtime": "2023/10/24 8:49:00",
            "lobdplace": "PORT KLANG - WESTPORTS",
            "dlpttime": "2023/10/24 12:12:00",
            "dlptplace": "PORT KLANG - WESTPORTS",
            "etdpol": "2023/10/24 12:12:00",
            "trsptime": "2023/11/1 10:41:00",
            "trspplace": "SINGAPORE - PSA SINGAPORE",
            "etapld": "2023/12/12 12:00:00",
            "dschtime": null,
            "dschplace": "NORFOLK",
            "terminalpld": "",
            "terminaldtp": "NORFOLK INTERNATIONAL TERMINAL(NIT) (Firms code:L005)",
            "pickupreference": null,
            "railcode": null,
            "sealno": null,
            "csize": null,
            "ctype": null,
            "stcstime": null,
            "stcsplace": null,
            "rcvetime": null,
            "rcveplace": null,
            "currentnode": "TSDP",
            "currentnodetime": "2023/11/1 12:57:01",
            "currentnodeplace": "SINGAPORE",
            "depotcd": null,
            "depot": null,
            "terminalcd": null,
            "terminal": null,
            "vslname": "ONE EAGLE",
            "voy": "030E",
            "carriercd": "YML",
            "carrier": null,
            "updatetime": "2023/11/15 15:18:35",
            "createtime": "2023/10/24 20:45:28",
            "declarationno": null,
            "referenceno": "E470020041",
            "isctnr": "",
            "currentvslname": "ONE EAGLE",
            "currentvoy": "030E",
            "companycd": null,
            "endtime": null,
            "isendforce": null,
            "tmpstime": null,
            "istmps": null,
            "lstlinertrackingstatus": [],
            "lstlinertrackingais": [],
            "lstlinertrackingctnrinfo": [
                {
                    "keyid": "77660ca2-234f-4db5-acbd-bf8e34883722",
                    "fkeyid": "5294ee29-b4f2-47f9-a917-66ea4a641761",
                    "ctnrno": "TCNU3053817",
                    "blno": "YMJAE470020041",
                    "sealno": "YMAP326946",
                    "csize": "40",
                    "ctype": "HQ",
                    "pkgs": null,
                    "gwgt": null,
                    "currentnode": null,
                    "currentnodetime": null,
                    "createtime": "2023/11/14 22:17:49",
                    "updatetime": "2023/11/14 22:17:49",
                    "lstLinertrackingStatus": [
                        {
                            "keyid": "0d736f7b-3fc1-4092-9ec7-e4decdb37d79",
                            "fkeyid": "77660ca2-234f-4db5-acbd-bf8e34883722",
                            "blno": "E470020041",
                            "statuscd": "STSP",
                            "statedescription": "提空",
                            "statedescription_en": "Empty to Shipper",
                            "statustime": "2023/10/17 10:28:00",
                            "statusplace": "PORT KLANG - G-fortune depot",
                            "statusplacecd": "MYLPK",
                            "statusplace_cn": null,
                            "vslname": "TRUCK",
                            "voy": "",
                            "isest": "N",
                            "cancelid": null,
                            "sourcecd": "1",
                            "updatetime": "2023/11/14 22:17:49",
                            "createtime": "2023/11/14 22:17:49",
                            "transportation": "TRUCK",
                            "transportationcd": null
                        },
                        {
                            "keyid": "64f9df79-69ff-4d80-817c-a95e0dab9461",
                            "fkeyid": "77660ca2-234f-4db5-acbd-bf8e34883722",
                            "blno": "E470020041",
                            "statuscd": null,
                            "statedescription": "Received at Origin",