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

1、苏州移动中小企业信息化平台接口规范版本履历版本号.修订日期修订人审核人修改内容V1.52009-10-27罗海平V1.62009-10-29宋凯 增加了参数 ParamMap。 增加只有针对特殊产品才传入OrderCode的参数删除了原2.3.6 ISV业务健康检查章节增加新的章节 【产品业务期限查询接口】V1.612009-11-26冯宇梁1.企业业务受理接口（ISV10101）增加只有针对特殊产品才传入OrderCode的参数目 录 TOC o 1-3 h z u HYPERLINK l _Toc2444279661General Summary（总体规范） PAGEREF _Toc244

2、427966 h 2HYPERLINK l _Toc2444279671.1.技术方案 PAGEREF _Toc244427967 h 2HYPERLINK l _Toc2444279681.2.接口协议 PAGEREF _Toc244427968 h 2HYPERLINK l _Toc2444279691.2.1.基本协议 PAGEREF _Toc244427969 h 2HYPERLINK l _Toc2444279701.2.2.消息格式 PAGEREF _Toc244427970 h 2HYPERLINK l _Toc2444279711.3.消息安全性 PAGEREF _Toc244

3、427971 h 3HYPERLINK l _Toc2444279721.3.1.数据安全 PAGEREF _Toc244427972 h 3HYPERLINK l _Toc2444279731.3.2.加密算法 PAGEREF _Toc244427973 h 4HYPERLINK l _Toc2444279741.3.3.密钥处理 PAGEREF _Toc244427974 h 4HYPERLINK l _Toc2444279751.3.4.网络安全 PAGEREF _Toc244427975 h 5HYPERLINK l _Toc2444279762Interface Specificat

4、ion（接口描述） PAGEREF _Toc244427976 h 5HYPERLINK l _Toc2444279772.1SaaS接口概述 PAGEREF _Toc244427977 h 5HYPERLINK l _Toc2444279782.2SaaS管理平台提供ISV应用系统接口(ISV应用系统SaaS管理平台) PAGEREF _Toc244427978 h 7HYPERLINK l _Toc2444279792.2.1SSO鉴权接口 PAGEREF _Toc244427979 h 7HYPERLINK l _Toc2444279802.2.2SSO心跳接口 PAGEREF _Toc

5、244427980 h 10HYPERLINK l _Toc2444279812.2.3客户端登录接口 PAGEREF _Toc244427981 h 11HYPERLINK l _Toc2444279822.2.4产品访问鉴权接口 PAGEREF _Toc244427982 h 13HYPERLINK l _Toc2444279832.2.5企业信息接口 PAGEREF _Toc244427983 h 15HYPERLINK l _Toc2444279842.2.6企业员工信息接口 PAGEREF _Toc244427984 h 17HYPERLINK l _Toc2444279852.2.

6、7企业部门信息接口 PAGEREF _Toc244427985 h 20HYPERLINK l _Toc2444279862.2.8企业通讯录信息接口 PAGEREF _Toc244427986 h 23HYPERLINK l _Toc2444279872.2.9ISV消息通知接口 PAGEREF _Toc244427987 h 25HYPERLINK l _Toc2444279882.3ISV应用系统提供SaaS管理平台接口(SaaS管理平台ISV应用系统) PAGEREF _Toc244427988 h 27HYPERLINK l _Toc2444279892.3.1企业客户业务受理接口

7、PAGEREF _Toc244427989 h 27HYPERLINK l _Toc2444279902.3.2企业客户员工业务受理接口 PAGEREF _Toc244427990 h 31HYPERLINK l _Toc2444279912.3.3角色列表同步（读取）接口 PAGEREF _Toc244427991 h 34HYPERLINK l _Toc2444279922.3.4用户角色权限同步（读取）接口 PAGEREF _Toc244427992 h 36HYPERLINK l _Toc2444279932.3.5用户角色权限同步（更新）接口 PAGEREF _Toc24442799

