金蝶EAS_WebService总账_新接口开发指南（五）：凭证操作

概述

　　如果EAS总账与外部系统有交互，那么最常见的就是凭证做为外部系统单据的下游单据存在。当外部系统的单据提交或审核时，可以通过我们前面提供的接口（金蝶EAS_WebService总账_新接口开发指南（二）：将凭证引入到EAS系统中）把凭证引入到EAS系统中。当外部系统的单据有调整时，之前引入到EAS系统的凭证往往也要做出相应的调整：比如先删除，再重新引入，以保证同步。下面这个接口WSVoucher.nOperateVoucher可以处理这样的需求。

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

2、编写代码（完整代码在附件工程中的类client.VoucherOperateTest），使用凭证操作新接口WSVoucher.nOperateVoucher操作凭证，以下是参数构建和发起调用的代码片段：

以下是调用结果分析处理的代码片段：

如果看到下面类似的信息说明操作已经成功：

3、凭证操作时，系统会先使用过滤条件找到凭证，然后再执行凭证操作。接口查找凭证目前分为三种模式：ID模式、importKey模式，一般模式。ID模式，你只需要提供凭证的ID（voucherId）就行；importKey模式，你只需要提供凭证的importKey就行；一般模式，提供了组织编码（companyNumber），如果提供了组织编码，依然提供了凭证的ID或importKey，也会认为是一般模式，且voucherId，importKey仍然起作用，只不过是作为普通条件使用。voucherId，importKey或companyNumber三者至少有一个要有值。

4、凭证操作新接口WSVoucher.nOperateVoucher的参数jsonParams，它是一个Map<key, value>形式的json字符串，目前支持以下参数项：

参数名（控制）	参数值	说明
operate	submit、audit、post、antiPost、antiAudit、delete、check、antiCheck、cancel或antiCancel	对凭证执行何种操作，各参数值的意思为：提交、审核、过账、反过账、反审核、删除，复核、反复核、作废或生效。
force	true或false，默认为false	是否对凭证执行连续操作，默认情况下，只能对凭证执行一步操作，比如一个已审核的凭证，只能“反审核”或“过账”，不能直接“删除”，但是你确实需要把它删除，当参数force为true时，系统会在一个事务里，先“反审核”再“删除”。
isUseWorkflow	true或false，默认为true	是否走工作流，总账参数GL_032为否，isUseWorkflow无效；总账参数GL_032为是，isUseWorkflow为true，走工作流，isUseWorkflow为false，不走工作流。该参数主要是为了应对接口操作的凭证不走工作流，手工凭证要走工作流，该场景要求工作流流程入口做一定的区分，使接口操作的凭证不走工作流。
nCreator	制单人编码	凭证提交时的制单人编码
nAuditor	审核人编码	凭证审核时的审核人编码
nPoster	过账人编码	凭证过账时的过账人编码
nCashier	复核人编码	凭证复核时的复核人编码
参数名（过滤）	参数值	说明
voucherId	凭证ID	要操作的目标凭证的ID，可以多选，用“;”分隔。
importKey	导入Key	要操作的目标凭证的外部标识，具体意义请参考引入接口说明，可以多选，用“;”分隔。
companyNumber	公司编码	公司编码，可以多选，用“;”分隔。
voucherType	凭证类型	凭证类型，可以多选，用“;”分隔。
voucherNumber	凭证编码	凭证编码，可以多选，用“;”分隔。
fromPeriodNumber	开始期间	开始期间，如202312。
toPeriodNumber	结束期间	结束期间，如202312。
fromBookedDate	记账开始日期	记账开始日期，格式yyyy-MM-dd，如2023-12-01。
toBookedDate	记账结束日期	记账结束日期，格式yyyy-MM-dd，如2023-12-31。
fromBizDate	业务开始日期	业务开始日期，格式yyyy-MM-dd，如2023-12-01。
toBizDate	业务结束日期	业务结束日期，格式yyyy-MM-dd，如2023-12-31。
bizStatus	0、1、2、3、5或空，默认空	业务状态，可以多选，用“;”分隔，如0;1。
isCheck	true、false或空，默认空	是否复核。
creator	制单人编码	制单人编码，支持多个，用“;”分隔。
auditor	审核人编码	审核人编码，支持多个，用“;”分隔。
poster	过账人编码	过账人编码，支持多个，用“;”分隔。
cashier	复核人编码	复核人编码，支持多个，用“;”分隔。
description	参考信息	参考信息，模糊匹配。
voucherAbstract	凭证摘要	凭证摘要，模糊匹配。
sourceSys	来源系统	来源系统，可以多选，用“;”分隔，如：11，可填的值请参考com.kingdee.eas.framework.SystemEnum。
sourceType	来源类型	来源类型，可以多选，用“;”分隔，如：4，可填的值请参考com.kingdee.eas.fi.gl.SourceType。
category	1、2、3或空，默认空	凭证类别，各参数值的意思为财务凭证、预算凭证、平行记账，可以多选，用“;”分隔，只支持EAS850以上版本。
entryDescription	分录摘要	分录摘要，模糊匹配。
currency	币别编码	币别编码，支持多个，用“;”分隔。
accountNumber	科目编码	科目编码，支持多个，用“;”分隔。
fromAccount

金蝶EAS_WebService总账_新接口开发指南（五）：凭证操作

金蝶EAS_WebService总账_新接口开发指南（五）：凭证操作

相关阅读

栏目

最新发布

热门标签