1. 程式人生 > >.NetCore對接各大財務軟體憑證API——用友系列(3)

.NetCore對接各大財務軟體憑證API——用友系列(3)

## 一. 前言 由於前段時間專案比較集中,所以停更了好久,終於來到我們用友的系列產品3---U8Cloud2.7了。 一,2.7和2.5的api方式有什麼區別? 1、2.7版本以後可以直接使用u8c登入地址直接呼叫; 2、2.7版本以前的api只能走apilink上呼叫(客戶必須有公網地址),呼叫路徑如下:呼叫apilink,然後apilink呼叫客戶U8C的公網地址(沒有公網地址調不通); 二、2.7的API文件在哪? 2.7版本以及以上版本的API文件地址:http://apidoc.yyu8c.com Ps:2.7的財務系統仍然要注意: 如果不是最新補丁的話,要記得打補丁,不然後續的科目介面會有問題。 ## 二. API引數 ### 2.1 遠端訪問財務系統 如果我們對接的財務系統是公有云的U8C的話,你會得到一個遠端的財務系統的地址,接著使用UClient工具進行訪問 ### 2.2 全域性請求頭 2.7版本的請求頭和2.5的不太一樣,取消了apicode的請求方式,改為如下圖所示 ![](https://img2020.cnblogs.com/blog/1447233/202008/1447233-20200827160153699-1650628651.png) 如圖,固定的全域性請求頭引數有以下幾個: 1.contentType---請求資料型別 預設是 application/json 2.usercode---使用者.即可正常登入到財務系統的使用者名稱 3. password ---密碼。此處為MD5加密後 4. system --系統引數 具體的請求引數獲取方式可見附件 > [api請求頭引數詳情](http://apidoc.yyu8c.com/icons/apiHeader.f30fd75e.pdf) ### 2.3 基礎檔案 基礎檔案,我們主要使用到的API介面有科目查詢. ![](https://img2020.cnblogs.com/blog/1447233/202008/1447233-20200827160336200-336932273.png) 會計主體賬簿編碼--我們可以從財務系統裡獲取,具體的獲取方式如下 這些引數和2.5的api介面請求引數基本上都類似。 開啟U8Client,使用正確的使用者名稱和密碼登入財務系統.在企業建模平臺--》基礎檔案--》組織機構--》會計主體 一欄,可以看到我們使用的會計主體賬簿編碼.如我們要使用的就是40001-9999 其中40001為公司編碼,9999為會計方案.可以看到是採用分頁形式來訪問的,所以如果我們要一次性獲取到所有的會計科目,可以採用以下方法。 ```c# public AccountQueryResponse QueryAccount(string pk_subjscheme, string pageIndex, string glorgBookCode) { var request = new AccountQueryRequest(); var pms = new Dictionary(); pms.Add("pk_subjscheme", pk_subjscheme); pms.Add("glorgbookcode", glorgBookCode); pms.Add("page_now", pageIndex); pms.Add("page_size", "100"); request.SetPostParameters(pms); return _Client.Excute(request); } public List GetAccountQueryResult(string pk_subjscheme, string pageIndex, string glorgBookCode) { var list = new List(); var response = QueryAccount(pk_subjscheme, pageIndex, glorgBookCode); if (response != null && response.status == "success" && response.data != null) { var result = JsonConvert.DeserializeObject(response.data); list = result.datas == null ? new List() : result.datas.ToList().Select(x => new U8AccountResult { balanorient = x.accsubjParentVO.balanorient, subjcode = x.accsubjParentVO.subjcode, subjname = x.accsubjParentVO.subjname, dispname = x.accsubjParentVO.dispname, remcode = x.accsubjParentVO.remcode, subjId = x.accsubjParentVO.pk_accsubj, endflag = x.accsubjParentVO.endflag, subjectAssInfos = x.subjass == null ? new List() : x.subjass.ToList().Select(t => new AccSubjectAssInfo { bdcode = t.bdcode, bddispname = t.bddispname, bdname = t.bdname }).ToList() }).ToList(); } return list; } ///獲取所有的會計科目 public List GetAllAccount(string pk_subjescheme, string glorgBookCode) { var pageNo = "1"; var list = new List(); var response = QueryAccount(pk_subjescheme, pageNo, glorgBookCode); if (response != null && response.status == "success" && response.data != null) { var result = JsonConvert.DeserializeObject(response.data); var allCount = Math.Ceiling(Convert.ToDouble(result.allcount) / result.retcount); if (allCount >= 1) { for (int i = 1; i <= allCount; i++) { var resultList = GetAccountQueryResult(pk_subjescheme, i.ToString(), glorgBookCode); list.AddRange(resultList); } } } return list; } ``` allCount為總條數,retCount為當次請求的分頁條數,預設最大值為100,即介面每次只能返回100條資料,超過100條的資料量,我們就要採用分頁的形式來獲取了。 這裡,有兩個隱藏的坑需要注意一下 1.如果沒有打過類似“patch_會計科目查詢api查詢條件增加會計主體賬簿編碼”這樣的補丁,我們無法傳入會計主體賬簿編碼,就預設返回該集團下所有公司的會計科目,這樣顯然達不到我們的目的。 2.返回的會計科目中沒有輔助核算明細,這對於我們傳輸憑證也是有影響的。所以這兩個補丁,如果我們在對接的過程中發現有介面有問題,那麼就要聯絡總部的老師幫忙打相應的補丁了. [2.7補丁下載](https://files.cnblogs.com/files/wnxyz8023/%E8%A1%A5%E4%B8%81.zip) ### 2.4 總賬 總賬模組,主要是我們的憑證傳輸了. 我們先來看憑證的儲存,憑證儲存要傳入相應的憑證json串. ```c# public GL_VoucherInsertResponse InsertVoucher(List models) { var request = new GL_VoucherInsertRequest(); var pms = new Dictionary(); pms.Add("voucher", models); request.SetPostParameters(pms); return _Client.Excute(request); } ///憑證新增結果 public List GetVoucherInsertResult(List models) { var list = new List(); var response = InsertVoucher(models); if (response != null && response.status == "success") { if (response.data != null && !response.data.IsNullOrEmpty()) { var result = JsonConvert.DeserializeObject>(response.data); list = result.Select(x => new U8GLVoucherResult { explanation = x.explanation, glorgbook_code = x.glorgbook_code, glorgbook_name = x.glorgbook_name, no = x.no, pk_glorgbook = x.pk_glorgbook, pk_voucher = x.pk_voucher, totalcredit = x.totalcredit, totaldebit = x.totaldebit, pk_vouchertype = x.pk_vouchertype, vouchertype_code = x.vouchertype_code, vouchertype_name = x.vouchertype_name, prepareddate = Convert.ToDateTime(x.prepareddate), errorMsg = "" }).ToList(); } } else { list.Add(new U8GLVoucherResult { errorMsg = response.errormsg }); } return list; } ``` 借貸方,憑證字主要用於我們新增後回執進行憑證記錄的. 接著我們來看憑證儲存的實體類. ```c# public class U8VoucherModel { /// /// 是否差異憑證 ///
public bool ISDIFFLAG { get; set; } /// /// 附單據數 /// public string attachment { get; set; } public Detail[] details { get; set; } /// /// 憑證摘要 /// public string explanation { get; set; } /// /// 憑證號 /// public string no { get; set; } /// /// 公司 ///
public string pk_corp { get; set; } /// /// 賬簿 /// public string pk_glorgbook { get; set; } /// /// 制單人編碼 /// public string pk_prepared { get; set; } /// /// 憑證類別簡稱 /// public string pk_vouchertype { get; set; } /// /// 制單日期 ///
public string prepareddate { get; set; } /// /// 憑證型別 /// public int voucherkind { get; set; } } public class Detail { /// /// 原幣貸方金額 /// public string creditamount { get; set; } /// /// 貸方數量 /// public string creditquantity { get; set; } /// /// 原幣借方金額 /// public string debitamount { get; set; } /// /// 借方數量 /// public string debitquantity { get; set; } /// /// 分錄號 /// public string detailindex { get; set; } /// /// 匯率 /// public string excrate1 { get; set; } /// /// 摘要 /// public string explanation { get; set; } /// /// 本幣貸方金額 /// public string localcreditamount { get; set; } /// /// 本幣借方金額 /// public string localdebitamount { get; set; } /// /// 科目 /// public string pk_accsubj { get; set; } /// /// 幣別編碼 /// public string pk_currtype { get; set; } /// /// 單價 /// public string price { get; set; } public Ass[] ass { get; set; } public Cashflow[] cashflow { get; set; } } public class Ass { /// /// 輔助核算型別編碼 /// public string checktypecode { get; set; } /// /// 輔助核算值編碼 /// public string checkvaluecode { get; set; } } public class Cashflow { public string cashflow_code { get; set; } public string currtype_code { get; set; } public int money { get; set; } } ``` 2.7版本以上的api其實和2.5的差別不太大,除了請求頭的引數不一樣以外,各個介面的請求體引數都大致相同,且返回值的型別也一樣,所以我在處理2.7版本以上的程式集封裝處理時就顯得沒那麼困難了。 上線前才發現客戶的財務版本是2.7,本來不太想處理的,但是諮詢了用友總部的開發老師,最後還是建議要處理,因為畢竟版本不一樣,有些隱藏的東西我們可能無法預知。 所以還是建議大家,在做API開發的時候,要看清楚要對接的財務版本,可能差一個版本,就會差很多。 ## 三.結束語 好了,u8Cloud2.7以上的api處理過程就這樣愉快結束了,如果你看過上個系列的文章,會發現很多相似的地方,其實也是,畢竟都是同一個產品,只是差了2個版本一樣。希望文章對你的開發過程有幫助。也希望同樣做API對接的小夥伴,我們可以多多交流。祝你在開發的道路上勇往直前。 我是程式猿貝塔,一個分享自己對接過財務系統API經歷和生活感悟的程式設計師。 ![](https://img2020.cnblogs.com/blog/1447233/202006/1447233-20200610165721015-1848373610.gif)