金蝶EAS_WebService总账_新接口开发指南金蝶EAS_WebService总账_新接口开发指南金蝶软件（中国）有限公司2021年2月版权所有©金蝶软件（中国）有限公司i金蝶EAS_WebService总账_新接口开发指南日期作者版本参考版本备注2021-02-01李柱良V1.0版权所有©金蝶软件（中国）有限公司ii总账新接口开发指南Error:ReferencesourcenotfoundError:Referencesourcenotfound一、概述本指南主要面向开发人员，介绍如何利用WebService总账新接口将凭证引入到EAS系统中。版权所有©金蝶软件（中国）有限公司1总账新接口开发指南Error:ReferencesourcenotfoundError:Referencesourcenotfound一、环境准备1.补丁更新EAS800：PT157043EAS820：PT156620EAS850：PT152757EAS861：PT1563452.下载一个较新一点的jdk，我下载的文件是jdk-8u152-windows-x64.exe，安装时可以指定一个安装目录，其它的按默认一路next即可。3.下载一个Enterprise版本的Eclipse，我下载的文件是eclipse-jee-2020-06-R-win32-x86_64.zip，将压缩包解压到指定目录，双击eclipse.exe，指定一个工作空间，即可启动。版权所有©金蝶软件（中国）有限公司2总账新接口开发指南Error:ReferencesourcenotfoundError:Referencesourcenotfound4.指定项目所用的jre：Window->Preferences->Java-InstalledJREs5.建立一个java项目：File->New->Project…->JavaProject版权所有©金蝶软件（中国）有限公司3总账新接口开发指南Error:ReferencesourcenotfoundError:Referencesourcenotfound版权所有©金蝶软件（中国）有限公司4总账新接口开发指南Error:ReferencesourcenotfoundError:Referencesourcenotfound二、登陆EAS1.到http://eascloud.kingdee.com:7050/ormrpc/services下载登陆用wsdl服务描述文件，这里要修改为你服务器的地址和端口：鼠标右键wsdl->链接另存为...将文件的后缀改为wsdl->保存到项目的根目录版权所有©金蝶软件（中国）有限公司5总账新接口开发指南Error:ReferencesourcenotfoundError:Referencesourcenotfound2.生成登陆用WebService客户端类：鼠标右键EASLogin.wsdl->WebServices->GenerateClient->Finish版权所有©金蝶软件（中国）有限公司6总账新接口开发指南Error:ReferencesourcenotfoundError:Referencesourcenotfound在src目录下自动生成了登陆相关的客户端类：3.编写登陆代码运行后，如果能够看到类似25770803-2d66-476c-bc2e-1619eb23631b这样的字符串，说明登陆成功：版权所有©金蝶软件（中国）有限公司7总账新接口开发指南Error:ReferencesourcenotfoundError:Referencesourcenotfound版权所有©金蝶软件（中国）有限公司8总账新接口开发指南Error:ReferencesourcenotfoundError:Referencesourcenotfound三、引入凭证1.到http://eascloud.kingdee.com:7050/ormrpc/services下载凭证用wsdl服务描述文件，这里要修改为你服务器的地址和端口：用与（二）同样的方式将文件保存到项目根目录，并生成客户端代码。版权所有©金蝶软件（中国）有限公司9总账新接口开发指南Error:ReferencesourcenotfoundError:Referencesourcenotfound2.添加JSON架包：在项目的根目录下建一个lib目录，然后到EAS服务端eas\server\lib\common目录找到fastjson-xxx.jar，把它拷贝到新建的lib下。将架包引入到项目中：右键项目->Properties->JavaBuildPath->Libraries->AddJARs版权所有©金蝶软件（中国）有限公司10总账新接口开发指南Error:ReferencesourcenotfoundError:Referencesourcenotfound注：也可以使用其它JSON库，如Gson，Jackson，Json-lib。3.编写引入代码，如果看到：数据起始行1,组织xn003,期间202101,原凭证号vn001,新凭证号vn001这样的信息，说明有凭证引入成功。版权所有©金蝶软件（中国）有限公司11总账新接口开发指南Error:ReferencesourcenotfoundError:Referencesourcenotfound版权所有©金蝶软件（中国）有限公司12总账新接口开发指南Error:ReferencesourcenotfoundError:Referencesourcenotfound版权所有©金蝶软件（中国）有限公司13总账新接口开发指南Error:ReferencesourcenotfoundError:Referencesourcenotfound版权所有©金蝶软件（中国）有限公司14总账新接口开发指南Error:ReferencesourcenotfoundError:Referencesourcenotfound4.凭证引入接口nImportVoucher第一个参数jsonRows可传的列的说明：列名中文名是否必录说明值格式(示例)companyNumber公司编码是在EAS中必须有该编码的公司xn003voucherNumber凭证号是单次引入凭证唯一区别vn001periodYear会计期间年是要与bookedDate相匹配，必须在EAS中有2021periodNumber会计期间编码是要与bookedDate相匹配，必须在EAS中有1bookedDate记账日期是凭证的登账日期2021-01-28bizDate业务日期是业务的发生日期2021-01-28voucherType凭证类型是凭证类型编码（或名称），必须在EAS中有记description参考信息否GL_016参数设置为“是”，GL_016_1为“否”（或为“是”且importKey为空）时，将使用该字段判断重复引入，建义使用importKey方式。testvoucherAbstract摘要否分录摘要，第一条分录的值同时作凭证的摘要testattaches附件数量否附件数量0isCheck复核否是否复核falsecreator制单人是制单人编码（或名称），必须在EAS中有xn001版权所有©金蝶软件（中国）有限公司15总账新接口开发指南Error:ReferencesourcenotfoundError:Referencesourcenotfoundauditor审核人否审核人编码（或名称），必须在EAS中有xn001poster过账人否过账人编码（或名称），必须在EAS中有xn001cashier出纳人否出纳人编码（或名称），必须在EAS中有xn001importKey全局标识否GL_016参数设置为“是”，GL_016_1为“是”，importKey不为空时，将使用该字段判断重复引入，半角字符，不能超过88个。keyxxxxxxsourceSys来源系统否来源系统，默认为11（基础系统）11sourceType来源类型否来源类型，默认为4（其它系统引入）4sourceBillId来源单ID否来源单ID，半角字符，不能超过44个idxxxxxx凭证分录行entrySeq分录行号是当前凭证的分录唯一区别，当为现金流量行时，为本方科目分录号1profitCenterNumber利润中心编码否利润中心编码，必须在EAS中有pf001accountNumber科目是分录行科目编码，必须在EAS中有1001.01currencyNumber币种是分录行币别编码，必须在EAS中有BB01entryDC方向是分录行方向：1借方，0贷方1measurement计量单位否名称，必须在EAS中有吨cussent核销/挂账否0，1，2，3，默认为0，0customerNumber内部业务单位否客户编码c001localRate汇率否本位币汇率：没有时默认为11.01originalAmount原币金额是分录行原币金额1debitAmount借方金额是分录行借方金额:分录方向为借方时必录1creditAmount贷方金额是分录行贷方金额:分录方向为贷方时必录1qty数量否分录行数量1price单价否分录行单价1凭证辅助账行asstSeq辅助账行号否当前凭证的当前分录的辅助账行唯一区别1assistAbstract辅助账摘要否辅助账摘要testassistBizDate业务日期否业务日期2021-01-28assistEndDate到期日否到期日2021-01-28版权所有©金蝶软件（中国）有限公司16总账新接口开发指南Error:ReferencesourcenotfoundError:ReferencesourcenotfoundsettlementType结算方式否结算方式编码，必须在EAS中有settlementNumber结算号否结算号bizNumber业务编号否业务编号ticketNumber票证号码否票证号码invoiceNumber发票号码否发票号码asstActType1核算项目类型1否编码（或名称），必须在EAS中有。比如：客户。如果当前为现金流量行，则为现金流量的核算项目类型1。客户asstActNumber1核算项目编码1否编码，必须在EAS中有。比如：客户A的编码。如果当前为现金流量行，则为现金流量的核算项目编码1。01.01asstActName1核算项目名称1否名称。比如：客户A。如果当前为现金流量行，则为现金流量的核算项目名称1。客户AasstActType2核算项目类型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否版权所有©金蝶软件（中国）有限公司17总账新接口开发指南Error:ReferencesourcenotfoundError:ReferencesourcenotfoundasstActType7核算项目类型7否asstActNumber7核算项目编码7否asstActName7核算项目名称7否asstActType8核算项目类型8否asstActNumber8核算项目编码8否asstActName8核算项目名称8否现金流量字段itemFlag现金流量标记是0或1，如引入现金流量，且是现金流量行，应设置为11oppAccountSeq对方科目分录号是对方科目分录号2primaryItem主表项目是主表项目编码，EAS中必存在的现金流量项目ci001supplyItem附表项目否附表项目编码，EAS中必存在的现金流量项目ci001cashflowAmountOriginal现金流量原币金额是现金流量原币金额1cashflowAmountLocal现金流量本位币金额是现金流量本位币金额1cashflowAmountRpt现金流量报告币金额是现金流量报告币金额1type现金流量性质列否1，2，3，当主表项目挂辅助账时，性质应为2(外部)或3(内部)，主表项目不挂辅助账，性质应为2(外部)25.凭证引入接口nImportVoucher第二个参数jsonParams可传的明细参数的说明：isSubmit：是否将凭证引入为提交凭证，true或false。isAudit：是否将凭证引入为审核凭证，true或false，如果isSubmit为false，该参数将不起作用。isPost：是否将凭证引入为过账凭证，true或false，如果isSubmit为false或isAudit为false，该参数将不起作用。isVerify：是否将引入凭证进行核销，true或false。isImpCashflow：是否引入现金流量，true或false。isCompress：是否对传输的数据进行压缩，true或false，如果为true，传入的数据需要用com.kingdee.eas.fi.gl.ZipUtils.gzip(rows)进行压缩，返回的结果要用com.kingdee.eas.fi.gl.ZipUtils.gunzip(result)进行解压，类ZipUtils可以在eas\client\lib\patch\sp-fi_gl-client.jar中找到如果传输的数据量较大（超过2000行），建义压缩处理。6.凭证引入接口nImportVoucher返回结果的说明，返回结果是一个json字符串，它的结构为：版权所有©金蝶软件（中国）有限公司18总账新接口开发指南Error:ReferencesourcenotfoundError:Referencesourcenotfoundsucs：表示成功引入的凭证集合Map，key是行号，value是凭证相关的Map：companyNumber公司编码，periodNumber期间,voucherNumber原凭证号，id保存后的凭证ID，number新凭证号，bizStatus凭证状态。errs：表示无法引入的凭证集合Map，key是行号，value是凭证相关的Map：companyNumber公司编码，periodNumber期间,voucherNumber原凭证号，type错误类型（暂时请不要使用），col错误列，val错误值，msg错误信息，ex引入时可能发生的异常信息。prepareTime：后端转换用时。analysisTime：后端解析用时。saveTime：后端保存用时。totalTime后端处理总用时。版权所有©金蝶软件（中国）有限公司19
