集团客户门户 - 详细设计规格说明书 下载本文

中国移动河南公司网上营业厅详细设计说明书

3 总体结构说明

3.1 子系统结构

数据库数据库层电子渠道接口NGCS客服接口联动优势接口Actions客户服务网上选号数据库服务器 防火墙业务推广接口接口服务InterfaceService菜单服务MenuService日志服务LogService移动之家??Actions个人信息业务办理话费服务表1表2数据库实体充值服务ChargeService活动服务ActivityService缓存服务CacheService其它服务??HibernateORM 层缓存ActionSupport单点登录模板适配菜单适配业务介绍??类1类2Domain 实体类Spring控制层Struts2 Freemarker视图层ORM层控制层视图层

3.1.1 依赖的外部接口

3.1.1.1 集团预约接口(HTTP+PSOT+XML)

3.1.1.1.1 集团账户开户预约

接口标准定义

接口发送地址是:http://218.206.204.18:8082/jttiyan/order/zhorder.action 此接口采用HTTP+POST+XML 传入参数列表

参数名字 TransactionID 参数说明 事务ID 全局唯一 备注 以毫秒为单位的当前时间(必填项) 亚信科技(中国)有限公司 - 4 -

中国移动河南公司网上营业厅详细设计说明书

Platform MhOrderId GroupName GroupStName ComAddress CerType CerContent ComPhone ComFax ComLegalRep ComSiteUrl ComEmail OrderMsisdn CityName AreaName Key 平台编码 预约单号 集团名称 集团简称 公司地址 证件类型 证件号码 联系电话 传真 法人代表 企业网址 集团Email 预约人手机号 所属城市名称 所属城市下的所属区县名称 加密key 目前集团客户门户帐号预约暂定为JTMHZHYY(必填项) (必填项)0<长度<=20 (必填项)0<长度<=50 (必填项)0<长度<=20 (必填项)0<长度<=200 (必填项)0<长度<=10 (必填项)0<长度<=50 (必填项)0<长度<=50 0<=长度<=50 0<=长度<=50 0<=长度<=50 0<=长度<=50 (必填项)限河南移动 详见《集团业务体验中心--地市区县统计v1.0》(必填项) 详见《集团业务体验中心--地市区县统计v1.0》(必填项) Key是一个MD5加密的字符串key=TransactionID+Platform+KEY 其中KEY暂定为JTYWTYZXZHYY(必填项) 响应参数列表 参数名字 TransactionID Platform ResultCode 参数说明 事务ID 全局唯一 平台编码 响应编码 备注 以毫秒为单位的当前时间 目前集团客户门户帐号预约暂定为JTMHZHYY 不同的指令会对应不同请求 返回具体值,对于信息如下 功能需求 集团账号预约可为中国移动潜在集团客户提供在线预约申请成为集团单位的功能,针对未建档,且有开户、业务办理意向的集团客户进行开户预约。当用户在集团客户门户预约集团账号时,门户将预约单提交到集团业务体验中心预约管理系统,系统按照集客自有平台原产品预约流程派发预约单。

3.1.1.1.2集团账户预约开通状态查询

接口标准定义

接口发送地址是:http://218.206.204.18:8082/jttiyan/order/cxzhyyorder.action(地址可能有变,到联调的时候确认) 此接口采用HTTP+POST+XML 传入参数列表 参数名字 参数说明 备注 亚信科技(中国)有限公司 - 5 -

中国移动河南公司网上营业厅详细设计说明书

TransactionID Platform OrderMsisdn 事务ID 全局唯一 平台编码 预约人手机号 加密key 以毫秒为单位的当前时间 目前集团客户门户集团帐号预约查询暂定为JTMHZHYYCX Key是一个MD5加密的字符串key=TransactionID+Platform+KEY 其中KEY暂定为JTYWTYZHYYCX 备注 以毫秒为单位的当前时间 目前集团客户门户集团帐号预约查询暂定为JTMHZHYYCX 不同的指令会对应不同请求 返回具体值,对于信息如下 这个是对于ResultCode=0000成功的时候返回的值具体描述如下: Key 响应参数列表 参数名字 TransactionID Platform ResultCode ResultMsg 参数说明 事务ID 全局唯一 平台编码 响应编码 响应信息 ResultCode响应编码描述: 返回代码(resultCode) 9001 9002 0000 0001 0002 0003 ResultMsg响应编码描述: 参数名字 OrderID 参数说明 预约单号 备注 《集团帐号预约接口规范说明书》中门户传人的预约单好一致 格式为:yyyy-MM-dd HH:mm:ss 返回数字1、2、3、4 状态为工单完结时返回 状态为工单完结时返回 标识标识说明 错误 Key值不存在 成功 Xml格式不正确 预约人手机号不合法 没有此人的预约单 GroupName OrderTime OrderSta CusManName CusMsisdn 功能需求

集团名称 预约时间 状态(1派单中|2处理中|3工单完结|4已删除) 处理预约的客户经理 客户经理联系方式 用户在集团客户门户查询预约单时,门户使用手机号码访问集客的预约单查询接口,集客返回该手机号的集团帐号预约单状态列表。

亚信科技(中国)有限公司 - 6 -

中国移动河南公司网上营业厅详细设计说明书

3.1.1.1.3根据手机号码查询是否为集团联系人

接口标准定义 入参: 序号 数据名 1 交易代码 ServNum 描述 交易代码 手机号 大小 必选项 6 15 备注 集团联系人手机号 99991 Y 出参: 序号 数据名 1 2 3 交易代码 CustName GroupCustId IsSuccess 描述 交易代码 集团名称 集团编号 状态码 大小 必选项 6 5 20 20 备注 返回参数 返回参数 Y 成功 N 失败 99991 Y Y Y 说明:传入手机号,如果手机号时集团联系人,则返回状态码“Y”及集团名称和集团编号, 如果该手机号不是集团联系人,则状态码为“N”、集团名称和集团编号返回空。 功能需求

根据用户手机号码查询是否为为集团联系人,如果是集团联系人,则返回有集团信息,如果不是,则返回集团信息为空

3.1.1.1.4根据集团编号查询集团信息

接口标准定义 入参: 序号 数据名 1 交易代码 customerId 描述 交易代码 集团编号 大小 必选项 6 15 备注 传入参数,集团编号 99997 Y 出参: 序号 数据名 1 2 3 4 5 6 7 8 9 10 11 交易代码 custName shortName addr cardType cardNo fax phone ownerName web groupEmail IsSuccess 描述 交易代码 集团名称 集团简称 公司地址 证件类型 证件号码 传真 联系电话 法人代表 企业网址 集团Email 操作标识 大小 必选项 6 5 20 20 20 20 20 20 20 20 20 20 备注 返回参数 返回参数 返回参数 返回参数 返回参数 返回参数 返回参数 返回参数 返回参数 返回参数 返回Y,操作成功,N操作失99997 Y Y Y Y Y Y Y Y Y Y Y 亚信科技(中国)有限公司 - 7 -