金蝶EAS_WebService总账_新接口开发指南（九）：使用接口查询辅助明细账

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

概述

　　辅助明细账与明细分类账是非常相像的，前者是反映核算项目维度上数据的变化，后者是应映科目维度上数据的变化，接口的调用方式，过滤条件，展示的数据结构大同小异。本指南将介绍如何使用接口查询辅助明细账数据。

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

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

以下是发起调用的代码片段：

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

3、接口的参数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	AsstactGD	必填，辅助明细账。
companyNumber	公司编码	必填（没提供orgTreeId时），支持虚体，支持多组织，查多个时请使用;分隔。查虚体时，通常指定一个上级即可，系统会将它下面的所有实体数据汇总，如果指定多个虚体，不要出现多个同级的最上级虚体，即保证所有组织在一颗树上。另外，虚体多组织查询时，下级组织有范围过滤的作用，比如有1级组织org1，它下面有2级组织org21，org22，org23，传递org1;org21时，org22，org23将会被排除。
companyDisplayMode	details或enumerate，默认details	选填，展示方式，details：平级，是指将数据直接从未级组织汇总到最上级，中间级的虚体不展示；enumerate：罗列，是指将数据分组织显示。
orgTreeId	合并范围的ID	选填，合并范围的ID，当提供合并范围时，优先使用合并范围过滤组织，否则使用companyNumber过滤组织。
unionNumber	合并单元编码	选填，合并范围下合并单元的编码，支持多个，用;分隔。
periodTypeNumber	期间类型编码	选填，默认为组织当前使用的期间类型。
fromPeriodNumber	开始期间编码	选填，如果不填，默认为公司的当前期间。
toPeriodNumber	结束期间编码	选填，如果不填，默认为公司的当前期间。
accountTableNumber	科目表编码	选填，默认为组织当前的科目表。
fromAccountNumber	开始科目编码	选填。
toAccountNumber	结束科目编码	选填。
accountNumber	科目编码	选填，支持多个，用;分隔，指定上级科目，会包含它的所有下级科目。
currencyNumber	币别编码	选填，空表示查询所有原币币别。
balType	1或5，默认为5	选填，1：包含未过账余额，5：过账余额。
notIncludePLVoucher	true或false，默认为false	选填，不包含结转损益凭证。
onlyAsstact	true或false，默认为false	选填，数据分组方式，true，只按核算项目分组，false，按核算项目+科目分组。
asstActTypes	核算项目列表	必填，可以添加多个，在下面的表格具体说明。

voucherType	凭证类型编码	选填，支持多个，用;分隔。
voucherNumber	凭证编码	选填，支持多个，用;分隔。
fromVoucherNumber	凭证开始编码	选填。
toVoucherNumber	凭证结束编码	选填。
fromBookedDate	记账开始日期	选填，格式yyyy-MM-dd。
toBookedDate	记账结束日期	选填，格式yyyy-MM-dd。
fromBizDate	业务开始日期	选填，格式yyyy-MM-dd。
toBizDate	业务结束日期	选填，格式yyyy-MM-dd。
sourceSys	来源系统	选填，来源系统的内码，支持多个，用;分隔。
sourceType	来源类型	选填，来源类型的内码，支持多个，用;分隔。
creator	制单人	选填，制单人编码，支持多个，用;分隔。
auditor	审核人	选填，审核人编码，支持多个，用;分隔。
poster	过账人	选填，过账人编码，支持多个，用;分隔。
cashier	复核人	选填，复核人编码，支持多个，用;分隔。
description	参考消息	参考消息，选填。
entryDC	1、0或空，默认为空	凭证分录的借贷方向，1，借；0，贷；空，所有。
recordDescription	辅助账摘要	辅助账摘要，选填。
recordMinAmount	辅助账最小金额	辅助账最小金额，选填。
recordMaxAmount	辅助账最大金额	辅助账最大金额，选填。

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	选填，显示公司是否实体。
showAccountName	true或false，默认为false	选填，显示科目名称。
showAccountLongName	true或false，默认为false	选填，显示科目长名称。
showAccountDc	true或false，默认为false	选填，显示科目余额方向。
showAsstActNumber	true或false，默认为false	选填，显示核算项目编码。
showAsstActLongNumber	true或false，默认为false	选填，显示核算项目长编码。
showAsstActLongName	true或false，默认为false	选填，显示核算项目长名称。
showCurrencyNumber	true或false，默认为false	选填，显示币别编码。
showCurrencyName	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	批次名	必填。

4、下面是辅助明细账的数据项目说明：

项目名	说明
asstActNumber1	核算项目1编码
asstActLongNumber1	核算项目1长编码
asstActName1	核算项目1名称
asstActLongName1	核算项目1长名称
...	...
accountNumber	科目编码
accountName	科目名称
accountLongName	科目长名称
accountDc	科目余额方向
bookedDate	记账日期
bizDate	业务日期
period	期间
companyNumber	公司编码
companyLongNumber	公司长编码
companyName	公司名称
companyLevel	公司级次
isBizUnit	是否实体
voucherId	凭证ID
voucherType	凭证类型
voucherNumber	凭证号
description	摘要
creatorName	制单人
currencyNumber	币别编码
currencyName	币别名称
debitFor	本期借方(原币)
creditFor	本期贷方(原币)
endBalanceFor	期未余额(原币)
forPrecision	原币精度
debitLocal	本期借方(本位币)
creditLocal	本期贷方(本位币)
endBalanceLocal	期未余额(本位币)
localPrecision	本位币精度
debitRpt	本期借方(报告币)
creditRpt	本期贷方(报告币)
endBalanceRpt	期未余额(报告币)
rptPrecision	报告币精度
measureUnitName	计量单位名称
debitQty	本期借方数量
creditQty	本期贷方数量
endQty	期未数量
qtyPrecision	数量精度

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

补丁号（EAS881）	发布时间	更新内容
PT174965	2023-12-22	首次发布。
补丁号（EAS861）	发布时间	更新内容
PT174763	2023-12-22	首次发布。
补丁号（EAS850）	发布时间	更新内容
PT174916	2023-12-22	首次发布。
补丁号（EAS820）	发布时间	更新内容
PT175010	2023-12-22	首次发布。
补丁号（EAS810）	发布时间	更新内容
待发布	待发布	待发布
补丁号（EAS800）	发布时间	更新内容
PT175018	2023-12-22	首次发布。