1.应用场景:
业务系统生成的凭证,通过WEB Service方式调用EAS凭证接口,导入金蝶EAS总账系统生成凭证和现金流量,同时返回生成的凭证号。
2.技术方案
其他业务系统数据,传输到EAS系统服务器,通过凭证引入“webservice接口”,转化为EAS数据。其他业务系统内的资金流动信息,实时地、非人工干预的传递到EAS系统,以财务凭证的形式,转化为EAS系统内的财务信息
3.技术规范
EAS系统提供WebService 服务,以及产生EAS财务凭证的接口,供其他业务系统调用。WebService 服务:金蝶在EAS系统上发布WebService服务,提供wsdl文件供客户端下载,其他业务系统根据下载的wsdl文件,产生客户端。
EAS财务凭证的接口产生的客户端,分为两部分(java客户端举例)
(1)协议类 包名 localhost.bosws.services.WSWSVoucher
协议类用于获得金蝶在EAS系统上发布WebService服务接口。本用例中为其他业务系统内的资金流动信息产生EAS财务凭证的接口。
(2)JavaBean类 包名 wsvoucher.client
JavaBean类提供接口需要的参数。本用例中为EAS财务凭证需要的信息
4.调用说明
(1)接口:importVoucher(wsvoucher[],int isVerify,int isCashflow)
传入参数第一个: WSWSVoucher[] 普通对象数组,见构造EAS凭证字段以及含义说明
传入参数第二个isverify
0不核销、暂存, 1 核销、暂存, 2不核销、提交
3核销、提交
传入参数第三个 isImpCashflow 是否引入现金流量 0 不是 1 是
(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系统的。
处理信息的定义:其他处理信息见后面
0000 成功
(5)处理方法:
将正确的符合条件的凭证、核销记录、现金流量引入,返回的信息包含全部内容;
有问题的凭证,只返回凭证号,处理信息 也就是 String[][0], String[][4]
(6)参数信息描述
WSWSVoucher 一行 是一个凭证对象或者 是一个现金流量对象
凭证对象行包括:凭证行,分录行,辅助账行,itemFlag=0
现金流量行包括:凭证号,分录号和现金流量行 itemFlag=1
在对象传入时,请顺序传入:
比如共有5行记录,3行是凭证对象行,2行是现金流量行,那么格式如下
凭证号 分录号 。。。。辅助账。。。现金流量(对方分录号)。。。 流量标记
1 1 0
1 2 0
1 3 0
1 1 3 1
1 2 3 1
其他处理信息:
1000 没有凭证数据传入
1001 根据传入的组织编码找不到组织
1002 根据传入的科目编码找不到科目
1003 根据传入的币别编码找不到币别
1004 根据传入的登账日期找不到合适的期间
1005 根据传入的凭证类型名称找不到凭证类型
1007 没有找到核算项目
1008 制单人不能为空
1111 其他异常:如保存失败,网络异常等
2001 根据编码没有取得现金流量项目
3001 没有权限新增凭证
3100 凭证引入重复
3003 登账日期和期间不匹配
3008 组织单元的报告币折算方式没有选取
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 凭证有错误:{0}
4800 每张凭证至少应该有一条分录。
4302 第{0}条分录缺少摘要。
4109 第{0}条分录的币别与凭证头的币别不一致。
4666 第{0}条分录的数量、金额不能全都为0。
4667 第{0}条分录第{1}条辅助账的数量、金额不能全都为0。
4898 第{0}条分录为往来科目,但它的第{1}条辅助账缺少到期日。
4900 现金流量项目{0}已经被禁用!
4980 第{0}条分录科目所属公司与凭证所属公司不一致。
4345 记账日期不能为空。
4346 业务日期不能为空。
4347 凭证类型不能为空。
4355 输入的凭证编码重复
补充时间:2007-1-29 12:01:32
老金