06苏州移动中小企业信息化平台接口规范 v16

1、苏州移动中小企业信息化平台接口规范版本履历版本号.修订日期修订人审核人修改内容V1.52009-100-27罗海平V1.62009-100-29宋凯4 增加了参参数 ParammMap。 增加只有针针对特殊产品品才传入OrrderCoode的参数数删除了原2.33.6 ISSV业务健康康检查章节增加新的章节 【产品业务务期限查询接接口】V1.612009-111-26冯宇梁1.企业业务受受理接口（IISV101101）增加加只有针对特特殊产品才传传入OrdeerCodee的参数目 录TOC o 1-3 h z u HYPERLINK l _Toc244427966 1Generral Suum

2、maryy（总体规范范） PAGEREF _Toc244427966 h 2 HYPERLINK l _Toc244427967 1.1.技术术方案 PAGEREF _Toc244427967 h 2 HYPERLINK l _Toc244427968 1.2.接口口协议 PAGEREF _Toc244427968 h 2 HYPERLINK l _Toc244427969 1.2.1.基本协议 PAGEREF _Toc244427969 h 2 HYPERLINK l _Toc244427970 1.2.2.消息格式 PAGEREF _Toc244427970 h 2 HYPERLINK l

3、 _Toc244427971 1.3.消息息安全性 PAGEREF _Toc244427971 h 3 HYPERLINK l _Toc244427972 1.3.1.数据安全 PAGEREF _Toc244427972 h 3 HYPERLINK l _Toc244427973 1.3.2.加密算法 PAGEREF _Toc244427973 h 4 HYPERLINK l _Toc244427974 1.3.3.密钥处理 PAGEREF _Toc244427974 h 4 HYPERLINK l _Toc244427975 1.3.4.网络安全 PAGEREF _Toc244427975

4、h 5 HYPERLINK l _Toc244427976 2Interrface Speciificattion（接接口描述） PAGEREF _Toc244427976 h 5 HYPERLINK l _Toc244427977 2.1SaaaS接口概述述 PAGEREF _Toc244427977 h 5 HYPERLINK l _Toc244427978 2.2SaaaS管理平台台提供ISVV应用系统接接口(ISVV应用系统SaaaS管理平平台) PAGEREF _Toc244427978 h 7 HYPERLINK l _Toc244427979 2.2.1SSSO鉴权接口 PAGE

5、REF _Toc244427979 h 7 HYPERLINK l _Toc244427980 2.2.2SSSO心跳接接口 PAGEREF _Toc244427980 h 10 HYPERLINK l _Toc244427981 2.2.3客客户端登录接口 PAGEREF _Toc244427981 h 11 HYPERLINK l _Toc244427982 2.2.4产产品访问鉴权接口 PAGEREF _Toc244427982 h 13 HYPERLINK l _Toc244427983 2.2.5企企业信息接口口 PAGEREF _Toc244427983 h 15 HYPERLIN

6、K l _Toc244427984 2.2.6企企业员工信息息接口 PAGEREF _Toc244427984 h 17 HYPERLINK l _Toc244427985 2.2.7企企业部门信息息接口 PAGEREF _Toc244427985 h 20 HYPERLINK l _Toc244427986 2.2.8企企业通讯录信信息接口 PAGEREF _Toc244427986 h 23 HYPERLINK l _Toc244427987 2.2.9IISV消息通通知接口 PAGEREF _Toc244427987 h 25 HYPERLINK l _Toc244427988 2.3I

7、SVV应用系统提提供SaaSS管理平台接接口(SaaaS管理平台台ISV应用系系统) PAGEREF _Toc244427988 h 27 HYPERLINK l _Toc244427989 2.3.1企企业客户业务受理理接口 PAGEREF _Toc244427989 h 27 HYPERLINK l _Toc244427990 2.3.2企企业客户员工工业务受理接口 PAGEREF _Toc244427990 h 31 HYPERLINK l _Toc244427991 2.3.3角角色列表同步步（读取）接口 PAGEREF _Toc244427991 h 34 HYPERLINK l _

8、Toc244427992 2.3.4用用户角色权限限同步（读取）接口 PAGEREF _Toc244427992 h 36 HYPERLINK l _Toc244427993 2.3.5用用户角色权限限同步（更新新）接口 PAGEREF _Toc244427993 h 38 HYPERLINK l _Toc244427994 2.3.6产产品业务期限限查询接口 PAGEREF _Toc244427994 h 40 HYPERLINK l _Toc244427995 附录一：PDUU通用HEADD（消息头） PAGEREF _Toc244427995 h 1 HYPERLINK l _Toc24

