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

一. 前言

今天我们继续来分析用友系列的第二个产品--U8Cloud2.5 ,apilink方式的API.官网的API文档地址如下：U8API文档 因为我们主要是凭证对接，所以使用到的模块有总账、基础档案这两个模块。

Ps:2.5的财务系统如果不是最新补丁的话，要记得打补丁，不然后续的科目接口会有问题。

二. API参数

2.1 远程访问财务系统

如果我们对接的财务系统是公有云的U8C的话，你会得到一个远程的财务系统的地址，接着使用UClient工具，即 通过集成友户通，为企业应用提供了统一的单点登陆支持，支持CA登陆、短信登陆、用户名／密码登陆，支持企业用户系统与友户通进行绑定，实现统一的用户登陆服务 的这么一个工具。

具体的添加应用的步骤为

应用.png

2.2 全局请求头

首先，我们必须要在网站内注册账号，API集市上有各个接口的详细说明，我们需要获取一个apicode参数，每个API模块在点击购买后系统会自动分配该模块的apicode，所以这也就是我们需要两个不同的apicode.

基本上U8cloud2.5的版本接口，需要涉及到的请求参数就是这个了，接着我们就可以愉快的进行开发工作了。

apicode.png

如图，固定的全局请求头参数有以下几个：

1.authoration--验证方式；默认是apicode

2.apicode---模块的apicode.也就是我们上文中购买模块后得到的参数.

3.system---系统类型. 1---测试. 2---正式.

4.trantype--翻译类型； 默认为code.即采用编码模式.

2.3 基础档案

基础档案，我们主要使用到的API接口有科目查询.

科目查询.png

会计主体账簿编码--我们可以从财务系统里获取，具体的获取方式如下

打开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