获取网点信息

wpCode字段对应值查看文档:快递公司和快递代码

1.请求参数:

请求URL:

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

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

业务参数

参数名称 参数类型 是否必须 参数描述
brand_code String 可选 品牌编码,非必填

2. 请求示例代码(Java)

@Test  
public void waybillSearch() 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("brand_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": [
        {
            "branchCode": "440202",
            "cpCode": "shentong",
            "cpType": 2,
            "cpName": "申通快递",
            "usage": {
                "recycledQuantity": 0,
                "quantity": 144,
                "allocatedQuantity": 2364,
                "cancelQuantity": 29
            },
            "branchName": "广东广州磐石市场三十一部(440202)",
            "senderAddressList": [
                {
                    "address": {
                        "province": "广东省",
                        "town": "太和镇",
                        "city": "广州市",
                        "district": "白云区",
                        "detail": "九台路26号"
                    },
                    "phone": "17612345678",
                    "name": "坚强"
                }
            ]
        }
    ]
}

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

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