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

本文轉載自查看原文 2018-03-14 10:45 5667 開放API/ 微信小程序/ 飛鵝雲打印/ 小程序/ 雲打印/ 外賣小程序

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

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

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聯網則填入放置在打印機里面的手機卡號。若要該打印機在接單時自動打印小票則勾選“接單自動小票打印”復選框。

在保存時，商家后台系統在本地保存打印機信息，並調用打印框架在雲端注冊打印機。注冊成功后則會顯示雲端注冊狀態為“已注冊”。