一. 前言

今天我們繼續來分析用友系列的第二個産品--U8Cloud2.5 ,APIlink方式的API.官網的API文檔地址如下：U8API文檔 因為我們主要是憑證對接，所以使用到的模塊有總賬、基礎檔案這兩個模塊。

Ps:2.5的财務系統如果不是最新補丁的話，要記得打補丁，不然後續的科目接口會有問題。

二. API參數

2.1 遠程訪問财務系統

如果我們對接的财務系統是公有雲的U8C的話，你會得到一個遠程的财務系統的地址，接着使用UClient工具，即 通過集成友戶通，為企業應用提供了統一的單點登陸支持，支持CA登陸、短信登陸、用戶名／密碼登陸，支持企業用戶系統與友戶通進行綁定，實現統一的用戶登陸服務 的這麼一個工具。

具體的添加應用的步驟為

2.2 全局請求頭

首先，我們必須要在網站内注冊賬号，API集市上有各個接口的詳細說明，我們需要獲取一個apicode參數，每個API模塊在點擊購買後系統會自動分配該模塊的apicode，所以這也就是我們需要兩個不同的apicode.

基本上U8cloud2.5的版本接口，需要涉及到的請求參數就是這個了，接着我們就可以愉快的進行開發工作了。

如圖，固定的全局請求頭參數有以下幾個：

1.authoration--驗證方式；默認是apicode

2.apicode---模塊的apicode.也就是我們上文中購買模塊後得到的參數.

3.system---系統類型. 1---測試. 2---正式.

4.trantype--翻譯類型； 默認為code.即采用編碼模式.

2.3 基礎檔案

基礎檔案，我們主要使用到的API接口有科目查詢.

會計主體賬簿編碼--我們可以從财務系統裡獲取，具體的獲取方式如下

打開U8Client,使用正确的用戶名和密碼登錄财務系統.在企業建模平台--》基礎檔案--》組織機構--》會計主體 一欄，可以看到我們使用的會計主體賬簿編碼.如我們要使用的就是40001-9999

其中40001為公司編碼，9999為會計方案.可以看到是采用分頁形式來訪問的，所以如果我們要一次性獲取到所有的會計科目，可以采用以下方法。

public AccountQueryResponse QueryAccount(string pk_subjscheme, string pageIndex, string glorgBookCode) { var request = new AccountQueryRequest(); var pms = new Dictionary<string, object>(); 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<U8AccountResult> GetAccountQueryResult(string pk_subjscheme, string pageIndex, string glorgBookCode) { var list = new List<U8AccountResult>(); var response = QueryAccount(pk_subjscheme, pageIndex, glorgBookCode); if (response != null && response.status == "success" && response.data != null) { var result = JsonConvert.DeserializeObject<AccountQueryResult>(response.data); list = result.datas == null ? new List<U8AccountResult>() : 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<AccSubjectAssInfo>() : x.subjass.ToList().Select(t => new AccSubjectAssInfo { bdcode = t.bdcode, bddispname = t.bddispname, bdname = t.bdname }).ToList() }).ToList(); } return list; } ​ ///獲取所有的會計科目 public List<U8AccountResult> GetAllAccount(string pk_subjescheme, string glorgBookCode) { var pageNo = "1"; var list = new List<U8AccountResult>(); var response = QueryAccount(pk_subjescheme, pageNo, glorgBookCode); if (response != null && response.status == "success" && response.data != null) { var result = JsonConvert.DeserializeObject<AccountQueryResult>(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.4 總賬

總賬模塊，主要是我們的憑證傳輸了.

我們先來看憑證的保存,憑證保存要傳入相應的憑證json串.

public GL_VoucherInsertResponse InsertVoucher(List<object> models) { var request = new GL_VoucherInsertRequest(); var pms = new Dictionary<string, object>(); pms.Add("voucher", models); request.SetPostParameters(pms); return _Client.Excute(request); } ///憑證新增結果 public List<U8GLVoucherResult> GetVoucherInsertResult(List<object> models) { var list = new List<U8GLVoucherResult>(); var response = InsertVoucher(models); if (response != null && response.status == "success") { if (response.data != null && !response.data.IsNullOrEmpty()) { var result = JsonConvert.DeserializeObject<List<VoucherResult>>(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; }

借貸方,憑證字主要用于我們新增後回執進行憑證記錄的.

接着我們來看憑證保存的實體類.

public class U8VoucherModel { /// <summary> /// 是否差異憑證 /// </summary> public bool ISDIFFLAG { get; set; } /// <summary> /// 附單據數 /// </summary> public string attachment { get; set; } public Detail[] details { get; set; } /// <summary> /// 憑證摘要 /// </summary> public string explanation { get; set; } /// <summary> /// 憑證号 /// </summary> public string no { get; set; } /// <summary> /// 公司 /// </summary> public string pk_corp { get; set; } /// <summary> /// 賬簿 /// </summary> public string pk_glorgbook { get; set; } /// <summary> /// 制單人編碼 /// </summary> public string pk_prepared { get; set; } /// <summary> /// 憑證類别簡稱 /// </summary> public string pk_vouchertype { get; set; } /// <summary> /// 制單日期 /// </summary> public string prepareddate { get; set; } /// <summary> /// 憑證類型 /// </summary> public int voucherkind { get; set; } } ​ public class Detail { /// <summary> /// 原币貸方金額 /// </summary> public string creditamount { get; set; } /// <summary> /// 貸方數量 /// </summary> public string creditquantity { get; set; } /// <summary> /// 原币借方金額 /// </summary> public string debitamount { get; set; } /// <summary> /// 借方數量 /// </summary> public string debitquantity { get; set; } /// <summary> /// 分錄号 /// </summary> public string detailindex { get; set; } /// <summary> /// 彙率 /// </summary> public string excrate1 { get; set; } /// <summary> /// 摘要 /// </summary> public string explanation { get; set; } /// <summary> /// 本币貸方金額 /// </summary> public string localcreditamount { get; set; } /// <summary> /// 本币借方金額 /// </summary> public string localdebitamount { get; set; } /// <summary> /// 科目 /// </summary> public string pk_accsubj { get; set; } /// <summary> /// 币别編碼 /// </summary> public string pk_currtype { get; set; } /// <summary> /// 單價 /// </summary> public string price { get; set; } public Ass[] ass { get; set; } public Cashflow[] cashflow { get; set; } } ​ public class Ass { /// <summary> /// 輔助核算類型編碼 /// </summary> public string checktypecode { get; set; } /// <summary> /// 輔助核算值編碼 /// </summary> 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; } }

整個憑證對接下來，其實坑不是很多，主要在于前期接口文檔的研究，參數的獲取以及測試接口連通性上面.

三.結束語

希望文章能在你開發API接口對接的路上一些幫助和解疑，也希望同樣做API對接的小夥伴，我們可以多多交流。祝你在開發的道路上勇往直前。

我是程序猿貝塔，一個分享自己對接過财務系統API經曆和生活感悟的程序員。

更多精彩资讯请关注tft每日頭條，我们将持续为您更新最新资讯!