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

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

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

1.请求参数

请求URL:

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

上述入参data的具体JSON格式如下：

1.1 淘宝密文可达地址查询

由于消费者隐私政策，消费者的收件人地址中的详细地址会被脱敏打星，因此需要传入oaid和订单号进行精确的判断。入参data的具体JSON格式如下:

   {
  "address_and_service_list" : [ {
    "object_id" : "abc100",
    "receive_address" : {
      "address_detail" : "丰*街道鞋都二期望**园",
      "area_name" : "鹿城区",
      "city_name" : "温州市",
      "province_name" : "浙江省",
      "town_name" : "丰门街道"
    },
    "send_address" : {
      "area_name" : "南沙区",
      "city_name" : "广州市",
      "province_name" : "广东省",
      "town_name" : "",
      "address_detail" : "塘坑村工业一路6号B区668仓库"
    },
    "order_id" : 4055784950921181018,
    "oaid" : "1INcXhYriaMA99jYdXib855sMe0J1RVdqvrCaeicv6swMeMYG6YvqceowSqYK5R87drdPia09Of"
  } ],
  "cp_code" : "STO"
}

1.2 淘宝明文可达地址查询

如果已经明确知道消费者的收件地址是明文地址，可以使用明文模式进行查询，入参data的具体JSON格式如下:

{
  "address_and_service_list" : [ {
    "object_id" : "abc100",
    "receive_address" : {
      "address_detail" : "江苏省盐城市亭湖区公园道一号20幢1003",
      "area_name" : "亭湖区",
      "city_name" : "盐城市",
      "province_name" : "江苏省",
      "town_name" : ""
    },
    "send_address" : {
      "area_name" : "南沙区",
      "city_name" : "广州市",
      "province_name" : "广东省",
      "town_name" : "",
      "address_detail" : "塘坑村工业一路6号B区668仓库"
    }
  } ],
  "cp_code" : "STO"
}

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. 淘宝和拼多多快递公司代码

拼多多

淘宝