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

00604 接收数据失败 5.1.3.3.4 接口数据包示例

? 用户绑定产品,领航平台返回产品平台数据包格式:

1246 0201

200 300 6 6

ap 1 马汉

用户绑定产品

? 用户绑定产品,产品平台发送应答数据包到领航平台格式:

1246 0201

< ReturnStatus >00000

用户绑定产品

? 用户信息变更,领航平台返回产品平台数据包格式:

1246 0202

200 300 6 6

ap 1 马汉

用户信息变更

Q/CT XXXX-2014

23

Q/CT XXXX-2014

? 用户信息变更,产品平台发送应答数据包到领航平台格式:

1246 0202

< ReturnStatus >00000

用户信息变更

? 用户解绑产品,领航平台返回产品平台数据包格式:

1246 0203

200 300 6 6

ap 1 马汉

用户解绑产品

? 客户退订产品,产品平台发送应答数据包到领航平台格式:

1141 0203

< ReturnStatus >00000

用户解绑产品 5.1.4 用户信息查询接口 5.1.4.1 接口协议概述

? ? ? ? ? ?

接口名称:用户信息查询。

接口描述:产品平台通过用户信息查询接口,能查到对应产品的用户和用户绑定产品属性信息。 触发条件:产品平台发起查询产品相关的用户、用户绑定产品属性信息。 接口协议:SOAP(Document Style)。

接口调用方向:产品平台 ? 省领航平台(ISMP-B)管理子系统。 命名空间:http://www.bnet.cn/v3.0/。 ? 接口方法:getPortalResult。

24

Q/CT XXXX-2014

5.1.4.2 接口流程

主要涉及到的接口调用流程:

产产产产产(ISMP-B)产产产产产(产产产)产产产产(产产产)1产产产产产产产产产产产产产产产产2产产产产产产产产产产产

图 4用户信息查询接口流程

1) 产品平台根据分配的ProductID和密码(MD5加密后的密文),加上当前时间戳、查询条件,调用

省领航平台(ISMP-B)管理子系统的webservice接口方法getPortalResult,发起从省领航平台(ISMP-B)管理子系统的查询某一用户信息请求;

2) 省领航平台(ISMP-B)管理子系统根据收到的接口参数,判断校验通过后,返回产品平台用户数据

内容包。 5.1.4.3 数据信息定义

5.1.4.3.1 产品平台查询请求要素定义

表 12用户信息查询接口产品平台查询请求要素定义

参数名 StreamingNo OPFlag SIID TimeStamp ProductID OfferID Password CustID CustAccount UserID Summary 类型 String String String String String String String String String String String 出现次数 1 1 1 1 1 1 1 1 1 1 0..1 长度 32 4 8 18 8 8 32 20 100 32 64 流水号 0204:用户查询 SI编码 当前时间戳YYYYMMDDHHMISS 产品编码 销售品ID 查询密码 客户编码 客户帐号 用户帐号 备注 注释 5.1.4.3.2 领航平台返回产品平台查询结果要素定义

表 13用户信息查询接口领航平台返回产品平台查询结果要素定义

参数名 StreamingNo OPFlag ProductID OfferID BizID 类型 String String String String String 1 1 0..1 1 0..1 出现次数 32 4 8 8 20 长度 流水号 0204:用户查询 销售品ID 客户产品计费标识 注释 25

Q/CT XXXX-2014

AreaCode CustID CustName UserID AccType AccName ProductInfo Summary String String String String String String Product String 0..1 1 0..1 1 1 1 0..n 1 5 20 256 32 1 32 1024 客户编码 客户名称 用户产品信息 备注 当处理失败时,将全量校验和失败的详细错误信息说明加入“@@XX领航平台返回” 表 14用户信息查询接口领航平台返回产品平台查询结果要素定义数据项定义:Product

参数名 ProductType ProductValue ParentType 类型 String String String 1 1 0..1 出现次数 32 100 32 长度 注释 产品属性标识 产品属性值 上级属性标识 5.1.4.3.3 领航平台返回产品平台应答结果返回码

表 15用户信息查询接口领航平台返回产品平台应答结果返回码

结果码 以下为通用返回码 00000 00001 00002 00003 00004 00005 00006 数据库异常 00201 00202 00203 00204 00205 业务逻辑错误 00401 00402 00403 26

关键数据项不能为空 业务数据内容不存在 数据格式不正确 查询数据库异常 插入数据异常 修改数据异常 删除数据异常 过程执行异常 交易成功 交易失败 参数要素不全 非业务时间 业务未授权 查询结果为空 系统无此业务 错误原因 备注