运单轨迹查询接口
查询条件: 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】或商家店铺后台查看 |
二、请求示例代码
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);
}三、返回结果
{ "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。