ISV产品接入指南2（DOC33）

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 _Toc267405234

2、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字符串） PAGEREF

3、 _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字符串） PAGER

4、EF _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 7

5、 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 _Toc2674052

6、51 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 16

7、 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 _Toc267

8、405260 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接口测试指南 P

9、AGEREF _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 _Toc2

10、67405270 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 _Toc2674052

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

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

13、12 http:/2222.92.1177.855:70012沙箱环境平平台登录录地址 HYPERLINK 5:7011/SaaS2ISVInterface.asmx http:/2222.92.1177.855:70011/SSaaSS2ISSVInnterrfacce.aasmxx沙箱环境平平台Weeb SServvicee地址 HYPERLINK 5:7011/SaaS2ISVInterfaceURl.aspx http:/2222.92.1177.855:70011/SSaaSS2ISSVInnterrfacceURRl.aaspxx沙箱环境接接收Poost数数据地址址 HYPERLI

14、NK 5:7012/SSOLogin.aspx http:/2222.92.1177.855:70012/SSSOLLogiin.aaspxx沙箱环境平平台单点点登录地地址 HYPERLINK 5:7009 http:/2222.92.1177.855:70009提供示例程程序、加加解密算算法、接接口调用用日志查查看、SSDK等等辅助调调试资源源ISV接入入工作内内容ISV产品品改造平台中维护护的数据据，ISSV产品品中不可可增加或或删除，如如企业、用用户。平台中维护护的数据据，ISSV产品品中仅可可编辑平平台中不不包含的的数据属属性的值值。去掉登录页页面去掉注销、退退出等功功能去掉修改密密码

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

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

17、，PPostt的数据据及返回回值均为为字符串串（XMML文本本），较较适用于于Javva平台台或其它它异构平平台如PPHP、AASP等等。平台提供给给ISVV的接口口Web SServvicee（参数数为实体体对象）方法名称SaaSIISVIInteerfaaceXXMLSStriing参数数据类类型RequeestIInfoo返回值数据据类型RespoonseeInffoWeb SServvicee（参数数为XMML字符符串）方法名称SaaSIISVIInteerfaaceXXMLSStriing参数数据类类型Strinng返回值数据据类型StrinngPost方方式请求方法POST参数形式

18、Msg=xxml格格式的字字符串参数数据类类型Strinng返回值数据据类型StrinngISV需要要实现的的接口定定义ISV从接接口实现现的三种种方式中中，选择择一种适适合自己己平台的的方式实实现给平平台调用用的接口口。实现方式11：Weeb SServvicee（参数数为实体体对象）方法名称ISVSaaaSIInteerfaace参数数据类类型RequeestIInfoo返回值数据据类型RespoonseeInffo实现方式22：Weeb SServvicee（参数数为XMML字符符串）方法名称ISVSaaaSIInteerfaaceXXMLSStriing参数数据类类型Strinng返回

19、值数据据类型Strinng实现方式33：Poost方方式请求方法POST参数形式Msg=xxml格格式的字字符串参数数据类类型Strinng返回值数据据类型StrinngISV接口口实现注注意事项项Web SServvicee方法只只有一个个参数，通通过传递递不同的的参数CCodee来指定定调用的的功能。namesspacce 必必须是： HYPERLINK http:/SaaSInterface.Sispark.M/ htttp:/SaaaSIInteerfaace.Sissparrk.MMm/，包包括最后后一个反反斜线。几种实现方方式提供供的接口口方法的的功能一一样，只只是参数数和返回回值

20、类型型不同。具具体的业业务功能能和返回回信息由由请求消消息头的的操作码码（操作作码）决决定，即即接口调调用只有有一个入入口。示示例如下下：publiic RessponnseIInfoo ISSVSaaaSIInteerfaace(ReqquesstInnfo reqq) ReespoonseeInffo rrespp = neww RessponnseIInfoo(); swwitcch (reqq.Heead.Codde) /企业业客户业业务受理理接口 ccasee ISSV1001011: reesp = IISV1101001CoorpBBindd.ExxecuuteBBusiines

