金蝶EAS_WebService总账_新接口开发指南（四）：基础资料查询
概述
科目和核算项目是凭证相关的比较重要的基础资料，如果想通过接口往EAS导入凭证，你需要知道EAS系统中定义了哪些科目？科目又核算了哪些核算项目类型？核算项目类型下有哪些可选的核算项目？本指南将介绍如何取得这些基础资料。
１、如果还没有下载凭证用wsdl服务描述文件和导入架包，请参考金蝶EAS_WebService总账_新接口开发指南（二）：将凭证引入到EAS系统中文章中的第1、2步。
2、使用接口WSVoucher.nGetAccounts查询科目信息，以下是相关的代码片段（完整代码在附件工程中的类client.GetDataBaseTest）：
如果看到下面类似的信息，说明查询成功：
接口的参数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中找到。 |
| companyNumber | 公司编码 | 必填。 |
| periodNumber | 期间编码 | 选填，如果不填，默认为公司的当前期间。 |
| accountNumber | 科目编码 | 选填，支持多个，用;分隔，如果不填，将返回公司的所有科目。 |
接口返回的数据也是一个Map<key, value>形式的json字符串，如果调用时参数isCompress设置为true，应先对它进行解压，它有以下项目：
| 项目名 | 项目值 | 说明 |
| totalTime | 长整型 | 后端处理总用时，单位毫秒。 |
| errs | List<String> | 错误信息，它是过滤条件的校验信息，如果校验失败（也就是说errs有数据），则不会进行查询处理。它的格式为：key[value]:错误信息。 |
| rows | List<Map<String, String>> | 科目数据列表。 |
下面是科目的数据项目说明：
| 项目名 | 说明 |
| id | 科目ID |
| number | 科目编码 |
| name | 科目名称 |
| longNumber | 科目长编码 |
| isLeaf | 是否明细科目 |
| level | 科目级别 |
| helpCode | 助记码 |
| CAA.id | 辅助账类型的ID |
| CAA.number | 辅助账类型的编码 |
| CAA.name | 辅助账类型的名称 |
| accountTypeID.id | 科目类型的ID |
| accountTypeID.number | 科目类型的编码 |
| accountTypeID.name | 科目类型的名称 |
| accountTypeID.property | 科目类型的性质 |
| isQty | 是否数量核算 |
| AC | 是否往来核算 |
| ACNotice | 是否发送往来通知 |
| isBank | 是否银行科目 |
| isCash | 是否现金科目 |
| isCashEquivalent | 是否现金等价物 |
| DC | 科目余额方向 |
| accrualDirection | 发生额方向 |
| hasUserProperty | 是否带自定义属性 |
| bw | 是否表外科目 |
| isControl | 是否受控科目 |
| isChangeCurrency | 是否总账期未调汇 |
| isBizChangeCurrency | 是否业务期未调汇 |
| isCFreeze | 是否冻结 |
| PLType | 损益类别 |
| accountingcurrency | 外币核算类型 |
3、使用接口WSVoucher.nGetAsstActTypes查询辅助账的核算项目类型信息，以下是相关的代码片段（完整代码在附件工程中的类client.GetDataBaseTest）：
如果看到下面类似的信息，说明查询成功：
注：辅助账类型是科目的一个属性，不同的科目可能用的是同一个辅助账类型，可以将该数据缓存起来以便复用，提升性能。
接口的参数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中找到。 |
| asstAccountNumber | 辅账类型编码 | 辅账类型编码。 |
接口返回的数据也是一个Map<key, value>形式的json字符串，如果调用时参数isCompress设置为true，应先对它进行解压，它有以下项目：
| 项目名 | 项目值 | 说明 |
| totalTime | 长整型 | 后端处理总用时，单位毫秒。 |
| errs | List<String> | 错误信息，它是过滤条件的校验信息，如果校验失败（也就是说errs有数据），则不会进行查询处理。它的格式为：key[value]:错误信息。 |
| rows | List<Map<String, String>> | 核算项目类型数据列表。 |
下面是核算项目类型的数据项目说明：
| 项目名 | 说明 |
| id | 核算项目类型ID |
| number | 核算项目类型编码 |
| name | 核算项目类型名称 |
| isMultilevel | 是否多级 |
| useLongNumber | 是否使用长编码 |
| isQty | 是否数量核算 |
| asstHGAttribute | 在横表中的属性名 |
| mappingFieldName | 在横表中的字段名 |
| realtionDataObject | 核算项目类型源表 |
| groupTableName | 分组表名 |
| groupMappingFieldName | 分组表字段名 |
| glAsstActTypeGrp.id | 自定义核算项目类别ID（如果是自定义核算项目类型） |
| glAsstActTypeGrp.number | 自定义核算项目类别编码（如果是自定义核算项目类型） |
| glAsstActTypeGrp.name | 自定义核算项目类别名称（如果是自定义核算项目类型） |
| measureUnit.id | 计量单位ID |
| measureUnit.number | 计量单位编码 |
| measureUnit.name | 计量单位名称 |
| company.id | 创建公司ID |
| company.number | 创建公司编码 |
| company.name | 创建公司名称 |
4、使用接口WSVoucher.nGetAsstActs查询核算项目信息，以下是相关的代码片段（完整代码在附件工程中的类client.GetDataBaseTest）：
如果看到下面类似的信息，说明查询成功：
接口的参数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中找到。 |
| companyNumber | 公司编码 | 选填，要录入凭证的公司的编码，不填则默认为登录公司。 |
| asstActTypeNumber | 核算项目类型编码 | 必填。 |
| asstActNumber | 核算项目编码 | 选填，支持多个，用;分隔，如果不填，将返回指定类型的所有核算项目。有些用户的核算项目数量巨大，如物料，可能有几十万，甚至上百万，如果不过滤可能有性能问题，目前这个简单的条件可能无法满足要求，后续可能考虑加一些其它过滤条件，比如like操作。 |
| user | 用户 | 选填，凭证的制单用户，不填则默认为登陆用户。 |
| lastUpdateTime | 最后修改时间 | 选填，过滤项，格式yyyy-MM-dd HH:mm:ss，只返回大于等于这个修改时间的资料。 |
接口返回的数据也是一个Map<key, value>形式的json字符串，如果调用时参数isCompress设置为true，应先对它进行解压，它有以下项目：
| 项目名 | 项目值 | 说明 |
| totalTime | 长整型 | 后端处理总用时，单位毫秒。 |
| errs | List<String> | 错误信息，它是过滤条件的校验信息，如果校验失败（也就是说errs有数据），则不会进行查询处理。它的格式为：key[value]:错误信息。 |
| rows | List<Map<String, String>> | 核算项目数据列表。 |
下面是核算项目的数据项目说明：
| 项目名 | 说明 |
| id | ID |
| number | 编码 |
| name | 名称 |
| ? | 核算项目类型各式各样：客户，供应商，物料，自定义等，类型不同字段会有差异，请以实际返回的结果为准。 |
版本迭代说明（不完全统计，新的在上）：
| 补丁号（EAS861） | 发布时间 | 更新内容 |
| PT169207 | 2022-12-09 | nGetAsstActs接口给（物料、客户、供应商、自定义核算项目）增加更新时间的过滤参数lastUpdateTime。 |
| PT166000 | 2022-06-17 | nGetAsstActs接口给（客户、供应商）增加状态字段的输出。 |
| PT165737 | 2022-05-20 | nGetAsstActs接口给（自定义核算项目）增加修改时间的输出。 |
| PT165367 | 2022-04-29 | nGetAsstActs接口给（物料、供应商、组织类型核算项目）增加简称输出。 |
| PT164961 | 2022-04-01 | nGetAsstActs接口给（项目、现金流量项目、组织类型核算项目、自定义核算项目、收付类别）增加displayName的输出。 |
| PT164527 | 2022-03-04 | 首次发布。 |
| 补丁号（EAS850） | 发布时间 | 更新内容 |
| PT169000 | 2022-12-09 | nGetAsstActs接口给（物料、客户、供应商、自定义核算项目）增加更新时间的过滤参数lastUpdateTime。 |
| PT166258 | 2022-06-20 | nGetAsstActs接口给（客户、供应商）增加状态字段的输出。 |
| PT165295 | 2022-05-20 | nGetAsstActs接口给（自定义核算项目）增加修改时间的输出。 |
| PT165433 | 2022-04-29 | nGetAsstActs接口给（物料、供应商、组织类型核算项目）增加简称输出。 |
| PT164066 | 2022-04-01 | nGetAsstActs接口给（项目、现金流量项目、组织类型核算项目、自定义核算项目、收付类别）增加displayName的输出。 |
| PT164516 | 2022-03-04 | 首次发布。 |
| 补丁号（EAS820） | 发布时间 | 更新内容 |
| PT169268 | 2022-12-09 | nGetAsstActs接口给（物料、客户、供应商、自定义核算项目）增加更新时间的过滤参数lastUpdateTime。 |
| PT168049 | 2022-09-23 | 首次发布。 |
| 补丁号（EAS800） | 发布时间 | 更新内容 |
| PT169270 | 2022-12-09 | nGetAsstActs接口给（物料、客户、供应商、自定义核算项目）增加更新时间的过滤参数lastUpdateTime。 |
| PT167703 | 2022-09-22 | 首次发布。 |
附件工程：
相关文章：
金蝶EAS_WebService总账_新接口开发指南（一）：环境准备
金蝶EAS_WebService总账_新接口开发指南（二）：将凭证引入到EAS系统中
金蝶EAS_WebService总账_新接口开发指南（三）：将凭证从EAS系统引出
金蝶EAS_WebService总账_新接口开发指南（四）：基础资料查询
金蝶EAS_WebService总账_新接口开发指南（五）：凭证操作
金蝶EAS_WebService总账_新接口开发指南（六）：使用接口查询科目余额
金蝶EAS_WebService总账_新接口开发指南（七）：使用接口查询核算项目余额
金蝶EAS_WebService总账_新接口开发指南（八）：使用接口查询明细分类账
金蝶EAS_WebService总账_新接口开发指南（九）：使用接口查询辅助明细账
金蝶EAS_WebService总账_新接口开发指南（四）：基础资料查询
本文2024-09-22 18:23:23发表“eas cloud知识”栏目。
本文链接：https://wenku.my7c.com/article/kingdee-eas-100461.html
