ISV产品接入指南页

1、ISV产产品接入入指南目 录TOC o 1-3 h z u HYPERLINK l _Toc267405230 1文档目的 PAGEREF _Toc267405230 h 3 HYPERLINK l _Toc267405231 2ISV接入提交项 PAGEREF _Toc267405231 h 3 HYPERLINK l _Toc267405232 3接口开发与测试环境 PAGEREF _Toc267405232 h 3 HYPERLINK l _Toc267405233 4ISV接入工作内容 PAGEREF _Toc267405233 h 4 HYPERLINK l _Toc26740523

2、4 5接口定义 PAGEREF _Toc267405234 h 5 HYPERLINK l _Toc267405235 5.1接口实现形式 PAGEREF _Toc267405235 h 5 HYPERLINK l _Toc267405236 5.2平台提供给ISV的接口 PAGEREF _Toc267405236 h 5 HYPERLINK l _Toc267405237 5.2.1Web Service（参数为实体对象） PAGEREF _Toc267405237 h 5 HYPERLINK l _Toc267405238 5.2.2Web Service（参数为XML字符串） PAGER

3、EF _Toc267405238 h 5 HYPERLINK l _Toc267405239 5.2.3Post方式 PAGEREF _Toc267405239 h 5 HYPERLINK l _Toc267405240 5.3ISV需要实现的接口定义 PAGEREF _Toc267405240 h 6 HYPERLINK l _Toc267405241 5.3.1实现方式1：Web Service（参数为实体对象） PAGEREF _Toc267405241 h 6 HYPERLINK l _Toc267405242 5.3.2实现方式2：Web Service（参数为XML字符串） PAG

4、EREF _Toc267405242 h 6 HYPERLINK l _Toc267405243 5.3.3实现方式3：Post方式 PAGEREF _Toc267405243 h 6 HYPERLINK l _Toc267405244 5.4ISV接口实现注意事项 PAGEREF _Toc267405244 h 6 HYPERLINK l _Toc267405245 5.5接口调用示例 PAGEREF _Toc267405245 h 7 HYPERLINK l _Toc267405246 5.5.1示例：Web Service（参数为实体对象） PAGEREF _Toc267405246 h

5、 7 HYPERLINK l _Toc267405247 5.5.2示例：Web Service（参数为XML字符串） PAGEREF _Toc267405247 h 8 HYPERLINK l _Toc267405248 5.5.3示例：Post方式 PAGEREF _Toc267405248 h 8 HYPERLINK l _Toc267405249 5.6接口消息格式 PAGEREF _Toc267405249 h 10 HYPERLINK l _Toc267405250 5.6.1请求消息 PAGEREF _Toc267405250 h 10 HYPERLINK l _Toc26740

6、5251 5.6.2返回消息 PAGEREF _Toc267405251 h 11 HYPERLINK l _Toc267405252 5.7消息体加密处理 PAGEREF _Toc267405252 h 13 HYPERLINK l _Toc267405253 5.8消息调用返回码定义 PAGEREF _Toc267405253 h 13 HYPERLINK l _Toc267405254 6接口开发与产品改造指南 PAGEREF _Toc267405254 h 16 HYPERLINK l _Toc267405255 6.1接口实现过程步骤 PAGEREF _Toc267405255 h

7、16 HYPERLINK l _Toc267405256 6.2配置文件 PAGEREF _Toc267405256 h 16 HYPERLINK l _Toc267405257 6.3接口实现 PAGEREF _Toc267405257 h 17 HYPERLINK l _Toc267405258 6.3.1产品订购 PAGEREF _Toc267405258 h 17 HYPERLINK l _Toc267405259 6.3.2用户授权 PAGEREF _Toc267405259 h 19 HYPERLINK l _Toc267405260 6.3.3健康检查 PAGEREF _Toc2

8、67405260 h 26 HYPERLINK l _Toc267405261 6.3.4产品登录 PAGEREF _Toc267405261 h 28 HYPERLINK l _Toc267405262 6.3.5心跳保持 PAGEREF _Toc267405262 h 30 HYPERLINK l _Toc267405263 6.3.6数据同步 PAGEREF _Toc267405263 h 31 HYPERLINK l _Toc267405264 6.3.7客户端登录 PAGEREF _Toc267405264 h 31 HYPERLINK l _Toc267405265 7接口测试指南

