一. 前言

今天我们继续来分析用友系列的第二个产品--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经历和生活感悟的程序员。

.NetCore对接各大财务软件凭证API——用友系列(2)的更多相关文章

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

    一.前言 今天,我们转战用友系列的第一个产品---T+/Tplus.前两篇文章讲解分享的都是金蝶的产品,因为本身公司牵涉的业务有限,后续有金蝶其他产品的API对接业务时,会继续来分享经验. T+的AP ...

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

    一. 前言 由于前段时间项目比较集中,所以停更了好久,终于来到我们用友的系列产品3---U8Cloud2.7了. 一,2.7和2.5的api方式有什么区别? 1.2.7版本以后可以直接使用u8c登入地 ...

  3. .NetCore对接各大财务软件凭证API——金蝶系列(1)

    哈喽,又和大家见面了,虽然看文章的小伙伴不多,但是我相信总有一天,自己写的这些文章或多或少会对其他人有些帮助,让他们在相关的业务开发下能少走些弯路,那我的目的就达到了,好了,今天就正式开始我们的系列了 ...

  4. winform怎么实现财务上凭证录入和打印

    序言 现如今存在的财务软件层出不穷,怎么样让自己的业务系统与财务系统相结合,往往是很多公司头痛的问题.大多数公司也没有这个能力都去开发一套属于自己的财务软件,所以只有对接像金蝶用友这类的财务软件,花费 ...

  5. 常用财务软件:用友,金蝶,新中大,速达,管家婆,金算盘,远方,远光,金钥匙,润衡,浪潮,上海博科,易商,任我行,千方百剂,智管,小蜜蜂,SAP,ORACLE,SSA,QAD,MAPICS,JDE。

    常用财务软件:用友,金蝶,新中大,速达,管家婆,金算盘,远方,远光,金钥匙,润衡,浪潮,上海博科,易商,任我行,千方百剂,智管,小蜜蜂,SAP,ORACLE,SSA,QAD,MAPICS,JDE. 申 ...

  6. CentOS6安装各种大数据软件 第九章:Hue大数据可视化工具安装和配置

    相关文章链接 CentOS6安装各种大数据软件 第一章:各个软件版本介绍 CentOS6安装各种大数据软件 第二章:Linux各个软件启动命令 CentOS6安装各种大数据软件 第三章:Linux基础 ...

  7. Qt加载网页(加载浏览器插件)和制作托盘后台运行(南信大财务报账看号)

    程序模块要添加QNetWork和QWebKit模块: nuistfinancevideo.h文件: #ifndef NUISTFINANCEVIDEO_H #define NUISTFINANCEVI ...

  8. 为大数据软件准备JAVA、Python环境

    环境:SUSE 11 64位 安装JAVA JDK 1.确定版本.一般都是安装最新的JDK(Java SE Development Kit).个别软件和系统需要特定版本的JDK,根据实际需要下载. 2 ...

  9. CentOS6安装各种大数据软件 第四章:Hadoop分布式集群配置

    相关文章链接 CentOS6安装各种大数据软件 第一章:各个软件版本介绍 CentOS6安装各种大数据软件 第二章:Linux各个软件启动命令 CentOS6安装各种大数据软件 第三章:Linux基础 ...

随机推荐

  1. 数据库范式1NF 2NF 3NF详细阐述

    范式:关系数据库中的关系是要满足一定要求的,满足不同程度要求的不同范式.满足最低要求的叫第一范式,简称1NF ,在第一范式中满足进一步要求的为第二范式,其余以此类推.通俗来说是满足数据库关系表中的一套 ...

  2. 关于MySQL数据被删除后空间重用的问题实验

    以前知道,MySQL在通过delete语句删除数据后,空间并不会被腾出,而只是在数据文件中被标记为已删除,除非执行optimize table.前两天听说,虽然delete数据后硬盘空间不会被腾出,但 ...

  3. java中的上下问解释以及ServletContext介绍使用

    摘抄的:所谓上下文,它是用来存储系统的一些初始化信息,例如在jboss中通过配置文件指定了数据源,那么在jboss启动的时候就把这个文件的相关信息上下文中,于是在我们使用这个数据源的时候,就需要先获得 ...

  4. 四、HTML属性—— HTML 元素提供的附加信息

    HTML属性 (1)属性一般描述于开始标签 (2)属性总是以名称/值对的形式出现,比如:name="value" (3)使用小写属性 HTML属性值 应该始终被包括在引号内. —— ...

  5. poi--读取不同类型的excel表格

    要想根据不同类型excel表格获取其数据,就要先判断其表格类型 poi-api种方法: getCellType    public int getCellType()        Return th ...

  6. FPGA内部硬件结构简介

    我们知道FPGA内部有很多可供用户任意配置的资源,其中包括:可编程逻辑.可编程I/O.互连线.IP核等资源,很多学过数字电路的人都知道与或非门可以构成几乎所有的数字电路,但是FPGA内部最基本的主要单 ...

  7. 洛谷 P1352 没有上司的舞会 树形DP板子

    luogu传送门 题目描述: 某大学有n个职员,编号为1~n. 他们之间有从属关系,也就是说他们的关系就像一棵以校长为根的树,父结点就是子结点的直接上司. 现在有个周年庆宴会,宴会每邀请来一个职员都会 ...

  8. Mysql面试的技术名词

    面试的技术名词 面试一般会遇到一些名词,其实可能自己都知道其中的道理,但是因为没了解过,当时心里就一句WC,然后弱弱答一句:不好意思这个我只是听过,具体还没了解过: 回表 覆盖索引 最左前缀匹配 索引 ...

  9. 通道(Channel)的原理与获取

    通道(Channel):由 java.nio.channels 包定义 的.Channel 表示 IO 源与目标打开的连接. Channel 类似于传统的“流”.只不过 Channel 本身不能直接访 ...

  10. 中国电信中兴F412光猫——IPTV与网络单线复用

    标题: 中国电信中兴F412光猫--IPTV与网络单线复用 作者: 梦幻之心星 347369787@QQ.com 标签: [光猫, IPTV] 目录: 路由器 日期: 2019-2-30 目录 第一步 ...