查询商家和物流商的订购关系以及物流单号使用情况
查询商家和物流商的订购关系以及物流单号使用情况
本接口可以查询商家和物流商的订购关系以及物流单号使用情况
注意:logistics_code入参的是物流公司code,不是物流公司id
1.请求参数:
请求URL:
POST https://kf.fw199.com/gateway/dd/logistics/shopnetsite/list
公共参数
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
appid | String | 是 | 合作伙伴AppId | |
timestamp | String | 是 | 1657525936 | 当前Unix时间戳,秒 |
seller_nick | String | 是 | oms38173182 | 抖店的账号,对应蜂巢授权返回doudianseller字段 |
sign | String | 是 |
业务参数
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
logistics_code | String | 是 | yunda | 物流服务商编码(想获取全量物流,则传空字符串) |
2. 请求示例代码(Java)
@Test
public void LogisticsShopnetSiteList() 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", "yunda");// 获取全部,传空串
data.put("sign", Sign(data,Config.AppSecret));
// 调用服务API
String resp = doHttpRequest(Config.DDLogisticsShopnetSiteListUrl, data);
System.out.println(resp);
}
3. 返回结果如下:
{
"code":0,
"message":"ok",
"data":{
"netsites":[
{
"netsite_code":"0070149359",
"netsite_name":"",
"amount":"-1",
"sender_address":[
{
"province_name":"浙江省",
"city_name":"嘉兴市",
"district_name":"海宁市",
"street_name":"海昌街道",
"detail_address":"测试"
}
],
"allocated_quantity":19,
"cancelled_quantity":0,
"recycled_quantity":0,
"company":"suning",
"company_type":1
},
{
"netsite_code":"90000004688691",
"netsite_name":"",
"amount":"-1",
"sender_address":[
{
"province_name":"浙江省",
"city_name":"杭州市",
"district_name":"西湖区",
"street_name":"",
"detail_address":"龙湖西溪天街蓝海引擎8楼(抖音测试账号,无需上门收件)"
}
],
"allocated_quantity":15645,
"cancelled_quantity":694,
"recycled_quantity":0,
"company":"ems",
"company_type":1
},
{
"netsite_code":"JJW000020",
"netsite_name":"测试寄件网点A21",
"amount":"4295",
"sender_address":[
{
"province_name":"浙江省",
"city_name":"杭州市",
"district_name":"西湖区",
"street_name":"",
"detail_address":"龙湖西溪天街蓝海引擎8楼(抖音测试账号,无需上门收件)"
}
],
"allocated_quantity":-1,
"cancelled_quantity":-1,
"recycled_quantity":-1,
"company":"zhongyouex",
"company_type":2
},
{
"netsite_code":"9988776655",
"netsite_name":"",
"amount":"-1",
"sender_address":[
{
"province_name":"浙江省",
"city_name":"杭州市",
"district_name":"西湖区",
"street_name":"",
"detail_address":"龙湖西溪天街蓝海引擎8楼(抖音测试账号,无需上门收件)"
}
],
"allocated_quantity":1607,
"cancelled_quantity":0,
"recycled_quantity":0,
"company":"zhaijisong",
"company_type":1
},
{
"netsite_code":"NZW001273",
"netsite_name":"深圳西乡中粮部",
"amount":"500",
"sender_address":[
{
"province_name":"安徽省",
"city_name":"芜湖市",
"district_name":"鸠江区",
"street_name":"二坝镇",
"detail_address":"测试"
}
],
"allocated_quantity":0,
"cancelled_quantity":0,
"recycled_quantity":0,
"company":"NZSY",
"company_type":2
},
{
"netsite_code":"90000004688691",
"netsite_name":"",
"amount":"-1",
"sender_address":[
{
"province_name":"浙江省",
"city_name":"杭州市",
"district_name":"西湖区",
"street_name":"",
"detail_address":"龙湖西溪天街蓝海引擎8楼(抖音测试账号,无需上门收件)"
},
{
"province_name":"浙江省",
"city_name":"杭州市",
"district_name":"杭州市",
"street_name":"",
"detail_address":"互金"
}
],
"allocated_quantity":146657,
"cancelled_quantity":4139,
"recycled_quantity":0,
"company":"youzhengguonei",
"company_type":1
}
],
"logistics_code":"",
"company_type":-1
},
"trace_id":""
}
4. 返回参数说明:
说明: code为0表示成功,非0为失败,message会包含失败原因。 data字段包含商家与物流商的订购关系以及物流单号使用情况,字段说明参见文档
文档更新时间: 2023-03-14 16:52 作者:admin