21、ss(rreq); reeturrn rrespp; /企业业客户员员工业务务受理接接口 ccasee ISSV1001022: reesp = IISV1101002SttafffBinnd.EExeccuteeBussineess(reqq); reeturrn rrespp; /角色色列表同同步（读读取）接接口 ccasee ISSV1002011: reesp = IISV1102001PuullRRolees.EExeccuteeBussineess(reqq); reeturrn rrespp; /用户户角色权权限同步步（读取取）接口口 ccasee ISSV1002022: re

22、esp = IISV1102002PuullUUserrRolle.EExeccuteeBussineess(reqq); reeturrn rrespp; /用户户角色权权限同步步（更新新）接口口 ccasee ISSV1002033: reesp = IISV1102003SyyncUUserrRolle.EExeccuteeBussineess(reqq); reeturrn rrespp; /未知知接口，非非法调用用 ddefaaultt: reeturrn nulll; 接口调用示示例示例：Weeb SServvicee（参数数为实体体对象） /构造RRequuesttInffo对象

23、象并赋值值 ReequeestIInfoo reequeest = nnew ReqquesstInnfo(); ReequeestHHeaddInffo rreqHHeadd = neww ReequeestHHeaddInffo(); reeqHeead.SubbmittTimme = 22008807009099443337779; reeqHeead.ApppID = PROO2000805527000055; reeqHeead.Codde = IISV1101001; reeqHeead.CTIID = 2200880700900000000555; reeqHeead.Priio

24、riity = 10; reeqHeead.Verrsioon = 11; reequeest.Heaad = reeqHeead; sttrinng bbodyy = 1变更原原因; /加密BBodyy并赋值值，“AABCDD12334”为为密钥 reequeest.Boddy = CrrptoograaphyyHellperr.CoomEnncryypt(boddy, ABBCD112344); /实例化化Webb Seerviice ISSV2SSaaSSIntterffacee serrvicce = neew ISVV2SaaaSIInteerfaace(); /调用WWeb Ser

25、rvicce ReespoonseeInffo rrespponsse = seerviice.ISVVSaaaSInnterrfacce(rrequuestt); /解密RRespponsseInnfo的的Boddy，还还原为XXML sttrinng bbodyyXmll = CrpptoggrapphyHHelpper.CommDeccryppt(rrespponsse.BBodyy, ABCCD12234);示例：Weeb SServvicee（参数数为XMML字符符串） /构造BBodyy的XMML字符符串 sttrinng bbodyyXMLL = 1开通; /加密BBodyy的X

26、MML字符符串，“AABCDD12334”为为密钥 sttrinng bbodyy = CrpptoggrapphyHHelpper.CommEnccryppt(bbodyyXMLL, ABCCD12234); /构造请请求消息息XMLL字符串串 sttrinng rrequuesttXMLL = ISSV1001011200080070990000000055PRRO20008006100000012000807709009444337779110 + boddy + ; /实例化化Webb Seerviice ISSV2SSaaSSIntterffacee serrvicce = neew

27、 ISVV2SaaaSIInteerfaace(); /调用WWeb Serrvicce sttrinng rrespponsseXMML = seerviice.ISVVSaaaSInnterrfacceXMMLSttrinng(rrequuesttXMLL); /取出BBodyy值 XmmlDoocummentt xmmlDooc = neew XmllDoccumeent(); xmmlDooc.LLoaddXmll(reespoonseeXMLL); XmmlNoode rooot = xmmlDooc.DDocuumenntEllemeent; sttrinng rrespponss

28、eBoody = rroott.SeelecctSiinglleNoode(Boody).IInneerTeext; /解密BBodyy，还原原为XMML sttrinng bbodyyXmll = CrpptoggrapphyHHelpper.CommDeccryppt(rrespponsseBoody, AABCDD12334);示例：Poost方方式 / / Poost方方式请求求Urll,返回回ressponnse字字符串 / / 数数据流 / Urrl地址址 / 返回数数据 priivatte staaticc strringg UrrlPoost(strringg poostDDa

29、taa,sttrinng pposttUrll) trry HHttppWebbReqquesst RRequuesttObjjectt = WebbReqquesst.CCreaate(posstUrrl) as HtttpWeebReequeest; / 设设定Coookiie RRequuesttObjjectt.CoookiieCoontaaineer = neew CoookieeConntaiinerr(); RRequuesttObjjectt.Crredeentiialss = CreedenntiaalCaachee.DeefauultCCreddenttialls; /Re

