金蝶EAS_WebService总账_新接口开发指南（八）：使用接口查询明细分类账

栏目：eas cloud知识作者：金蝶来源：金蝶云社区发布：2024-09-22浏览：1

概述

　　有些客户想将明细分类账数据通过接口导出自动进行备份，明细分类账数据还是比较复杂的，特别是显示对方科目对方核算项目时，通过简单的脚本难以实现。为了更加方便第三方系统与EAS进行集成，简化二开开发，我们提供新接口来查询此类数据。本指南将介绍如何使用接口查询明细分类账数据。

１、如果还没有下载凭证用wsdl服务描述文件和导入架包，请参考金蝶EAS_WebService总账_新接口开发指南（二）：将凭证引入到EAS系统中文章中的第1、2步。

2、使用接口WSVoucher.nGetBalance查询明细分类账数据，以下是相关的代码片段（完整代码在附件工程中的类client.GetSubLedgerTest）：

如果看到下面类似的信息，说明查询成功：

接口的参数jsonParams它是一个Map<key, value>形式的json字符串，目前支持以下参数项：

参数名	参数值	说明
isCompress	true或false，默认为false	是否对传输的数据经过压缩处理，当值为true时，返回后使用com.kingdee.eas.fi.gl.ZipUtils.gunzip(jsonResult)进行解压。如果传输的数据量较大（超过2000行），建义压缩处理。该工具类可以在eas\client\lib\patch\ sp-fi_gl-client.jar中找到。
rptType	SubLedger	必填，明细分类账。
companyNumber	公司编码	必填（没提供orgTreeId时），支持虚体，支持多组织，查多个时请使用;分隔。查虚体时，通常指定一个上级即可，系统会将它下面的所有实体数据汇总，如果指定多个虚体，不要出现多个同级的最上级虚体，即保证所有组织在一颗树上。另外，虚体多组织查询时，下级组织有范围过滤的作用，比如有1级组织org1，它下面有2级组织org21，org22，org23，传递org1;org21时，org22，org23将会被排除。
orgTreeId	合并范围的ID	选填，合并范围的ID，当提供合并范围时，优先使用合并范围过滤组织，否则使用companyNumber过滤组织。
unionNumber	合并单元编码	选填，合并范围下合并单元的编码，支持多个，用;分隔。
periodTypeNumber	期间类型编码	选填，默认为组织当前使用的期间类型。
fromPeriodNumber	开始期间编码	选填，如果不填，默认为公司的当前期间。
toPeriodNumber	结束期间编码	选填，如果不填，默认为公司的当前期间。
currencyNumber	币别编码	选填，空表示查询所有原币币别。
balType	1或5，默认为5	选填，1：包含未过账余额，5：过账余额。
notIncludePLVoucher	true或false，默认为false	选填，不包含结转损益凭证。
accountTableNumber	科目表编码	选填，默认为组织当前的科目表。
fromAccountNumber	开始科目编码	选填。
toAccountNumber	结束科目编码	选填。
accountNumber	科目编码	选填，支持多个，用;分隔，这个会严格匹配科目的编码，与上面的from、to有所区别，指定上级科目，目前的实现不会显示下级科目。
toAccountLevel	大于等于0的整数，默认为0	选填，科目结束级次，它起到过滤作用，0不过滤。
showOnlyLeafAccount	true或false，默认为false	选填，只显示明细科目。
showAsstDetail	true或false，默认为false	选填，显示核算项目明细。
showOppAccount	true或false，默认为false	选填，显示对方科目。
showOppAsstact	true或false，默认为false	选填，显示对方核算项目。
asstActTypes	核算项目列表	选填，可以添加多个，在下面的表格具体说明。
voucherType	凭证类型编码	选填，支持多个，用;分隔。
voucherNumber	凭证编码	选填，支持多个，用;分隔。
fromBookedDate	记账开始日期	选填，格式yyyy-MM-dd。
toBookedDate	记账结束日期	选填，格式yyyy-MM-dd。
fromBizDate	业务开始日期	选填，格式yyyy-MM-dd。
toBizDate	业务结束日期	选填，格式yyyy-MM-dd。
sourceSys	来源系统	选填，来源系统的内码，支持多个，用;分隔。
sourceType	来源类型	选填，来源类型的内码，支持多个，用;分隔。
creator	制单人	选填，制单人编码，支持多个，用;分隔。
auditor	审核人	选填，审核人编码，支持多个，用;分隔。
poster	过账人	选填，过账人编码，支持多个，用;分隔。
cashier	复核人	选填，复核人编码，支持多个，用;分隔。
description	参考消息	选填。
entryDescription	分录摘要	选填。
notShowZero	true或false，默认为false	选填，余额为零不显示。
notShowNoCurrent	true或false，默认为false	选填，无发生不显示。
notShowZeroAndNoCurrent	true或false，默认为false	选填，余额为零且无发生不显示。
showFor	true或false，默认为false	选填，是否显示原币。
showLocal	true或false，默认为false	选填，是否显示本位币。
showRpt	true或false，默认为false	选填，是否显示报告币。
showQty	true或false，默认为false	选填，是否显示数量列。
showByStandardMU	true或false，默认为false	选填，showQty为true时有效，转换为标准计量单位显示。
showPeriodSum	true或false，默认为false	选填，显示本期合计。
showYearSum	true或false，默认为false	选填，显示本年累计。
showCompanyLongNumber	true或false，默认为false	选填，显示公司长编码。
showCompanyLevel	true或false，默认为false	选填，显示公司级次。
showCompanyName	true或false，默认为false	选填，显示公司名称。
showCompanyBizUnit	true或false，默认为false	选填，显示公司是否实体。
showCurrencyNumber	true或false，默认为false	选填，显示币别编码。
showCurrencyName	true或false，默认为false	选填，显示币别名称。
showAccountName	true或false，默认为false	选填，显示科目名称。
showAccountLongName	true或false，默认为false	选填，显示科目长名称。
showAccountLevel	true或false，默认为false	选填，显示科目级次。
showAccountDc	true或false，默认为false	选填，显示科目余额方向。
showAsstActNumber	true或false，默认为false	选填，显示核算项目编码。
showAsstActLongName	true或false，默认为false	选填，显示核算项目长名称。
showVoucherId	true或false，默认为false	选填，显示凭证ID。
updateBalance	true或false，默认为false	选填，查询前是否先更新余额。
threadCount	大于等于1小于等于64的整数，默认为1	选填，查询用线程数，受系统参数 GL_RptMax_ThreadCount限制，应小于等于GL_RptMax_ThreadCount值。
asstActTypes具体项
type	核算项目类型编码	必填。
from	开始核算项目编码	选填。
to	结束核算项目编码	选填。
number	核算项目编码	选填。
standard	分类标准编码	选填。
group	分类编码	选填。