9、 PAGEREF _Toc267405265 h 32 HYPERLINK l _Toc267405266 7.1测试准备工作 PAGEREF _Toc267405266 h 32 HYPERLINK l _Toc267405267 7.1.1基本数据准备 PAGEREF _Toc267405267 h 32 HYPERLINK l _Toc267405268 7.1.2基本数据检查 PAGEREF _Toc267405268 h 32 HYPERLINK l _Toc267405269 7.2加解密算法测试 PAGEREF _Toc267405269 h 33 HYPERLINK l _To

10、c267405270 7.3开通企业客户测试 PAGEREF _Toc267405270 h 33 HYPERLINK l _Toc267405271 7.4企业用户授权测试 PAGEREF _Toc267405271 h 33 HYPERLINK l _Toc267405272 7.4.1集成授权测试1 PAGEREF _Toc267405272 h 33 HYPERLINK l _Toc267405273 7.4.2集成授权测试2 PAGEREF _Toc267405273 h 34 HYPERLINK l _Toc267405274 7.5产品登录测试 PAGEREF _Toc26740

11、5274 h 34文档目的的本文档用用于帮助助ISVV了解其其产品接接入平台台时需要要进行哪哪些工作作、如何何进行这这些工作作、完成成后如何何进行测测试等，ISVV在开始始接入工工作前，请详细细阅读此此文档内内容。ISV接接入提交交项类型提交项重要程度度描述文档产品图标标必需用户订购购时显示示的产品品图标产品介绍绍必需产品简介介，介绍绍产品的的宣传亮亮点、在在技术、功能、应用等等方面的的特点，以及产产品能为为用户在在哪些方方面带来来价值等等用户手册册必需详细介绍绍产品的的管理功功能与应应用功能能的使用用方法，指导企企业的管管理员与与最终用用户使用用系统安装手册册必需系统的安安装部署署说明文文档

12、，能能让平台台维护人人员参照照此文档档即可自自行完成成产品部部署FAQ可选提供最终终用户在在使用系系统中遇遇到一些些常见的的问题时时的一般般解决方方法多媒体培培训材料料可选Flassh、视视频或其其它形式式的多媒媒体培训训材料程序系统程序序必需产品可运运行程序序与数据据库等接口程序序必需产品接口口可运行行程序产品接口口访问地地址必需产品接口口部署后后的访问问地址，其中的的主机名名与端口口可替换换为实际际部署环环境的主主机名与与端口产品系统统访问地地址必需产品部署署后的访访问地址址，其中中的主机机名与端端口可替替换为实实际部署署环境的的主机名名与端口口接口开发发与测试试环境资源描述 HYPERL

13、INK 5:7012 httpp:/2222.922.1117.885:770122沙箱环境境平台登登录地址址 HYPERLINK 5:7011/SaaS2ISVInterface.asmx httpp:/2222.922.1117.885:77011/SSaaSS2ISSVInnterrfacce.aasmxx沙箱环境境平台WWeb Serrvicce地址址 HYPERLINK 5:7011/SaaS2ISVInterfaceURl.aspx httpp:/2222.922.1117.885:77011/SSaaSS2ISSVInnterrfacceURRl.aaspxx沙箱环境境接收PPo

14、stt数据地地址 HYPERLINK 5:7012/SSOLogin.aspx httpp:/2222.922.1117.885:77012/SSSOLLogiin.aaspxx沙箱环境境平台单单点登录录地址 HYPERLINK 5:7009 httpp:/2222.922.1117.885:770099提供示例例程序、加解密密算法、接口调调用日志志查看、SDKK等辅助助调试资资源ISV接接入工作作内容ISV产产品改造造平台中维维护的数数据，IISV产产品中不不可增加加或删除除，如企企业、用用户。平台中维维护的数数据，IISV产产品中仅仅可编辑辑平台中中不包含含的数据据属性的的值。去掉登录录页

15、面去掉注销销、退出出等功能能去掉修改改密码、修改个个人信息息等功能能平台用户户的IDD为GUUID，ISVV需实现现此IDD与其产产品中的的用户身身份的对对应。提供体验验功能，能让用用户点击击产品体体验链接接后，以以一个默默认体验验帐号的的身份直直接进入入系统，让用户户简单试试用。ISV接接口实现现企业客户户业务受受理接口口：企业业订购时时调用，平台会会传送企企业的信信息给IISV；企业客户户员工业业务受理理接口：企业建建立用户户时调用用，平台台会传送送用户信信息给IISV；角色列表表同步（读取）接口：企业给给用户分分配权限限时调用用，如果果产品无无角色功功能，可可不实现现。用户角色色权限同同

