是否派送可达判定批量查询接口

是否派送可达判定批量查询接口

提供给商家在发货之前做截单处理，输入物流商编码和收发货地址进行可达判定，目前支持国内主流的物流服务商, 支持快运和快递两种类型 。此接口支持淘宝，拼多多查询。由于不同的电商平台的快递公司代码不同，使用此接口时，要传入电商平台的代码及快递公司代码。

1.请求参数

请求URL:

POST https://kf.fw199.com/gateway/taobao/cainiao/reachable/v2/batchjudge

2. 请求示例代码(Java)

    @Test  
public void  taobaoCaiNiaoReachableBatchjudgeV2() throws Exception {  

    String tb_seller_nick = Config.TBSellerNick ;  
    //业务参数  
    Map<String, String> data = new HashMap<String, String>();  
    data.put("appid",  Config.AppId);  
    Long timestamp = System.currentTimeMillis() / 1000;  
    data.put("timestamp", timestamp.toString());  
    data.put("tb_seller_nick", tb_seller_nick);  
    String     checkData = "{" +  
            "    \"address_and_service_list\": [{" +  
            "        \"object_id\": \"abc100\"," +  
            "        \"receive_address\": {" +  
            "            \"address_detail\": \"球场路模范二村C栋七单元158\"," +  
            "            \"area_name\": \"江岸区\"," +  
            "            \"city_name\": \"武汉市\"," +  
            "            \"province_name\": \"湖北省\"," +  
            "            \"town_name\": \"\"" +  
            "        }," +  
            "        \"send_address\": {" +  
            "            \"area_name\": \"青浦区\"," +  
            "            \"city_name\": \"上海市\"," +  
            "            \"province_name\": \"上海市\"," +  
            "            \"town_name\": \"\"" +  
            "        }" +  
            "    }" +  
            "     ]," +  
            "    \"cp_code\": \"YTO,YZXB\"" +  

            "}";  

    // 1:快递 2:快运  
   data.put("address_type", "1");  
   data.put("channel", "2");  
   data.put("data", checkData);  
    // 签名  
    data.put("sign", Utils.Sign(data,Config.AppSecret));  
    // 调用服务API  
   doHttpRequest(Config.TaobaoCaiNiaoReachableBatchjudgeV2Url ,data);  

}

说明：cp_code为快递公司代码，可以传入多个快递公司，用英文逗号隔开。典型的场景，对收发地址，根据传入多家快递公司来判断哪几家可以到达。

3. 返回结果如下：

{
    "code": 0,
    "message": "ok",
    "data": [
        {
            "success": true,
            "cp_code": "POSTB",
            "module": {
                "result_list": [
                    {
                        "success": true,
                        "module": {
                            "interrupt_apply_waybill_code": false //是否阻断 true:阻断 false:可达
                        },
                        "object_id": "abc100"
                    }
                ]
            }
        },
        {
            "success": true,
            "cp_code": "YTO",
            "module": {
                "result_list": [
                    {
                        "success": true,
                        "module": {
                            "interrupt_reason": "物流服务不支持派送,内部整顿",//阻断原因
                            "interrupt_apply_waybill_code": true // 是否阻断 true:阻断 false:可达
                        },
                        "object_id": "abc100"
                    }
                ]
            }
        }
    ],
    "trace_id": ""
}

说明： code为0表示成功，这是系统层面的成功或失败，非0为失败，对于业务层面，根据interrupt_apply_waybill_code是否真正可达来判断，true:阻断 false:可达。

4. 淘宝和拼多多快递公司代码

拼多多

淘宝