接口返回的数据也是一个Map<key, value>形式的json字符串，如果调用时参数isCompress设置为true，应先对它进行解压，它有以下项目：

项目名	项目值	说明
totalTime	长整型	后端处理总用时，单位毫秒。
errs	List<String>	错误信息，它是过滤条件的校验信息，如果校验失败（也就是说errs有数据），则不会进行查询处理。它的格式为：key[value]:错误信息。
rows	List<List<String>>	明细分类账数据列表。
batchNames	List<String>	分批名列表，明细分类账数据可能量比较大，后台会将数据进行分批，如果返回值有内容，你需要进行批次查询，分批大小由系统参数GL_RptMax_BatchSize决定，单位为万行。服务端分批时，是将数据缓存到文件系统上，所以一旦返回分批名称，请一定要执行批次查询，要不然分批缓存将无法清除。

批次查询也是调用同样的接口，只是参数不同：

参数名	参数值	说明
isCompress	true或false，默认为false	是否对返回的数据进行压缩。
rptType	getBatch	必填。
batchName	批次名	必填。

下面是明细分类账的数据项目说明：

项目名	说明
accountNumber	科目编码
accountName	科目名称
accountLongName	科目长名称
accountLevel	科目级次
accountDc	科目余额方向
bookedDate	记账日期
bizDate	业务日期
companyNumber	公司编码
companyLongNumber	公司长编码
companyName	公司名称
companyLevel	公司级次
isBizUnit	是否实体
voucherId	凭证ID
voucherType	凭证类型
voucherNumber	凭证号
description	摘要
creatorName	制单人
currencyNumber	币别编码
currencyName	币别名称
asstAct1	核算项目1
asstAct2	核算项目2
asstAct3	核算项目3
...	...
oppAccountNumber	对方科目编码
oppAccountName	对方科目名称
oppAccountLongName	对方科目长名称
oppDescription	对方摘要
oppAsstAct1	对方核算项目1
oppAsstAct1	对方核算项目2
oppAsstAct1	对方核算项目3
...	...
debitFor	本期借方(原币)
creditFor	本期贷方(原币)
endBalanceFor	期未余额(原币)
debitLocal	本期借方(本位币)
creditLocal	本期贷方(本位币)
endBalanceLocal	期未余额(本位币)
debitRpt	本期借方(报告币)
creditRpt	本期贷方(报告币)
endBalanceRpt	期未余额(报告币)
measureUnitName	计量单位名称
debitQty	本期借方数量
creditQty	本期贷方数量
endQty	期未数量

版本迭代说明（不完全统计，新的在上）：

补丁号（EAS861）	发布时间	更新内容
PT168486	2022-10-28	修正明细分类账分页查询行数不准的问题。增加凭证ID的输出。
PT168279	2022-10-14	凭证的计量单位都显示实际的计量单位。虚体查询时增加限制只允许出现一颗组织树。查询结果增加输出组织的最高级次companyTopLevel。权限校验优化。
PT168028	2022-09-23	明细分类账支持分页取数。增加按合并范围过滤组织。
PT167546	2022-08-26	首次发布
补丁号（EAS850）	发布时间	更新内容
PT168509	2022-10-28	修正明细分类账分页查询行数不准的问题。增加凭证ID的输出。
PT167841	2022-10-14	凭证的计量单位都显示实际的计量单位。虚体查询时增加限制只允许出现一颗组织树。查询结果增加输出组织的最高级次companyTopLevel。权限校验优化。
PT167317	2022-09-23	明细分类账支持分页取数。增加按合并范围过滤组织。
PT167540	2022-08-26	首次发布
补丁号（EAS820）	发布时间	更新内容
PT168617	2022-10-28	修正明细分类账分页查询行数不准的问题。增加凭证ID的输出。
PT168234	2022-10-14	凭证的计量单位都显示实际的计量单位。虚体查询时增加限制只允许出现一颗组织树。查询结果增加输出组织的最高级次companyTopLevel。权限校验优化。
PT168049	2022-09-23	明细分类账支持分页取数。增加按合并范围过滤组织。
PT166472	2022-08-26	首次发布
补丁号（EAS810）	发布时间	更新内容
?	?	未发布
补丁号（EAS800）	发布时间	更新内容
PT168709	2022-10-28	修正明细分类账分页查询行数不准的问题。增加凭证ID的输出。凭证的计量单位都显示实际的计量单位。虚体查询时增加限制只允许出现一颗组织树。查询结果增加输出组织的最高级次companyTopLevel。权限校验优化。
PT167703	2022-09-22	明细分类账支持分页取数。增加按合并范围过滤组织。
PT167362	2022-08-26	首次发布