运单轨迹查询接口

查询条件:
1、必须是通过抖音电子面单获取的单号并且调用过发货接口回传的运单号才可以查询到物流轨迹。

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/dd/logistics/trackno/route

公共参数

参数名称 参数类型 是否必须 示例值 参数描述
appid String 合作伙伴AppId
timestamp String 1657525936 当前Unix时间戳,秒
seller_nick String oms38173182 抖店的账号,对应蜂巢授权返回doudianseller字段
sign String

业务参数

参数名称 参数类型 是否必须 示例值 参数描述
logistics_code String shentong 物流商编码;需使用【/order/logisticsCompanyList】接口响应参数中的code;
track_no String 78393454 运单号;可使用电子面单接口获取返回的单号查询【/logistics/newCreateOrder】或商家店铺后台查看

2. 请求示例代码(Java)

      @Test
    public void    LogisticsTraceNoTroute() throws Exception {
        Map<String, Object> data = new HashMap<String, Object>();
        data.put("appid",  Config.AppId);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("seller_nick", Config.DDSellerNick);
        data.put("logistics_code", "zhongtong");
        data.put("track_no", "75531717195834");//
        data.put("sign", Sign(data,Config.AppSecret));
        // 调用服务API
        String resp = doHttpRequest(Config.DDLogisticsTraceNoTrouteUrl, data);
        System.out.println(resp);

    }

3. 返回结果如下:

{
    "code": 0,
    "message": "ok",
    "data": {
        "route__node_list": [
            {
                "content": "配送中",
                "site_name": "北京",
                "state": "1",
                "state_description": "配送",
                "timestamp": "161324234234"
            }
        ],
        "track_info": {
            "express": "ssss",
            "track_no": "234234234"
        },
        "code": 10000,
        "msg": "success",
        "sub_code": "",
        "sub_msg": ""
    },
    "trace_id": ""
}

返回参数说明

说明: code为0表示成功,非0为失败,message会包含失败原因。可以忽略内层的code。

文档更新时间: 2023-03-14 16:53   作者:admin