[计算机]金蝶专业版财务接口说明.doc

金蝶kis财务接口使用说明(专业版)版本1.0目录1、概述32、应用范围33、接口说明34、调用示列55、备注71、概述接口插件名称为kisprofessionalplugin.dll；该接口用到三个类，voucher和voucherentry和clsdatabase。voucher为凭证头类, voucherentry为凭证科目明细类（该类的对象作为类voucher的一个属性使用），clsdatabase为数据库操作类。2、应用范围 金蝶kis专业版v9.0及以上版本3、接口说明一、voucher类属性和方法说明（1）voucher类属性列表属性名称类型读写性必填备注vchgroup字符型可读可写是凭证字vchnum整形可读可写否凭证号：根据系统设置是否允许修改凭证号，不允许修改时，传入凭证号时失效，系统自动生成凭证号vchreference字符型可读可写否参考信息vouchentryvoucherentry类对象可读可写是凭证明细类对象数组vchdate日期型可读可写是凭证日期vchserialnum整形可读可写否凭证序号：可传入，未传入时系统自动生成vchattachment整形可读可写否凭证附件数vchtrandate日期型可读可写否业务日期，未传入则取凭证日期ncount整形可读不可写否凭证明细类对象个数errnumber长整形可读不可写否返回保存不成功的错误号（如果大于512，则为验证错误号，否则为系统错误号）errdescription字符型可读不可写否返回保存不成功的错误描述。（2）voucher类方法列表函数名称返回类型参数说明备注insertentry布尔型无参数插入一个凭证明细对象，插入成功返回true，否则返回falsesave（byval sdsn as string）布尔型sdsn数据库连接字符串保存凭证，成功返回true，否则返回false二、voucherentry类属性和方法说明（1）voucherentry类属性列表属性名称类型读写性必填备注acctid字符型可读可写是科目代码vchexp字符型可读可写否摘要（凭证的第一条科目必填）vchcyid字符型可读可写是币别编号vchdebit货币型可读可写科目为借方必填，否则必须不填。借方金额vchcredit货币型可读可写科目为贷方必填，否则必须不填。贷方金额vchqty双精度型可读可写否数量vchprice双精度型可读可写否单价vchsettleno字符型可读可写否结算号vchsettlecode字符型可读可写否结算方式编号vchtransid字符型可读可写否往来业务编号itemid字符型可读可写否核算项目id：如果科目有多个核算项目，则核算项目id用逗号隔开传入，例如：212，552exchangerate双精度型可读可写否对应传入币别的汇率：如果传入汇率则必须大于0，不传入则从kis系统取传入币别对应的汇率三、clsdatabase类属性和方法说明（1）clsdatabase类属性列表属性名称类型读写性必填备注connadodb.connection可读不可写否数据库连接对象（2）clsdatabase类方法列表函数或者过程名称返回类型参数说明备注begintrans无无参数开始一个事务initconnection无strconnectionstring为数据库连接字符串初始化数据库连接对象committrans无无参数提交一个事务rollbacktrans无无参数回滚一个事务4、调用示列private sub cmdsave_click()dim objcn as object dim strconn as string dim i as integer dim strerrornum as stringdim strerrordesc as stringset objcn = createobject(“kisprofessionalplugin.clsdatabase”)/初始化数据库连接对象objcn.initconnection (strconn) /strconn传入的数据库连接字符串objcn.begintrans /开始一个事务/循环保存凭证，每次循环保存一张凭证。for i = 0 to 3 if not savedata (i, strerrornum, strerrordesc) then objcn.rollbacktrans/出错回滚事务msgbox 保存第 & i & 个凭证失败！失败原因：错误号： & strerrornum & 错误描述： & strerrordesc exit sub end if next objcn.committrans/提交事务 set objcn=nothing msgbox 保存成功！end sub/保存凭证过程private function savedata(byval i as variant, byref errornum as variant, byref errordesc as variant) as booleandim obj as object set obj = createobject (“kisprofessionalplugin.voucher”) /-”凭证头”-obj.vchgroup = 收 obj.vchattachment = 2obj.vchdate = cdate(2006-07-25) /下面的代码说明怎么新增一个凭证科目明细，注意：在为obj对象的属性vouchentry赋值前，要先执行obj.insertentry（新增一个凭证科目明细对象） /新增一个借方凭证科目明细obj.insertentryobj.vouchentry(obj.ncount - 1).vchexp = 现金 obj.vouchentry(obj.ncount - 1).acctid = 1001.01 obj.vouchentry(obj.ncount - 1).vchdebit = 100 obj.vouchentry(obj.ncount - 1).vchcyid = rmb。/新增一个贷方凭证科目明细obj.insertentryobj.vouchentry(obj.ncount - 1).vchexp = 销售出库 obj.vouchentry(obj.ncount - 1).acctid = 4101.03 obj.vouchentry(obj.ncount - 1). vchcredit= 100 （注意这里和上面vchdebit不同） obj.vouchentry(obj.ncount - 1).vchcyid = rmbobj.vouchentry(obj.ncount - 1).itemid = 152,100,162 obj.vouchentry(obj.ncount - 1).vchtransid = 343434。savedata = obj.save()/保存/保存