.NetCore對接各大財務軟體憑證API——用友系列(3)
阿新 • • 發佈:2020-08-27
## 一. 前言
由於前段時間專案比較集中,所以停更了好久,終於來到我們用友的系列產品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