8、3 h 38HYPERLINK l _Toc2444279942.3.6产品业务期限查询接口 PAGEREF _Toc244427994 h 40HYPERLINK l _Toc244427995附录一：PDU通用HEAD（消息头） PAGEREF _Toc244427995 h 1HYPERLINK l _Toc244427996附录二：数据类型 PAGEREF _Toc244427996 h 1HYPERLINK l _Toc244427997附录三：消息类型 PAGEREF _Toc244427997 h 1HYPERLINK l _Toc244427998附录四：算法说明 PAGERE

9、F _Toc244427998 h 5HYPERLINK l _Toc244427999附录五：接口WSDL PAGEREF _Toc244427999 h 6General Summary（总体规范）技术方案本系统对外集成通信接口采用WebService技术作为SaaS平台与外部各系统之间的主要通信接口。接口协议基本协议双方的消息交互采用SOAP（Simple Object Access Protocol，简单对象访问协议）协议。消息格式所有的协议数据单元PDU(Protocol Data Unit)由如下表的消息头和消息体组成： PDU组成描述Message Head消息头Message

10、Body消息体完整的消息格式如下例所示：消息头属性一消息头属性二消息头属性三加密后的消息体其中未加密的消息体格式，如下例所示：消息体属性一消息体属性二消息体属性三消息安全性数据安全采用DES算法对数据进行加密。DES加密只针对消息体，对消息头不加密。不同的ISV应用系统采用不同的密钥对本系统向SaaS管理平台发送的消息进行加密。各个ISV应用系统的密钥由SaaS平台管理员在SaaS管理平台上设定新密钥的启用时间，SaaS系统自动生成新密钥；密钥生成后，SaaS平台管理员通过线下的方式给到ISV应用系统，ISV应用系统进行配置。SaaS和ISV应用系统在新密钥启用时间到来时同时启用新的密钥。Sa

