外賣小程序對接飛鵝小票打印的實現

外賣點餐在流程處理上是爭分奪秒的，大多數買家都是臨近飯點才點餐，這樣下單以後就會盼望着能儘快送到，做爲點餐流程環節一部分的小票打印也就要求越便捷越省時間越好。小票雲打印由於其小巧便捷、無線聯網、自動打印而成爲首選的外賣小程序小票打印解決方案。

酷客多外賣小程序的小票打印對接了易聯雲、飛鵝兩家，其中飛鵝小票打印機由於自帶接單語音提醒因此更受歡迎。雲打印的原理相似，對接方式大同小異。下文以飛鵝雲打印爲例詳細說明。

1. 小票雲打印的工做原理

雲打印服務商在互聯網上發佈一套開放API做爲小票雲服務，商家（從雲打印服務商）購買小票打印機後將打印機經過Wi-Fi鏈接互聯網，外賣小程序與開放API對接，完成小票打印機遠程註冊、推送待打印數據等工做。小票雲服務經過互聯網將待打印數據推送到對應的小票打印機，小票打印機打印出小票。

 

圖1 雲打印的工做原理

2. 飛鵝雲打印開放API

• 添加打印機到開發者帳戶（可批量）
• 打印訂單
• 刪除打印機（可批量）
• 修改打印機信息
• 清空待打印隊列
• 查詢訂單是否打印成功
• 查詢某臺打印機某日訂單統計數
• 查詢某臺打印機狀態

3. 對接開放API的準備工做

(1) 在飛鵝雲服務後臺註冊開發者帳戶

(2) 小票打印機接通電源，配置Wi-Fi密碼鏈接互聯網

飛鵝小票打印機接通電源後，會在小票上自動打印聯網配置的二維碼。手機改成Wi-Fi上網，用微信掃描二維碼，即出現填寫Wi-Fi密碼界面，填寫密碼後點擊「鏈接」按鈕鏈接網絡，成功後打印機會打印一張小票給出提示。

圖2 微信掃碼配置打印機Wi-Fi密碼

4. 開發對接API的框架（打印框架）

(1) 打印框架類圖

框架支持水平擴展，可適配多家雲打印開放API。對應於開放API裏面的各個方法，一對一地編寫打印框架的方法。

框架方法與開放API的交互封裝在一個通用方法裏面，傳入參數、返回數據都是泛型，在具體的業務方法裏面傳遞相應的數據類型及實參。

圖3 打印框架類圖

圖4 封裝的對接方法

(2) 通用方法

 1 /// <summary>
 2 /// 調用飛鵝接口通用方法
 3 /// </summary>
 4 /// <typeparam name="TOutData">接口返回的業務實體類型</typeparam>
 5 /// <typeparam name="TInData">接口傳入的業務實體類型</typeparam>
 6 /// <param name="apiUrl">接口Url</param>
 7 /// <param name="cityDistributionAccountOuterId">商戶編號（建立商戶帳號分配的編號），不須要時傳遞空字符串</param>
 8 /// <param name="inData">接口傳入的業務實體</param>
 9 /// <param name="isIncludeNullProperty">序列化業務實體時是否包含空值屬性</param>
10 /// <param name="needEscapeParameterValue">是否須要對參數值進行Url轉義，默認不須要</param>
11 /// <returns></returns>
12 public IApiResult<TOutData> CallFeiEApi<TOutData>(string apiUrl, string method, Dictionary<string, string> methodParameters, bool isIncludeNullProperty = true, bool needEscapeParameterValue = false)
13 {
14     ApiResult<TOutData> apiResult = new ApiResult<TOutData>();
15     ApiParameterContainer apiParameterContainer = null;
16 
17     try
18     {
19         string unixTimestamp = HttpAgent.GetUnixTimestamp(DateTime.Now);
20         apiParameterContainer = new ApiParameterContainer(unixTimestamp)
21         {
22             AppId = appId,
23             AppKey = appKey,
24             Signature = ComputeSign(appId, appKey, unixTimestamp),
25             ApiMethod = method
26         };
27 
28         if (methodParameters != null && methodParameters.Count > 0)
29         {
30             foreach (var methodParameter in methodParameters)
31             {
32                 if (!apiParameterContainer.Parameters.ContainsKey(methodParameter.Key))
33                 {
34                     apiParameterContainer.Parameters.Add(methodParameter.Key, methodParameter.Value);
35                 }
36             }
37         }
38 
39         //
40         // 調用接口，獲取返回值
41         //
42         string responseText = HttpAgent.DoPost(apiUrl, apiParameterContainer.Parameters, needEscapeParameterValue, "application/x-www-form-urlencoded");
43 
44         //
45         // 提取返回數據
46         //
47         apiResult = JsonConvert.DeserializeObject<ApiResult<TOutData>>(responseText);
48     }
49     catch (Exception ex)
50     {
51         Log(string.Format("調用飛鵝接口出錯，Url：{0}，傳入數據：{1}，錯誤：{2}", apiUrl, JsonConvert.SerializeObject(apiParameterContainer, Formatting.None), ex.ToString()));
52     }
53 
54     return apiResult;
55 }

 其中，ComputeSign()方法使用開發者Key計算出接口請求的哈希值，具體哈希算法由每一個雲打印服務商指定。HttpAgent.DoPost()方法將數據轉換爲表單鍵值對序列形式發起POST請求，注意必須指定Web請求的ContentType標頭爲「application/x-www-form-urlencoded」，不然沒法正常使用開放API。

5. 在業務系統裏使用打印框架

(1) 商家填寫並註冊打印機

商家從打印機的機身標籤查找編號、識別碼，填入表單，自定義一個打印機名稱以便於區分多臺打印機，若是須要使用GPRS聯網則填入放置在打印機裏面的手機卡號。若要該打印機在接單時自動打印小票則勾選「接單自動小票打印」複選框。

在保存時，商家後臺系統在本地保存打印機信息，並調用打印框架在雲端註冊打印機。註冊成功後則會顯示雲端註冊狀態爲「已註冊」。

圖5 商家填寫並註冊打印機

(2) 商家手動打印小票

商家在商家後臺系統查詢、瀏覽所接的訂單，能夠根據須要手動打印某個訂單的小票。打印時先選擇須要打印小票的一到多臺打印機，點擊「打印」按鈕調用打印框架完成打印。

圖6 商家瀏覽訂單

圖7 商家選擇打印機

6. 附錄

飛鵝雲打印開發文檔：http://www.feieyun.com/open/index.html

飛鵝雲後臺（註冊開發者）：http://admin.feieyun.com/

酷客多商家後臺：http://kukeduo.cn

 

酷客多小程序  陳蘇洲