查询物流跟踪信息

获取物流轨迹跟踪信息

　　　通过快递单号查询物流的轨迹信息。主要针对淘宝、天猫、1688，菜鸟系快递。

1.请求参数:

POST https://kf.fw199.com/gateway/cnlink/logistics/trace

业务参数说明

2. 请求示例代码(Java)

    @Test
    public void queryLogisticsTrace() throws Exception {

        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("cp_code","YTO" );
        data.put("waybill_code","YT7577282891100" );
       // 参数签名
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        doHttpRequest(Config.AddrResolveUrl, data);  
    }

3. 返回结果如下：

为了隐私保护，下面示例中的数据已做脱敏（打星号），实际接口返回的数据不会脱敏（打星号)

{
    "code": 0,
    "message": "ok",
    "data": {
        "lastTime": "2025-10-18T10:49:41",
        "cpTelPhoneNumber": "95554",
        "detail": [
            {
                "cpCode": "YTO",
                "cityName": "广州市",
                "opMessage": "您的快件在【广东省广州市从化区太平镇花园】已揽收，揽收人: 02414053（1768191**）【物流问题无需找商家或平台，请致电（15876269***）（专属热线:95554）更快解决】",
                "opTime": "2025-10-17 13:23:57",
                "opDesc": "已揽件",
                "addressText": "广州市",
                "opCode": "ACCEPT"
            },
            {
                "cpCode": "YTO",
                "cityName": "广州市",
                "opMessage": "您的快件离开【广东省广州市从化区太平镇花园】，已发往【广州转运中心】",
                "opTime": "2025-10-17 13:24:19",
                "opDesc": "运输中",
                "addressText": "广州市",
                "opCode": "TRANSPORT"
            },
            {
                "cpCode": "YTO",
                "cityName": "广州市",
                "opMessage": "您的快件已经到达【广州转运中心】【物流问题无需找商家或平台，请致电（专属热线:95554）更快解决】",
                "opTime": "2025-10-17 14:46:23",
                "opDesc": "运输中",
                "addressText": "广州市",
                "opCode": "TRANSPORT"
            },
            {
                "cpCode": "YTO",
                "cityName": "广州市",
                "opMessage": "您的快件离开【广州转运中心】，已发往【广东省广州市白云区鹤龙鹤丰分部】",
                "opTime": "2025-10-17 15:07:03",
                "opDesc": "运输中",
                "addressText": "广州市",
                "opCode": "TRANSPORT"
            },
            {
                "cpCode": "YTO",
                "cityName": "广州市",
                "opMessage": "您的快件已经到达【广东省广州市白云区鹤龙鹤丰分部】【物流问题无需找商家或平台，请致电（1892229****）（专属热线:95554）更快解决】",
                "opTime": "2025-10-17 18:05:26",
                "opDesc": "运输中",
                "addressText": "广州市",
                "opCode": "TRANSPORT"
            },
            {
                "cpCode": "YTO",
                "cityName": "广州市",
                "opMessage": "广东省广州市白云区鹤龙鹤丰分部 已收入",
                "opTime": "2025-10-18 08:24:30",
                "opDesc": "运输中",
                "addressText": "广东省广州市白云区鹤龙鹤丰分部",
                "opCode": "TRANSPORT"
            },
            {
                "cpCode": "YTO",
                "cityName": "广州市",
                "opMessage": "【广东省广州市白云区鹤龙鹤丰分部】的邓**（1781963***）正在派件（有事先呼我，勿找商家，少一次投诉，多一份感恩）！如有疑问请联系网点:1892229***，投诉电话:1892229***。[95161和18521号段的上海号码为圆通快递员专属号码，请放心接听]",
                "opTime": "2025-10-18 08:24:30",
                "opDesc": "派送中",
                "addressText": "广州市",
                "opCode": "DELIVERING"
            },
            {
                "cpCode": "YTO",
                "cityName": "广州市",
                "opMessage": "您的快件已投递，收件人: 门卫代收。如有疑问请联系快递员: 178196****，网点电话：18922291***，投诉电话: 18922291***。(有事先呼我，勿找商家，少一次投诉，多一份感恩）！感谢使用圆通速递，期待再次为您服务！",
                "opTime": "2025-10-18 10:49:41",
                "opDesc": "已签收",
                "addressText": "广州市",
                "opCode": "SIGN"
            }
        ],
        "lastState": "SIGN",
        "lastStateDesc": "已签收"
    },
    "trace_id": "afd971ff-18b0-4f89-a35f-08f841757ed1"
}

说明： code为0表示成功，非0为失败，message会包含失败原因。

4.　附录

4.1 快递公司代码

4.2 节点状态说明