跳转到内容
返回官网

运单轨迹查询接口

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

一、请求参数

请求URL:

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

公共参数

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

业务参数

参数名称参数类型是否必须示例值参数描述
logistics_codeStringshentong物流商编码;需使用【/order/logisticsCompanyList】接口响应参数中的code;
track_noString78393454运单号;可使用电子面单接口获取返回的单号查询【/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。