16、步（读读取）接接口：企企业给用用户分配配权限时时调用，如果产产品无角角色功能能，可不不实现。用户角色色权限同同步（更更新）接接口：企企业给用用户分配配权限时时调用，如果产产品无角角色功能能，可不不实现。接口定义义接口实现现形式平台与IISV之之间的交交互接口口的实现现有三种种形式，具体如如下：双方提供供Webb Seerviice供供对方调调用，参参数与返返回值使使用实体体对象（实体类类），较较适用于于.Neet平台台或Jaava平平台。双方提供供Webb Seerviice供供对方调调用，参参数与返返回值使使用字符符串（XXML文文本），较适用用于Jaava平平台或其其它异构构平台。双方提供

17、供接收PPostt数据的的页面，Posst的数数据及返返回值均均为字符符串（XXML文文本），较适用用于Jaava平平台或其其它异构构平台如如PHPP、ASSP等。平台提供供给ISSV的接接口Web Serrvicce（参参数为实实体对象象）方法名称称SaaSSISVVIntterffaceeXMLLStrringg参数数据据类型RequuesttInffo返回值数数据类型型RespponsseInnfoWeb Serrvicce（参参数为XXML字字符串）方法名称称SaaSSISVVIntterffaceeXMLLStrringg参数数据据类型Striing返回值数数据类型型StriingP

18、ostt方式请求方法法POSTT参数形式式Msg=xmll格式的的字符串串参数数据据类型Striing返回值数数据类型型StriingISV需需要实现现的接口口定义ISV从从接口实实现的三三种方式式中，选选择一种种适合自自己平台台的方式式实现给给平台调调用的接接口。实现方式式1：WWeb Serrvicce（参参数为实实体对象象）方法名称称ISVSSaaSSIntterffacee参数数据据类型RequuesttInffo返回值数数据类型型RespponsseInnfo实现方式式2：WWeb Serrvicce（参参数为XXML字字符串）方法名称称ISVSSaaSSIntterffaceeXM

19、LLStrringg参数数据据类型Striing返回值数数据类型型Striing实现方式式3：PPostt方式请求方法法POSTT参数形式式Msg=xmll格式的的字符串串参数数据据类型Striing返回值数数据类型型StriingISV接接口实现现注意事事项Web Serrvicce方法法只有一一个参数数，通过过传递不不同的参参数Coode来来指定调调用的功功能。nameespaace 必须是是： HYPERLINK http:/SaaSInterface.Sispark.M/ htttp:/SSaaSSIntterffacee.Siispaark.Miccrossoftt.coom/，包括

20、最最后一个个反斜线线。几种实现现方式提提供的接接口方法法的功能能一样，只是参参数和返返回值类类型不同同。具体体的业务务功能和和返回信信息由请请求消息息头的操操作码（操作码码）决决定，即即接口调调用只有有一个入入口。示示例如下下：publlicRRespponsseInnfo ISVVSaaaSInnterrfacce(RRequuesttInffo rreq) RespponsseInnfo ressp = neewReespoonseeInffo();swittch (reeq.HHeadd.Coode) /企业业客户业业务受理理接口caseeISSV1001011: rrespp = IS

21、VV101101CCorppBinnd.EExeccuteeBussineess(reqq);retuurn ressp; /企业业客户员员工业务务受理接接口caseeISSV1001022: rrespp = ISVV101102SStafffBiind.ExeecutteBuusinnesss(reeq);retuurn ressp; /角色色列表同同步（读读取）接接口caseeISSV1002011: rrespp = ISVV102201PPulllRolles.ExeecutteBuusinnesss(reeq);retuurn ressp; /用户户角色权权限同步步（读取取）接口口

22、caseeISSV1002022: rrespp = ISVV102202PPulllUseerRoole.ExeecutteBuusinnesss(reeq);retuurn ressp; /用户户角色权权限同步步（更新新）接口口caseeISSV1002033: rrespp = ISVV102203SSynccUseerRoole.ExeecutteBuusinnesss(reeq);retuurn ressp; /未知知接口，非法调调用defaaultt: retuurnnnulll; 接口调用用示例示例：WWeb Serrvicce（参参数为实实体对象象）/构造造ReqquesstI

23、nnfo对对象并赋赋值 RRequuesttInffo rrequuestt = neww ReequeestIInfoo(); RRequuesttHeaadInnfo reqqHeaad = neew RRequuesttHeaadInnfo(); rreqHHeadd.SuubmiitTiime = 2000807709009444337779; rreqHHeadd.ApppIDD = PRRO2000800527700005; rreqHHeadd.Coode = ISVV101101; rreqHHeadd.CTTID = 200080770900000000555; rreqHH

