一. 前言
今天我們繼續來分析用友系列的第二個產品–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經歷和生活感悟的程序員。
本站聲明:網站內容來源於博客園,如有侵權,請聯繫我們,我們將及時處理
【其他文章推薦】
※廣告預算用在刀口上，台北網頁設計公司幫您達到更多曝光效益
※別再煩惱如何寫文案,掌握八大原則!
※教你寫出一流的銷售文案?
※超省錢租車方案
※廣告預算用在刀口上，台北網頁設計公司幫您達到更多曝光效益
※產品缺大量曝光嗎?你需要的是一流包裝設計!
