金蝶EAS Cloud 金蝶EAS系统引入引出WebService接口说明.doc

第1页共15页金蝶EAS引入引出“webservice接口”说明第2页共15页日期作者版本参考版本备注第3页共15页目录1.通用外部数据引入接口.........................................................................................................................................41.1IMPORTBIZDATA.............................................................................................................................................41.1.1参数：.....................................................................................................................................................41.1.2返回值.....................................................................................................................................................41.1.3引入代码调用说明.................................................................................................................................41.2IMPORTDATA...................................................................................................................................................51.2.1引入参数：.............................................................................................................................................51.2.2返回值.....................................................................................................................................................51.2.3引入代码调用说明.................................................................................................................................51.3EXPORTDATA（数据引出）...........................................................................................................................51.3.1参数：.....................................................................................................................................................51.3.2返回值.....................................................................................................................................................61.3.3引出接口代码调用示例.........................................................................................................................62.EAS登录WEBSERVICE接口...........................................................................................................................62.1功能规划.........................................................................................................................................................62.2EASLOGIN代码调用......................................................................................................................................62.2.1所需参数：.............................................................................................................................................62.2.2参数说明.................................................................................................................................................62.2.3调用代码示例.........................................................................................................................................73.接口导入数据详细说明及示例.............................................................................................................................83.1客户分组.........................................................................................................................................................83.1.1模板编码.................................................................................................................................................83.1.2字段说明.................................................................................................................................................83.1.3XML示例................................................................................................................................................83.2客户基础信息.................................................................................................................................................93.2.1模板编码.................................................................................................................................................93.2.2字段说明.................................................................................................................................................93.2.3XML示例..............................................................................................................................................103.3供应商分组...................................................................................................................................................113.3.1模板编码...............................................................................................................................................113.3.2字段说明...............................................................................................................................................113.3.3XML示例..............................................................................................................................................123.4供应商基础信息...........................................................................................................................................123.4.1模板编码...............................................................................................................................................123.4.2字段说明...............................................................................................................................................123.4.3XML示例..............................................................................................................................................134.其他导入接口说明...............................................................................................................................................15第4页共15页1.通用外部数据引入接口所有基础资料和单据的引入使用通用的外部数据交换接口：WSExternalDataExchangeFacade来实现。1、要使用引入接口，必须首先登录EAS，可参考EASLogin接口文档。2、引入引接口webService接口生成客户端，可参考EASLogin方法1.1importBizData通过xml字符串引入，一次可引入多条数据1.1.1参数：String[][]importBizData(StringeasTemplaeNum,StringxmlData,booleanisUpdate)throwsBOSException传参数第1个：easTemplaeNum数据引入模板编码传参数第2个：xmlDataXml格式的数据文件，xml模板可以从webService引出功能获得。传参数第3个：isUpdate是否覆盖更新，是：覆盖更新；否，新增引入1.1.2返回值String[][]是一个长度为导入数据中有错误的数据总数，宽度是2的字符串数据宽度的定义：第N行数据导入错误，错误详细信息。1.1.3引入代码调用说明引入接口的收款单引入代码示例如下WSExternalDataExchangeFacadeSrvProxyServiceLocatorlocator=newWSExternalDataExchangeFacadeSrvProxyServiceLocator("192.168.0.88");WSExternalDataExchangeFacadeSrvProxyproxy=locator.getWSExternalDataExchangeFacade();Stringtemple="receivingBill";Stringfile="C:\\引入引出\\收.xml";FileInputStreamfis=newFileInputStream(file);InputStreamReaderisr=newInputStreamReader(fis);BufferedReaderbr=newBufferedReader(isr);StringBuffersb=newStringBuffer();while(br.ready()){sb.append(br.readLine());}String[][]www=proxy.importBizData(temple,sb.toString(),true);第5页共15页1.2importData通过键值数组引入，一次只能引入一条数据1.2.1引入参数：String[][]importData(StringeasTemplateNumber,String[]key,String[]data,booleanisUpdate)throwsBOSException,DatataskException传参数第1个：easTemplaeNum数据引入模板编码传参数第2个：key是模板中定义的字段名称数组传参数第3个：data对应的数据数组传参数第4个：isUpdate是否覆盖更新，是：覆盖更新；否，新增引1.2.2返回值String[][]长度为1的宽度为2，内容与importBizData一致1.2.3引入代码调用说明WSExternalDataExchangeFacadeSrvProxyServiceLocatorlocator=newWSExternalDataExchangeFacadeSrvProxyServiceLocator("192.168.0.88");WSExternalDataExchangeFacadeSrvProxyproxy=locator.getWSExternalDataExchangeFacade();Stringtemple="customergroupbasedata";String[]key=newString[]{"FNumber","Fname_l2","FCSSPGroupStandardID"”};String[]data=newString[]{"01","商户","customerGroupStandard"};String[][]www=proxy.importData(temple,key,data,true);1.3exportData（数据引出）1.3.1参数：StringexportData(StringeasTemplateNumber,StringmainQueryPK,StringmainQuery)throwsBOSException,DatataskException传参数第1个：easTemplaeNum数据引入模板编码传参数第2个：mainQueryPK查询对象（如需要导出收付款单，查询对象细节请与现场人员联系）传参数第3个：OQL查询语句（具体写法需要根据场景配合查询对象使用，如果需求请与现场人员联系）数据引出接口具体参数值及OQL写法，请根据相关业务场景咨询金蝶开发人员1.3.2返回值String若导出时发生错误，则显示0002若正常则为XMl格式的的符合收付款单模板的数据字符流，编码格式为UTF-8.1.3.3引出接口代码调用示例WSExternalDataExchangeFacadeSrvProxyexchangeProxy=(newWSExternalDataExchangeFacadeSrvProxyServiceLocator()).getWSExternalDataExchangeFacade();StringxmlStr=exchangeProxy.exportData("receivingBill",第6页共15页"com.kingdee.eas.fi.cas.CasReceivingBillQuery","wherenumber='AR-00000029'");System.out.println(xmlStr);2.EAS登录webService接口2.1功能规划1、如需调用数据引入引出接口，必需先要登录EAS，先期需要调用EASLogin登录EAS2.2EASLogin代码调用2.2.1所需参数：*@paramuserName用户名String*@parampassword密码String*@paramslnNameeasString*@paramdcName数据中心String*@paramlanguage语言String*@paramdbType数据库类型int*@paramauthPattern验证方式默认"BaseDB";其他认证方式KEY可从easAuthPatterns.xml中获取String2.2.2参数说明a)所传参数，如上所列，按顺序传入b)查看EASLogin(wsdl)，有两个接口，i.传参6个，此方式不提倡使用。为保证原有功能，服务端最后也会调用传参7个的方法，第7参数自动调用"BaseDB"ii.传参7个，如调用此方法，则需要查询easAuthPatterns.xml文档c)解决方案：easd)数据中心为EAS服务器注册的数据中心编码，暂定为（HL001）e)语言：L2简体中文L3繁体中文f)服务器地址+端口：组合成URLg)数据库类型：0SQLServer1Oracle2DB2h)authPattern验证方式i.默认"BaseDB"ii.easAuthPatterns.xml文档路径iii.easAuthPatterns.xml文档说明第7页共15页2.2.3调用代码示例2.2.3.1非安全模式调用：EASLoginProxyproxy=(newEASLoginProxyServiceLocator()).getEASLogin();proxy.login("user","kduser","eas","HL001","L2",0);2.2.3.2安全模式调用（本项目采用安全模式）：//登录EASLoginProxyproxy=（newEASLoginProxyServiceLocator()）.getEASLogin();WSContextcontext=proxy.login("user","kduser","eas","HL001","l2",0);//具体业务调用String[][]vouchers=null;WSGLWebServiceFacadeSrvProxyproxyWS=null;proxyWS=newWSGLWebServiceFacadeSrvProxyServiceLocator().getWSGLWebServiceFacade();//设置登录返回的session在soap头((Stub)proxyWS).setHeader("http://login.webservice.bos.kingdee.com","SessionId",context.getSessionId());vouchers=proxyWS.getVoucher("001","2008","5",0,0);3.接口导入数据详细说明及示例3.1客户分组3.1.1模板编码customergroupbasedata3.1.2字段说明注：表格中粗体标*的字段为本次项目必须要传入EAS系统的字段字段名称字段标题是否必录备注1FNumber*编码Y2FName_L1英文_名称3FName_L2*简体中文_名称Y第8页共15页4FName_L3繁体中文_名称5FParentID上级分类6FCSSPGroupStandardID*对应分类标准编码Y默认值:customerGroupStandard7FDescription_L1英文_描述8FDescription_L2简体中文_描述9FDescription_L3繁体中文_描述10FCreatorNumber创建人编码11FCreateTime创建时间3.1.3XML示例01商户customerGroupStandarduser2019-04-193.2客户基础信息3.2.1模板编码customerbasedata3.2.2字段说明注：表格中粗体标*的字段为本次项目必须要传入EAS系统的字段字段名称字段标题是否必录备注1.FNumber*编码Y2.FName_L1英文_名称3.FName_L2*简体中文_名称Y4.FName_L3繁体中文_名称5.FForeignName外文名称第9页共15页6.FShortName简称7.FCustomerKind客户性质8.FBarCode条形码9.FMnemonicCode助记码10.FBizAnalysisCodeID业务分析码编码11.FParentID上级客户编码12.FIsInternalCompany*内部客户Ytrue是,false不是13.FInternalCompanyID集团内公司编码如果是内部客户必录14.FTaxRegisterNo*税务登记号15.FBizRegisterNo工商注册号16.FBusiLicence营业执照17.FBusiExequatur生产/经营许可证18.FGSPAuthenticationGSP认证19.FTaxDataID税种编码20.FIndustryID行业编码21.FAddress地址22.FCountryID国家编码23.FProvince省份编码24.FCityID城市编码25.FRegionID区县编码26.FArtificialPerson法人代表27.FVersion修改版本28.FFreezeOrgUnitID禁用组织编码29.FUsedStatus状态30.FCustomerGroupStandardID*客户分类标准编码Y默认值:customerGroupStandard31.FCustomerGroupID*客户分类编码Y默认值0132.FCreatorNumber创建人编码33.FCreateTime创建时间34.FIsCredited信用管理35.FTaxRate税率36.FInvoiceType开票类型37.FInternalCustomerType内部客户类型如果是内部客户必录,0----公司;1----利润中心;38.FInternalProfitCenter_number内部利润中心编码3.2.3XML示例000001上海月星企业管理有限公司经销商false1核准customerGroupStandard01user2019-04-19false0第11页共15页03.3供应商分组3.3.1模板编码suppliergroupbasedata3.3.2字段说明注：表格中粗体标*的字段为本次项目必须要传入EAS系统的字段字段名称字段标题是否必录备注1.FNumber*编码Y2.FName_L1英文_名称3.FName_L2*简体中文_名称Y4.FName_L3繁体中文_名称5.FParentID上级分类6.FCSSPGroupStandardID*对应分类标准编码Y默认值：supplierGroupStandard7.FDescription_L1英文_描述8.FDescription_L2简体中文_描述9.FDescription_L3繁体中文_描述10.FCreatorNumber创建人编码11.FCreateTime创建时间3.3.3XML示例01供应商分类supplierGroupStandard第12页共15页user2019-04-223.4供应商基础信息3.4.1模板编码supplierbasedata3.4.2字段说明注：表格中粗体标*的字段为本次项目必须要传入EAS系统的字段字段名称字段标题是否必录备注1.FNumber*供应商编码Y2.FName_L1英文_名称3.FName_L2*简体中文_名称Y4.FName_L3繁体中文_名称5.FBarCode条形码6.FMnemonicCode助记码7.FForeignName外文名称8.FBizAnalysisCodeID业务分析码9.FShortName简称10.FParentID上级供应商编码11.FIsInternalCompany*内部供应商Ytrue是,false不是12.FInternalCompanyID集团内公司编码如果是内部供应商必录13.FTaxDataID税种编码14.FTaxRegisterNo*税务登记号15.FBizRegisterNo工商注册号16.FBusiLicence营业执照17.FBusiExequatur生产/经营许可证18.FGSPAuthenticationGSP认证19.FIndustryID行业编码20.FAddress地址编码21.FCountryID国家编码22.FProvinceID省份编码23.FCityID城市编码24.FRegionID区县编码25.FArtificialPerson法人代表26.FTaxRate税率27.FVersion修改版本28.FUsedStatus供应商状态默认值:核准29.FFreezeOrgUnit禁用组织编码30.FSupplierGroupStandardID*供应商分类标准编码Y默认值:supplierGroupStandard31.FSupplierGroupID*供应商分类编码Y默认值0132.FCreatorNumber创建人编码33.FCreateTime创建时间34.FIsCarrier承运商true是,false不是第13页共15页35.FIsOuter委外商true是,false不是36.FInternalSupplierType内部供应商类型0-----------公司;1-----------利润中心;37.FInternalProfitCenter_number内部利润中心编码3.4.3XML示例第14页共15页000051上海文徽投资管理咨询有限公司false0核准supplierGroupStandard01wy2019-04-24falsefalse04.其他导入接口说明通用数据交换接口需要配合EAS系统中的导入导出模板使用，菜单路径：系统平台-业务工具-引入引出管理-引入引出模板管理打开界面如下：第15页共15页系统中所有预设的模板均可以通过类似方法调用，传入的xml可以按照一下规则拼装，或者参考导出接口返回的数据格式：模板所有字段的描述，参考前边样例第一行行数据对应模板字段的值，参考前边样例第二行行数据对应模板字段的值，参考前边样例