获取网点信息

获取网点信息

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/wxv/waybill/netsearch

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

业务参数

参数名称 参数类型 是否必须 示例值 参数描述
need_balance bool 是否需要查询库存
limit int 单次请求数量
wp_code String 快递公司编码【delivery_id】

2. 请求示例代码(Java)

@Test  
public void netSearch() throws Exception {  

    String sellerNick = "xxx"; 
    //业务参  
    Map<String, String> data = new HashMap();  
    data.put("appid",  Config.AppId);  
    data.put("seller_nick", sellerNick);   
    Long timestamp = System.currentTimeMillis();  
    data.put("timestamp", timestamp.toString());   
    data.put("need_balance", "true"); 
      data.put("wp_code", " xxx");   
    // 参数签名  
    data.put("sign", Utils.Sign(data, Config.AppSecret));  
    String result = doHttpRequest(apiUrl, data);  
    System.out.println("result:"+result);  
}

3. 返回结果

返回结果如下

{
    "code": 0,
    "message": "获取成功",
    "data": [
        {
            "delivery_id": "ZTO",
            "acct_type": 0,
            "company_type": 1,
            "shop_id": "5009833132232",
            "acct_id": "6633676295",
            "status": 3,
            "available": 462,
            "allocated": 0,
            "recycled": 13,
            "cancel": 0,
            "monthly_card": "",
            "site_info": {
                "delivery_id": "ZTO",
                "site_status": 1,
                "site_code": "58933",
                "site_name": "东阳吴宁街道",
                "address": {
                    "city_code": "330700000",
                    "city_name": "金华市",
                    "country_code": "1",
                    "detail_address": "汉宁东路468号",
                    "district_code": "330783000",
                    "district_name": "东阳市",
                    "province_code": "330000000",
                    "province_name": "浙江省",
                    "street_code": "",
                    "street_name": ""
                },
                "contact": {
                    "mobile": "18368840xxxx",
                    "name": "xxxx",
                    "phone": "17357909xx"
                },
                "site_fullname": "浙江省金华市东阳市东阳吴宁街道"
            },
            "share": [],
            "sender_address": {
                "province": "浙江省",
                "city": "金华市",
                "county": "东阳市",
                "address": "三丰纺织"
            }
        }
    ]
}

返回code为0表示成功, 非0为失败,失败时message会有失败原因。

文档更新时间: 2025-12-29 20:23   作者:admin