批量运单订阅接口

POST

https://api.trackingeyes.com/api/oceanbill/batchOceanBill

1.每次订阅数量限制30条。
2.code=warning说明部分失败，根据error错误代码判断原因。
3.不同的场景有不同的订阅方式，请参照下列👇订阅说明。

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

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

curl --location 'https://api.trackingeyes.com/api/oceanbill/batchOceanBill?companyCode=undefined&token=undefined&orgCode=undefined' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "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"
    }
]'

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

Modified at 2026-05-19 02:01:39

海运状态码

推送运单动态接口