金蝶EAS_WebService总账_新接口开发指南（二）：将凭证引入到EAS系统中

概述

　　我们的系统本身是有凭证引入接口的：直接接口WSVoucher.importVoucher和间接接口GLWebServiceFacade.importVoucher，并且被使用了很多年。但随着客户应用的不断深入，EAS总账作为核心财务系统的地位越来越高，原接口在有些场景下已无法满足需要，特列是大数据量导入时，容易发生内存溢出，甚至宕机。另外因为原接口的声明形式，无法扩展与重构，所以我们提供了一个新的接口WSVoucher.nImportVoucher以满足客户的需求。该接口单次可传的数据量是原接口的10倍以上，错误信息提示更加准确，速度更快，更加稳定，并且具有一定的扩展性。

1、到http://localhost:6888/ormrpc/services下载凭证用wsdl服务描述文件，这里要修改为你服务器的地址和端口，然后鼠标右键wsdl->链接另存为...

将文件后缀改为wsdl后保存到项目根目录，并生成客户端代码。

2、添加架包：在项目的根目录下建一个lib目录，然后将EAS服务端的server\lib\common\bos\common.jar，server\lib\patch\sp-fi_gl-server.jar和server\lib\common\trd\fastjson-xxx.jar拷贝到新建的lib下：

将架包引入到项目中：右键项目->Properties->Java Build Path->Libraries->Add JARs

注：附件中的示例工程并没有引入common.jar和sp-fi_gl-server.jar，而是将用到的类提取到了ziputils.jar中，引入的是ziputils.jar。另外对于JSON也可以使用其它库，如Gson，Jackson，Json-lib。

3、编写代码（完整代码在附件工程中的类client.VoucherImportTest），使用凭证引入新接口WSVoucher.nImportVoucher引入凭证，以下是发起调用的代码片段：

以下是凭证数据构造的代码片段：

凭证数据jsonRows是一个List<List<String>>形式的字符串，如果把它展开，形如一个excel表格：

构造数据时，对于非必录项或是无关项就填空字符串""即可，如果不填会造成错位。运行后，看到这样的信息，说明有凭证引入成功。

以下是本次引入的凭证信息，两条分录，分录1不带辅助账，分录2带两行辅助账：

以下是本次引入凭证的现金流量信息：

4、凭证引入新接口WSVoucher.nImportVoucher的第1个参数jsonRows，它是一个List<List<String>>形式的json字符串，所有明细项都要求是字符串，目前支持以下字段：