Q/CT XXXX-2014
5.1.3 用户绑定/变更/解绑产品接口 5.1.3.1 接口协议概述
? 接口名称：用户绑定/变更/解绑产品。
? 接口描述：省领航平台(ISMP-B)管理子系统把用户绑定/变更/解绑产品的数据信息经过产品接口
同步到产品平台（注：用户产品属性通过用户信息查询接口获取）。企业成员在领航上的成员纳入，双订购的个人订购，使用此接口。
? 触发条件：省领航平台(ISMP-B)管理子系统向产品平台发送用户绑定/变更/解绑产品请求时触发
产品平台调用此接口。
? 接口协议：SOAP(Document Style)。
? 接口调用方向：产品平台 ? 省领航平台(ISMP-B)管理子系统。 ? 命名空间：http://www.bnet.cn/v3.0/。
? 接口方法：getPortalRequest、getPortalResult。 5.1.3.2 接口流程
主要涉及到的接口调用流程:
19
Q/CT XXXX-2014
领航中心(BNET)产品平台(AP)1)用户绑定/变更/解绑产品2)生成交易包、streamingno、rand、encode3)http的url请求4)调用getPortalRequest5)返回XML明文6)调用getEncodeString7)返回XML密文8)交易包验证9)调用getPortalResult10)查询密码验证11)返回XML包明文12)本地信息处理13)调用getPortalResult14)本地信息处理15)返回XML报文16)重定向
图 3用户绑定/变更/解绑产品接口流程
1) 客户管理员在集团领航平台管理子系统中客户工作台给用户绑定/变更/解绑产品；
2) 集团领航平台管理子系统生成相关参数StreamingNo、rand和encode,并存入日志表中；
3) 集团BNET管理子系统调用产品平台提供的HTTP请求，在请求中加入关键字信息，格式如下：
http://service.productid.bnet.cn? StreamingNo=xxxx&rand=xxxx&encode=xxxx ；
4) 产品平台从HTTP请求中获取的交易关键字StreamingNo、rand、encode，加入到调用集团BNET
管理子系统的webservice接口方法getPortalRequest中，发起从集团BNET管理子系统获取用户信息的请求；
5) 集团BNET管理子系统根据收到的接口参数，判断校验通过后，返回产品平台用户数据内容包，
并注销本次交易流水记录；
6) 产品平台根据获取的用户数据内容包，调用getEncodeString加密获取数据包；
20
Q/CT XXXX-2014
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.3 数据信息定义
5.1.3.3.1 领航平台返回产品平台要素定义
表 8用户绑定/变更/解绑产品接口领航平台返回产品平台要素定义
参数名 StreamingNo OPFlag 类型 String String 出现次数 1 1 长度 32 4 流水号 0201：用户绑定 0202：用户变更 0203：用户退订 0207：用户停机 0208:用户复机 0209:用户改号 ProductID OfferID BizID CustID AccountInfo Summary String String String String 1 1 1 1 8 8 20 20 64 销售品ID 客户产品计费标识 客户编码 用户帐号信息 备注 注释 AccountAttribute 1..n String 0..1 表 9用户绑定/变更/解绑产品接口领航平台返回产品平台要素定义数据项定义：AccountAttribute
参数名 UserID NewUserID IMSI AccType AccName 类型 String String String String String 1 1 1 1 1 出现次数 32 32 20 1 100 长度 用户帐号 用户新账号（可为空） 手机的IMSI 用户类型 用户名称 注释 21
Q/CT XXXX-2014
5.1.3.3.2 产品平台返回领航平台应答要素定义
表 10用户绑定/变更/解绑产品接口产品平台返回领航平台应答要素定义
参数名 StreamingNo OPFlag 类型 String String 出现次数 1 1 长度 32 4 流水号 0201：用户绑定 0202：用户变更 0203：用户解绑 0207：用户停机 0208:用户复机 0209:用户改号 ReturnStatus String Summary String 1 1 4 1024 应答返回状态 备注 当处理失败时，将全量校验和失败的详细错误信息说明加入“@@XX产品平台返回” 注释 5.1.3.3.3 业务结果返回码
表 11用户绑定/变更/解绑产品接口业务结果返回码
结果码 以下为通用返回码 00000 00001 00002 00003 00004 00005 00006 数据库异常 00201 00202 00203 00204 00205 业务逻辑错误 00401 00402 00403 00404 网络通讯错误 00601 00602 00603 22
连接服务异常 断开服务异常 发送数据失败 关键数据项不能为空 业务数据内容不存在 数据格式不正确 业务逻辑执行错误 查询数据库异常 插入数据异常 修改数据异常 删除数据异常 过程执行异常 交易成功 交易失败 参数要素不全 非业务时间 业务未授权 查询结果为空 系统无此业务 错误原因@@XX产品平台返回 备注