11、aS管理平台接收到ISV应用系统的消息后，根据消息头中的AppID获取对应ISV应用系统的密钥后，即可对消息体进行解密。SaaS管理平台向ISV应用系统发送消息时，根据该应用系统对应的密钥对消息体进行加密。ISV应用系统接收到SaaS管理平台发送的消息后可直接采用自身的密钥对消息体解密。：对于特殊情况，ISV也可以选择不加密消息，直接传送明文。加密算法具体消息体的加密算法为：Base64(DES(MD5(消息体) + 消息体)密钥处理对于Key,做如下处理：Key与IV一致Key的长度为64bitKey的格式为：ODD(MD5(Key)对Key进行MD5 hash对hash值取奇数位子串经过上

12、述处理的Key，再对消息体进行加密或解密。 算法示例: public static string DESEncrypt(string data, string key) if(String.IsNullOrEmpty(data) | string.IsNullOrEmpty(key)throw new ArgumentNullException(The params cannt be null.);DES des = DES.Create();MD5 md5Hasher = MD5.Create();byte keyHashBytes = md5Hasher.ComputeHash(Encod

13、ing.UTF8.GetBytes(key);byte keyBytes = ArrayUtil.GetOddArray(keyHashBytes);byte ivBytes = ArrayUtil.GetOddArray(keyHashBytes);/IV is same as KeyMemoryStream memoryStream = new MemoryStream();CryptoStream cryptoStream = new CryptoStream(memoryStream, des.CreateEncryptor(keyBytes, ivBytes), CryptoStre

14、amMode.Write);StreamWriter writer = new StreamWriter(cryptoStream);writer.Write(data);writer.Flush();cryptoStream.FlushFinalBlock();writer.Flush();return Convert.ToBase64String(memoryStream.GetBuffer(),0,(int)memoryStream.Length); 网络安全SaaS管理平台接口采用如下的手段保证和ISV应用系统之间通信的网络安全：IP鉴权及业务应用ID控制列表。ISV应用系统接入Saa

15、S管理平台时需提供其业务系统出访IP和URL（根据其业务特性确定）SaaS管理平台为ISV应用系统的每一个业务分配一个全局唯一的业务应用IDSaaS管理平台侧防火墙配置安全策略，只有有效的IP和业务应用ID才能访问SaaS管理平台ISV应用系统端配置相应策略，以拒绝非SaaS管理平台的接口调用Interface Specification（接口描述）SaaS接口概述SaaS接口提供两个webmethod的webservice供ISV调用：ResponseInfo SaaSISVInterface(RequestInfo req)和String SaaSISVInterfaceXMLString

16、(String strXML)，两个方法的功能一样，只是参数和返回类型不同。ISV可以选择使用其中的一个方法来调用接口，具体的功能和返回信息由消息头的操作码：操作码决定，也就是说接口调用只有一个入口。反之，ISV提供给SaaS调用的接口也一样，只有一个入口，两个方法为：ResponseInfo ISVSaaSInterface(RequestInfo req)和String ISVSaaSInterfaceXMLString(String strXML)。：1.如果是非dotnet的应用请尽量实现字符串方法，以减少信息对象在不同平台之间转换带来的风险。2.ISV实现接口时方法名称必须和本文档描

17、述的一致（ISVSaaSInterface 和ISVSaaSInterfaceXMLString）。另外，平台还支持URL（网页）方式的接口，ISV可以直接向该一个URL地址POST数据，在返回流（Response）中就是满足接口规范接口的返回信息。具体的Request信息格式为：Msg“XML文件的字符串”，Response的格式就是本规范中描述的返回消息格式。SaaS和ISV的应用系统可以看做是接口的两个相关人。他们各自需要提供接口供对方消费。SaaS管理平应提供如下接口供ISV调用：SSO鉴权接口SSO心跳接口客户端登录接口产品访问鉴权接口企业信息接口企业员工信息接口企业部门信息接口企业

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

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

20、到平台进行鉴权。SaaS管理平台将鉴权结果结果信息返回ISV应用系统。应用场景用户先登录SaaS平台,再从SaaS平台提供的入口访问ISV的应用系统用户直接访问ISV的应用系统接口定义消息类型编码SYS10101请求消息消息格式Request通用消息头（ref: 附录）加密后的消息体未加密的消息体格式应用提供商编号应用（产品）编号令牌名称说明数据类型长度（字节）ISVID应用提供商编号String16AppID应用（产品）编号String16Token令牌（可转换为Guid的串）String36返回消息消息格式Response通用消息头（ref: 附录）加密后的消息体未加密的消息体格式返回结果

21、代码返回结果描述企业客户编号用户ID用户类型名称说明数据类型长度（字节）ResultCode返回结果代码（0: 有效Token；1: 无效Token）String16ResultDesc返回结果文字描述String256CorpID企业客户编号String16UserID用户ID（可转换成Guid类型）String36UserType用户类型：(1: 企业管理员；0:企业普通用户)String1SSO心跳接口接口描述为实现用户的单点登录，SaaS管理平台必须能够感知到用户当前是否处于存活状态。用户登录到ISV应用系统以后，SaaS管理平台无法确定用户是否在线，默认情况下，一定时间（如30分钟）

22、后，SaaS管理平台将会自动杀死用户的进程。所以ISV应用系统必须定时调用该接口通知SaaS管理平台更新用户的存活期，以保证用户的Token在用户由ISV应用系统中返回到SaaS管理平台后仍然有效，可以继续访问其他ISV应用系统的功能。交互流程用户登录到ISV应用系统通过SaaS管理平台统一鉴权。ISV应用系统定时（30分钟内）间隔一段时间后向SaaS管理平台发送心跳请求。SaaS管理平台刷新用户Token存活期为初始值（如30分钟）。SaaS管理平台发送心跳响应结果到ISV应用系统（如Token不存在或刷新失败等。）应用场景接口定义消息类型编码SYS10102请求消息消息格式Request通

23、用消息头（ref: 附录）加密后的消息体未加密的消息体格式令牌名称说明数据类型长度（字节）Token令牌（可转换为Guid的字符串）String36返回消息消息格式Response通用消息头（ref: 附录）加密后的消息体未加密的消息体格式返回结果代码返回结果描述名称说明数据类型长度（字节）ResultCode返回结果代码（0:成功；1:失败）String16ResultDesc返回结果文字描述String256客户端登录接口我们的服务器和他们服务器的接口接口描述ISV的智能客户端可以通过本接口进行客户端登录鉴权。对于ISV的B/S架构应用应统一使用SaaS平台集成验证进行登录鉴权。由于是C/

24、S结构,可能会影响其余B/S应用的SSO登录体验交互流程用户在客户端输入用户名及密码。ISV客户端将用户名，密码及其他系统配置信息通过接口发送到ISV服务端ISV服务端通过Web Service调用SaaS平台的登录鉴权接口SaaS平台服务端将登录验证结果发回ISV服务端ISV服务端将登录验证结果发回至客户端应用场景接口定义消息类型编码SYS10201请求消息消息格式Request通用消息头（ref: 附录）加密后的消息体未加密的消息体格式应用提供商编号 应用系统编号用户名密码名称说明数据类型长度（字节）ISVID应用提供商编号String16AppID应用系统编号String16Userna

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

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

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

28、据类型长度（字节）CorpID企业客户编号String16返回消息消息格式Response通用消息头（ref: 附录）加密后的消息体未加密的消息体格式返回结果代码返回结果描述企业客户编号企业客户名称企业客户简称企业客户英文名称企业客户英文简称企业FQDN企业营业执照号企业法人企业管理员联系电话企业管理员联系手机企业管理员联系邮件企业地址企业邮寄地址 邮编企业电话传真号码邮箱地址企业WEB网址企业LogoURL 变更时间名称说明数据类型长度（字节）ResultCode返回结果代码(0: 处理成功；1: 处理失败)String16ResultDesc返回结果描述String256CorpID企业客

29、户编号String16CorpName企业客户名称String64ShortName企业客户简称String32EnglishName企业客户英文名称String128EngShortName企业客户英文简称String32FQDN企业FQDNString256CorpLicense企业营业执照号String64LegalPerson企业法人String64AdminPhone 企业管理员联系电话String32AdminMobile企业管理员联系手机String32AdminEmail 企业管理员联系邮件String80Address企业地址String256MailingAddress企业

30、邮寄地址String256ZipCode邮编String6Phone企业电话String32Fax传真号码String32Email邮箱地址String80WebSite企业WEB网址String100CorpLogoURL企业Logo URLString256UpdateTime变更时间，格式为YYYYMMDDHHmmssfffString17企业员工信息接口接口描述对于需要企业员工信息的ISV应用，则实现该接口，以接受企业员工信息更新。交互流程管理员在平台中更新企业员工信息。ISV定期（按需）从SaaS平台获取最新的企业员工信息。SaaS平台将最新的企业员工信息返回至ISV。ISV应用系统

31、更新本地数据系统。应用场景接口定义消息类型编码SYS10302请求消息消息格式Request通用消息头（ref: 附录）加密后的消息体未加密的消息体格式企业客户编号用户ID ,n名称说明数据类型长度（字节）CorpID企业客户编号String16UserIDs用户ID列表(以逗号分割，用户ID是Guid的串);至少包含一个用户ID String返回消息消息格式Response通用消息头（ref: 附录）加密后的消息体未加密的消息体格式返回结果代码返回结果描述企业客户编号用户ID用户名称别名性别用户登录名用户AD 帐号用户SAM帐户邮箱地址联系地址HomeAddress身份证出生日期部门ID 职

32、务办公电话移动电话变更时间名称说明数据类型长度（字节）ResultCode返回结果代码（0: 成功；1: 失败）String16ResultDesc返回结果描述String256CorpID企业客户编号String16UserID用户ID(Guid)String36StaffName用户名称String32Alias别名String32Sex性别F女 M男String1UserName用户登录名String20ADAccount用户AD 帐号String50SAMAccount用户SAM帐户String20Email邮箱地址String80Address联系地址String256CardID证

33、件号String32Birthday出生日期格式为YYYYMMDDString8DeptID部门IDString16Position职务String32OfficePhone办公电话String24MobilePhone移动电话String24UpdateTime变更时间，格式为YYYYMMDDHHmmssfff（必填）String17企业部门信息接口接口描述对于需要企业部门信息的ISV应用，则实现该接口，以接受企业部门信息更新。交互流程管理员在平台中更新企业部门信息。ISV定期（按需）从SaaS平台获取最新的企业部门信息。SaaS平台将最新的企业部门信息返回至ISV。ISV应用系统更新本地数

34、据系统。应用场景接口定义消息类型编码SYS10303请求消息消息格式Request通用消息头（ref: 附录）加密后的消息体未加密的消息体格式企业客户编号部门ID,n名称说明数据类型长度（字节）CorpID企业客户编号String16DeptIDs部门ID 列表(以逗号分割)String256返回消息消息格式Response通用消息头（ref: 附录）加密后的消息体未加密的消息体格式返回结果代码返回结果描述企业客户编号部门ID 上级部门ID 部门名称部门描述部门电话部门传真号变更时间名称说明数据类型长度（字节）ResultCode返回结果代码(0: 处理成功；1: 处理失败)String16R

35、esultDesc返回结果描述String256CorpID企业客户编号String16DeptID部门IDString16ParentID上级部门ID，无上级部门填0String16DeptName部门名称String32DeptDesc部门描述String100DeptPhone部门电话String32DeptFax部门传真号String32DeptMgrID部门负责人用户ID(可转换为Guid的串)String36UpdateTime变更时间，格式为YYYYMMDDHHmmssfffString17企业通讯录信息接口接口描述对于需要企业通讯录信息的ISV应用，则实现该接口，以接受企业通讯

36、录信息更新。交互流程管理员在平台中更新企业通讯录信息。ISV定期（按需）从SaaS平台获取最新的企业通讯录信息。SaaS平台将最新的企业通讯录信息返回至ISV。ISV应用系统更新本地数据系统。应用场景接口定义消息类型编码SYS10304请求消息消息格式Request通用消息头（ref: 附录）加密后的消息体未加密的消息体格式企业客户编号联系人ID ,n名称说明数据类型长度（字节）CorpID企业客户编号String16ContactIDs联系人ID列表(以逗号分割).如果 是空串,则表示获取所有联系人String返回消息消息格式Response通用消息头（ref: 附录）加密后的消息体未加密的

37、消息体格式返回结果代码返回结果描述企业客户编号联系人ID联系人全名 联系人名字 联系人中间名 联系人姓氏 职位电子邮件公司电话家庭电话移动电话家庭住址邮政编码变更时间名称说明数据类型长度（字节）ResultCode返回结果代码(0:处理成功；1: 处理失败)String16ResultDesc返回结果描述String256CorpID企业客户编号String16ContactID联系人IDString16FullName联系人全名String64FirstName联系人名字String24MiddleName联系人中间名String16LastName联系人姓氏String24Title职位S

38、tring32Email电子邮件String80CompanyPhone公司电话String32HomePhone家庭电话String32Mobile移动电话String24HomeAddress家庭住址String256Zipcode邮政编码String6UpdateTime变更时间，格式为YYYYMMDDHHmmssfffString17ISV消息通知接口接口描述ISV产品中会发生一些事件，比如：剩余金额不够时或者产品中重要信息被更改时等等，此时ISV产品需要向用户发送一些消息通知。目前平台提供三种消息，分别为短信通知，邮件通知和Web站内消息通知。ISV可以使用这些通知方式来通知相应的产

39、品用户。交互流程ISV调用平台消息通知接口。SaaS平台将消息根据类型发送出去。接口定义消息类型编码SYS10601请求消息消息格式Request通用消息头（ref: 附录）加密后的消息体未加密的消息体格式企业客户编号 用户类型（是否管理员）用户ID消息类型消息标题消息内容名称说明数据类型长度（字节）CorpID企业客户编号String16UserType用户类型（是否管理员）(1: 企业管理员；0:企业普通用户)String1UserID用户ID（可转化成Guid），如果UserType为1，则该项传递的任何值都被忽略；如果UserType为0，则需要准确的相应用户IDString36Mes

40、sageType消息类型， 0001为Web站内消息，0010为短信消息，0100为邮件通知。如果想同时发送多种消息，则对这三种基本消息格式做叠加，如0011：是同时发送站内消息和短信通知，0101是同时发送站内消息和邮件通知，0110是同时发送短信消息和邮件通知，0111是同时发送三种消息。注意：同时发送多类消息时，需要注意内容长度，比如同样的消息，邮件可能就是一封，但短信可能就是多条，所以在发送消息时注重用户的可读性。String4MessageSubject消息标题，其中可以含有占位符(ref:占位符)string=256MessageBody消息内容，其中可以含有占位符(ref:占位符

41、)，如果还想发送Html的邮件，请将Text消息和Html消息之间使用关键词stone进行分割，但必须Html中的都变成都变成String=8000返回消息消息格式Response通用消息头（ref: 附录）加密后的消息体未加密的消息体格式返回结果代码返回结果描述名称说明数据类型长度（字节）ResultCode返回结果代码，更多结果代码，请（ref: 消息返回码定义）(0: 处理成功；1: 处理失败)String16ResultDesc返回结果描述String256占位符定义占位符含义AppName对应产品在平台中的名称CompanyName对应的企业名称UserName对应的发送给用户的名称

42、ISV应用系统提供SaaS管理平台接口(SaaS管理平台ISV应用系统)企业客户业务受理接口接口描述企业客户在系统订购业务成功后，SaaS管理平台管理员需要调用该接口使新产生的订购关系生效，该接口主要功能是将企业客户业务订购信息同步到相应的ISV应用系统；ISV应用系统为企业客户配置相应的业务数据。交互流程企业客户提交业务订购申请,系统管理员确认企业客户提交的资料信息。系统根据企业客户提交的申请资料生成订购关系，包括企业客户订购的功能点、业务配置信息（如邮箱系统邮件大小、附件大小等）及其他信息。SaaS管理平台调用ISV应用系统提供的该接口将业务订购关系同步到ISV应用系统，ISV应用系统再自

43、行处理，为企业客户分配相应的业务资源信息。ISV应用系统返回企业客户业务受理结果消息。应用场景接口定义消息类型编码ISV10101请求消息消息格式Request通用消息头（ref: 附录）加密后的消息体未加密的消息体格式绑定标志绑定说明应用（产品）编号企业客户编号企业客户编号企业客户名称企业客户简称企业客户英文名称企业客户英文简称企业FQDN企业营业执照号 企业法人企业管理员GUID企业管理员联系电话企业管理员联系手机企业管理员联系邮件企业地址企业邮寄地址 邮编企业电话传真号码邮箱地址企业WEB网址企业LogoURL 变更时间 订购人GUID 订购人帐号 订购人显示名 订购人办公电话 订购人手

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

45、数名String64ParamValue业务订购配置参数值String256只有针对特殊产品才传入OrderCode的参数ModuleList订购模块列表（以逗号分割）StringStartTime开始时间（只对OPType: 1,4有效）格式为：YYYYMMDDHHmmssfffString17EndTime结束时间（只对OPType: 1,4有效）格式为：YYYYMMDDHHmmssfffString17返回消息消息格式Response通用消息头（ref: 附录）加密后的消息体未加密的消息体格式返回结果代码返回结果描述名称说明数据类型长度（字节）ResultCode返回结果代码（0:成功；

46、1:失败）String16ResultDesc返回结果文字描述String256企业客户员工业务受理接口我们开放给他们服务器的接口接口描述对于需要个人帐号的ISV应用，如企业邮箱、OA系统等，这些应用必须绑定企业客户员工帐号信息，否则应用无法开展。企业客户管理员或客户经理是员工帐号绑定的发起者，通过调用该接口一次可实现多个员工帐号信息的批量受理。交互流程企业客户管理员分配员工帐户。系统根据企业客户管理员提交的员工帐户分配情况生成员工用户订购关系，包括企业客户员工订购的功能点、业务配置信息（如邮箱系统邮件大小、附件大小等）及其他信息。SaaS管理平台调用ISV应用系统提供的该接口将业务订购关系同

47、步到ISV应用系统，ISV应用系统再自行处理，为企业客户员工分配相应的业务资源信息。ISV应用系统返回企业客户员工业务受理结果消息。应用场景接口定义消息类型编码ISV10102请求消息消息格式Request通用消息头（ref: 附录）加密后的消息体未加密的消息体格式绑定标志绑定说明应用（产品）编号企业客户编号用户ID用户类型用户名称别名性别用户登录名用户AD 帐号用户SAM帐户邮箱地址联系地址HomeAddress身份证出生日期部门ID 职务办公电话移动电话变更时间开始时间结束时间名称说明数据类型长度（字节）OPType操作类型：1:开通4 : 停用String8OPNote绑定说明，例如：业

48、务变更原因等。String256AppID应用（产品）编号String16CorpID企业客户编号String16Staffs企业客户员工的信息列表StringStartTime开始时间（只对OPType: 1有效）格式为：YYYYMMDDHHmmssfffString17EndTime结束时间（只对OPType: 1有效）格式为：YYYYMMDDHHmmssfffString17返回消息消息格式Response通用消息头（ref: 附录）加密后的消息体未加密的消息体格式返回结果代码返回结果描述名称说明数据类型长度（字节）ResultCode返回结果代码（0:成功；1:失败）String16R

49、esultDesc返回结果文字描述String256角色列表同步（读取）接口接口描述SaaS管理平台的权限管理分为角色管理及用户权限管理。其中，角色管理由各ISV内部管理维护，SaaS管理平台通过此接口获得各ISV的内部角色，以便对用户帐户权限进行统一控制。交互流程管理员获得企业所订购所有ISV应用的角色列表，以便对用户权限进行集中授权。SaaS管理平台递归此企业订购的各ISV应用（产品）集。SaaS平台依次从2中各ISV应用处获得相应角色列表。ISV应用系统返回企业在此系统中对应的角色列表。应用场景接口定义消息类型编码ISV10201请求消息消息格式Request通用消息头（ref: 附录）

50、加密后的消息体未加密的消息体格式应用提供商编号应用（产品）编号企业客户编号名称说明数据类型长度（字节）ISVID应用提供商编号String16AppID应用（产品）编号String16CorpID企业客户编号String16返回消息消息格式Response通用消息头（ref: 附录）加密后的消息体未加密的消息体格式返回结果代码返回结果描述应用提供商编号应用（产品）编号企业客户编号角色ID角色名角色描述名称说明数据类型长度（字节）ResultCode返回结果代码(0: 成功；1: 失败)String16ResultDesc返回结果描述String256ISVID应用提供商编号String16Ap

51、pID应用（产品）编号String16CorpID企业客户编号String16RoleList角色列表-RoleInfo角色信息-RoleID角色ID(ISV系统内部角色ID)String16RoleName角色名String64RoleDesc角色描述String256用户角色权限同步（读取）接口接口描述SaaS管理平台的权限管理分为角色管理及用户权限管理。其中，角色管理由各ISV内部管理维护，而用户权限通过SaaS管理平台进行集中设置管理。考虑到系统设计的松散耦合原则及SOA体系架构，用户对各ISV应用的权限配置信息都存放在各ISV应用中，由各ISV应用进行host，SaaS管理平台只进行

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

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

54、ing16UserID用户IDString36RoleList角色列表-RoleID角色ID(ISV系统内部角色ID)String64用户角色权限同步（更新）接口接口描述SaaS管理平台的权限管理分为角色管理及用户权限管理。其中，角色管理由各ISV内部管理维护，而用户权限通过SaaS管理平台进行集中设置管理。管理员在SaaS管理平台中对各个用户设置相应ISV应用角色权限后，SaaS平台调用此接口将更新的用户角色权限同步至各ISV应用中，以使ISV的本地系统中的用户角色权限控制始终保持与平台的一致性。交互流程管理员在平台中设置用户角色权限信息。SaaS管理平台递归此企业订购的各ISV应用（产品）

55、集。SaaS平台依次对2中各ISV应用调用本接口将更新的用户角色权限同步写回。ISV应用系统返回处理结果。应用场景接口定义消息类型编码ISV10203请求消息消息格式Request通用消息头（ref: 附录）加密后的消息体未加密的消息体格式应用提供商编号应用（产品）编号企业客户编号用户ID角色1,角色2,名称说明数据类型长度（字节）ISVID应用提供商编号String16AppID应用（产品）编号String16CorID企业客户编号String16UserID用户IDString36RoleIDs角色ID(ISV系统内部角色ID)列表（以逗号分割）String返回消息消息格式Response

56、通用消息头（ref: 附录）加密后的消息体未加密的消息体格式返回结果代码返回结果描述名称说明数据类型长度（字节）ResultCode返回结果代码（0:成功；1:失败）String16ResultDesc返回结果文字描述String256 产品业务期限查询接口接口描述 对于部分ISV产品，SaaS平台不能知道该产品具体的有效时间。这个接口，就是处理对于这样的产品，去调用ISV的接口，得到具体客户对应的ISV产品的有效时间。交互流程用户在订购产品的时候，系统记录计划去调用ISV接口的时间后台服务,定期执行计划任务去调用ISV的接口根据返回的数据，更新下一次计划执行调用接口的时间应用场景接口定义消息

57、类型编码ISV10401请求消息消息格式Request通用消息头（ref: 附录）加密后的消息体未加密的消息体格式应用（产品）编号企业客户编号名称说明数据类型长度（字节）AppID应用（产品）编号String16CorpID企业客户编号 String16返回消息消息格式Response通用消息头（ref: 附录）加密后的消息体未加密的消息体格式返回结果代码返回结果描述可使用月数(整型)发送邮件提醒内容(字符型)名称说明数据类型长度（字节）ResultCode返回结果代码（0:成功；1:失败）String16ResultDesc返回结果文字描述String256UseTimeLimit可使用月数

58、(整型)Int32RemindContent发送邮件提醒内容(字符型)String256附录一：PDU通用HEAD（消息头）Request通用HEAD（消息头）名称说明数据类型长度（字节）Code操作码（参见附录三）String8CTID客户端交易序列号（在发起方唯一标识一个交易的流水号，客户系统内16位唯一标示号）组成方式：8位日期8位唯一数，每天从00000001开始，如2008031500000001String16AppID业务应用标识（标识是哪个ISV应用系统，由平台统一分配）String16SubmitTime提交时间，格式为：YYYYMMDDHHmmssfffString17Ve

59、rsion版本号（保留字段）当前值: 1String10Priority优先级（保留字段）当前值: 10Int3Response通用HEAD（消息头）名称说明数据类型长度（字节）Code操作码（参见附录三）String8CTID客户端交易序列号（在发起方唯一标识一个交易的流水号，客户系统内16位唯一标示号）组成方式：8位日期8位唯一数，每天从00000001开始，如2008031500000001String16STID服务端交易序列号（在接受方唯一标识一个交易的流水号，平台系统内唯一20位唯一流水）组成方式：AppID + “_” + 8位日期8位唯一数，每天从00000001开始，如PRO

60、200805140007_2008031500000001String32AppID业务应用标识（标识是哪个ISV应用系统，由平台统一分配）String16RequestTime请求接受时间，格式为：YYYYMMDDHHmmssfffString17ResponseTime响应处理时间，格式为：YYYYMMDDHHmmssfffString17Version版本号（保留字段）当前值：1String10Priority优先级（保留字段）当前值：10(能转换为int的串)String16Status返回结果状态(能转换为int的串)(0: 正常；-1: 系统调用异常)String16附录二：数据类