WebService总账凭证引入接口说明EAS701文档格式.docx
《WebService总账凭证引入接口说明EAS701文档格式.docx》由会员分享,可在线阅读,更多相关《WebService总账凭证引入接口说明EAS701文档格式.docx(59页珍藏版)》请在冰豆网上搜索。
java–Djava.ext.dirs=liborg.apache
lib是包放置的文件夹名
1.3EASLogin代码调用
1、调用的各所需参数
2、所需参数:
*@paramuserName用户名String
*@parampassword密码String
*@paramslnNameeasString
*@paramdcName数据中心String
*@paramlanguage语言String
*@paramdbType数据库类型int
*@paramauthPattern验证方式默认"
BaseDB"
;
其他认证方式KEY可从easAuthPatterns.xml中获取String
3、参数说明
a)所传参数,如上所列,按顺序传入
b)查看EASLogin(wsdl),有两个接口,
i.传参6个,此方式不提倡使用。
为保证原有功能,服务端最后也会调用
传参7个的方法,第7参数自动调用"
ii.传参7个,如调用此方法,则需要查询easAuthPatterns.xml文档
c)解决方案:
eas
d)语言:
L2简体中文L3繁体中文
e)服务器地址+端口:
组合成URL
f)数据库类型:
0SQLServer1Oracle2DB2
g)authPattern验证方式
i.默认"
ii.easAuthPatterns.xml文档路径
iii.easAuthPatterns.xml文档说明
4、做一个javaBean类,把此参数set到此javaBean类中
5、登录代码
a)登录
b)登录实现
2.凭证引入接口
2.1importVoucher(凭证引入)
1、凭证引入接口,两个接口方法都可用,且用法一致
2、凭证webService接口生成客户端,可参考EASLogin方法
3、凭证引入参数:
importVoucher(wsvoucher[],intisVerify,intisCashflow)
●传参数第1个:
WSWSVoucher[]普通对象数组,见构造EAS凭证字段以及含义说明
●传参数第2个:
isverify
0不核销,暂存
1核销,暂存
2不核销,提交
3核销,提交
●传参数第3个:
isImpCashflow
是否引入现金流量0不引入1引入
4、凭证引入代码调用说明
5、返回值String[][]
是一个长度为凭证数,宽度是5的字符串数据
宽度的定义:
外部系统凭证号,凭证字,会计年度,会计期间,处理信息,异常信息,金蝶凭证号
凭证引入原版文档如下
一.“凭证引入”技术方案
其他业务系统数据,传输到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.client
JavaBean类提供接口需要的参数。
本用例中为EAS财务凭证需要的信息。
三.“凭证导入接口”调用说明
●接口:
importVoucher(wsvoucher[],intisVerify,intisCashflow)
isImpCashflow
是否引入现金流量0不是1是
四.构造EAS凭证字段以及含义说明如下:
WSWSVoucher说明:
一张凭证占据的行数=凭证行*分录行*辅助账行
字体黑色:
凭证头字段;
深蓝:
分录行字段;
橙色:
辅助账字段;
紫罗兰:
现金流量
单元格颜色:
灰色必录项;
浅青绿:
辅助账核算项目(科目多核算项目,最多8个);
浅绿:
字段名
类型
中文说明
是否必录
说明
格式
companyNumber
String
公司编码
是
录入公司编码,必须在EAS中有该编码
bookedDate
记账日期
凭证的登账日期
2005-11-1
bizDate
业务日期
业务发生日期
periodYear
int
会计期间-年
必须在EAS中有
2005
periodNumber
会计期间-编码
11
voucherType
凭证字(凭证类型)
凭证类型中文名称,必须在EAS中有
记
attaches
附件数量
否
description
参考信息
voucherNumber
凭证号
凭证唯一区别
1
entrySeq
分录行号
当前凭证的分录唯一区别
voucherAbstract
摘要
分录摘要
accountNumber
科目
分录行科目编码,必须在EAS中有
1001.01
currencyNumber
币种
分录行币别编码,必须在EAS中有
001
localRate
double
汇率
本位币汇率:
没有时默认为1
1.01
entryDC
方向
分录行方向:
1借方-1贷方
originalAmount
原币金额
分录行原币金额
qty
数量
分录行数量
measurement
计量单位
名称,必须在EAS中有
吨
price
单价
分录行单价
debitAmount
借方金额
分录行借方金额:
分录方向为借方时必录
creditAmount
贷方金额
分录行贷方金额:
分录方向为贷方时必录
creator
制单人
当前操作人员名称,必须在EAS中有
徐晓霞
poster
过账人
auditor
审核人
asstSeq
辅助账行号
当前凭证的当前分录的辅助账行唯一区别
bizNumber
业务编号
settlementNumber
结算方式
settlementType
结算号
cussent
核销/挂账
默认为0,
asstActType1
核算项目1
名称,必须在EAS中有。
比如:
客户、
客户
asstActNumber1
核算对象编码1
编码,必须在EAS中有。
客户A的编码
01.01
asstActName1
核算对象名称1
客户A
asstActType2
核算项目2
以下:
取决于科目是否核算多个项目,最多8个
asstActNumber2
核算对象编码2
asstActName2
核算对象名称2
asstActType3
核算项目3
asstActNumber3
核算对象编码3
asstActName3
核算对象名称3
asstActType4
核算项目4
asstActNumber4
核算对象编码4
asstActName4
核算对象名称4
asstActType5
核算项目5
asstActNumber5
核算对象编码5
asstActName5
核算对象名称5
asstActType6
核算项目6
asstActNumber6
核算对象编码6
asstActName6
核算对象名称6
asstActType7
核算项目7
asstActNumber7
核算对象编码7
asstActName7
核算对象名称7
asstActType8
核算项目8
asstActNumber8
核算对象编码8
asstActName8
核算对象名称8
itemflag
现金流量标记
如引入现金流量,必设置为1
oppAccountSeq
对方科目分录号
primaryItem
主表项目
EAS中必存在的主表项目
supplyItem
附表项目
primaryCoef
主表系数
supplyCoef
附表系数
cashflowAmountOriginal
现金流量原币金额
cashflowAmountLocal
现金流量本位币金额
cashflowAmountRpt
现金流量报告币金额
type
Int
现金流量性质列
1、空;
2、外部;
3、内部
cashAsstActType1
现金流量核算项目1
cashAsstActNumber1
现金流量核算对象编码1
cashAsstActName1
现金流量核算对象名称1
cashAsstActType2
现金流量核算项目2
cashAsstActNumber2
现金流量核算对象编码2
cashAsstActName2
现金流量核算对象名称2
cashAsstActType3
现金流量核算项目3
cashAsstActNumber3
现金流量核算对象编码3
cashAsstActName3
现金流量核算对象名称3
cashAsstActType4
现金流量核算项目4
cashAsstActNumber4
现金流量核算对象编码4
cashAsstActName4
现金流量核算对象名称4
cashAsstActType5
现金流量核算项目5
cashAsstActNumber5
现金流量核算对象编码5
cashAsstActName5
现金流量核算对象名称5
cashAsstActType6
现金流量核算项目6
cashAsstActNumber6
现金流量核算对象编码6
cashAsstActName6
现金流量核算对象名称6
cashAsstActType7
现金流量核算项目7
cashAsstActNumber7
现金流量核算对象编码7
cashAsstActName7
现金流量核算对象名称7
cashAsstActType8
现金流量核算项目8
cashAsstActNumber8
现金流量核算对象编码8
cashAsstActName8
现金流量核算对象名称8
1.接口说明:
将正确的符合条件的凭证引入到系统中,作为暂存凭证或者提交状态的凭证,错误的和不符合条件的凭证给与提示,不引入到系统。
2.如果引入核销记录
那么每一张凭证中,需要有往来科目,自动设置核销分录
3.如果引入现金流量
那么普通对象数组中,也存放现金流量数组,数组中的对象也是WSWSVoucher,
与凭证行的区分标记是:
itemFlag字段描述0不是现金流量1是现金流量
4.返回值String[][]
外部系统凭证号,凭证字,年度,期间,处理信息,异常信息,金蝶凭证号
1.凭证号:
第3方系统自身产生的凭证号
2.凭证字:
第3方系统自身产生的凭证字
3.年度:
第3方系统自身产生的会计年度
4.期间:
第3方系统自身产生的会计期间
5.处理信息:
6.异常信息isVerify:
应该是EAS在保存凭证时产生的异常,如校验不通过产生的提示信息等。
7.金蝶返回凭证号:
EAS产生的凭证号,用于回填FreightNet系统的。
8.处理信息的定义:
0000成功其他处理信息见后面
5.处理方法:
将正确的符合条件的凭证、核销记录、现金流量引入,返回的信息包含全部内容;
有问题的凭证,只返回凭证号和错误信息定义
5.参数信息描述
WSWSVoucher一行是一个凭证对象或者是一个现金流量对象
凭证对象行包括:
凭证行、分录行、辅助账行,itemFlag=0
现金流量行包括:
凭证号、分录号、现金流量行,itemFlag=1
在对象传入时,请顺序传入:
比如共有5行记录,3行是凭证对象行,2行是现金流量行,那么格式如下
凭证号分录号…辅助账…现金流量(对方科目分录号)…流量标记
110
120
130
1131
1231
6.其他处理信息:
1000没有凭证数据传入
1001根据传入的组织编码找不到组织
1002根据传入的科目编码找不到科目
1003根据传入的币别编码找不到币别
1004根据传入的登账日期找不到合适的期间
1005根据传入的凭证类型名称找不到凭证类型
1006所引入凭证币别,不属于本科目币别核算值
1007没有找到核算项目
1008制单人不能为空
1010凭证没有找到过账人
1111其他异常:
如保存失败,网络异常等
2001根据编码没有取得现金流量项目
2002现金流量性质列不正确,当主表项目挂辅助账时,性质列必须为外部或内部,外部凭证号:
{0}
2003没有找到核算项目:
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凭证有错误:
4800每张凭证至少应该有一条分录。
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(StringcomNumber,intyear,intperiodNumber)
●输入:
公司代码、期间年(2006)、期间月(7),
●输出:
凭证字、凭证号、参考消息
●输出类型:
String[],以“,”组合,需要拆分。
●默认查询条件:
所查凭证来源系统必须为“基础系统”(查询的是先前从webService中引入的凭证,才是基础系统)
●返回类型:
String[]
#0001未找到公司#0002未找到期间
正确结果转账,0001,FLY20060701001
5.“凭证校验”接口说明
checkVoucher(StringcomNumber,intyear,intperiodNumber,StringmessageNumber,doublelocalAmount)
公司代码、期间年、期间月、参考消息、本位币金额
金蝶