1、 接口说明

接口名称 根据单号查询对应物流轨迹信息
频率 实时
Method POST
Type JSON
URI /track/v1/front/getOrdersTrack

2、 接口请求

2.1、请求参数
Field 类型 长度限制 是否必填 描述
timestamp String Y 时间戳
messageId String Y 请求唯一号消息ID
trackingNos List< String > 100 Y 物流单号，最多100个
2.2、请求报文
{
  "timestamp":1503560234000,
  "messageId": "38311971988180992",
  "trackingNos": ["3676E4043665","3676E4038434","3676E4038521"] //物流单号列表
}

3、 接口响应

3.1、公共响应参数
Field 类型 最大长度 是否必填 描述
msg String Y 响应消息
code String Y 响应编码，200表示成功，500表示请求错误
body List< ILSBillEvent > Y 单号物流轨迹的详细数据
3.1.1、响应参数 ILSBillEvent
Field 类型 最大长度 是否必填 描述
consignment String Y 查询的单号
orderStatus OrderStatus Y 运单信息
billTrackList List< BillTrackList > Y 物流轨迹节点信息
3.1.2、响应参数 OrderStatus
Field 类型 最大长度 是否必填 描述
service String Y 服务提供商
despatchdepot String Y 始发点
despatchdate Date Y 始发时间
deliverydepot String Y 最新送达地点
lastscan Date Y 最新事件发生时间
status String Y 事件状态
3.1.3、响应参数 billTracks
Field 类型 最大长度 是否必填 描述
deport String Y 包裹所在地
desc String Y 事件描述(英文)
descCn String Y 事件描述(中文)
date Date Y 事件发生时间
3.2、成功响应报文
{
    "body": [
        {
            "consignment": "SYD10002991340",
            "orderStatus": {
                "Service": "Air",
                "Despatch Depot": null,
                "Despatch Date": "",
                "Port Of Delivery": null,
                "Status": "DELIVERED",
                "Lastscan": "2025-04-28 19:33:46",
                "VenderCodeAndRefCode": "Self-Support SYD10002991340"
            },
            "billTrackList": [
                {
                    "eventCode": "CREORD-ORD",
                    "id": 20488336,
                    "date": "2025-02-27 17:28:18",
                    "desc": "Order Created",
                    "descCn": "订单创建",
                    "deport": "",
                    "img": [],
                    "isDisplay": 1,
                    "refCode": "SYD10002991340"
                },
                {
                    "eventCode": "TRANITMF-LMD",
                    "id": 21583998,
                    "date": "2025-03-21 20:50:24",
                    "desc": "In transit to the next facility",
                    "descCn": "尾程服务商转运中",
                    "deport": "",
                    "img": [],
                    "isDisplay": 1,
                    "refCode": "SYD10002991340"
                },
                {
                    "eventCode": "DELDST-LMD",
                    "id": 23431140,
                    "date": "2025-04-28 19:33:46",
                    "desc": "DELIVERED",
                    "descCn": "签收",
                    "deport": "",
                    "img": [
                        "3"
                    ],
                    "isDisplay": 1,
                    "refCode": "SYD10002991340"
                }
            ],
            "msg": null
        }
    ],
    "code": 200,
    "msg": ""
}
3.3、 失败响应报文
{
    "body": null,
    "code": 50003,
    "msg": "查询的物流单号不能为空"
}

4、 物流轨迹节点

序号 ILS事件代码 描述
1 CREORD-ORD 订单已创建（生成头程单号&尾程单号）
2 CONFIRM-ORD 订单确认（客服与客户已明确订单信息）
3 PAID-ORD 订单已支付(卖家支付)
4 ERCONORD-ORD 订单异常
5 CALORD-ORD 订单取消
6 CNFORD-ORD 订单取消成功
7 ERRJTORD-ORD 订单取消失败
8 SUOPIC-HTR 物流订单推送揽收服务商
9 SUSSCH-HTR 调度成功
10 CANSCH-HTR 调度取消
11 ABNSCH-HTR 调度异常
12 ERRPIC-HTR 揽收失败
13 SUPPIC-HTR 揽收成功
14 HTBHLV-HTR 头程转运（头程国内服务商）
15 ARRHLV-HTR 到达转运站点
16 FTOHLV-HTR 航班起飞
17 FLDHLV-HTR 航班落地
18 HDLHLV-HTR 头程派件
19 HSFHLV-HTR 头程签收
20 REWWH-LHH 更换面单
21 ARRWH-LHH 仓库入库
22 LDUWH-LHH 生成舱单（装柜）
23 ECRORA-ECD 出口报关申请
24 ECCORA-ECD 出口报关完成
25 INSORA-ECD 出口报关查验
26 ERHLDORA-ECD 出口报关扣关
27 DEPORA-ITL 离开起运港
28 ARRDEA-ITL 到达目的港
29 IPCCIMP-ICC 进口预清关
30 ICCIMP-ICC 进口清关完成
31 INSIMP-ICC 进口海关查验
32 ERHLDIMP-ICC 进口清关扣关
33 ERDEYIMP-ICC 包裹销毁
34 UNPIMP-ICC 口岸拆包
35 PLDIMP-ICC 推送至尾程派送服务商
36 SCNDST-LMD 尾程服务商揽收成功
37 OFDDST-LMD 开始派送
38 PICDST-LMD 待取件
39 ATTDST-LMD 尝试派送
40 DELDST-LMD 派送完成
41 ERDELDST-LMD 妥投失败
42 ERDLYDST-LMD 妥投延迟
43 WAFPIC-LMD 等待客户上门取货
44 TRANSIT-LMD 尾程服务商转运中
45 RETURN-LMD 尾程退回
46 BOOKED-LMD 预约派送
47 WMSOUT-LHH 仓库出库
作者：ZYL  创建时间：2023-07-19 13:08
最后编辑：ZYL  更新时间：2025-12-16 17:30