下订单

下订单

客户系统向顺丰下发订单, 系统为订单分配运单号。

1.请求参数:

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

1.1 参数request_data 的说明

1.2 参数ContactInfo的说明

1.3 参数CargoDetail 的说明

1.3 参数Service的说明

1.4 参数CustomsInfo 的说明

1.5 参数WaybillNoInfo 的说明

1.6 参数ExtraInfo 的说明

扩展字段备注

1.7 参数CustomerRightsReq 的说明

1.8 参数EquityUseInfo 的说明

2. 请求示例代码(Java)

  /**
     *  下单
     * @throws Exception
     */
    @Test
    public void createOrder() throws Exception {

        String result ="";
        String jsonData  = "{" +
                "\"cargoDetails\": [{" +
                "\"amount\": 308.0," +
                "\"count\": 1.0," +
                "\"name\": \"君宝牌地毯\"," +
                "\"unit\": \"个\"," +
                "\"volume\": 0.0," +
                "\"weight\": 0.1" +
                "}]," +
                "\"contactInfoList\": [{" +
                "\"address\": \"十堰市丹江口市公园路155号\"," +
                "\"city\": \"十堰市\"," +
                "\"company\": \"清雅轩保健品专营店\"," +
                "\"contact\": \"张三丰\"," +
                "\"contactType\": 1," +
                "\"county\": \"武当山风景区\"," +
                "\"mobile\": \"17006805888\"," +
                "\"province\": \"湖北省\"" +
                "}, {" +
                "\"address\": \"湖北省襄阳市襄城区环城东路122号\"," +
                "\"city\": \"襄阳市\"," +
                "\"contact\": \"郭襄阳\"," +
                "\"county\": \"襄城区\"," +
                "\"contactType\": 2," +
                "\"mobile\": \"18963828829\"," +
                "\"province\": \"湖北省\"" +
                "}]," +
                "\"customsInfo\": {}," +
                "\"expressTypeId\": 1," +
                "\"extraInfoList\": []," +
                "\"isOneselfPickup\": 0," +
                "\"language\": \"zh-CN\"," +
//                "\"monthlyCard\": \"75512367xxx\"," +  // 月结卡号
                "\"orderId\": \"QIAO-20200618-200\"," +
                "\"parcelQty\": 1," +
                "\"payMethod\": 1," +
                "\"totalWeight\": 6" +
                "}";


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

        //业务参数
        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": "00017A89365B933FEFF713093FC0353F",
         "apiResultCode": "A1000",
         "apiResultData": "{\"success\":true,\"errorCode\":\"S0000\",\"errorMsg\":null,\"msgData\":{\"orderId\":\"QIAO-20200618-200\",\"originCode\":\"719\",\"destCode\":\"710BF-001\",\"filterResult\":2,\"remark\":\"4:受雷雨天气影响，您的快件时效预计有所增加，带来不便请您理解！\",\"url\":null,\"paymentLink\":null,\"isUpstairs\":null,\"isSpecialWarehouseService\":null,\"mappingMark\":null,\"agentMailno\":null,\"returnExtraInfoList\":null,\"waybillNoInfoList\":[{\"waybillType\":1,\"waybillNo\":\"SF1303262056675\"}],\"routeLabelInfo\":[{\"code\":\"1000\",\"routeLabelData\":{\"waybillNo\":\"SF1303262056675\",\"sourceTransferCode\":\"719VA\",\"sourceCityCode\":\"719\",\"sourceDeptCode\":\"719J\",\"sourceTeamCode\":\"009\",\"destCityCode\":\"710\",\"destDeptCode\":\"710BF\",\"destDeptCodeMapping\":\"\",\"destTeamCode\":\"001\",\"destTeamCodeMapping\":\"\",\"destTransferCode\":\"710VA\",\"destRouteLabel\":\"710BF-001\",\"proName\":\"顺丰标快\",\"cargoTypeCode\":\"T6\",\"limitTypeCode\":\"T6\",\"expressTypeCode\":\"B1\",\"codingMapping\":\"\",\"codingMappingOut\":\"\",\"xbFlag\":\"0\",\"printFlag\":\"000000000\",\"twoDimensionCode\":\"MMM={'k1':'710VA','k2':'710BF','k3':'001','k4':'T6','k5':'SF1303262056675','k6':'','k7':'46ff3389'}\",\"proCode\":\"T6\",\"printIcon\":\"00000000\",\"abFlag\":\"\",\"destPortCode\":\"\",\"destCountry\":\"\",\"destPostCode\":\"\",\"goodsValueTotal\":\"\",\"currencySymbol\":\"\",\"cusBatch\":\"\",\"goodsNumber\":\"\",\"errMsg\":\"\",\"checkCode\":\"46ff3389\",\"proIcon\":\"\",\"fileIcon\":\"\",\"fbaIcon\":\"\",\"icsmIcon\":\"\",\"destGisDeptCode\":\"710BF\",\"newIcon\":null,\"sendAreaCode\":null,\"destinationStationCode\":null,\"sxLabelDestCode\":null,\"sxDestTransferCode\":null,\"sxCompany\":null,\"newAbFlag\":null,\"destAddrKeyWord\":null,\"rongType\":null},\"message\":\"SF1303262056675:\"}],\"contactInfoList\":null,\"sendStartTm\":null,\"customerRights\":null}}"
     },
     "trace_id": "DNkXs8WxO8CNZbLnTEGJ"
 }

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

4. 失败返回结果如下

{
    "code": 0,
    "message": "ok",
    "data": {
        "apiErrorMsg": "",
        "apiResponseID": "00017A89DB6EBB3FDAD84ED54CF5EA3F",
        "apiResultCode": "A1000",
        "apiResultData": "{\"success\":false,\"errorCode\":\"8016\",\"errorMsg\":\"重复下单\",\"msgData\":null}"
    },
    "trace_id": "gqsC38wDrmwgEEJQapJA"
}

4. 返回参数msgData说明

4.1 参数CustomerRightsResult 说明

4.2 参数CustomerRightsResult/EquityOrderResultInfo 说明

4.3 参数OrderResponse /routeLabelInfo 说明

4.4 参数OrderResponse/routeLabelInfo/routeLabelData 说明

4.4 增值服务传值说明举例

更多增值服务可见基础技术-基础资料-增值服务类别表