金蝶WebService总账接口说明.doc

金蝶EAS凭证引入 “webservice接口”说明文档作者：金向平创建日期：2005-1118确认日期：2005-1118当前版本：V1.0拷贝数量：1维护作者：吴进确认日期：20069-8当前版本：V1.1维护作者：吴进确认日期：2007115维护日期:200711-30当前版本:V5。4.0日期作者版本参考版本备注200511-18金向平V1.020069-8吴进V1。1V1。02007115吴进V5.4。0V1。1凭证引入“webservice接口”说明1. EAS发布的 webService 接口1.1 功能规划1、 如需调用凭证接口，必需先要登录EAS，先期需要调用 EASLogin 登录 EAS1.2 EASLogin 发布1、 发布 EASLogin 客户端2、 点击 EASLogin（wsdl),获取其 wsdl 地址3、 制作 bat 文件，利用第三方包，发布登录客户端代码，调用语句如下：java Djava。ext.dirs=lib org。apache。axis.wsdl.WSDL2Java http：/192。168.16.13:6888/ormrpc/services/EASLogin？wsdl4、 第三方apache包5、 代码解释：java Djava.ext.dirs=lib org.apachelib 是包放置的文件夹名1.3 EASLogin 代码调用1、 调用的各所需参数2、 所需参数： param userName 用户名String * param password 密码String param slnName easString param dcName 数据中心String * param language 语言String * param dbType 数据库类型int* param authPattern 验证方式 默认 BaseDB” ; 其他认证方式KEY可从easAuthPatterns.xml中获取String3、 参数说明a) 所传参数,如上所列，按顺序传入b) 查看EASLogin（wsdl）,有两个接口，i. 传参6个,此方式不提倡使用。为保证原有功能,服务端最后也会调用传参7个的方法,第7参数自动调用BaseDB”ii. 传参7个,如调用此方法，则需要查询easAuthPatterns。xml 文档c) 解决方案:easd) 语言：L2 简体中文L3 繁体中文e) 服务器地址 + 端口：组合成 URL f) 数据库类型：0 SQL Server1 Oracle2 DB2g) authPattern 验证方式i. 默认 ”BaseDBii. easAuthPatterns。xml 文档路径iii. easAuthPatterns.xml 文档说明4、 做一个javaBean 类，把此参数 set 到此javaBean 类中5、 登录代码a) 登录b) 登录实现2. 凭证引入接口2.1 importVoucher（凭证引入)1、 凭证引入接口，两个接口方法都可用,且用法一致2、 凭证 webService 接口生成客户端，可参考 EASLogin 方法3、 凭证引入参数：importVoucher(wsvoucher, int isVerify, int isCashflow）l 传参数第1个:WSWSVoucher 普通对象数组，见构造EAS凭证字段以及含义说明l 传参数第2个：isverify 0 不核销,暂存 1 核销,暂存 2 不核销，提交 3 核销,提交l 传参数第3个：isImpCashflow是否引入现金流量 0 不引入1 引入4、 凭证引入代码调用说明5、 返回值String是一个长度为凭证数，宽度是5的字符串数据宽度的定义:外部系统凭证号，凭证字,会计年度，会计期间，处理信息，异常信息，金蝶凭证号2.2 凭证引入原版文档如下一 “凭证引入”技术方案其他业务系统数据，传输到EAS系统服务器，通过凭证引入“webservice接口”,转化为EAS数据.其他业务系统内的资金流动信息，实时地、非人工干预的传递到EAS系统，以财务凭证的形式,转化为EAS系统内的财务信息。二 “凭证引入技术规范EAS系统提供WebService 服务,以及产生EAS财务凭证的接口，供其他业务系统调用。WebService 服务：金蝶在EAS系统上发布WebService服务，提供wsdl文件供客户端下载,其他业务系统根据下载的wsdl文件,产生客户端。EAS财务凭证的接口产生的客户端，分为两部分（java客户端举例）（1） 协议类，包名 localhost。bosws.services.WSWSVoucher协议类用于获得金蝶在EAS系统上发布WebService服务接口.本用例中为其他业务系统内的资金流动信息产生EAS财务凭证的接口。（2） JavaBean类,包名 wsvoucher.clientJavaBean类提供接口需要的参数。本用例中为EAS财务凭证需要的信息。三 “凭证导入接口”调用说明l 接口:importVoucher(wsvoucher, int isVerify, int isCashflow） l 传参数第1个：WSWSVoucher 普通对象数组，见构造EAS凭证字段以及含义说明l 传参数第2个：isverify 0 不核销,暂存 1 核销，暂存 2 不核销，提交 3 核销,提交l 传参数第3个：isImpCashflow 是否引入现金流量 0 不是 1 是四 构造EAS凭证字段以及含义说明如下：WSWSVoucher 说明：一张凭证占据的行数 = 凭证行*分录行辅助账行字体黑色：凭证头字段；深蓝：分录行字段; 橙色：辅助账字段;紫罗兰：现金流量单元格颜色:灰色 必录项 ；浅青绿：辅助账核算项目（科目多核算项目，最多8个);浅绿：现金流量字段名类型中文说明是否必录说明格式companyNumberString公司编码是录入公司编码，必须在EAS中有该编码bookedDateString记账日期是凭证的登账日期2005111bizDateString业务日期是业务发生日期2005111periodYearint会计期间-年是必须在EAS中有2005periodNumberint会计期间编码是必须在EAS中有11voucherTypeString凭证字（凭证类型）是凭证类型中文名称,必须在EAS中有记attachesint附件数量否descriptionString参考信息否voucherNumberString凭证号是凭证唯一区别1entrySeqint分录行号是当前凭证的分录唯一区别1voucherAbstractString摘要否分录摘要accountNumberString科目是分录行科目编码，必须在EAS中有1001。01currencyNumberString币种是分录行币别编码，必须在EAS中有001localRatedouble汇率否本位币汇率:没有时默认为11。01entryDCint方向是分录行方向:1 借方 1贷方originalAmountdouble原币金额是分录行原币金额qtydouble数量否分录行数量measurementString计量单位否名称，必须在EAS中有吨pricedouble单价否分录行单价debitAmountdouble借方金额是分录行借方金额:分录方向为借方时必录creditAmountdouble贷方金额是分录行贷方金额:分录方向为贷方时必录creatorString制单人是当前操作人员名称，必须在EAS中有徐晓霞posterString过账人否当前操作人员名称,必须在EAS中有auditorString审核人否当前操作人员名称，必须在EAS中有asstSeqint辅助账行号否当前凭证的当前分录的辅助账行唯一区别bizNumberString业务编号否settlementNumberString结算方式否settlementTypeString结算号否cussentint核销/挂账否默认为0，asstActType1String核算项目1否名称，必须在EAS中有。比如：客户、客户asstActNumber1String核算对象编码1否编码，必须在EAS中有。比如：客户A的编码01.01asstActName1String核算对象名称1否名称，必须在EAS中有。比如：客户A客户AasstActType2String核算项目2否以下：取决于科目是否核算多个项目，最多8个asstActNumber2String核算对象编码2否asstActName2String核算对象名称2否asstActType3String核算项目3否asstActNumber3String核算对象编码3否asstActName3String核算对象名称3否asstActType4String核算项目4否asstActNumber4String核算对象编码4否asstActName4String核算对象名称4否asstActType5String核算项目5否asstActNumber5String核算对象编码5否asstActName5String核算对象名称5否asstActType6String核算项目6否asstActNumber6String核算对象编码6否asstActName6String核算对象名称6否asstActType7String核算项目7否asstActNumber7String核算对象编码7否asstActName7String核算对象名称7否asstActType8String核算项目8否asstActNumber8String核算对象编码8否asstActName8String核算对象名称8否itemflagint现金流量标记是如引入现金流量，必设置为1oppAccountSeqint对方科目分录号是primaryItemString主表项目是EAS中必存在的主表项目supplyItemString附表项目否primaryCoefint主表系数否supplyCoefint附表系数否cashflowAmountOriginaldouble现金流量原币金额是cashflowAmountLocaldouble现金流量本位币金额是cashflowAmountRptdouble现金流量报告币金额是2 接口说明：将正确的符合条件的凭证引入到系统中,作为暂存凭证或者提交状态的凭证，错误的和不符合条件的凭证给与提示，不引入到系统。3 如果引入核销记录那么每一张凭证中，需要有往来科目，自动设置核销分录4 如果引入现金流量那么普通对象数组中，也存放现金流量数组，数组中的对象也是WSWSVoucher，与凭证行的区分标记是:itemFlag字段描述 0 不是现金流量 1 是现金流量5 返回值 String是一个长度为凭证数，宽度是5的字符串数据宽度的定义：外部系统凭证号，凭证字,年度，期间，处理信息，异常信息，金蝶凭证号1. 凭证号： 第3方系统自身产生的凭证号2. 凭证字: 第3方系统自身产生的凭证字3. 年度: 第3方系统自身产生的会计年度4. 期间: 第3方系统自身产生的会计期间5. 处理信息:6. 异常信息isVerify：应该是EAS在保存凭证时产生的异常，如校验不通过产生的提示信息等。7. 金蝶返回凭证号：EAS产生的凭证号，用于回填FreightNet系统的。8. 处理信息的定义：0000 成功 其他处理信息见后面5处理方法:将正确的符合条件的凭证、核销记录、现金流量引入，返回的信息包含全部内容;有问题的凭证，只返回凭证号和错误信息定义6 参数信息描述WSWSVoucher 一行 是一个凭证对象或者 是一个现金流量对象凭证对象行包括：凭证行、分录行、辅助账行,itemFlag = 0现金流量行包括:凭证号、分录号、现金流量行，itemFlag = 1在对象传入时，请顺序传入：比如共有5行记录，3行是凭证对象行，2行是现金流量行，那么格式如下凭证号 分录号 辅助账 现金流量（对方科目分录号） 流量标记1 1 01 2 01 3 01 1 3 11 2 3 17 其他处理信息：1000 没有凭证数据传入1001 根据传入的组织编码找不到组织1002 根据传入的科目编码找不到科目1003 根据传入的币别编码找不到币别1004 根据传入的登账日期找不到合适的期间1005 根据传入的凭证类型名称找不到凭证类型1006 所引入凭证币别,不属于本科目币别核算值1007 没有找到核算项目1008 制单人不能为空1010 凭证没有找到过账人 1111 其他异常：如保存失败，网络异常等2001 根据编码没有取得现金流量项目3001 没有权限新增凭证3003 登账日期和期间不匹配3008 组织单元的报告币折算方式没有选取3100 凭证引入重复3101 参考消息重复4001 本位币借贷不相等.4002 报告币借贷不相等。4003 凭证类型与分录科目不匹配:0（1）4004 第0条分录的第1条辅助账必须录入结算方式.4005 第0条分录的第1条辅助账非银行科目不允许录入结算方式。4006 第0条分录缺少科目。4007 同一凭证不允许同时包含表内科目与表外科目。4008 第0条分录的科目带自定义属性或核算项目,但没有辅助账.4009 第0条分录的原币金额不等于辅助账原币金额之和。4110 第0条分录的本位币金额不等于辅助账本位币金额之和.4111 第0条分录的报告币金额不等于辅助账报告币金额之和。4112 凭证的会计期间不能早于当前会计期间。4113 分账制，凭证头币种不能为空。4114 第0条分录科目“1的核算币别与分录币别“2”不一致。4115 会计期间不能为空。4116 凭证类型不能为空。4117 公司不能为空。4118 第0条分录缺少币别。4120 第0条分录缺少借贷方向。4121 第0条分录的第1条辅助账行缺少核算项目组合。4122 凭证的借方本币与凭证行不符。4123 凭证的贷方本币与凭证行不符。4124 凭证的借方报告币与凭证行不符。4125 凭证的贷方报告币与凭证行不符.4126 凭证头的行数量与凭证行不符。4128 第0条分录的第1条辅助账行缺少必录的自定义属性。4129 凭证应该至少存在两条分录.4130 第0条分录的科目“1”不是明细科目。4131 第0条分录的科目“1”已被禁用.4132 该凭证必须录入现金流量。4161 该凭证不存在或已经被删除，不能进行这项操作。4162 凭证的会计期间不能早于当前会计期间。4300 第0条分录是核销分录但没有设置核销标志。4301 第0条分录不是核销分录但设置了核销标志.4400 第0条分录的第1条辅助账是核销记录但没有设置对应的往来账记录。4401 第0条分录的第1条辅助账不是核销记录但设置了对应的往来账记录。4501 凭证有错误：04800 每张凭证至少应该有一条分录。4302 第0条分录缺少摘要。4109 第0条分录的币别与凭证头的币别不一致.4666 第0条分录的数量、金额不能全都为0。4667 第0条分录第1条辅助账的数量、金额不能全都为0。4898 第0条分录为往来科目,但它的第1条辅助账缺少到期日。4900 现金流量项目0已经被禁用!4980 第0条分录科目所属公司与凭证所属公司不一致。4345 记账日期不能为空.4346 业务日期不能为空。4347 凭证类型不能为空。4355 输入的凭证编码重复3. 凭证查询、校验、删除接口4. “凭证查询”接口说明findVoucher（String comNumber, int year， int periodNumber)l 输入:公司代码、期间年（2006）、期间月(7 )，l 输出：凭证字、凭证号、参考消息l 输出类型:String， 以“，”组合，需要拆分。l 默认查询条件：所查凭证来源系统必须为“基础系统”(查询的是先前从webService中引入的凭证，才是基础系统)l 返回类型：String#0001 未找到公司#0002 未找到期间正确结果 转账, 0001, FLY200607010015. “凭证校验接口说明checkVoucher（ String comNumber, int year， int periodNumber, String messageNumber, double localAmount)l 输入：公司代码、期间年、期间月、参考消息、本位币金额l 输出:金蝶凭证号l 输出类型:String l 默认查询条件：所查公司,必须是财务实体组织l 返回类型：String0001 未找到公司#0002 未找到期间1001 未找到符合条件的凭证正确结果 凭证号6. “凭证删除”接口说明deleteVoucher（String companyNumber, String period, String voucherNumber, String fexp )参数：String companyNumberHQF001 公司编码String period2006.09” 期间String voucherNumber20”凭证号String fexp ”000000112 参考消息返回类型:int0 成功10000 公司编码不能为空10001 未找到公司编码 10002 期间输入格式不正确 10003 凭证号不能为空10004 参考消息不能为空10005 未找到此凭证或凭证已被删除10006 凭证删除失败