Shipment Exception Alert Push API

New API

This API takes effect only after [Alert Settings] have been configured in the Trackingeyes SAAS system.

Alert takes effect: when a status event actually occurs, the alert is triggered and pushed, but only once;

Warning takes effect: when the status event has not actually occurred and the difference between the latest retrieved time and the first retrieved time exceeds the threshold, a push is triggered. After the first alert is triggered, if the time changes again and the latest status event time differs from the time at the previous alert and still satisfies the alert rule, another push is sent.

Currently supported alert types:

Alert Code	Alert Name	Repeated Alert	Alert Rule
DLPTNotice	Departure Alert	×	First time ATD is retrieved
DLPTWarning	Sailing Delay Warning	√	The difference between the latest ETD and the first ETD exceeds the threshold
TSDPWarning	Transshipment Departure Warning	√	The difference between the latest ETD and the first ETD at the transshipment port exceeds the threshold
BDARWarning	Arrival at Port of Discharge Warning	√	The difference between the latest ETA and the first ETA exceeds the threshold
PDARWarning	Arrival at Destination Warning	√	The difference between the latest arrival time at destination and the first arrival time at destination exceeds the threshold

Request

Body Params application/json

Example

{
    "noticeType": "Warning",
    "ccPerson": "",
    "sender": "service@mail.my56home.com",
    "receiver": "张三<san_zhang@net.com>",
    "title": "云当网订单提醒",
    "content": "",
    "attachment": "",
    "createTime": "2026-05-10 12:00:00",
    "basePer": "perCtnr",
    "detail": [
        {
            "messageId": "2059195591594504193",
            "localKey": "15452536176965",
            "referenceNo": "COSU456789",
            "ctnrNo": "COSU456789",
            "extendNo": "",
            "extendNo1": "",
            "message": "订阅号：COSU456789 预计开航时间发生延误，最新时间为 2026-04-27 10:00:00",
            "exceptionCd": "DLPTWarning",
            "exceptionName": "托班预警",
            "originValue": "2026-04-20 10:00:00",
            "newValue": "2026-04-27 10:00:00",
            "msgCreateTime": "202-05-10 10:00:00"
        },
        {
            "messageId": "2059195591594504192",
            "localKey": "15452536176965",
            "referenceNo": "OOCL123456",
            "ctnrNo": "COSU456789",
            "extendNo": "",
            "extendNo1": "",
            "message": "订单号：OOCL123456预计抵达时间发生延误，最新时间为 2026-05-12 10:00:00",
            "exceptionCd": "BDARWarning",
            "exceptionName": "抵达卸货港预警",
            "originValue": "2026-05-10 10:00:00",
            "newValue": "2026-05-12 10:00:00",
            "msgCreateTime": "202-05-10 10:00:00"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Shipment Exception Alert Push API

Request

Request Code Samples

Responses