24、eadd.Prriorrityy = 100; rreqHHeadd.Veersiion = 1; rrequuestt.Heead = rreqHHeadd;striing boddy = 1变更更原因;/加密密Boddy并赋赋值，“ABCCD12234”为密钥钥 rrequuestt.Boody = CCrpttogrraphhyHeelpeer.CComEEncrryptt(boody, AABCDD12334);/实例例化Weeb SServviceeISV22SaaaSInnterrfacce sservvicee = newwISVV2SaaaSIInteerfaace();/调用

25、用Webb Seerviice RRespponsseInnfo ressponnse = sservvicee.ISSVSaaaSIInteerfaace(reqquesst);/解密密RessponnseIInfoo的Boody，还原为为XMLLstriing boddyXmml = CrrptoograaphyyHellperr.CoomDeecryypt(ressponnse.Boddy, ABBCD112344);示例：WWeb Serrvicce（参参数为XXML字字符串）/构造造Boddy的XXML字字符串striing boddyXMML = 1开通通;/加密密Boddy的XX

26、ML字字符串，“ABBCD112344”为密密钥striing boddy = CrrptoograaphyyHellperr.CoomEnncryypt(boddyXMML, ABBCD112344);/构造造请求消消息XMML字符符串striing reqquesstXMML = IISV11010012200880700900000000555PPRO2200880611000001200080070990944433377991100 + boody + ;/实例例化Weeb SServviceeISV22SaaaSInnterrfacce sservvicee = newwISVV2

27、SaaaSIInteerfaace();/调用用Webb Seerviicestriing ressponnseXXML = sservvicee.ISSVSaaaSIInteerfaaceXXMLSStriing(reqquesstXMML);/取出出Boddy值XmlDDocuumennt xxmlDDoc = nnewXXmlDDocuumennt(); xxmlDDoc.LoaadXmml(rrespponsseXMML);XmlNNodee rooot = xxmlDDoc.DoccumeentEElemmentt;striing ressponnseBBodyy = rooot.S

28、SeleectSSinggleNNodee(BBodyy).InnnerTTextt;/解密密Boddy，还还原为XXMLstriing boddyXmml = CrrptoograaphyyHellperr.CoomDeecryypt(ressponnseBBodyy, ABCCD12234);示例：PPostt方式/ Posst方式式请求UUrl,返回rrespponsse字符符串/数据据流/Urll地址/返返回数据据privvateestaaticcstrringg UrrlPoost(strringg poostDDataa,sttrinng pposttUrll) try Httpp

29、WebbReqquesst RRequuesttObjjectt = WebbReqquesst.CCreaate(posstUrrl) asHtttpWWebRRequuestt;/ 设设定Coookiie ReqquesstObbjecct.CCookkieCConttainner = nnewCCookkieCConttainner(); ReqquesstObbjecct.CCreddenttialls = CrredeentiialCCachhe.DDefaaulttCreedenntiaals;/ReequeestOObjeect.Prooxy = tthiss._wwebPPro