30、equeestOObjeect.Prooxy = tthiss._wwebPProxxy; / 设设定请求求头。 RRequuesttObjjectt.PrrotoocollVerrsioon = neew Verrsioon(11, 00); RRequuesttObjjectt.KeeepAAlivve = trrue; RRequuesttObjjectt.PrreAuutheentiicatte = faalsee; RRequuesttObjjectt.Accceppt = */*; /ReequeestOObjeect.Reffereer = poostUUrl; RRequues

31、ttObjjectt.Heeadeers.Addd(AAcceept-Lannguaage, uutf-8); RRequuesttObjjectt.UnnsaffeAuutheentiicattedCConnnecttionnShaarinng = trrue; /ReequeestOObjeect.UseerAggentt = SMMPClliennt; RRequuesttObjjectt.Meethood = PPOSTT; RRequuesttObjjectt.CoonteentTTypee = apppliicattionn/x-wwww-foorm-urllenccodeed;

32、RRequuesttObjjectt.AlllowwAuttoReedirrectt = truue; / PPostt数据 bbytee posstBuuffeer = Enncoddingg.UTTF8.GettByttes(Mssg= + HtttpUttiliity.UrllEnccodee(poostDDataa); RRequuesttObjjectt.CoonteentLLenggth = pposttBuffferr.Leengtth; uusinng (Sysstemm.IOO.Sttreaam pposttStrreamm = ReqquesstObbjecct.GGetR

33、RequuesttStrreamm() posstSttreaam.WWritte(pposttBuffferr, 00, pposttBuffferr.Leengtth); posstSttreaam.CClosse(); /网络络响应对对象 HHttppWebbRessponnse ressp = ReequeestOObjeect.GettRessponnse() aas HtttpWeebReespoonsee; SSysttem.IO.Strreamm reespSStreeam = rrespp.GeetReespoonseeStrreamm(); /获取取返回数数据保护护包 SS

34、ysttem.IO.StrreammReaaderr sttreaamReead = nnew Sysstemm.IOO.SttreaamReeadeer(rresppStrreamm, EEncoodinng.DDefaaultt); SStriingBBuillderr sttrReet = neew StrringgBuiildeer(); sstrRRet.Apppendd(sttreaamReead.ReaadTooEndd(); rresppStrreamm.Cllosee(); rrespp.Cllosee(); rretuurn strrRett.TooStrringg();

35、caatchh (Exxcepptioon eex) tthroow neww Exccepttionn(URRL方式式调用错错误. + ex.Messsagge, ex); /reeturrn eex.MMesssagee; 接收方示例例： prootecctedd voiid PPagee_Looad(objjectt seendeer, EveentAArgss e) sttrinng mmsg = RRequuesttMMsg;/对请求求消息mmsg进进行解析析并做业业务处理理，生成成返回消消息。 Reespoonsee.Cllearr(); Reespoonsee.Wrritee(S

36、YSS103301200080331500000000223 + PROO2000805527000055220088040091661900775500 + 11.0100 + 300); 接口消息格格式请求消息请求消息是是指调用用接口的的一方发发出的消消息，即即Webb Seerviice方方法的传传入参数数。 ISVV101101 200080770900000000555 PROO2000805527000055 2000807709009444337779 1 10 id99#F999044sfLLO(%)$DSSKLDDOFEEKRXXBFSSDF#$LLCL_+$LXVV:SSF

37、LOOW(#$DDVS消息头所有接口的的请求消消息的消消息头格格式相同同，具体体属性说说明见下下表：名称说明数据类型长度（字节节）Code操作码Strinng8CTID客户端交易易序列号号（在发起起方唯一一标识一一个交易易的流水水号，客客户系统统内166位唯一一标示号号）组成方式：8位日日期88位唯一一数，每每天从00000000001开始始，如220088031550000000001Strinng16AppIDD业务应用标标识（标标识是哪哪个ISSV应用用系统，由平台统一分配）Strinng8SubmiitTiime提交时间，格式为为：YYYYMMMDDDHHmmmsssffffStrin

38、ng17Versiion版本号（保保留字段段）当前值: 1Strinng10Priorrityy优先级（保保留字段段）当前值: 10Int3消息体每一个接口口的请求求消息的的消息体体的格式式各不相相同，具具体请参参见各接接口的详详细消息息格式说说明。返回消息请求消息是是指接口口被调用用的一方方返回的的消息，即即Webb Seerviice方方法的返返回值。 ISVV101101 200080770900000000555 200080770900000019887 PROO2000805527000055 2000807709009444337779 1 10 0 id99#F999044sf

39、LLO(%)$DSSKLDDOFEEKRXXBFSSDF#$LLCL_+$LXVV:SSFLOOW(#$DDVS消息头所有接口的的返回消消息的消消息头格格式相同同，具体体属性说说明见下下表：名称说明数据类型长度（字节节）Code操作码Strinng8CTID客户端交易易序列号号（在发起起方唯一一标识一一个交易易的流水水号，客客户系统统内166位唯一一标示号号）组成方式：8位日日期88位唯一一数，每每天从00000000001开始始，如220088031550000000001Strinng16STID服务端交易易序列号号（在接受受方唯一一标识一一个交易易的流水水号，平平台系统统内唯一一20位位

40、唯一流流水）组成方式：ApppID + “_” + 8位日日期88位唯一一数，每每天从00000000001开始始，如11001120008031550000000001Strinng25AppIDD业务应用标标识（标标识是哪哪个ISSV应用用系统，由平台统一分配）Strinng16RequeestTTimee请求接受时时间，格式为为：YYYYMMMDDDHHmmmsssffffStrinng17RespoonseeTimme响应处理时时间，格式为为：YYYYMMMDDDHHmmmsssffffStrinng17Versiion版本号（保保留字段段）当前值：11Strinng10Priorri

41、tyy优先级（保保留字段段）当前值：110(能转换为为intt的串)Strinng16Statuus返回结果状状态(能转换为为intt的串)(0: 正正常；-1: 系统调调用异常常)Strinng16消息体每一个接口口的返回回消息的的消息体体的格式式各不相相同，具具体请参参见各接接口的详详细消息息格式说说明。消息体加密密处理消息体的原原始数据据为一段段XMLL字符串串，如：1变更原原因PPRO220088052270000529200080070990000000000002000901109000000000000，在消息息传输时时，消息息体需要要加密后后传输，即即消息的的Boddy部分分为

42、加密密后的字字符串。无无论是请请求消息息还是返返回消息息的消息息体都需需经过加加密处理理，具体体加密算算法为：Basse644(DEES(MMD5(消息体体) + 消息息体)消息调用返返回码定定义CodeResulltCoodeResulltMeessaage描述所有消息0成功正常返回1对未定义错错误的描描述未定义错误误101数据非法加加密ISV应用用系统私私钥与SSaaSS中的私私钥不一一致102非法的XMML格式式消息格式与与本规范范中定义义的不一一致SSO鉴权权消息1101001011获取登录信信息异常常在获取当前前登录用用户信息息时出错错110100102用户Tokken不不存在用户T

43、okken不不存在，需需要重新新登录110100103用户Tokken 已失效效用户Tokken过过期，需需要重新新登录1101001044用户Tokken非非法用户Tokken非非法，需需要重新新登录1101001055用户登录未未知系统统SaaS对对用户登登录的系系统未知知1101001066其他错误1101001*编码定定义鉴权权消息其其他错误误SSO心跳跳消息1101002022用户Tokken已已失效用户Tokken过过期，需需要重新新登录1101002033用户Tokken不不存在用户Tokken不不存在，需需要重新新登录1101001044用户Tokken非非法用户Tokken非

44、非法，需需要重新新登录110100205获取用户登登录信息息信息出出错在获取当前前登录用用户信息息时出错错110100206更新令牌错错误更新令牌错错误客户端登录录接口消息息1102001011 用户名或或密码出出错用户名或密密码出错错1102001033其他错误1102001*编码定定义产品品访问鉴鉴权消息息其他错错误产品访问鉴鉴权消息息1102002011用户Tokken已已失效用户Tokken过过期，需需要重新新登录1102002022用户Tokken不不存在用户Tokken不不存在，需需要重新新登录1102002033用户Tokken非非法用户Tokken非非法，需需要重新新登录110

45、2002044获取用户登登录信息息信息出出错获取用户登登录信息息信息出出错1102002055判断逻辑错错误判断订购关关系业务务逻辑错错误企业信息接接口1103001011取得用户信信息错误误获取企业管管理员信信息出错错1103001022未获得企业业信息返回信息为为空1103001033获取企业信信息异常常获取企业信信息发生生业务错错误企业员工信信息接口口1103002011非法的UsserIIDsUserIIDs为为空1103002022获取用户信信息错误误获取用户信信息错误误计费消息1104001011数据非法加加密 ISV应用用系统私私钥与SSaaSS中的私私钥不一一致11040010

46、22用户Tokken已已失效用户Tokken过过期，需需要重新新登录110400103用户Tokken不不存在用户Tokken不不存在，需需要重新新登录1101001044用户Tokken非非法用户Tokken非非法，需需要重新新登录1104001055用户订购关关系不存存在用户没有权权限使用用该功能能1104001066未知业务资资费信息息SaaS管管理平台台未设置置该业务务的计费费策略1104001077其他错误3*编码码定义批批价消息息其他错错误企业客户业业务受理理消息2101001011业务配置参参数错误误业务订购配配置不符符合ISSV应用用系统的的约定210100102业务功能点点订

47、购错错误订购的功能能点与IISV应应用系统统提供的的不一致致210100103Licennse数数量错误误Licennse可可能不是是非负的的整数210100104未知操作类类型ISV应用用系统无无法识别别操作类类型（订订购、取取消、暂暂停、恢恢复）210100105其他错误4*编码码定义该该类消息息其他错错误企业客户员员工业务务受理消消息2101002011未知企业客客户帐号号企业客户帐帐号在IISV应应用系统统中不存存在2101002022用户手机号号码非法法用户手机号号码错误误2101002033其他错误5*编码码定义该该类消息息其他错错误接口开发与与产品改改造指南南接口实现过过程步骤骤

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

49、功能能7 HYPERLINK l _企业用户授权测试 测试用户授授权功能能8 HYPERLINK l _产品登录 实现产品登登录功能能9 HYPERLINK l _产品登录测试 测试产品登登录功能能10 HYPERLINK l _心跳保持 实现心跳保保持功能能11 HYPERLINK l _SSO心跳测试 测试心跳保保持功能能配置文件ISV需提提供一个个配置文文件，其其中包括括以下可可修改的的配置参参数：参数值Web SServvicee接口地地址(或或Posst数据据的页面面地址)正式环境的的平台接接口地址址ISVIDDISV在平平台中的的唯一标标识码AppIDDISV的某某一产品品在平台台

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

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

52、est通通用消息息头加密后后的消息息体未加密的消消息体格格式绑定标标志绑定说说明应应用（产产品）IID企业客客户IDD企企业客户户名称企业客客户简称称企业客客户英文文名称企业客客户英文文简称企业业FQDDN企企业营业业执照号号 企业法法人企业管管理员GGUIDD企业管管理员联联系电话话企业管管理员联联系手机机企业管管理员联联系邮件件企业业地址企企业邮寄寄地址 邮编编企企业电话话传真号号码邮箱地地址企业业WEBB网址企业LoogoUURL 变更时时间业务配配置参数数代码业务配配置参数数值模块块1,模模块2,开始时时间结束束时间名称说明数据类型长度（字节节）OPTyppe受理标志:1 : 开通通2

53、 : 暂停停3 : 恢复复4 : 更新新5 : 退订订状态22、3、55只用企企业客户户ID和和应用（产产品）IID字段段Strinng8OPNotte绑定说明，例例如：业业务变更更原因Strinng256AppIDD应用（产品品）IDDStrinng16CorpIInfoo企业客户的的企业信信息Strinng16ParammNamme业务订购配配置参数数名Strinng64ParammVallue业务订购配配置参数数值Strinng256ModulleLiist订购模块列列表（以以逗号分分割）StrinngStarttTimme开始时间（只只对OPPTyppe: 1,44有效）格式为：YYY

54、YYYMMDDDHHHmmsssffffStrinng17EndTiime结束时间（只只对OPPTyppe: 1,44有效）格式为：YYYYYYMMDDDHHHmmsssffffStrinng17返回消息消息格式Reespoonsee通用消消息头加密后后的消息息体未加密的消消息体格格式返回回结果代代码返回回结果描描述名称说明数据类型长度（字节节）ResulltCoode返回结果代代码（00:成功功；1:失败）Strinng16ResulltDeesc返回结果文文字描述述Strinng256用户授权用户集成授授权需要要ISVV实现44个接口口，包括括企业客客户员工工业务受受理接口口，及权权限角色

55、色相关的的三个接接口：企业客户员员工业务务受理接接口：目目前必须须实现开开通(代代码为11)和停停用(代代码为44)两种种情况。角色列表同同步（读读取）接接口，如如果产品品无角色色功能，可可不实现现。用户角色权权限同步步（读取取）接口口，如果果产品无无角色功功能，可可不实现现。用户角色权权限同步步（更新新）接口口，如果果产品无无角色功功能，可可不实现现。应用场景角色列表同同步（读读取）接接口（IISV实实现，平平台调用用）返回ISVV产品中中所有角角色的列列表。消息类型编编码ISV1002011请求消息消息格式Reequeest通通用消息息头加密后后的消息息体未加密的消消息体格格式应用提提供商

56、IID应应用（产产品）IID企业客客户IDD名称说明数据类型长度（字节节）ISVIDD应用提供商商IDStrinng16AppIDD应用（产品品）IDDStrinng16CorpIID企业客户IIDStrinng16返回消息消息格式Reespoonsee通用消消息头加密后后的消息息体未加密的消消息体格格式返回回结果代代码返回回结果描描述应用提提供商IID应应用（产产品）IID企业客客户IDD角色IID角角色名角角色描述述名称说明数据类型长度（字节节）ResulltCoode返回结果代代码(00: 成成功；11: 失失败)Strinng16ResulltDeesc返回结果描描述Strinng25

57、6ISVIDD应用提供商商IDStrinng16AppIDD应用（产品品）IDDStrinng16CorpIID企业客户IIDStrinng16RoleLListt角色列表RoleIInfoo角色信息RoleIID角色ID(ISVV系统内内部角色色ID)Strinng16RoleNNamee角色名Strinng64RoleDDescc角色描述Strinng256用户角色权权限同步步（读取取）接口口（ISSV实现现，平台台调用）返回当前要要授权的的用户在在ISVV的产品品中具有有权限的的角色列列表。消息类型编编码ISV1002022请求消息消息格式Reequeest通通用消息息头加密后后的消息息

58、体未加密的消消息体格格式应用提提供商IID应应用（产产品）IID企业客客户IDD 用户IID名称说明数据类型长度（字节节）ISVIDD应用提供商商IDStrinng16AppIDD应用（产品品）IDDStrinng16CorpIID企业客户IIDStrinng16UserIID用户ID(可转换换为Guuid的的串)Strinng36返回消息消息格式Reespoonsee通用消消息头加密后后的消息息体未加密的消消息体格格式返回回结果代代码返回回结果描描述应用提提供商IID应应用（产产品）IID企业客客户IDD用户IID角色IID名称说明数据类型长度（字节节）ResulltCoode返回结果代代码

59、(00: 成成功；11: 失失败)Strinng16ResulltDeesc返回结果描描述Strinng256ISVIDD应用提供商商IDStrinng16AppIDD应用（产品品）IDDStrinng16CorpIID企业客户IIDStrinng16UserIID用户IDStrinng36RoleLListt角色列表RoleIID角色ID(ISVV系统内内部角色色ID)Strinng64企业客户员员工业务务受理接接口（IISV实实现，平平台调用用）企业客户员员工业务务受理接接口由IISV提提供给平平台调用用，平台台向ISSV输入入待增加加的企业业用户（员员工），IISV同同步用户户信息，并并

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