集合总账开发指南的重要更新，

 带你快速了解开发规则与技巧，

 推荐收藏，回看不迷路~

科目余额API接口

产品版本：V5.0.020及之后

系统已在开发平台预置了余额取数接口服务，可直接使用。详细使用可以参考API文档。

API服务路径：开放平台–>API管理列表–>财务云–>总账–>余额接口–>getBalance
请求url格式: https://xxx.kdcloud.com/test/kapi/v2/gl/getBalanceApi

产品版本：V5.0.020之前

需要自己新建API服务。

API服务路径：开放平台–>其他–>API服务管理1.0

现金流量余额API接口

产品版本：V5.0.020及之后

系统已在开发平台预置了余额取数接口服务，可直接使用。详细使用可以参考API文档。

API服务路径：开放平台–>API管理列表–>财务云–>总账–>余额接口–>getCashflow 现金流量接口

请求url格式: https://xxx.kdcloud.com/test/kapi/v2/gl/getBalanceApi

产品版本：V5.0.020之前

需要自己新建API服务。

API服务路径：开放平台–>其他–>API服务管理1.0

科目余额微服务接口

接口介绍：在财务项目开发过程或者第三方系统对接时，会遇到查询科目余额/核算维度余额的场景。为此提供余额接口指南，可以按照科目/核算维度的角度查询单组织某个期间的余额数据。余额接口调用通过以下微服务方式调用。

String result = DispatchServiceHelper.invokeBizService("fi", "gl", "BalanceService", "getBalance", param.toString());

会计科目使用说明

1、使用基础资料控件

• 添加基础资料控件，基础资料类型绑定【会计科目】。如果是在单据上使用并需要根据单据上某个业务日期去过滤对应版本的科目，则需要在代码中 beforeF7 时增加对应期间可用版本科目和科目表的过滤。

2、使用科目控件

• 系统已对会计科目封装为一个业务字段，在设计器业务字段可直接拉取使用。在单据中科目单选场景下，推荐使用科目控件。

3、代码查找对应版本科目

• 在很多开发场景中需要根据科目编码找到对应日期可用版本的科目，因此需要按照特定的几个查询条件进行查询，示例如下：

//假设查询科目1001对应的id 期间period：2021年5期
long orgId = 100000L;
long acctTableId = 1L;
// 财务用期间定义，也可以直接取单据对应记账日期或者业务日期进行过滤
Date enddate = period.getDate("enddate");
//当前组织可用的科目
QFilter forgId = BaseDataServiceHelper.getBaseDataFilter("bd_accountview", orgId);
//科目表过滤
QFilter faccttableId = new QFilter("accounttable", QCP.equals, acctTableId);
//科目编码
QFilter facct = new QFilter("number", QCP.equals, "1001");
//科目生效日期过滤
QFilter fdate = new QFilter("startdate", QCP.less_equals, enddate)
    .and(new QFilter("enddate", QCP.large_equals, enddate));
//查询对应日期可用科目版本id
QueryServiceHelper.queryDataSet("", "bd_accountview", "id", new QFilter[]{forgId, faccttableId, facct, fdate}, null);

• 如果知道当前科目数据masterid，也可以使用masterid进行查找，示例如下：
  

//假设查询科目1001对应的id 期间period：2021年5期
long orgId = 100000L;
long masterid = 1L;
// 财务用期间定义，也可以直接取单据对应记账日期或者业务日期进行过滤
Date enddate = period.getDate("enddate");
//当前组织可用的科目
QFilter forgId = BaseDataServiceHelper.getBaseDataFilter("bd_accountview", orgId);
//科目masterid
QFilter fmasterid = new QFilter("masterid", QCP.equals, masterid);
//科目生效日期过滤
QFilter fdate = new QFilter("startdate", QCP.less_equals, enddate)
    .and(new QFilter("enddate", QCP.large_equals, enddate));
//查询对应日期可用科目版本id
QueryServiceHelper.queryDataSet("", "bd_accountview", "id", new QFilter[]{forgId, faccttableId, facct, fdate}, null);