30、xxy;/ 设设定请求求头。 ReqquesstObbjecct.PProttocoolVeersiion = nnewVVerssionn(1, 0); ReqquesstObbjecct.KKeeppAliive = ttruee; ReqquesstObbjecct.PPreAAuthhentticaate = ffalsse; ReqquesstObbjecct.AAcceept = */*;/ReequeestOObjeect.Reffereer = poostUUrl; ReqquesstObbjecct.HHeadderss.Addd(Accceptt-Laanguuagee,

31、uttf-88); ReqquesstObbjecct.UUnsaafeAAuthhentticaateddConnnecctioonShhariing = ttruee;/ReequeestOObjeect.UseerAggentt = SMMPClliennt; ReqquesstObbjecct.MMethhod = POSST; ReqquesstObbjecct.CConttenttTyppe = aappllicaatioon/xx-wwww-fformm-urrlenncodded; ReqquesstObbjecct.AAlloowAuutoRRediirecct = trru

32、e;/ PPostt数据bytee posstBuuffeer = Enncoddingg.UTTF8.GettByttes(Mssg= + HtttpUttiliity.UrllEnccodee(poostDDataa); ReqquesstObbjecct.CConttenttLenngthh = posstBuuffeer.LLenggth;usinng (Sysstemm.IOO.Sttreaam pposttStrreamm = ReqquesstObbjecct.GGetRRequuesttStrreamm() poostSStreeam.Wriite(posstBuuffeer,

33、 0, posstBuuffeer.LLenggth); poostSStreeam.Cloose(); /网络络响应对对象HttppWebbRessponnse ressp = ReequeestOObjeect.GettRessponnse() aasHtttpWWebRRespponsse; Sysstemm.IOO.Sttreaam rresppStrreamm = ressp.GGetRRespponsseSttreaam();/获取取返回数数据保护护包 Sysstemm.IOO.SttreaamReeadeer sstreeamRReadd = neww Syysteem.IIO.

34、SStreeamRReadder(resspSttreaam, Enccodiing.Deffaullt);StriingBBuillderr sttrReet = neewSttrinngBuuildder(); strrRett.Apppennd(sstreeamRReadd.ReeadTToEnnd(); resspSttreaam.CClosse(); ressp.CClosse();retuurn strrRett.TooStrringg(); catcch (Exccepttionn exx) throowneewExxcepptioon(URRL方式式调用错错误. + ex.Me

35、sssagge, ex);/reeturrn eex.MMesssagee; 接收方示示例：prottecttedvvoidd Paage_Loaad(oobjeect sennderr, EEvenntArrgs e) striing msgg = ReqquesstMsgg;/对请请求消息息msgg进行解解析并做做业务处处理，生生成返回回消息。 RRespponsse.CCleaar(); RRespponsse.WWritte(SYYS1003011200080031550000000023 + PRRO2000800527700005200080440911619907775000 +

36、 1.00110 + 330); 接口消息息格式请求消息息请求消息息是指调调用接口口的一方方发出的的消息，即Weeb SServvicee方法的的传入参参数。 ISVV101101 200080770900000000555 PROO2000805527000055 2000807709009444337779 1 10 id99#F999044sfLLO(%)$DSSKLDDOFEEKRXXBFSSDF#$LLCL_+$LXVV:SSFLOOW(#$DDVS消息头所有接口口的请求求消息的的消息头头格式相相同，具具体属性性说明见见下表：名称说明数据类型型长度（字字节）Codee操作码Strii

37、ng8CTIDD客户端交交易序列列号（在发起起方唯一一标识一一个交易易的流水水号，客客户系统统内166位唯一一标示号号）组成方式式：8位位日期8位唯唯一数，每天从从0000000001开开始，如如20008031550000000001Striing16AppIID业务应用用标识（标识是是哪个IISV应应用系统统，由平平台统一一分配）Striing8SubmmitTTimee提交时间间，格式为为：YYYYYMMDDDHHHmmsssffffStriing17Verssionn版本号（保留字字段）当前值: 1Striing10Priooritty优先级（保留字字段）当前值: 100Int3消息体

38、每一个接接口的请请求消息息的消息息体的格格式各不不相同，具体请请参见各各接口的的详细消消息格式式说明。返回消息息请求消息息是指接接口被调调用的一一方返回回的消息息，即WWeb Serrvicce方法法的返回回值。 ISVV101101 200080770900000000555 200080770900000019887 PROO2000805527000055 2000807709009444337779 1 10 0 id99#F999044sfLLO(%)$DSSKLDDOFEEKRXXBFSSDF#$LLCL_+$LXVV:SSFLOOW(#$DDVS消息头所有接口口的返回回消息的的消

39、息头头格式相相同，具具体属性性说明见见下表：名称说明数据类型型长度（字字节）Codee操作码Striing8CTIDD客户端交交易序列列号（在发起起方唯一一标识一一个交易易的流水水号，客客户系统统内166位唯一一标示号号）组成方式式：8位位日期8位唯唯一数，每天从从0000000001开开始，如如20008031550000000001Striing16STIDD服务端交交易序列列号（在接受受方唯一一标识一一个交易易的流水水号，平平台系统统内唯一一20位位唯一流流水）组成方式式：ApppIDD + “_” + 8位日日期88位唯一一数，每每天从00000000001开始始，如110011200

40、08031550000000001Striing25AppIID业务应用用标识（标识是是哪个IISV应应用系统统，由平平台统一一分配）Striing16RequuesttTimme请求接受受时间，格式为为：YYYYYMMDDDHHHmmsssffffStriing17RespponsseTiime响应处理理时间，格式为为：YYYYYMMDDDHHHmmsssffffStriing17Verssionn版本号（保留字字段）当前值：1Striing10Priooritty优先级（保留字字段）当前值：10(能转换换为innt的串串)Striing16Stattus返回结果果状态(能转换换为innt的

41、串串)(0: 正常；-1: 系统统调用异异常)Striing16消息体每一个接接口的返返回消息息的消息息体的格格式各不不相同，具体请请参见各各接口的的详细消消息格式式说明。消息体加加密处理理消息体的的原始数数据为一一段XMML字符符串，如如：1变更更原因PROO20008055270000552992200880700900000000000020009001099000000000000，在消息息传输时时，消息息体需要要加密后后传输，即消息息的Boody部部分为加加密后的的字符串串。无论论是请求求消息还还是返回回消息的的消息体体都需经经过加密密处理，具体加加密算法法为：BBasee64(DE

42、SS(MDD5(消消息体) + 消息体体)消息调用用返回码码定义CodeeResuultCCodeeResuultMMesssagee描述所有消息息0成功正常返回回1对未定义义错误的的描述未定义错错误101数据非法法加密ISV应应用系统统私钥与与SaaaS中的的私钥不不一致102非法的XXML格格式消息格式式与本规规范中定定义的不不一致SSO鉴鉴权消息息1101101001获取登录录信息异异常在获取当当前登录录用户信信息时出出错1101101002用户Tookenn不存在在用户Tookenn不存在在，需要要重新登登录1101101003用户Tookenn 已失失效用户Tookenn过期，需要重

43、重新登录录1101101004用户Tookenn非法用户Tookenn非法，需要重重新登录录1101101005用户登录录未知系系统SaaSS对用户户登录的的系统未未知1101101006其他错误误1101101*编码码定义鉴鉴权消息息其他错错误SSO心心跳消息息1101102002用户Tookenn已失效效用户Tookenn过期，需要重重新登录录1101102003用户Tookenn不存在在用户Tookenn不存在在，需要要重新登登录1101101004用户Tookenn非法用户Tookenn非法，需要重重新登录录1101102005获取用户户登录信信息信息息出错在获取当当前登录录用户信信息

44、时出出错1101102006更新令牌牌错误更新令牌牌错误客户端登登录接口口消息1102201011用户名或或密码出出错用户名或或密码出出错1102201003其他错误误1102201*编码码定义产产品访问问鉴权消消息其他他错误产品访问问鉴权消消息1102202011用户Tookenn已失效效用户Tookenn过期，需要重重新登录录1102202002用户Tookenn不存在在用户Tookenn不存在在，需要要重新登登录1102202003用户Tookenn非法用户Tookenn非法，需要重重新登录录1102202004获取用户户登录信信息信息息出错获取用户户登录信信息信息息出错11022020

45、05判断逻辑辑错误判断订购购关系业业务逻辑辑错误企业信息息接口1103301001取得用户户信息错错误获取企业业管理员员信息出出错1103301002未获得企企业信息息返回信息息为空1103301003获取企业业信息异异常获取企业业信息发发生业务务错误企业员工工信息接接口1103302001非法的UUserrIDssUserrIDss为空1103302002获取用户户信息错错误获取用户户信息错错误计费消息息1104401011数据非法法加密ISV应应用系统统私钥与与SaaaS中的的私钥不不一致1104401022用户Tookenn已失效效用户Tookenn过期，需要重重新登录录11044010

46、3用户Tookenn不存在在用户Tookenn不存在在，需要要重新登登录1101101004用户Tookenn非法用户Tookenn非法，需要重重新登录录1104401055用户订购购关系不不存在用户没有有权限使使用该功功能1104401066未知业务务资费信信息SaaSS管理平平台未设设置该业业务的计计费策略略1104401077其他错误误3*编编码定义义批价消消息其他他错误企业客户户业务受受理消息息2101101011业务配置置参数错错误业务订购购配置不不符合IISV应应用系统统的约定定210110102业务功能能点订购购错误订购的功功能点与与ISVV应用系系统提供供的不一一致210110

47、103Liceensee数量错错误Liceensee可能不不是非负负的整数数210110104未知操作作类型ISV应应用系统统无法识识别操作作类型（订购、取消、暂停、恢复）210110105其他错误误4*编编码定义义该类消消息其他他错误企业客户户员工业务务受理消消息2101102001未知企业业客户帐帐号企业客户户帐号在在ISVV应用系系统中不不存在2101102002用户手机机号码非非法用户手机机号码错错误2101102003其他错误误5*编编码定义义该类消消息其他他错误接口开发发与产品品改造指指南接口实现现过程步步骤序号工作内容容1联系平台台管理员员，在平平台中录录入ISSV和产产品信息息

48、，获取取ISVVID、ApppID、密钥2建立配置置文件，填入平平台管理理员提供供的ISSVIDD、ApppIDD、密钥钥、平台台接口地地址、平平台单点点登录地地址3建立Weeb SServvicee并声明明好方法法，发布布在外网网，然后后将Weeb SServvicee的地址址和产品品地址发发给平台台管理员员，在平平台的产产品信息息中录入入。4 HYPERLINK l _产品订购 实现产品品订购功功能5 HYPERLINK l _开通企业客户测试 测试产品品订购功功能6 HYPERLINK l _用户授权 实现用户户授权功功能7 HYPERLINK l _企业用户授权测试 测试用户户授权功功

49、能8 HYPERLINK l _产品登录 实现产品品登录功功能9 HYPERLINK l _产品登录测试 测试产品品登录功功能10 HYPERLINK l _心跳保持 实现心跳跳保持功功能11 HYPERLINK l _SSO心跳测试 测试心跳跳保持功功能配置文件件ISV需需提供一一个配置置文件，其中包包括以下下可修改改的配置置参数：参数值Web Serrvicce接口口地址(或Poost数数据的页页面地址址)正式环境境的平台台接口地地址ISVIIDISV在在平台中中的唯一一标识码码AppIIDISV的的某一产产品在平平台中的的唯一标标识码加解密密密钥ISV分分配的加加解密密密钥平台单点点登录

50、页页面正式环境境的平台台单点登登录页面面.Nett应用的的Webb.coonfiig文件件中添加加配置信信息示例例，其它它平台类类似： 接口实现现产品订购购应用场景景企业客户户业务受受理接口口（ISSV实现现，平台台调用）企业客户户业务受受理接口口由ISSV提供供给平台台调用，平台向向ISVV输入待待增加的的企业客客户，IISV给给企业客客户创建建一个新新的实例例，并配配置数据据库等相相关资源源。注意意事项如如下：ISV给给企业创创建实例例时如果果需要特特殊的参参数，则则需事先先整理出出来，交交给平台台管理员员维护。这样用用户在订订购的时时候就可可以输入入这些参参数的值值，然后后平台会会将这些

51、些参数值值传递给给ISVV的Weeb SServvicee，ISSV再根根据这些些参数值值给企业业开通服服务。如果ISSV的产产品需要要根据模模块收费费，则需需要将模模块信息息整理并并提交给给平台管管理员。这样用用户在订订购的时时候就可可以选择择需要的的模块。然后平平台会将将模块信信息传递递给ISSV的WWeb Serrvicce。企业可以以多次订订购一个个产品，例如初初次订购购和续订订，ISSV产品品需要做做相应处处理，续续订时，注意新新的时间间区间的的记录和和处理。消息类型型编码ISV1101001请求消息息消息格式式RRequuestt通用消消息头加密后后的消息息体未加密的的消息体体格式

52、绑定标标志绑定定说明应用（产品）ID企业客客户IDD企业客客户名称称企业业客户简简称企业客客户英文文名称企业客客户英文文简称企企业FQQDN企业营营业执照照号 企业业法人企业业管理员员GUIID企业管管理员联联系电话话企业管管理员联联系手机机企业管管理员联联系邮件件企企业地址址企业邮邮寄地址址 邮编企业电电话传真号号码邮箱地地址企企业WEEB网址址企业LoogoUURL 变更时时间业务配配置参数数代码业务配配置参数数值模模块1,模块22,开始始时间结结束时间间名称说明数据类型型长度（字字节）OPTyype受理标志志:1 : 开开通2 : 暂暂停3 : 恢恢复4 : 更更新5 : 退退订状态态2

53、、33、5只只用企业业客户IID和应应用（产产品）IID字段段Striing8OPNoote绑定说明明，例如如：业务务变更原原因Striing256AppIID应用（产产品）IIDStriing16CorppInffo企业客户户的企业业信息Striing16ParaamNaame业务订购购配置参参数名Striing64ParaamVaaluee业务订购购配置参参数值Striing256ModuuleLListt订购模块块列表（以逗号号分割）StriingStarrtTiime开始时间间（只对对OPTTypee: 11,4有有效）格式为：YYYYYMMMDDHHHmmmssffffStriing

54、17EndTTimee结束时间间（只对对OPTTypee: 11,4有有效）格式为：YYYYYMMMDDHHHmmmssffffStriing17返回消息息消息格式式RRespponsse通用用消息头头加密后后的消息息体未加密的的消息体体格式返返回结果果代码返返回结果果描述名称说明数据类型型长度（字字节）ResuultCCodee返回结果果代码（0:成成功；11:失败败）Striing16ResuultDDescc返回结果果文字描描述Striing256用户授权权用户集成成授权需需要ISSV实现现4个接接口，包包括企业业客户员员工业务务受理接接口，及及权限角角色相关关的三个个接口：企业客户户员

55、工业业务受理理接口：目前必必须实现现开通(代码为为1)和和停用(代码为为4)两两种情况况。角色列表表同步（读取）接口，如果产产品无角角色功能能，可不不实现。用户角色色权限同同步（读读取）接接口，如如果产品品无角色色功能，可不实实现。用户角色色权限同同步（更更新）接接口，如如果产品品无角色色功能，可不实实现。应用场景景角色列表表同步（读取）接口（ISVV实现，平台调调用）返回ISSV产品品中所有有角色的的列表。消息类型型编码ISV1102001请求消息息消息格式式RRequuestt通用消消息头加密后后的消息息体未加密的的消息体体格式应用提提供商IID应用（产品）ID企业业客户IID名称说明数据

56、类型型长度（字字节）ISVIID应用提供供商IDDStriing16AppIID应用（产产品）IIDStriing16CorppID企业客户户IDStriing16返回消息息消息格式式RRespponsse通用用消息头头加密后后的消息息体未加密的的消息体体格式返返回结果果代码返返回结果果描述应用提提供商IID应用（产品）ID企业业客户IID角色色ID角色名名角色描描述名称说明数据类型型长度（字字节）ResuultCCodee返回结果果代码(0: 成功；1: 失败)Striing16ResuultDDescc返回结果果描述Striing256ISVIID应用提供供商IDDStriing16App

57、IID应用（产产品）IIDStriing16CorppID企业客户户IDStriing16RoleeLisst角色列表表-RoleeInffo角色信息息-RoleeID角色IDD(ISSV系统统内部角角色IDD)Striing16RoleeNamme角色名Striing64RoleeDessc角色描述述Striing256用户角色色权限同同步（读读取）接接口（IISV实实现，平平台调用用）返回当前前要授权权的用户户在ISSV的产产品中具具有权限限的角色色列表。消息类型型编码ISV1102002请求消息息消息格式式RRequuestt通用消消息头加密后后的消息息体未加密的的消息体体格式应用提提供

58、商IID应用（产品）ID企业业客户IID 用户户ID名称说明数据类型型长度（字字节）ISVIID应用提供供商IDDStriing16AppIID应用（产产品）IIDStriing16CorppID企业客户户IDStriing16UserrID用户IDD(可转转换为GGuidd的串)Striing36返回消息息消息格式式RRespponsse通用用消息头头加密后后的消息息体未加密的的消息体体格式返返回结果果代码返返回结果果描述应用提提供商IID应用（产品）ID企业业客户IID用户户ID角色色ID名称说明数据类型型长度（字字节）ResuultCCodee返回结果果代码(0: 成功；1: 失败)St

59、riing16ResuultDDescc返回结果果描述Striing256ISVIID应用提供供商IDDStriing16AppIID应用（产产品）IIDStriing16CorppID企业客户户IDStriing16UserrID用户IDDStriing36RoleeLisst角色列表表-RoleeID角色IDD(ISSV系统统内部角角色IDD)Striing64企业客户户员工业业务受理理接口（ISVV实现，平台调调用）企业客户户员工业业务受理理接口由由ISVV提供给给平台调调用，平平台向IISV输输入待增增加的企企业用户户（员工工），IISV同同步用户户信息，并保存存授权信信息。消息类型型

60、编码ISV1101002请求消息息消息格式式RRequuestt通用消消息头加密后后的消息息体未加密的的消息体体格式绑定标标志绑定定说明应用（产品）ID企业客客户IDD用户户ID用户类类型用户户名称别名性别用户登登录名用户户AD 帐号用用户SAAM帐户户邮箱地地址联系地地址HHomeeAdddresss身份证证出生日日期部门IDD 职务办公电电话移动电电话变更时时间开开始时间间结结束时间间名称说明数据类型型长度（字字节）OPTyype操作类型型：1:开通2:暂停3:恢复4 : 停用Striing8OPNoote绑定说明明，例如：业务变变更原因因等。Striing256AppIID应用（产产品）