9、4427996 附录二：数据类类型 PAGEREF _Toc244427996 h 1 HYPERLINK l _Toc244427997 附录三：消息类类型 PAGEREF _Toc244427997 h 1 HYPERLINK l _Toc244427998 附录四：算法说说明 PAGEREF _Toc244427998 h 5 HYPERLINK l _Toc244427999 附录五：接口WWSDL PAGEREF _Toc244427999 h 6Generall Summaary（总体规范）技术方案本系统对外集成成通信接口采采用WebSServicce技术作为为SaaS平平台与外部

10、各各系统之间的主要通信接口口。接口协议基本协议双方的消息交互互采用SOAAP（Simmple OObjectt Acceess Prrotocool，简单对对象访问协议议）协议。消息格式所有的协议数据据单元PDUU(Prottocol Data Unit)由如下表的的消息头和消消息体组成： PDU组成描述Messagee Headd消息头Messagee Bodyy消息体完整的消息格式式如下例所示：消息头属性性一消息头属性性二消息头属性性三加加密后的消息息体其中未加密的消消息体格式，如下例所示示：消息体属性性一消息体属性性二消息体属性性三消息安全性数据安全采用DES算法法对数据进行行加密。DE

11、ES加密只针针对消息体，对对消息头不加加密。不同的ISV应应用系统采用用不同的密钥钥对本系统向向SaaS管管理平台发送送的消息进行行加密。各个个ISV应用用系统的密钥钥由SaaSS平台管理员员在SaaSS管理平台上上设定新密钥钥的启用时间间，SaaSS系统自动生生成新密钥；密钥生成后后，SaaSS平台管理员员通过线下的的方式给到IISV应用系系统，ISVV应用系统进进行配置。SSaaS和IISV应用系系统在新密钥钥启用时间到到来时同时启启用新的密钥钥。SaaS管理平平台接收到IISV应用系系统的消息后后，根据消息息头中的ApppID获取取对应ISVV应用系统的的密钥后，即即可对消息体体进行解密

