用友u8远程通网页版(用友u8远程代理服务启动不了)

日期：2023年05月22日 14:43 浏览量：10

一. 前言

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

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