总账OpenAPI接口说明

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

总账OpenAPI接口说明

概述

　　EAS系统用于凭证引入的新接口WSVoucher.nImportVoucher，除了WebService调用方式外，还提供了OpenAPI调用方式，OpenAPI方式速度和稳定性相对于WebService方式有所提升。OpenAPI和WebService后端用的是同一套实现代码，也就是说，前端传入的参数和后端返回的结果是完全一样。本指南只说明如何使用OpenAPI方式进行接口调用，参数和结果的详细说明请参考另一篇文章：金蝶EAS_WebService总账_新接口开发指南（二）：将凭证引入到EAS系统中。

1、接口说明：

1.1、String nImportVoucher(String rows, String params)

接口编码：WSVoucher-nImportVoucher

接口名称：凭证引入新接口

接口简介：将凭证引入到EAS系统中

1.2、参数

入参

rows：凭证数据，行列式的json数据

params：处理参数，键值对的json数据

出参：

result：键值对的json数据

2、编写代码（完整代码在附件工程中的类VoucherImportTest，如果服务器是公有云，请参考类VoucherImportPublicTest），使用凭证引入新接口WSVoucher.nImportVoucher引入凭证，以下是发起调用的代码片段：

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

运行后，看到这样的信息，说明有凭证引入成功。

3、参数和结果样例：

rows（凭证数据）：

[["companyNumber","voucherNumber","periodYear","periodNumber","bookedDate","bizDate","voucherType","description","voucherAbstract","creator","entrySeq","accountNumber","currencyNumber","entryDC","originalAmount","debitAmount","creditAmount","asstSeq","asstActType1","asstActNumber1","asstActName1","asstActType2","asstActNumber2","asstActName2","itemFlag","oppAccountSeq","oppAsstSeq","primaryItem","type","cashflowAmountOriginal","cashflowAmountLocal"],["ZZZ02-01","v001","2022","11","2022-11-09","2022-11-09","记记","webservice test","webservice test","lhh11","1","1001","BB01","1","10","10","","","","","","","","","0","","","","","",""],["ZZZ02-01","v001","2022","11","2022-11-09","2022-11-09","记记","webservice test","webservice test","lhh11","2","1131.01.01","BB01","0","5","","5","1","00001","1001","普通客户","物料","1101","电阻","0","","","","","",""],["ZZZ02-01","v001","2022","11","2022-11-09","2022-11-09","记记","webservice test","webservice test","lhh11","2","1131.01.01","BB01","0","5","","5","2","00001","1002","重要客户","物料","1102","电容","0","","","","","",""],["ZZZ02-01","v001","2022","11","","","","","","lhh11","1","","","","","","","","00001","1001","普通客户","物料","1101","电阻","1","2","1","CI1.01.03","2","5","5"],["ZZZ02-01","v001","2022","11","","","","","","lhh11","1","","","","","","","","00001","1002","重要客户","物料","1102","电容","1","2","2","CI1.01.03","2","5","5"]]

params（控制参数）：

{"isCompress":"true","isImpCashflow":"true","isSubmit":"true"}

result（调用结果）：

{"errs":{},"analysisTime":170,"sucs":{2:{"number":"v001","periodNumber":"202211","companyNumber":"ZZZ02-01","voucherNumber":"v001","description":"webservice test","id":"/fP5C+MEQ+q1OD9ISYQbyCZS4B4=","bizStatus":"1"}},"prepareTime":0,"totalTime":537,"saveTime":367}

4、第三方依赖包：

sp-openapi-server.jar（可以在服务端lib\patch下找到，这个要优先于openapi-server.jar ）

openapi-server.jar （可以在服务端lib\server\bos下找到）

ziputils.jar（lib\patch\sp-fi_gl-client.jar也有该包中的类）

其它的都是一些开源或容器架包。

5、凭证引出新接口WSVoucher.nExportVoucher也支持OpenAPI方式，接口的编码为WSVoucher-nExportVoucher，调用的代码类似，在附件工程中也有示例代码，参数和结果请参考：金蝶EAS_WebService总账_新接口开发指南（三）：将凭证从EAS系统引出。

6、关于公有云的一些配置，请参考：公有云OpenAPI网关配置&调用。

版本迭代说明

补丁号（800）	发布时间	更新内容
		不支持。
补丁号（800）	发布时间	更新内容
		不支持。
补丁号（850）	发布时间	更新内容
PT159633	2021-07-09	首次发布。
		如果有更新会标注在WebService的那篇文章。
补丁号（861）	发布时间	更新内容
PTM158682	2021-06-29	首次发布。
		如果有更新会标注在WebService的那篇文章。