1、 API Description

Function Track shipment via order code
Frequency Real-time
Method POST
Type JSON
URI /track/v1/front/getOrdersTrack

2、 API Request

2.1、Request Parameters
Field Type Max Length Required Description
timestamp String Y Request timestamp
messageId String Y Unique request message ID
trackingNos List< String > 100 Y List of tracking numbers
(1. Both conCode & refCode are acceptable
2. Maximum 100 records per time)
2.2、Request Message Example
{
  "timestamp":1503560234000,
  "messageId": "38311971988180992",
  "trackingNos": ["3676E4043665","3676E4038434","3676E4038521"] //tracking number list
}

3、 API Response

3.1、Common Response Parameters
Field Type Max Length Required Description
msg String Y Response message
code String Y Response code:
200 - request success
500 - request error
body List< ILSBillEvent > Y Detail tracks of all order queried
3.1.1、Parameter: ILSBillEvent
Field Type Max Length Required Description
consignment String Y Each tracking number queried
orderStatus OrderStatus Y Shipment information
billTrackList List< BillTrackList > Y Logistics tracking information
3.1.2、Parameter: OrderStatus
Field Type Max Length Required Description
service String Y Service provider
despatchdepot String Y Dispatch location
despatchdate Date Y Dispatch date
deliverydepot String Y Latest location
lastscan Date Y Time of the latest event
status String Y Shipment status
3.1.3、Parameter: billTrackList
Field Type Max Length Required Description
deport String Y Location of the package
desc String Y Event description(English)
descCn String Y Event description(Chinese)
date Date Y Event occurrence date
3.2、Success Response Example
{
    "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、 Failure Response Example
{
    "body": null,
    "code": 50003,
    "msg": "查询的物流单号不能为空"
}

4、 Logistics Tracking Nodes

Index ILS Event Code Description
1 CREORD-ORD Order created (Waybill and Delivery order numbers generated)
2 CONFIRM-ORD Order confirmed (Order details confirmed by customer service and customer)
3 PAID-ORD Order paid (Seller payment)
4 ERCONORD-ORD Order exception
5 CALORD-ORD Order cancelled
6 CNFORD-ORD Order cancellation successful
7 ERRJTORD-ORD Order cancellation failed
8 SUOPIC-HTR Order pushed to headway collection service provider
9 SUSSCH-HTR Scheduling successful
10 CANSCH-HTR Scheduling cancelled
11 ABNSCH-HTR Scheduling exception
12 ERRPIC-HTR Collection failed
13 SUPPIC-HTR Collection successful
14 HTBHLV-HTR Headway transportation (Domestic service provider)
15 ARRHLV-HTR Arrived at transfer station
16 FTOHLV-HTR Flight departure
17 FLDHLV-HTR Flight landing
18 HDLHLV-HTR Headway delivery
19 HSFHLV-HTR Headway signed
20 REWWH-LHH Shipping label replacement
21 ARRWH-LHH Warehouse entry
22 LDUWH-LHH Cargo manifest generated (load into container)
23 ECRORA-ECD Export customs declaration
24 ECCORA-ECD Export customs clearance complete
25 INSORA-ECD Export customs inspection
26 ERHLDORA-ECD Export customs hold
27 DEPORA-ITL Departure from origin port
28 ARRDEA-ITL Arrival at destination port
29 IPCCIMP-ICC Import pre-clearance
30 ICCIMP-ICC Import customs clearance complete
31 INSIMP-ICC Import customs inspection
32 ERHLDIMP-ICC Import customs hold
33 ERDEYIMP-ICC Package destruction
34 UNPIMP-ICC Port deconsolidation
35 PLDIMP-ICC Order pushed to final delivery service provider
36 SCNDST-LMD Final delivery service provider collection successful
37 OFDDST-LMD Delivery started
38 PICDST-LMD Awaiting pickup
39 ATTDST-LMD Delivery attempt
40 DELDST-LMD Delivery complete
41 ERDELDST-LMD Delivery failed
42 ERDLYDST-LMD Delivery delay
43 WAFPIC-LMD Waiting for customer pickup
44 TRANSIT-LMD Final delivery service provider transit
45 RETURN-LMD Final delivery return
46 BOOKED-LMD Delivery appointment
47 WMSOUT-LHH Warehouse outbound
作者：conghui  创建时间：2024-09-12 15:12
最后编辑：conghui  更新时间：2025-12-16 17:30