订单收派范围查询

订单筛单（订单收派范围查询）

客户系统通过此接口向顺丰系统发送主动的筛单请求,用于判断客户的收、派地址是否属于顺丰的收派范围。

1.请求参数:

POST https://kf.fw199.com/gateway/sfexpress/order/filter

1.1 参数request_data 的说明

1.2 元素<请求> contactInfos/FilterAddrInfoDto

2. 请求示例代码(Java)

  /**
     * 订单筛选接口
     * @throws Exception
     */
    @Test
    public void filterOrder() throws Exception {

        String result ="";

        // dealType：2表示取消
        String jsonData  = "[{" +
                "\"contactInfos\": [{" +
                "\"address\": \"浙江省深圳市南山区粤海街道创智天地大厦B栋27楼南区\"," +
                "\"city\": \"深圳市\"," +
                "\"contactType\": 1," +
                "\"country\": \"中国\"," +
                "\"county\": \"\"," +
                "\"province\": \"广东省\"," +
                "\"tel\": \"4001118851\"" +
                "}, {" +
                "\"address\": \"南朗镇翠亨村101\"," +
                "\"city\": \"中山市\"," +
                "\"contactType\": 2," +
                "\"country\": \"中国\"," +
                "\"county\": \"\"," +
                "\"province\": \"广东省\"," +
                "\"tel\": \"15888888111\"" +
                "}]," +
                "\"filterType\": 1 " +
                "}]";


        CloseableHttpClient httpclient = HttpClients.createDefault();
        HttpPost httpPost = new HttpPost( Config.SFExpressFilterOrderUrl );

        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        data.put("request_data", jsonData);
        data.put("client_code",  Config.SFClientCode);
       data.put("check_word",  Config.SFCheckWord);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());

        // 参数签名
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        List<BasicNameValuePair> params = new ArrayList<BasicNameValuePair>();
        for (Map.Entry<String, String> entry : data.entrySet()) {
            params.add(new BasicNameValuePair(entry.getKey(), entry.getValue()));
        }
        //发起POST请求
        try {
            httpPost.setEntity(new UrlEncodedFormEntity(params, "UTF-8"));
            HttpResponse httpResponse = httpclient.execute(httpPost);
            if (httpResponse.getStatusLine().getStatusCode() == HttpStatus.SC_OK) {
                result =  EntityUtils.toString(httpResponse.getEntity());
            } else {
                result =  ("doPost Error Response: " + httpResponse.getStatusLine().toString());
            }
        } catch (Exception e) {
            e.printStackTrace();

        }

        System.out.println(result);

    }

3. 返回结果如下：

{
    "code": 0,
    "message": "ok",
    "data": {
        "apiErrorMsg": "",
        "apiResponseID": "00017A8A1737A83FED7F51BD7733F13F",
        "apiResultCode": "A1000",
        "apiResultData": "{\"success\":true,\"errorCode\":\"S0000\",\"errorMsg\":null,\"msgData\":[{\"orderId\":null,\"filterResult\":2,\"originCode\":\"755\",\"destCode\":\"760\",\"remark\":null}]}"
    },
    "trace_id": "SoSQonmPoFRCkHAgi98V"
}

说明： code为0表示成功，非0为失败，message会包含失败原因。

4. 元素<响应> OrderFilterResponse

4.1 返回参数msgData说明：