欢迎光临财务管理培训课网站,我们有专业的财务讲解人员,优质的课程能够为您解决更多的财务困惑,提供理财能力.

财务管理培训课网站

财务管理有利于我们自己更好的理财,学习到更多的财务方面的知识.

.NetCore对接各大财务软件凭证API——用友系列(2)

作者:jcmp      发布时间:2021-03-12      浏览量:0
一. 前言今天我们继续来分析用友系列的第

一. 前言

今天我们继续来分析用友系列的第二个产品--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(); 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.4 总账

总账模块,主要是我们的凭证传输了.

我们先来看凭证的保存,凭证保存要传入相应的凭证json串.

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; }

借贷方,凭证字主要用于我们新增后回执进行凭证记录的.

接着我们来看凭证保存的实体类.

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; } }

整个凭证对接下来,其实坑不是很多,主要在于前期接口文档的研究,参数的获取以及测试接口连通性上面.

三.结束语

希望文章能在你开发API接口对接的路上一些帮助和解疑,也希望同样做API对接的小伙伴,我们可以多多交流。祝你在开发的道路上勇往直前。

我是程序猿贝塔,一个分享自己对接过财务系统API经历和生活感悟的程序员。