批量运单订阅接口 - Trackingeyes-API

1.每次订阅数量限制30条。
2.code=warning说明部分失败，根据error错误代码判断原因。
3.综合接口有区分普通CT和增强版CTP，需注意参数。
3.不同的场景有不同的订阅方式，请参照下列👇订阅说明。

不同场景接口订阅类型说明

场景	订阅类型	参数说明	备注
正常订阅	提单号/订舱号/箱号订阅	referenceNo=提单号/订舱号/箱号（三选一） blType=""(BL=提单号/BK=订舱号/CN=箱号/""=自动识别) carrierCd=船东代码	blType可为空值,云当根据单号自动识别
一票多柜但只需其中一个柜子信息	提单号/订舱号+指定单箱订阅	referenceNo=提单号/订舱号（二选一） ctnrNo=指定箱号 blType=""(BL=提单号/BK=订舱号/""=自动识别) carrierCd=船东代码 extendNo={"ctnrTrackId":"Y"}	该场景需将箱号上传至ctnrNo，同时扩展字段必须按照格式上传 ctnrTrackId 参数。若需返回多个箱子信息,则需每个箱子都需按该模式分别单独订阅
中外运SINO船东	提单号订阅中外运（SINO）船东	referenceNo=提单号 blType=""(BL=提单号/""=自动识别) carrierCd=船东代码 extendNo={"ctnrNo":"其中一个箱号"}	可直接箱号订阅。若提单号订阅,扩展字段必须按照格式上传 ctnrNo 参数；若还需返回指定箱信息,则额外多上传字段 ctnrNo=指定箱号
船东官网当前状态为提货或还空动态	历史箱号订阅	referenceNo=箱号 blType=""(CN=箱号/""=自动识别) carrierCd=船东代码 extendNo={"IncludeHistoryId":"Y"}	该场景系统会自动判断为历史箱。如需历史箱数据，扩展字段必须按照格式上传 IncludeHistoryId 参数；若船东官网当前不是提货或还空，赋值该场景参数，系统自动返回当前最新动态，而非历史动态
未知船东（承运人）是谁	船东自动识别订阅 (需额外开通服务)	referenceNo=订阅号 blType=""(BL=提单号/BK=订舱号/CN=箱号/""=自动识别) carrierCd=AUTO
需通过码头数据补充放行、查验	综合接口数据订阅（船东+码头） (需额外开通服务)	referenceNo=提单号/订舱号/箱号（三选一） blType=""(BL=提单号/BK=订舱号/CN=箱号/""=自动识别) carrierCd=船东代码 polCd=起运港代码(参照云当中国港区支持清单) serviceType=CT/CTP（根据采购类型选择参数）	综合接口不支持只订阅码头数据，如仅需码头数据请使用港区数据接口；若需返回指定箱信息,则必须按照第4种类型多上传 ctnrNo 和ctnrTrackId 参数 CTP=增强版综合接口

Request

Query Params

Body Params application/json

Example

[
    {
        "localKey": "001",
        "referenceNo": "177QAZAZXTCN0541",
        "blType": "",
        "carrierCd": "MSC",
        "customerService": null,
        "noticeEmail": "张三<123456@zs.com>;李四<654321@ls.com>",
        "serviceType": "C"
    },
    {
        "localKey": "002",
        "referenceNo": "N226269468",
        "ctnrNo": "TEMU8770940",
        "blType": "",
        "carrierCd": "YML",
        "extendNo": {
            "ctnrTrackId": "Y"
        },
        "serviceType": "C"
    },
    {
        "localKey": "003",
        "referenceNo": "SNLFSKALB61601",
        "blType": "BL",
        "carrierCd": "SINO",
        "extendNo": {
            "CtnrNo": "BHCU4987386"
        },
        "serviceType": "C"
    }
]

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200成功

application/json

Bodyapplication/json

Example

{
    "code": 200,
    "type": "success",
    "message": "",
    "time": "2026-01-10 19:49:31",
    "result": [
        {
            "resultType": "订阅成功",
            "resultTypeCd": "success",
            "error": "",
            "id": "000001",
            "deliveryNo": "",
            "orderNo": "",
            "localKey": "001",
            "referenceNo": "177QAZAZXTCN0541",
            "ctnrNo": "",
            "carrierCd": "MSC",
            "trackStatus": "跟踪中",
            "trackStatusCd": "T",
            "errorMessage": "",
            "errorStatus": "",
            "billCreateTime": "2026-01-10 19:49:31",
            "dataStatus": "",
            "blType": "BL"
        },
        {
            "resultType": "订阅成功",
            "resultTypeCd": "success",
            "error": "",
            "id": "000002",
            "deliveryNo": "",
            "orderNo": "",
            "localKey": "002",
            "referenceNo": "N226269468",
            "ctnrNo": "TEMU8770940",
            "carrierCd": "YML",
            "trackStatus": "跟踪中",
            "trackStatusCd": "T",
            "errorMessage": "",
            "errorStatus": "",
            "billCreateTime": "2026-01-10 19:49:31",
            "dataStatus": "",
            "blType": "BL"
        }，
        {
            "resultType": "订阅成功",
            "resultTypeCd": "success",
            "error": "",
            "id": "000003",
            "deliveryNo": "",
            "orderNo": "",
            "localKey": "003",
            "referenceNo": "SNLFSKALB61601",
            "ctnrNo": "BHCU4987386",
            "carrierCd": "SINO",
            "trackStatus": "跟踪中",
            "trackStatusCd": "T",
            "errorMessage": "",
            "errorStatus": "",
            "billCreateTime": "2026-01-10 19:49:31",
            "dataStatus": "",
            "blType": "BL"
        }
    ]
}