中国电信领航平台(ISMP-B)技术规范——省领航平台管理子系统产品接入接口(V3.0).doc

保密等级 公开发放 中国电信集团公司企业标准 Q CT XXXX 2014 中国电信领航平台 ISMP B 技术规范 省领航平台 ISMP B 管理子系统产品接入 接口 V3 0 Technical specifications of China Telecom Business Navigator Platform Interface of Access product for Management subsystem of Bnet platform of Province V3 0 2014 04 发布 2014 04 实施 中国电信集团公司 发布 Q CT XXXX 2014 II 目目 次次 目 次 II 前 言 IV 1 适用范围 1 2 引用标准 2 3 缩略语 3 4 接口概述 4 4 1方案概述 4 4 2功能界定 4 4 2 1客户受理产品 4 4 2 2用户绑定 变更 解绑产品 4 4 2 3用户登录使用产品 5 4 2 4用户受理产品 5 4 2 5用户操作行为同步接口 6 4 2 6清单 业务使用情况采集接口 6 4 2 7产品服务监控 6 4 2 8产品平台对改号的支持 6 4 2 9轻量认证鉴权接口 6 4 2 10支付结果通知 7 5 接口定义 8 5 1SOAP HTTP 方式 8 5 1 1客户开通 变更 退订产品接口 8 5 1 2客户信息查询接口 13 5 1 3用户绑定 变更 解绑产品接口 19 5 1 4用户信息查询接口 24 5 1 5用户使用产品认证鉴权接口 28 5 1 6用户受理请求接口 30 5 1 7使用客户端产品认证鉴权接口 可选 32 Q CT XXXX 2014 III 5 1 8轻量认证鉴权接口 34 5 1 9工单报峻接口 37 5 2数据库共享表方式 可选 38 5 2 1接口描述 38 5 2 2接口数据表定义 38 5 3FTP 方式 41 5 3 1使用清单采集接口 41 5 3 2业务使用情况采集接口 45 5 3 3用户操作行为同步接口 50 5 4业务监控协议方式 可选 52 5 4 1产品平台监控接口 52 附录 A 54 Q CT XXXX 2014 IV 前前 言言 本规范是中国电信领航平台系列规范之一 本规范定义了领航平台与产品平台的集成规范 包括功 能界定 接口定义等 本规范由中国电信集团提出并归口 本规范起草单位 中国电信股份有限公司广州研究院 修订记录如下 版本版本日期日期修订人修订人概述概述 修订 2010 9 20 李蓉蓉增加字段记录手机的 IMSI 信息 修订 2010 11 5 李蓉蓉所有 FTP 接口均增补文件头 修订 2012 09 10 李蓉蓉增加销售品 用户改号等商务领航 5 0 业务支持 修订 2013 11 13 李蓉蓉 增加用户受理接口 增加用户操作行为同步接口 增加话单同步接口 修改使用客户端产品认证鉴权接口中增加 0207 用户改密接口 修订 2014 4 3 舒大海 增加轻量认证鉴权接口 增加工单报竣接口 增加报竣优化异常信息定位 XX 平台返回 Q CT XXXX 2014 0 Q CT XXXX 2014 1 1 适用范围适用范围 本规范适用于中国电信领航平台的设计及研发 提供给为中国电信开发领航平台的相关厂商 本规 范是中国电信各级运营单位进行领航平台招标采购 工程设计 网络运营 管理 维护等方面的技术依 据 Q CT XXXX 2014 2 2 引用标准引用标准 下列文件通过本文的参考而成为本规范的条款 凡是注日期的参考文件 其随后所有的修改单 不 包括勘误的内容 或修订版均不适用于本文 凡是不注日期的参考文件 其最新版本适用于本文 1 中国电信集团领航平台业务规范 6 0 版 Q CT XXXX 2014 3 3 缩略语缩略语 缩略语缩略语中文全名中文全名 FTP 文件传输协议 SOAP 简单对象访问协议 XML 可扩展的标记语言 其他缩略语参见 中国电信领航平台 ISMP B 技术规范 总册 Q CT XXXX 2014 4 4 接口概述接口概述 4 1 方案概述方案概述 在在 SISI 产品接入领航平台时 主要完成接口相关工作包括 产品接入领航平台时 主要完成接口相关工作包括 1 首先 领航平台与 SI 产品在线下完成产品基础信息的确认工作 领航平台提供产品平台的数据 包括 SI 产品标识 领航平台的接口 webservice 地址 产品的相关参数字典说明 产品平台需 要提供给领航平台的基础信息包括 产品平台接受 HTTP 请求的地址 2 其次 领航平台与 SI 产品平台的接口完成同步数据接口 主要包括客户 用户信息同步 3 然后 实现客户使用领航平台 可以直接登录使用 SI 产品 即领航平台与 SI 产品平台实现单 点认证 产品平台需要屏蔽原用户认证登录功能 全部改成用户登录时与领航平台进行认证的 方式 在在 SISI 产品与领航平台接入接口对接工作完成后 与产品相关的操作流程 产品与领航平台接入接口对接工作完成后 与产品相关的操作流程 1 在 CRM 完成客户产品受理后 同步数据到领航平台 2 领航平台通过产品接入接口同步客户 用户相关数据信息给产品平台 产品平台能通过客户 用户信息查询接口 获取客户 用户的个性化产品属性信息内容 3 客户在使用产品时 产品平台必须先通过领航平台的产品认证鉴权接口 验证用户的合法性 方能提供用户具体使用产品的功能项 4 2 功能界定功能界定 4 2 14 2 1客户受理产品客户受理产品 4 2 1 14 2 1 1 产品平台产品平台 产品开通 从客户开通产品接口客户开通产品接口接收省领航平台 ISMP B 管理子系统发送的客户基础信息 并通过 客户信息查询接口客户信息查询接口查询客户开通产品属性信息 执行产品系统内部新增客户功能后 通过应答返回客户 开通结果给省领航平台 ISMP B 管理子系统 产品变更 从客户变更产品接口客户变更产品接口接收省领航平台 ISMP B 管理子系统发送的客户变更产品属性信息 并通过客户信息查询接口客户信息查询接口查询客户开通产品属性信息 执行产品系统内部变更客户产品属性信息后 通 过应答返回客户变更结果给省领航平台 ISMP B 管理子系统 产品退订 从客户退订产品接口客户退订产品接口接收省领航平台 ISMP B 管理子系统发送的客户退订产品信息 执 行产品系统内部注销客户信息后 通过应答返回客户退订结果给省领航平台 ISMP B 管理子系统 4 2 1 24 2 1 2 省领航平台省领航平台 ISMP B ISMP B 管理子系统管理子系统 产品开通 接收 CRM 派送的客户开通产品信息 通知能力网关新增客户产品配置数据 通知产品平 台新增客户产品配置数据 返回受理结果给 CRM 系统 产品变更 接收 CRM 派送的客户变更产品属性信息 通知能力网关更新客户产品配置数据 通知产 品平台更新客户产品配置数据 返回受理结果给 CRM 系统 产品退订 接收 CRM 派送的客户退订产品信息 通知能力网关注销客户产品配置数据 通知产品平 台注销客户产品配置数据 返回受理结果给 CRM 系统 4 2 24 2 2用户绑定用户绑定 变更变更 解绑产品解绑产品 4 2 2 14 2 2 1 产品平台产品平台 用户绑定产品 从用户绑定产品接口用户绑定产品接口接收省领航平台 ISMP B 管理子系统发送的用户基础信息 并 通过用户信息查询接口用户信息查询接口查询用户绑定产品的个性化信息 执行产品系统内部新增用户功能后 通过应答 Q CT XXXX 2014 5 返回用户绑定产品结果给省领航平台 ISMP B 管理子系统 用户变更产品 从用户变更产品接口用户变更产品接口接收省领航平台 ISMP B 管理子系统发送的用户变更信息 并 通过用户信息查询接口用户信息查询接口查询用户绑定产品的个性化信息 执行产品系统内部更新用户信息后 通过应答 返回用户变更结果给省领航平台 ISMP B 管理子系统 用户解绑产品 从用户解绑产品接口用户解绑产品接口接收省领航平台 ISMP B 管理子系统发送的用户解绑产品信息 执行产品系统内部注销用户产品绑定关系 并通过应答返回用户解绑产品结果给省领航平台 ISMP B 管 理子系统 4 2 2 24 2 2 2 省领航平台省领航平台 ISMP B ISMP B 管理子系统管理子系统 用户绑定产品 从 CRM 接收用户绑定产品信息 通过用户绑定产品接口用户绑定产品接口通知产品平台用户信息 返 回处理结果给 CRM 系统 用户变更产品 从 CRM 接收用户变更产品属性信息 通过用户变更产品接口用户变更产品接口通知产品平台用户变更 产品属性信息 返回处理结果给 CRM 系统 用户解绑产品 从 CRM 接收用户解绑产品信息 通过用户解绑产品接口用户解绑产品接口通知产品平台用户解绑 返 回处理结果给 CRM 系统 4 2 34 2 3用户登录使用产品用户登录使用产品 4 2 3 14 2 3 1 产品平台产品平台 a 企业管理员或用户可在产品平台直接登陆 有两种方式 1 产品平台调用领航平台提供的 URL 登录页面 以保证各个产品平台登录页面的一致性 如果产 品平台属于手机客户端登陆等领航平台暂时不提供的登陆方式 则需要产品平台按照领航平台 登陆界面要求实现自己账号登陆 但是密码不要在产品平台进行变更 2 省领航平台 ISMP B 管理子系统与客户端产品服务端实现用户统一认证接口 用户通过认证鉴 权后使用产品 b 用户登录领航平台使用产品 用户使用产品前 需经过集团领航平台 ISMP B 管理子系统提供 的用户认证数据接口 通过认证鉴权后使用产品 4 2 3 24 2 3 2 省领航平台省领航平台 ISMP B ISMP B 管理子系统管理子系统 a 在产品平台登录时 有两种情况 1 领航平台提供统一 URL 登录页面 供产品平台调用 以保证产品平台登录界面的一致性 2 领航平台提供客户端用户统一认证接口 产品平台调用接口鉴权认证用户 b 用户登录使用产品 领航提供统一登录界面 并且提供认证鉴权服务 为产品平台进行用户认 证鉴权 4 2 44 2 4用户受理产品用户受理产品 4 2 4 14 2 4 1 产品平台产品平台 用户订购产品 将用户订购数据送集团领航平台 ISMP B 管理子系统 通过集团领航平台 ISMP B 管理子系统调用翼支付进行费用支付 用户取消订单产品 将用户取消订单数据送集团领航平台 ISMP B 管理子系统 集团领航平台 ISMP B 管理子系统做订单取消操作 用户续费产品 将用户续费数据送集团领航平台 ISMP B 管理子系统 通过集团领航平台 ISMP B 管理 子系统调用翼支付进行费用支付 Q CT XXXX 2014 6 4 2 4 24 2 4 2 省省领航平台领航平台 ISMP B ISMP B 管理子系统管理子系统 用户订购产品 接收产品平台的用户订购数据 然后通过调用翼支付接口进行费用支付 用户取消订单产品 接收产品平台的用户取消订购数据 用户续费产品 接收产品平台的用户续费数据 然后通过调用翼支付接口进行费用支付 4 2 54 2 5用户操作行为同步接口用户操作行为同步接口 4 2 5 14 2 5 1 产品平台产品平台 将用户在产品平台的操作行为通过 ftp 同步到集团领航平台 4 2 5 24 2 5 2 集团领航平台集团领航平台 ISMP B ISMP B 管理子系统管理子系统 接收产品平台的用户操作行为数据 4 2 64 2 6清单 业务使用情况采集接口清单 业务使用情况采集接口 4 2 6 14 2 6 1 产品平台产品平台 生成清单 根据业务需要 按照指定格式生成客户 用户的使用产品详细清单数据 业务使用情况 根据业务需要 提供省领航平台 ISMP B 管理子系统查询客户 用户使用具体产品 的业务使用日志情况 4 2 6 24 2 6 2 省领航平台省领航平台 ISMP B ISMP B 管理子系统管理子系统 清单采集 根据业务需要 采集产品平台提供的客户 用户的使用产品详细清单数据 业务使用情况采集 根据业务需要 采集查询产品平台提供的客户 用户使用具体产品的业务使用 日志情况 4 2 74 2 7产品服务监控产品服务监控 4 2 7 14 2 7 1 产品平台产品平台 支持监控协议 支持 SNMP TCP IP 等多种协议 对产品平台进行监控 4 2 7 24 2 7 2 省领航平台省领航平台 ISMP B ISMP B 管理子系统管理子系统 监控产品 省领航平台 ISMP B 管理子系统发起对正式上线的产品平台监控请求 主要监控的内容 是监控产品平台的运行状况 包括产品平台服务器设备运行状态 产品功能服务状态等 4 2 84 2 8产品平台对改号的支持产品平台对改号的支持 产品平台需要支持用户号码的改号 改号的主要调用方式 1 个人单订购客户 产品平台通过客户变更接口接受改号请求 然后通过客户信息查询接口查询 客户改号信息 2 个人 企业双订购的个人客户 产品平台通过用户变更产品接口接受改号请求 然后通过用户信 息查询接口查询客户改号信息 4 2 94 2 9轻量认证鉴权接口轻量认证鉴权接口 业务轻量加载产品 业务加载时 省领航平台跟产品平台之间无需对接原有客户开通 变更 退订等接 口 在业务使用过程中 产品平台需要调用省领航平台的轻量认证鉴权接口进行认证鉴权 省领航平台 认证鉴权完成后 向业务平台返回认证鉴权结果 业务平台根据认证鉴权结果 向客户 用户提供相应的 Q CT XXXX 2014 7 服务 4 2 104 2 10支付结果通知支付结果通知 4 2 10 14 2 10 1产品平台产品平台 将支付结果告知省领航平台 ISMP B 管理子系统 4 2 10 24 2 10 2省省领航平台领航平台 ISMP B ISMP B 管理子系统管理子系统 接收支付结果通知 并将处理结果返回给产品平台 Q CT XXXX 2014 8 5 接口接口定义定义 注 下列 SOAP 的超时时间定义为 30 秒 发起方发起请求开始计时 超过 30 秒后自动断开连接 http 请求的响应时间为 60 秒 5 15 1SOAP HTTPSOAP HTTP 方式方式 省领航平台 ISMP B 管理子系统与产品平台的业务数据通过省领航平台 ISMP B 管理子系统提供的 WebServiceWebService 服务进行交换 省领航平台 ISMP B 管理子系统作为服务端 提供 TradeService wsdlTradeService wsdl 文件 供 SI 产品平台引用 产品平台作为客户端 只需提供一个 URL 地址接受省领航平台 ISMP B 管理子系统 发起的通知消息 具体接口方法及格式定义说明 1 省领航平台省领航平台 ISMP B ISMP B 管理子系统提供的管理子系统提供的 wsdlwsdl 文件地址 文件地址 在在 TradeService wsdlTradeService wsdl 中包含的方法有 中包含的方法有 public String getPortalRequest String streamingno String rand 依据流水号以及随机令牌 取得交易明文 public String getPortalResult String reqXML 依据 XML 请求报文取得相应的 XML 应答报文 public String getEncodeString String decode 依据明文取得相应密文 2 产品平台提供省领航平台产品平台提供省领航平台 ISMP B ISMP B 管理子系统的管理子系统的 URLURL 地址 地址 其中 productid 为产品编号 provinceid 为省标识 在省领航平台 ISMP B 管理子系统触发调用产品平台提供的 HTTP 请求时 产品平台 URL 中包括参数 流水号 streamingno 随机令牌 rand 和密文信息 encode 格式如 streamingno 1111 rand 1234 encode xxxx 3 3 加密协议加密协议 领航平台采用MD5MD5 算法作为系统关键域的加密协议 考虑到各类开发语言基于MD5 算法的实现方面可 能存在差异性 为了实现平台整体的开发语言无关性 平台将MD5算法进行了相应封装 并提供相关的 WEBSERVICE 服务供外界系统调用 getEncodeStringgetEncodeString 5 1 15 1 1客户开通客户开通 变更变更 退订产品接口退订产品接口 5 1 1 15 1 1 1 接口协议概述接口协议概述 接口名称 客户开通 变更 退订产品 接口描述 省领航平台 ISMP B 管理子系统把客户开通 变更 退订产品的数据信息经过产品接 口同步到产品平台 注注 客户产品属性通过客户信息查询接口客户信息查询接口获取 个人单订购 客户单订购 双订购的客户订购走此接口 触发条件 省领航平台 ISMP B 管理子系统向产品平台发送客户开通 变更 退订产品请求时触 发产品平台调用此接口 接口协议 SOAP Document Style 接口调用方向 产品平台 省领航平台 ISMP B 管理子系统 命名空间 接口方法 getPortalRequest getPortalResult 5 1 1 25 1 1 2 接口流程接口流程 主要涉及到的接口调用流程 Q CT XXXX 2014 9 图 1 客户开通 变更 退订产品接口流程 1 客户管理员在集团领航平台管理子系统中客户工作台开通 变更 退订产品 2 集团领航平台管理子系统生成相关参数 StreamingNo rand 和 encode 并存入日志表中 3 集团 BNET 管理子系统调用产品平台提供的 HTTP 请求 在请求中加入关键字信息 格式如下 StreamingNo xxxx rand xxxx encode xxxx 其中 StreamingNo 为明文数字 其中通过时间戳和 4 位随机数组合而成 rand 为 4 位随机数字 encode 为开户请求数据包通过 MD5 加密后的字符串 4 产品平台从 HTTP 请求中获取的交易关键字 StreamingNo rand encode 加入到调用集团 BNET 管理 子系统的 webservice 接口方法 getPortalRequest 中 发起从集团 BNET 管理子系统获取客户信息的 Q CT XXXX 2014 10 请求 5 集团 BNET 管理子系统根据收到的接口参数 判断校验通过后 返回产品平台客户数据内容包 并注 销本次交易流水记录 6 产品平台根据获取的客户数据内容包 调用 getEncodeString 加密获取数据包 7 集团 BNET 管理子系统根据产品平台的请求包加密后返回给产品平台 8 产品平台获取加密后的数据包与第四步中获取的 encode 进行验证 9 第八步验证通过后 产品平台调用集团 BNET 管理子系统的 webservice 接口方法 getPortalResult 发起从集团 BNET 管理子系统的查询某一客户信息请求 10 集团 BNET 管理子系统获取产品平台发起请求报文中的查询密码 并与原先在集团 BNET 管理子系统 设定的产品查询密码进行比较验证 11 第十步验证通过后 集团 BNET 管理子系统返回产品平台客户数据内容包 12 产品平台获取客户数据包内容 进行本地的客户信息处理 13 产品平台将客户信息处理后的结果返回给集团 BNET 管理子系统 14 集团 BNET 管理子系统根据产品平台的处理结果进行了相应的客户产品处理 15 集团 BNET 管理子系统处理完成以后 返回给产品平台一个包含重定向地址的数据内容包 16 产品平台获取返回的报文 解析出其中的重定向的 url 然后重定向操作 5 1 1 35 1 1 3 数据信息定义数据信息定义 5 1 1 3 15 1 1 3 1 领航平台返回产品平台要素定义领航平台返回产品平台要素定义 表 1 领航平台返回产品平台要素定义 参数名类型出现次数长度注释 StreamingNoString132 流水号 OPFlagString14 0101 客户开通 0102 客户变更 0103 客户退订 0107 客户停机 0108 客户复机 0109 改号 TimeStampString118 当前时间戳 YYYYMMDDHHMISS ProductIDString18 产品标识 SIIDString120 SI 标识 OfferIDString0 120 销售品 ID 销售品标识 本期只涉及一个产品包含多个销售品 但一个销售 品只对应一个产品 BizIDString120 客户产品计费标识 PasswordString132 产品查询密码 可为空 AreaCodeString15 客户地区 CustIDString120 客户标识 CustAccountString1100 客户帐号 Q CT XXXX 2014 11 CustNameString1256 客户名称 IMSIString0 120 手机的 IMSI 手机用户个人单订购使用 AccessNoString121 接入号 SummaryString0 164 备注 5 1 1 3 25 1 1 3 2 产品平台返回领航平台应答要素定义产品平台返回领航平台应答要素定义 表 2 产品平台返回领航平台应答要素定义 参数名类型出现次数长度注释 StreamingNoString132 流水号 OPFlagString14 0101 客户开通 0102 客户变更 0103 客户退订 0107 客户停机 0108 客户复机 0109 改号 ReturnStatusString14 应答返回状态 SummaryString11024 备注 当处理失败时 将全量校验和失败的详细错误信息说明加入 XX XX 产品平台返回产品平台返回 5 1 1 3 35 1 1 3 3 产品平台返回领航平台应答结果返回码产品平台返回领航平台应答结果返回码 表 3 产品平台返回领航平台应答结果返回码 结果码结果码错误原因错误原因备注备注 以下为通用返回码以下为通用返回码 00000 交易成功 00001 交易失败 00002 参数要素不全 00003 非业务时间 00004 业务未授权 00005 查询结果为空 00006 系统无此业务 数据库异常数据库异常 00201 查询数据库异常 00202 插入数据异常 00203 修改数据异常 00204 删除数据异常 00205 过程执行异常 业务逻辑错误业务逻辑错误 00401 关键数据项不能为空 Q CT XXXX 2014 12 00402 业务数据内容不存在 00403 数据格式不正确 00404 业务逻辑执行错误 网络通讯错误网络通讯错误 00601 连接服务异常 00602 断开服务异常 00603 发送数据失败 00604 接收数据失败 5 1 1 3 45 1 1 3 4 接口数据包示例接口数据包示例 客户开通产品 领航平台返回产品平台数据包格式 1141 0101 200 30009 300 666666 57102 6 aptest 中国电信测试企业 客户开通产品 客户开通产品 产品平台发送应答数据包到领航平台格式 1141 0101 00000 客户开通产品 客户信息变更 领航平台返回产品平台数据包格式 1141 0102 200 30009 300 666666 Q CT XXXX 2014 13 57102 6 aptest 中国电信测试企业 客户变更产品 客户信息变更 产品平台发送应答数据包到领航平台格式 1141 0102 00000 客户变更产品 客户退订产品 领航平台返回产品平台数据包格式 1141 0103 200 30009 300 666666 57102 6 aptest 中国电信测试企业 客户退订产品 客户退订产品 产品平台发送应答数据包到领航平台格式 1141 0103 00000 客户退订产品 5 1 25 1 2客户信息查询接口客户信息查询接口 5 1 2 15 1 2 1 接口协议概述接口协议概述 接口名称 客户信息查询 Q CT XXXX 2014 14 接口描述 产品平台通过客户信息查询接口 能查到对应产品的客户 用户和产品属性信息 触发条件 产品平台发起查询产品相关的客户 用户 产品属性信息 接口协议 SOAP Document Style 接口调用方向 产品平台 省领航平台 ISMP B 管理子系统 命名空间 接口方法 getPortalResult 5 1 2 25 1 2 2 接口流程接口流程 主要涉及到的接口调用流程 产品平台 客户端 省领航平台 ISMP B 管理子系统 服 务端 2 返回客户信息查询结果 1 根据产品标识 发起获取客户请求 图 2 客户信息查询接口流程 1 产品平台根据分配的 ProductID 和密码 MD5 加密后的密文 加上当前时间戳 查询条件 调 用省领航平台 ISMP B 管理子系统的 webservice 接口方法 getPortalResult 发起从省领航平 台 ISMP B 管理子系统的查询某一客户信息请求 2 省领航平台 ISMP B 管理子系统根据收到的接口参数 判断校验通过后 返回产品平台客户数 据内容包 5 1 2 35 1 2 3 数据信息定义数据信息定义 5 1 2 3 15 1 2 3 1 产品平台查询请求要素定义产品平台查询请求要素定义 表 4 客户信息查询接口产品平台查询请求要素定义 参数名类型出现次数长度注释 StreamingNoString132 流水号 OPFlagString14 0104 客户查询 SIIDString18 SI 编码 TimeStampString118 当前时间戳 YYYYMMDDHHMISS BizIDString120 客户产品计费标识 可为空 AreaCodeString15 客户地区 可为空 ProductIDString18 产品编码 OfferIDString18 销售品编码 PasswordString132 查询密码 CustIDString120 客户编码 CustAccountString1100 客户帐号 CustNameString1256 客户名称 AccessNoString121 接入号 Q CT XXXX 2014 15 SummaryString0 164 备注 5 1 2 3 25 1 2 3 2 领航平台返回产品平台查询结果要素定义领航平台返回产品平台查询结果要素定义 表 5 客户信息查询接口领航平台返回产品平台查询结果要素定义 参数名类型出现次数长度注释 StreamingNoString132 流水号 OPFlagString14 0104 客户查询 ProductIDString18 OfferIDString18 销售品编码 BizIDString120 客户产品计费标识 AreaCodeString15 CustIDString120 客户编码 CustAccountString1100 客户帐号 CustNameString1256 客户名称 ProductInfoProduct0 n 产品属性信息 ReturnStatusString14 应答返回状态 SummaryString11024 备注 当处理失败时 将全量校验和失败的详细错误信息说明加入 XX XX 领航返回领航返回 表 6 客户信息查询接口领航平台返回产品平台查询结果要素定义数据项定义 Product 参数名类型出现次数长度注释 ProductInstIDString132 产品属性实例 ID ProductTypeString132 产品属性标识 ProductValueString1100 产品属性值 ParentTypeString0 132 上级属性标识 ProductParentInstIDString132 父节点产品属性实例 ID 如果 没有父节点 就填空 5 1 2 3 35 1 2 3 3 领航平台返回产品平台应答结果返回码领航平台返回产品平台应答结果返回码 表 7 客户信息查询接口领航平台返回产品平台应答结果返回码 结果码结果码错误原因错误原因备注备注 以下为通用返回码以下为通用返回码 00000 交易成功 00001 交易失败 00002 参数要素不全 00003 非业务时间 Q CT XXXX 2014 16 00004 业务未授权 00005 查询结果为空 00006 系统无此业务 数据库异常数据库异常 00201 查询数据库异常 00202 插入数据异常 00203 修改数据异常 00204 删除数据异常 00205 过程执行异常 业务逻辑错误业务逻辑错误 00401 关键数据项不能为空 00402 业务数据内容不存在 00403 数据格式不正确 00404 业务逻辑执行错误 网络通讯错误网络通讯错误 00601 连接服务异常 00602 断开服务异常 00603 发送数据失败 00604 接收数据失败 5 1 2 3 45 1 2 3 4 接口数据包示例接口数据包示例 产品平台发送应答数据包到领航平台格式 0104 SI0001 1244690606890 200 300 3644a684f98ea8fe223c713b77189a77 6 ap 客户查询 领航平台返回产品平台数据包格式 0104 323002000 40825826451003 020 GD990947809 eshoretestxm06121 test Q CT XXXX 2014 17 1 11002001000000000000 1 2 11002004000000000000 0 3 11002005000000000000 0 4 11002006000000000000 0 5 11002007000000000000 0 6 11002008000000000000 0 7 Q CT XXXX 2014 18 11002009000000000000 8 11002009001000000000 1 7 9 11002009002000000000 1 7 10 11002009000000000000 11 11002009001000000000 2 10 12 11002009002000000000 1 10 13 11002009000000000000 Q CT XXXX 2014 19 14 11002009001000000000 3 13 15 11002009002000000000 1 13 16 11002010000000000000 1 00000 5 1 35 1 3用户绑定用户绑定 变更变更 解绑产品接口解绑产品接口 5 1 3 15 1 3 1 接口协议概述接口协议概述 接口名称 用户绑定 变更 解绑产品 接口描述 省领航平台 ISMP B 管理子系统把用户绑定 变更 解绑产品的数据信息经过产品接 口同步到产品平台 注注 用户产品属性通过用户信息查询接口用户信息查询接口获取 企业成员在领航上的成员 纳入 双订购的个人订购 使用此接口 触发条件 省领航平台 ISMP B 管理子系统向产品平台发送用户绑定 变更 解绑产品请求时触 发产品平台调用此接口 接口协议 SOAP Document Style 接口调用方向 产品平台 省领航平台 ISMP B 管理子系统 命名空间 接口方法 getPortalRequest getPortalResult 5 1 3 25 1 3 2 接口流程接口流程 主要涉及到的接口调用流程 Q CT XXXX 2014 20 领航中心 BNET 产品平台 AP 8 交易包验证 4 调用getPortalRequest 1 用户绑定 变更 解绑产品 2 生成交易包 streamingno rand encode 3 http的url请求 5 返回XML明文 6 调用getEncodeString 7 返回XML密文 9 调用getPortalResult 10 查询密码验证 13 调用getPortalResult 11 返回XML包明文 12 本地信息处理 14 本地信息处理 15 返回XML报文 16 重定向 图 3 用户绑定 变更 解绑产品接口流程 1 客户管理员在集团领航平台管理子系统中客户工作台给用户绑定 变更 解绑产品 2 集团领航平台管理子系统生成相关参数 StreamingNo rand 和 encode 并存入日志表中 3 集团 BNET 管理子系统调用产品平台提供的 HTTP 请求 在请求中加入关键字信息 格式如下 StreamingNo xxxx rand xxxx encode xxxx 4 产品平台从 HTTP 请求中获取的交易关键字 StreamingNo rand encode 加入到调用集团 BNET 管理子系统的 webservice 接口方法 getPortalRequest 中 发起从集团 BNET 管理子系统获取用 户信息的请求 5 集团 BNET 管理子系统根据收到的接口参数 判断校验通过后 返回产品平台用户数据内容包 并注销本次交易流水记录 6 产品平台根据获取的用户数据内容包 调用 getEncodeString 加密获取数据包 Q CT XXXX 2014 21 7 集团 BNET 管理子系统根据产品平台的请求包加密后返回给产品平台 8 产品平台获取加密后的数据包与第四步中获取的 encode 进行验证 9 第八步验证通过后 产品平台调用集团 BNET 管理子系统的 webservice 接口方法 getPortalResult 发起从集团 BNET 管理子系统的查询某一用户信息请求 10 集团 BNET 管理子系统获取产品平台发起请求报文中的查询密码 并与原先在集团 BNET 管理子 系统设定的产品查询密码进行比较验证 11 第十步验证通过后 集团 BNET 管理子系统返回产品平台用户数据内容包 12 产品平台获取客户数据包内容 进行本地的用户信息处理 13 产品平台将用户信息处理后的结果返回给集团 BNET 管理子系统 14 集团 BNET 管理子系统根据产品平台的处理结果进行了相应的用户产品处理 15 集团 BNET 管理子系统处理完成以后 返回给产品平台一个包含重定向地址的数据内容包 16 产品平台获取返回的报文 解析出其中的重定向的 url 然后重定向操作 5 1 3 35 1 3 3 数据信息定义数据信息定义 5 1 3 3 15 1 3 3 1 领航平台返回产品平台要素定义领航平台返回产品平台要素定义 表 8 用户绑定 变更 解绑产品接口领航平台返回产品平台要素定义 参数名类型出现次数长度注释 StreamingNoString132 流水号 OPFlagString14 0201 用户绑定 0202 用户变更 0203 用户退订 0207 用户停机 0208 用户复机 0209 用户改号 ProductIDString18 OfferIDString18 销售品 ID BizIDString120 客户产品计费标识 CustIDString120 客户编码 AccountInfoAccountAttribute1 n 用户帐号信息 SummaryString0 164 备注 表 9 用户绑定 变更 解绑产品接口领航平台返回产品平台要素定义数据项定义 AccountAttribute 参数名类型出现次数长度注释 UserIDString132 用户帐号 NewUserIDString132 用户新账号 可为空 IMSIString120 手机的 IMSI AccTypeString11 用户类型 AccNameString1100 用户名称 Q CT XXXX 2014 22 5 1 3 3 25 1 3 3 2 产品平台返回领航平台应答要素定义产品平台返回领航平台应答要素定义 表 10 用户绑定 变更 解绑产品接口产品平台返回领航平台应答要素定义 参数名类型出现次数长度注释 StreamingNoString132 流水号 OPFlagString14 0201 用户绑定 0202 用户变更 0203 用户解绑 0207 用户停机 0208 用户复机 0209 用户改号 ReturnStatusString14 应答返回状态 SummaryString11024 备注 当处理失败时 将全量校验和失败的详细错误信息说明加入 XX XX 产品平台返回产品平台返回 5 1 3 3 35 1 3 3 3 业务结果返回码业务结果返回码 表 11 用户绑定 变更 解绑产品接口业务结果返回码 结果码结果码错误原因错误原因 XX XX 产品平台返回产品平台返回备注备注 以下为通用返回码以下为通用返回码 00000 交易成功 00001 交易失败 00002 参数要素不全 00003 非业务时间 00004 业务未授权 00005 查询结果为空 00006 系统无此业务 数据库异常数据库异常 00201 查询数据库异常 00202 插入数据异常 00203 修改数据异常 00204 删除数据异常 00205 过程执行异常 业务逻辑错误业务逻辑错误 00401 关键数据项不能为空 00402 业务数据内容不存在 00403 数据格式不正确 00404 业务逻辑执行错误 网络通讯错误网络通讯错误 00601 连接服务异常 00602 断开服务异常 00603 发送数据失败 Q CT XXXX 2014 23 00604 接收数据失败 5 1 3 3 45 1 3 3 4 接口数据包示例接口数据包示例 用户绑定产品 领航平台返回产品平台数据包格式 1246 0201 200 300 6 6 ap 1 马汉 用户绑定产品 用户绑定产品 产品平台发送应答数据包到领航平台格式 1246 0201 00000 用户绑定产品 用户信息变更 领航平台返回产品平台数据包格式 1246 0202 200 300 6 6 ap 1 马汉 用户信息变更 Q CT XXXX 2014 24 用户信息变更 产品平台发送应答数据包到领航平台格式 1246 0202 00000 用户信息变更 用户解绑产品 领航平台返回产品平台数据包格式 1246 0203 200 300 6 6 ap 1 马汉 用户解绑产品 客户退订产品 产品平台发送应答数据包到领航平台格式 1141 0203 00000 用户解绑产品 5 1 45 1 4用户信息查询接口用户信息查询接口 5 1 4 15 1 4 1 接口协议概述接口协议概述 接口名称 用户信息查询 接口描述 产品平台通过用户信息查询接口 能查到对应产品的用户和用户绑定产品属性信息 触发条件 产品平台发起查询产品相关的用户 用户绑定产品属性信息 接口协议 SOAP Document Style 接口调用方向 产品平台 省领航平台 ISMP B 管理子系统 命名空间 接口方法 getPortalResult Q CT XXXX 2014 25 5 1 4 25 1 4 2 接口流程接口流程 主要涉及到的接口调用流程 产品平台 客户端 省领航平台 ISMP B 管理子系统 服 务端 2 返回用户信息查询结果 1 根据产品标识 发起获取用户请求 图 4 用户信息查询接口流程 1 产品平台根据分配的 ProductID 和密码 MD5 加密后的密文 加上当前时间戳 查询条件 调 用省领航平台 ISMP B 管理子系统的 webservice 接口方法 getPortalResult 发起从省领航平 台 ISMP B 管理子系统的查询某一用户信息请求 2 省领航平台 ISMP B 管理子系统根据收到的接口参数 判断校验通过后 返回产品平台用户数 据内容包 5 1 4 35 1 4 3 数据信息定义数据信息定义 5 1 4 3 15 1 4 3 1 产品平台查询请求要素定义产品平台查询请求要素定义 表 12 用户信息查询接口产品平台查询请求要素定义 参数名类型出现次数长度注释 StreamingNoString132 流水号 OPFlagString14 0204 用户查询 SIIDString18 SI 编码 TimeStampString118 当前时间戳 YYYYMMDDHHMISS ProductIDString18 产品编码 OfferIDString18 销售品 ID PasswordString132 查询密码 CustIDString120 客户编码 CustAccountString1100 客户帐号 UserIDString132 用户帐号 SummaryString0 164 备注 5 1 4 3 25 1 4 3 2 领航平台返回产品平台查询结果要素定义领航平台返回产品平台查询结果要素定义 表 13 用户信息查询接口领航平台返回产品平台查询结果要素定义 参数名类型出现次数长度注释 StreamingNoString132 流水号 OPFlagString14 0204 用户查询 ProductIDString0 18 OfferIDString18 销售品 ID BizIDString0 120 客户产品计费标识 Q CT XXXX 2014 26 AreaCodeString0 15 CustIDString120 客户编码 CustNameString0 1256 客户名称 UserIDString132 AccTypeString11 AccNameString132 ProductInfoProduct0 n 用户产品信息 SummaryString11024 备注 当处理失败时 将全量校验 和失败的详细错误信息说明 加入 XX XX 领航平台返回领航平台返回 表 14 用户信息查询接口领航平台返回产品平台查询结果要素定义数据项定义 Product 参数名类型出现次数长度注释 ProductTypeString132 产品属性标识 ProductValueString1100 产品属性值 ParentTypeString0 132 上级属性标识 5 1 4 3 35 1 4 3 3 领航平台返回产品平台应答结果返回码领航平台返回产品平台应答结果返回码 表 15 用户信息查询接口领航平台返回产品平台应答结果返回码 结果码结果码错误原因错误原因备注备注 以下为通用返回码以下为通用返回码 00000 交易成功 00001 交易失败 00002 参数要素不全 00003 非业务时间 00004 业务未授权 00005 查询结果为空 00006 系统无此业务 数据库异常数据库异常 00201 查询数据库异常 00202 插入数据异常 00203 修改数据异常 00204 删除数据异常 00205 过程执行异常 业务逻辑错误业务逻辑错误 00401 关键数据项