金蝶EAS_WebService总账_新接口开发指南(四):基础资料查询

概述
科目和核算项目是凭证相关的比较重要的基础资料,如果想通过接口往EAS导入凭证,你需要知道EAS系统中定义了哪些科目?科目又核算了哪些核算项目类型?核算项目类型下有哪些可选的核算项目?本指南将介绍如何取得这些基础资料。
1、如果还没有下载凭证用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 | 公司编码 | 选填,要录入凭证的公司的编码,不填则默认为登录公司。 |
| asstA |
金蝶EAS_WebService总账_新接口开发指南(四):基础资料查询
声明:除非特别标注,否则均为本站原创文章,转载时请以链接形式注明文章出处。如若本站内容侵犯了原著者的合法权益,可联系本站删除。