12、。SaaS管理平平台向ISVV应用系统发发送消息时，根根据该应用系系统对应的密密钥对消息体体进行加密。IISV应用系系统接收到SSaaS管理理平台发送的的消息后可直直接采用自身身的密钥对消消息体解密。：对于特特殊情况，IISV也可以以选择不加密密消息，直接接传送明文。加密算法具体消息体的加加密算法为：Base664(DESS(MD5(消息体) + 消息体)密钥处理对于Key,做做如下处理：Key与IV一一致Key的长度为为64bittKey的格式为为：ODD(MD5(KKey)对Key进行MMD5 haash对hash值取取奇数位子串串经过上述处理的的Key，再再对消息体进进行加密或解解密。

13、算法示例: public statiic strinng DESSEncryypt(sttring data, striing keey) if(Striing.IssNullOOrEmptty(datta) | striing.IssNullOOrEmptty(keyy)throw nnew ArgummentNuullExcceptioon(The paramms ccanntt be nnull.);DES dess = DEES.Creeate();MD5 md55Hasheer = MMD5.Crreate();byte keyHaashByttes = md5Haasher.Com

14、puuteHassh(Enccodingg.UTF88.GetBBytes(key);byte keyByytes = ArraayUtill.GettOddArrray(kkeyHasshBytees);byte ivByttes = ArrayyUtil.GetOOddArrray(keeyHashhBytess);/IIV is same as KeeyMemorySStreamm memooryStrream = new MemorryStreeam();CryptoSStreamm crypptoStrream = new CrypttoStreeam(meemorySStreamm

15、, dess.CreaateEnccryptoor(keyyBytess, ivBBytes), CryyptoSttreamMMode.WWrite);StreamWWriterr writter = new StreaamWritter(crryptoSStreamm);writer.Writee(dataa);writer.Flushh();cryptoSStreamm.FlusshFinaalBlocck();writer.Flushh();return Conveert.TooBase664Striing(meemorySStreamm.GetBBufferr(),0,(int)me

16、emorySStreamm.Lenggth); 网络安全SaaS管理平平台接口采用用如下的手段段保证和ISSV应用系统统之间通信的的网络安全：IP鉴权及及业务应用IDD控制列表。ISV应用系统统接入SaaaS管理平台台时需提供其其业务系统出出访IP和UURL（根据据其业务特性性确定）SaaS管理平平台为ISVV应用系统的的每一个业务务分配一个全全局唯一的业业务应用IDDSaaS管理平平台侧防火墙墙配置安全策策略，只有有有效的IP和和业务应用ID才能能访问SaaaS管理平台台ISV应用系统统端配置相应应策略，以拒拒绝非SaaaS管理平台台的接口调用用Interfaace Sppecifiicat

17、ioon（接口描述）SaaS接口概概述SaaS接口提提供两个weebmethhod的weebservvice供IISV调用：RespoonseInnfo SaaaSISVVInterrface(RequeestInffo reqq)和Strinng SaaaSISVIInterffaceXMMLStriing(Sttring strXMML)，两个方法的的功能一样，只只是参数和返返回类型不同同。ISV可可以选择使用用其中的一个个方法来调用用接口，具体体的功能和返返回信息由消消息头的操作作码：操作作码决定定，也就是说说接口调用只只有一个入口口。反之，IISV提供给给SaaS调调用的接口也也一样，

18、只有有一个入口，两两个方法为：RespoonseInnfo ISSVSaaSSInterrface(RequeestInffo reqq)和Strinng ISVSaaaSIntterfacceXMLSStringg(Stringg strXXML)。：11.如果是非非dotneet的应用请请尽量实现字字符串方法，以以减少信息对对象在不同平平台之间转换换带来的风险险。2.ISSV实现接口口时方法名称称必须和本文文档描述的一一致（ISVSaaaSIntterfacce 和ISVSSaaSInnterfaaceXMLLStrinng）。另外，平台还支支持URL（网网页）方式的的接口，ISSV可以直

19、接接向该一个UURL地址PPOST数据据，在返回流流（Respponse）中中就是满足接接口规范接口口的返回信息息。具体的RRequesst信息格式式为：Msgg“XML文件件的字符串”，Respponse的的格式就是本本规范中描述述的返回消息息格式。SaaS和ISSV的应用系系统可以看做做是接口的两两个相关人。他他们各自需要要提供接口供供对方消费。SaaS管理平平应提供如下下接口供ISSV调用：SSO鉴权接口口SSO心跳接口口客户端登录接口口产品访问鉴权接接口企业信息接口企业员工信息接接口企业部门信息接接口企业通讯录信息息接口ISV消息通知知接口ISV应用系统统应提供如下下接口供SaaaS调

20、用：企业客户业务受受理接口企业客户员工业业务受理接口口角色列表同步（读读取）接口用户角色权限同同步（读取）接接口用户角色权限同同步（更新）接口口SaaS管理平平台提供ISSV应用系统统接口(ISSV应用系统统SaaS管管理平台)SSO鉴权接口口接口描述用户使用ISVV应用系统之之前，首先需需要登录SaaaS管理平平台。登录成成功后，SaaaS管理平平台为用户生生成平台访问问身份认证TToken（令令牌）。用户户在访问平台台中各ISVV应用系统时时，各ISVV应用系统将将通过本接口口对访问者进进行统一的Tokken认证。以以便对用户进行统统一的SSOO鉴权认证。交互流程用户先登录SaaaS平台,

21、 再从SaaaS平台提提供的入口访访问ISV应应用用户输入帐号和和密码登录到到SaaS管管理平台，SaaS管管理平台为用用户产生Tooken。用户通过平台IISV产品链链接或直接登登录ISV应应用系统，访访问ISV应应用系统。ISV应用系统统将用户Tooken发送送到平台进行行鉴权。SaaS管理平平台将鉴权结果结果信息息返回ISVV应用系统。用户直接访问IISV的应用用系统用户直接访问IISV应用系系统。ISV应用系统统发现用户没没有登录，将将页面导向到到SaaS平平台的登录页页面。用户输入帐号和和密码登录到到SaaS管管理平台，SaaS管管理平台为用用户产生Tooken。用户通过平台IISV

22、产品链链接或直接登登录ISV应应用系统，访访问ISV应应用系统。ISV应用系统统将用户Tooken发送送到平台进行行鉴权。SaaS管理平平台将鉴权结果结果果信息返回IISV应用系系统。应用场景用户先登录SaaaS平台,再从SaaaS平台提供供的入口访问问ISV的应应用系统用户直接访问IISV的应用用系统接口定义消息类型编码SYS101001请求消息消息格式RRequesst通用消息息头（reff: 附录）加加密后的消息息体未加密的消息体体格式应用提供商商编号应用（产品品）编号令牌名称说明数据类型长度（字节）ISVID应用提供商编号号String16AppID应用（产品）编编号String16T

23、oken令牌（可转换为为Guid的的串）String36返回消息消息格式RResponnse通用消消息头（reef: 附录录）加加密后的消息息体未加密的消息体体格式返回结果代代码返回结果描述述企业客户编号号用户ID用户户类型名称说明数据类型长度（字节）ResultCCode返回结果代码（0: 有效效Tokenn；1: 无无效Tokeen）String16ResultDDesc返回结果文字描描述String256CorpID企业客户编号String16UserID用户ID（可转转换成Guiid类型）String36UserTyppe用户类型：(11: 企业管管理员；0:企业普普通用户)Strin

24、g1SSO心跳接口口接口描述为实现用户的单单点登录，SSaaS管理理平台必须能能够感知到用用户当前是否否处于存活状状态。用户登登录到ISVV应用系统以后后，SaaSS管理平台无法法确定用户是是否在线，默默认情况下，一一定时间（如如30分钟）后后，SaaSS管理平台将会会自动杀死用用户的进程。所所以ISV应用系统必须须定时调用该该接口通知SSaaS管理理平台更新用用户的存活期期，以保证用用户的Tokken在用户户由ISV应用系统中返返回到SaaaS管理平台台后仍然有效效，可以继续续访问其他IISV应用系统的功能。交互流程用户登录到ISSV应用系统统通过SaaaS管理平台台统一鉴权。ISV应用系统

25、统定时（300分钟内）间间隔一段时间间后向SaaaS管理平台台发送心跳请请求。SaaS管理平平台刷新用户户Tokenn存活期为初初始值（如330分钟）。SaaS管理平平台发送心跳跳响应结果到到ISV应用系系统（如Tooken不存存在或刷新失失败等。）应用场景接口定义消息类型编码SYS101002请求消息消息格式RRequesst通用消息息头（reff: 附录）加加密后的消息息体未加密的消息体体格式令牌名称说明数据类型长度（字节）Token令牌（可转换为为Guid的的字符串）String36返回消息消息格式RResponnse通用消消息头（reef: 附录录）加加密后的消息息体未加密的消息体体格

26、式返回结果代代码返回结果描述述名称说明数据类型长度（字节）ResultCCode返回结果代码（0:成功；1:失败）String16ResultDDesc返回结果文字描描述String256客户端登录接口口我们的服务器和他们服务器的接口我们的服务器和他们服务器的接口接口描述ISV的智能客客户端可以通通过本接口进进行客户端登登录鉴权。对于ISV的BB/S架构应应用应统一使使用SaaSS平台集成验证证进行登录鉴权权。由于是C/S结结构,可能会会影响其余BB/S应用的的SSO登录录体验交互流程用户在客户端输输入用户名及及密码。ISV客户端将将用户名，密密码及其他系系统配置信息息通过接口发送送到ISV服

27、服务端ISV服务端通通过Web Serviice调用SSaaS平台台的登录鉴权权接口SaaS平台服服务端将登录录验证结果发回ISSV服务端ISV服务端将将登录验证结果发回至客户端应用场景接口定义消息类型编码SYS102001请求消息消息格式RRequesst通用消息息头（reff: 附录）加加密后的消息息体未加密的消息体体格式应用提供商商编号 应用系统编号号用户名密码名称说明数据类型长度（字节）ISVID应用提供商编号号String16AppID应用系统编号String16Usernamme用户名String64Passworrd密码String64返回消息消息格式RResponnse通用消消

28、息头（reef: 附录录）加加密后的消息息体未加密的消息体体格式返回结果代代码返回结果描述述令牌名称说明数据类型长度（字节）ResultCCode返回结果代码(0: 有效用用户帐号；1: 无效效帐号或密码码)String16ResultDDesc返回结果文字描描述String256Token令牌(可转换为为Guid的的字符串)String36产品访问鉴权接接口接口描述在用户访问某一一个ISV产产品应用时，IISV可以通通过调用本接接口，对用户户所在公司是否否对产品具有有访问权限（用用户所在公司司是否已订购购相应产品）进行强制验证，从而保证用户对产品访问的安全检测。此接口需配合SSSO鉴权接接口

29、一起使用用。交互流程用户访问某一个个ISV应用产品。ISV应用将登登录鉴权时获获得的用户TToken及及AppIDD发送至服务务端。SaaS应用平平台服务端验验证用户对产品的访问资资格。SaaS平台服服务端将验证证结果发送回客户端。应用场景接口定义消息类型编码SYS102002请求消息消息格式RRequesst通用消息息头（reff: 附录）加加密后的消息息体未加密的消息体体格式令牌应用ID名称说明数据类型长度（字节）Token令牌(可转换为为Guid的的串)String36AppID应用(产品)编编号String16返回消息消息格式RResponnse通用消消息头（reef: 附录录）加加密

30、后的消息息体未加密的消息体体格式返回结果代代码返回结果描述述名称说明数据类型长度（字节）ResultCCode返回结果代码（0: 有产产品权限；11: 无产品品权限）String16ResultDDesc返回结果描述String256企业信息接口接口描述对于需要企业信信息的ISVV应用，则实实现该接口，以以接受企业信息更新新。交互流程管理员在平台中中更新企业信信息。ISV定期（按按需）从SaaaS平台获获取最新的企企业信息。SaaS平台将将最新的企业业信息返回至至ISV。ISV应用系统统更新本地数数据系统。应用场景接口定义消息类型编码SYS103001请求消息消息格式RRequesst通用消息

31、息头（reff: 附录）加加密后的消息息体未加密的消息体体格式企业客户编号号名称说明数据类型长度（字节）CorpID企业客户编号String16返回消息消息格式RResponnse通用消消息头（reef: 附录录）加加密后的消息息体未加密的消息体体格式返回结果代代码返回结果描述述企业客户编号号企业业客户名称企企业客户简称称企业客户英文文名称企业客户英文文简称企企业FQDNN企业营业业执照号企业法人人企业管理员员联系电话企业管理理员联系手机机企业管理员员联系邮件企业地地址企企业邮寄地址址 邮编企业电话传真真号码邮箱地址企业WEB网址企业LogooURL 变更时间名称说明数据类型长度（字节）Res

32、ultCCode返回结果代码(0: 处理成成功；1: 处理失败)String16ResultDDesc返回结果描述String256CorpID企业客户编号String16CorpNamme企业客户名称String64ShortNaame企业客户简称String32EnglishhName企业客户英文名名称String128EngShorrtNamee企业客户英文简简称String32FQDN企业FQDNString256CorpLiccense企业营业执照号号String64LegalPeerson企业法人String64AdminPhhone 企业管理员联系系电话String32Admin

33、Moobile企业管理员联系系手机String32AdminEmmail 企业管理员联系系邮件String80Addresss企业地址String256MailinggAddreess企业邮寄地址String256ZipCodee邮编String6Phone企业电话String32Fax传真号码String32Email邮箱地址String80WebSitee企业WEB网址址String100CorpLoggoURL企业Logo URLString256UpdateTTime变更时间，格式式为YYYYMMDDDHHmmmssffffString17企业员工信息接接口接口描述对于需要企业员员工信

34、息的IISV应用，则则实现该接口口，以接受企业业员工信息更更新。交互流程管理员在平台中中更新企业员员工信息。ISV定期（按按需）从SaaaS平台获获取最新的企企业员工信息息。SaaS平台将将最新的企业业员工信息返返回至ISVV。ISV应用系统统更新本地数数据系统。应用场景接口定义消息类型编码SYS103002请求消息消息格式RRequesst通用消息息头（reff: 附录）加加密后的消息息体未加密的消息体体格式企业客户编号号用户IID ,n名称说明数据类型长度（字节）CorpID企业客户编号String16UserIDss用户ID列表(以逗号分割割，用户IDD是Guidd的串);至至少包含一个

35、个用户ID String返回消息消息格式RResponnse通用消消息头（reef: 附录录）加加密后的消息息体未加密的消息体体格式返回结果代代码返回结果描述述企业客户编号号用户ID用用户名称别名性别别用户户登录名用用户AD 帐帐号用户SAMM帐户邮箱地址联系地址HHomeAdddresss身份证出生日期部门ID 职务务办公电话移动电话变更时间名称说明数据类型长度（字节）ResultCCode返回结果代码（0: 成功功；1: 失失败）String16ResultDDesc返回结果描述String256CorpID企业客户编号String16UserID用户ID(Guuid)String36St

36、affNaame用户名称String32Alias别名String32Sex性别F女 M男男String1UserNamme用户登录名String20ADAccouunt用户AD 帐号号String50SAMAccoount用户SAM帐户户String20Email邮箱地址String80Addresss联系地址String256CardID证件号String32Birthdaay出生日期格式为为YYYYMMDDDString8DeptID部门IDString16Positioon职务String32OfficePPhone办公电话String24MobilePPhone移动电话String2

37、4UpdateTTime变更时间，格式式为YYYYMMDDDHHmmmssffff（必填）String17企业部门信息接接口接口描述对于需要企业部部门信息的IISV应用，则则实现该接口口，以接受企企业部门信息息更新。交互流程管理员在平台中中更新企业部部门信息。ISV定期（按按需）从SaaaS平台获获取最新的企企业部门信息息。SaaS平台将将最新的企业业部门信息返返回至ISVV。ISV应用系统统更新本地数数据系统。应用场景接口定义消息类型编码SYS103003请求消息消息格式RRequesst通用消息息头（reff: 附录）加加密后的消息息体未加密的消息体体格式企业客户编号号部门IID,n名称说

38、明数据类型长度（字节）CorpID企业客户编号String16DeptIDss部门ID 列表表(以逗号分分割)String256返回消息消息格式RResponnse通用消消息头（reef: 附录录）加加密后的消息息体未加密的消息体体格式返回结果代代码返回结果描述述企业客户编号号部门ID 上级级部门ID 部门门名称部门门描述部部门电话部门传传真号变更时间名称说明数据类型长度（字节）ResultCCode返回结果代码(0: 处理成成功；1: 处理失败)String16ResultDDesc返回结果描述String256CorpID企业客户编号String16DeptID部门IDString16Pa

39、rentIID上级部门ID，无无上级部门填填0String16DeptNamme部门名称String32DeptDessc部门描述String100DeptPhoone部门电话String32DeptFaxx部门传真号String32DeptMgrrID部门负责人用户户ID(可转转换为Guiid的串)String36UpdateTTime变更时间，格式式为YYYYMMDDDHHmmmssffffString17企业通讯录信息息接口接口描述对于需要企业通通讯录信息的的ISV应用用，则实现该该接口，以接接受企业通讯录信信息更新。交互流程管理员在平台中中更新企业通通讯录信息。ISV定期（按按需）从S

40、aaaS平台获获取最新的企企业通讯录信信息。SaaS平台将将最新的企业业通讯录信息息返回至ISSV。ISV应用系统统更新本地数数据系统。应用场景接口定义消息类型编码SYS103004请求消息消息格式RRequesst通用消息息头（reff: 附录）加加密后的消息息体未加密的消息体体格式企业客户编号号联系人IDD ,n名称说明数据类型长度（字节）CorpID企业客户编号String16ContacttIDs联系人ID列表表(以逗号分分割).如果果 是空串,则表示获取取所有联系人人String返回消息消息格式RResponnse通用消消息头（reef: 附录录）加加密后的消息息体未加密的消息体体格

41、式返回结果代代码返回结果描述述企业客户编编号联联系人ID联系系人全名 联联系人名字 联系人中间间名 联系系人姓氏 职位电子邮件公司电电话家家庭电话移动电话话家庭住址址邮政编编码变更时间名称说明数据类型长度（字节）ResultCCode返回结果代码(0:处理成功功；1: 处处理失败)String16ResultDDesc返回结果描述String256CorpID企业客户编号String16ContacttID联系人IDString16FullNamme联系人全名String64FirstNaame联系人名字String24MiddleNName联系人中间名String16LastNamme联系人

42、姓氏String24Title职位String32Email电子邮件String80CompanyyPhonee公司电话String32HomePhoone家庭电话String32Mobile移动电话String24HomeAdddress家庭住址String256Zipcodee邮政编码String6UpdateTTime变更时间，格式式为YYYYMMDDDHHmmmssffffString17ISV消息通知知接口接口描述ISV产品中会会发生一些事事件，比如：剩余金额不不够时或者产产品中重要信信息被更改时时等等，此时时ISV产品品需要向用户户发送一些消消息通知。目目前平台提供供三种消息，分分

43、别为短信通通知，邮件通通知和Webb站内消息通通知。ISVV可以使用这这些通知方式式来通知相应应的产品用户户。交互流程ISV调用平台台消息通知接接口。SaaS平台将将消息根据类类型发送出去去。接口定义消息类型编码SYS106001请求消息消息格式RRequesst通用消息息头（reff: 附录）加加密后的消息息体未加密的消息体体格式企业客户户编号 用户户类型（是否否管理员）用户IDD消息类型型消消息标题消息内容名称说明数据类型长度（字节）CorpID企业客户编号String16UserTyppe用户类型（是否否管理员）(1: 企业业管理员；00:企业普通通用户)String1UserID用户I

44、D（可转转化成Guiid），如果果UserTType为11，则该项传传递的任何值值都被忽略；如果UseerTypee为0，则需需要准确的相相应用户IDDString36MessageeType消息类型， 00001为WWeb站内消消息，00110为短信消消息，01000为邮件通通知。如果想想同时发送多多种消息，则则对这三种基基本消息格式式做叠加，如如0011：是同时发送送站内消息和和短信通知，00101是同同时发送站内内消息和邮件件通知，01110是同时时发送短信消消息和邮件通通知，01111是同时发发送三种消息息。注意：同时发送送多类消息时时，需要注意意内容长度，比比如同样的消消息，邮件可可

45、能就是一封封，但短信可可能就是多条条，所以在发发送消息时注注重用户的可可读性。String4MessageeSubjeect消息标题，其中中可以含有占占位符(reef:占位符符)string=256MessageeBody消息内容，其中中可以含有占占位符(reef:占位符符)，如果还还想发送Httml的邮件件，请将Teext消息和和Html消消息之间使用用关键词sstone进行分割，但但必须Htmml中的都变变成String=8000返回消息消息格式RResponnse通用消消息头（reef: 附录录）加加密后的消息息体未加密的消息体体格式返回结果代代码返回结果描述述名称说明数据类型长度（字节

46、）ResultCCode返回结果代码，更更多结果代码码，请（reef: 消息返回码码定义）(0: 处理成成功；1: 处理失败)String16ResultDDesc返回结果描述String256占位符定义占位符含义AppNamme对应产品在平台台中的名称CompannyNamee对应的企业名称称UserNaame对应的发送给用用户的名称ISV应用系统统提供SaaaS管理平台台接口(SaaaS管理平平台ISV应应用系统)企业客户业务受受理接口接口描述企业客户在系统统订购业务成成功后，SaaaS管理平平台管理员需需要调用该接接口使新产生生的订购关系系生效，该接接口主要功能能是将企业客客户业务订购信

47、息息同步到相应应的ISV应用系系统；ISVV应用系统为为企业客户配置置相应的业务务数据。交互流程企业客户提交业业务订购申请请,系统管理员员确认企业客户户提交的资料料信息。系统根据企业客客户提交的申申请资料生成成订购关系，包包括企业客户户订购的功能能点、业务配配置信息（如如邮箱系统邮邮件大小、附附件大小等）及及其他信息。SaaS管理平平台调用ISV应用系系统提供的该该接口将业务务订购关系同同步到ISVV应用系统，IISV应用系系统再自行处处理，为企业业客户分配相相应的业务资资源信息。ISV应用系统统返回企业客客户业务受理理结果消息。应用场景接口定义消息类型编码ISV101001请求消息消息格式R

48、Requesst通用消息息头（reff: 附录）加加密后的消息息体未加密的消息体体格式绑定标志绑定说明明应用（产品品）编号企业客户户编号企业客户编编号企业业客户名称企企业客户简称称企业客户英文文名称企业客户英文文简称企企业FQDNN企业营业业执照号 企业法法人企企业管理员GGUID企业管理员员联系电话企业管理员员联系手机企业管理员员联系邮件企业地地址企企业邮寄地址址 邮编企业电话传真真号码邮箱地址企业WEB网址企业LogooURL 变更时间 订购人GUUID 订购人帐号号 订购购人显示名 订购人办公公电话 订购人手机机 订订购人电子邮邮件业务配置参参数代码业务配置参参数值模块1,模模块2,开开

49、始时间结束时时间订订单号名称说明数据类型长度（字节）OPType受理标志:1 : 开通4 : 更新5 : 退订状态 66:续费5只只用企业客户户ID和应用用（产品）IID字段。4：只只变更和周期期性费用业务务参数 6：续费指使用用费续费。只只有需要收取取使用费的产产品才需要实实现该状态。并并且当OPTType为66时，仅传递递和使用费相相关的参数String8OPNote绑定说明，例如如：业务变更更原因String256AppID应用（产品）编编号String16CorpInffo企业客户的企业业信息String16Subscriiber订购人信息ParamNaame业务订购配置参参数名Str

50、ing64ParamVaalue业务订购配置参参数值String256只有针对特殊产产品才传入OOrderCCode的参参数ModuleLList订购模块列表（以以逗号分割）StringStartTiime开始时间（只对对OPTyppe: 1,4有效）格式为：YYYYYMMDDDHHmmsssfffString17EndTimee结束时间（只对对OPTyppe: 1,4有效）格式为：YYYYYMMDDDHHmmsssfffString17返回消息消息格式RResponnse通用消消息头（reef: 附录录）加加密后的消息息体未加密的消息体体格式返回结果代代码返回结果描述述名称说明数据类型长度（

51、字节）ResultCCode返回结果代码（00:成功；11:失败）String16ResultDDesc返回结果文字描描述String256企业客户员工业业务受理接口口我们开放给他们服务器的接口我们开放给他们服务器的接口接口描述对于需要个人帐帐号的ISVV应用，如企企业邮箱、OOA系统等，这这些应用必须须绑定企业客客户员工帐号号信息，否则则应用无法开开展。企业客客户管理员或或客户经理是员员工帐号绑定定的发起者，通通过调用该接接口一次可实实现多个员工工帐号信息的的批量受理。交互流程企业客户管理员员分配员工帐帐户。系统根据企业客客户管理员提交的的员工帐户分分配情况生成成员工用户订购购关系，包括括企

52、业客户员员工订购的功功能点、业务务配置信息（如如邮箱系统邮邮件大小、附附件大小等）及及其他信息。SaaS管理平平台调用ISSV应用系统统提供的该接接口将业务订订购关系同步步到ISV应应用系统，IISV应用系系统再自行处处理，为企业业客户员工分配相应应的业务资源源信息。ISV应用系统统返回企业客客户员工业务受理理结果消息。应用场景接口定义消息类型编码ISV101002请求消息消息格式RRequesst通用消息息头（reff: 附录）加加密后的消息息体未加密的消息体体格式绑定标志绑定说明明应用（产品品）编号企业客户编编号用户ID用户户类型用用户名称别名性别别用户户登录名用用户AD 帐帐号用户SAM

53、M帐户邮箱地址联系地址HHomeAdddresss身份证出生日期部门ID 职务务办公电话移动电话变更时间开始时间结束时时间名称说明数据类型长度（字节）OPType操作类型：1:开通4 : 停用String8OPNote绑定说明，例如如：业务变更原原因等。String256AppID应用（产品）编编号String16CorpID企业客户编号String16Staffs企业客户员工的的信息列表StringStartTiime开始时间（只对对OPTyppe: 1有有效）格式为：YYYYYMMDDDHHmmsssfffString17EndTimee结束时间（只对对OPTyppe: 1有有效）格式为：

54、YYYYYMMDDDHHmmsssfffString17返回消息消息格式RResponnse通用消消息头（reef: 附录录）加加密后的消息息体未加密的消息体体格式返回结果代代码返回结果描述述名称说明数据类型长度（字节）ResultCCode返回结果代码（00:成功；11:失败）String16ResultDDesc返回结果文字描描述String256角色列表同步（读取）接口接口描述SaaS管理平平台的权限管管理分为角色色管理及用户户权限管理。其其中，角色管管理由各ISSV内部管理理维护，SaaaS管理平平台通过此接接口获得各IISV的内部部角色，以便便对用户帐户户权限进行统统一控制。交互流程

55、管理员获得企业业所订购所有有ISV应用用的角色列表表，以便对用用户权限进行行集中授权。SaaS管理平平台递归此企业订购的各各ISV应用用（产品）集集。SaaS平台依依次从2中各各ISV应用用处获得相应应角色列表。ISV应用系统统返回企业在在此系统中对对应的角色列列表。应用场景接口定义消息类型编码ISV102001请求消息消息格式RRequesst通用消息息头（reff: 附录）加加密后的消息息体未加密的消息体体格式应用提供商编编号应用（产品品）编号企业客户户编号名称说明数据类型长度（字节）ISVID应用提供商编号号String16AppID应用（产品）编编号String16CorpID企业客户

56、编号String16返回消息消息格式RResponnse通用消消息头（reef: 附录录）加加密后的消息息体未加密的消息体体格式返回结果代代码返回结果描述述应用提供商编编号应用（产品品）编号企业客户户编号角色IDD角色色名角色色描述名称说明数据类型长度（字节）ResultCCode返回结果代码(0: 成功功；1: 失失败)String16ResultDDesc返回结果描述String256ISVID应用提供商编号号String16AppID应用（产品）编编号String16CorpID企业客户编号String16RoleLisst角色列表RoleInffo角色信息RoleID角色ID(ISSV

57、系统内部部角色ID)String16RoleNamme角色名String64RoleDessc角色描述String256用户角色权限同同步（读取）接口接口描述SaaS管理平平台的权限管管理分为角色色管理及用户户权限管理。其其中，角色管管理由各ISSV内部管理理维护，而用用户权限通过过SaaS管管理平台进行行集中设置管管理。考虑到到系统设计的的松散耦合原原则及SOAA体系架构，用用户对各ISSV应用的权权限配置信息息都存放在各各ISV应用用中，由各IISV应用进进行hostt，SaaSS管理平台只只进行统一的的集中式权限限设置管理。SaaS管理平平台在对用户户设置权限时时，可以通过过此接口获得得

58、此用户在各IISV的中的的角色权限，以便对对用户帐户权权限进行统一一控制。交互流程管理员获得企业业所订购所有有ISV应用用的角色列表表。SaaS管理平平台递归此企企业订购的各各ISV应用用（产品）集集。SaaS平台依依次从2中各各ISV应用用处获得此用用户对应角色色权限列表。ISV应用系统统返回用户在此系统统中对应的角角色列表。应用场景接口定义消息类型编码ISV102002请求消息消息格式RRequesst通用消息息头（reff: 附录）加加密后的消息息体未加密的消息体体格式应用提供商编编号应用（产品品）编号企业客户户编号 用户IDD名称说明数据类型长度（字节）ISVID应用提供商编号号Str

59、ing16AppID应用（产品）编编号String16CorpID企业客户编号String16UserID用户ID(可转转换为Guiid的串)String36返回消息消息格式RResponnse通用消消息头（reef: 附录录）加加密后的消息息体未加密的消息体体格式返回结果代代码返回结果描述述应用提供商编编号应用（产品品）编号企业客户户编号用户IDD角色IDD名称说明数据类型长度（字节）ResultCCode返回结果代码(0: 成功功；1: 失失败)String16ResultDDesc返回结果描述String256ISVID应用提供商编号号String16AppID应用（产品）编编号Stri

60、ng16CorpID企业客户编号String16UserID用户IDString36RoleLisst角色列表RoleID角色ID(ISSV系统内部部角色ID)String64用户角色权限同同步（更新）接口接口描述SaaS管理平平台的权限管管理分为角色色管理及用户户权限管理。其其中，角色管管理由各ISSV内部管理理维护，而用用户权限通过过SaaS管管理平台进行行集中设置管管理。管理员员在SaaSS管理平台中中对各个用户户设置相应IISV应用角角色权限后，SSaaS平台台调用此接口口将更新的用用户角色权限限同步至各IISV应用中中，以使ISSV的本地系系统中的用户户角色权限控控制始终保持持与平台