电子面单云打印

云打印面单接口

提供给用户自主打单的服务，传入模板，面单号，以及附言等内容，蜂巢打印好的电子面单（PDF文件）会直接推送（WebSocket)给蜂巢开发者 。 如何处理推送结果见文档

1.请求参数:

POST https://kf.fw199.com/gateway/sfexpress/waybill/cloudprint

1.1 参数request_data 的说明

1.2 参数templateCode模板编码说明

1.3 参数documents模板固定字段

2. 请求示例代码(Java)

  /**
     * 云打印面单打印
     * @throws Exception
     */
    @Test
    public void cloudPrintWayBill() throws Exception {

        String result ="";

        // 单个订单时的示例
        String jsonData  = "{\"templateCode\": \"fm_76130_standard_ZLXXKWh\",  \"version\":\"1.0\",\"fileType\":\"pdf\",\"documents\": [{\"masterWaybillNo\": \"SF1303262056675\" , \"isPrintLogo\":true,\"remark\":\"下午3点后再送1\"}]}";


      // 子母件时示例
//        String jsonData  = "{" +
//                "    \"templateCode\": \"fm_76130_standard_ZLXXKWh\"," +
//                "    \"version\": \"1.0\"," +
//                "    \"fileType\": \"pdf\"," +
//                "    \"documents\": [{" +
//                "        \"masterWaybillNo\": \"SF7444432055982\"," +
//                "        \"seq\": \"1\"," +
//                "        \"sum\": \"2\"" +
//                "    }, {" +
//                "        \"masterWaybillNo\": \"SF7444432055982\"," +
//                "        \"branchWaybillNo\": \"SF7444510471516\"," +
//                "        \"seq\": \"2\"," +
//                "        \"sum\": \"2\"" +
//                "    } ]" +
//                "}";

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

        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        data.put("custom_data", "112233ks");// 自定义数据，推送时会原样返回
        data.put("request_data", jsonData);
        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": "00017A8974A5113FD3B0FFA235CC5A3F",
         "apiResultCode": "A1000",
         "apiResultData": "{\"requestId\":\"5jE0kkXBcWHWpmVtnypf\",\"success\":true}"
     },
     "trace_id": "Eftq41kKxoBRRRwIG51Z"
 }

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

4. 失败时返回结果如下：

 {
     "apiErrorMsg": "auth_error:partnerID:test010d_is_not_exist",
     "apiResponseID": "00016ABEC9ECCB3FE1C04106BA87EF3F",
     "apiResultCode": "A1011",
     "apiResultData": "{***}"
 }