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

海运船东支持清单跳转地址

海运跟踪状态代码跳转地址

https://trackingeyes-cn.apifox.cn/doc-5259310

📌不同场景有不同的订阅方式，请根据以下说明进行订阅

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

注意：
1.每次批量订阅时，一批次数组仅支持30条运单。
2.code=warning说明有订阅失败的运单，根据error错误代码判断原因。

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"
        }
    ]
}