中兴“IP直通车”营帐服务系统接口方案.doc

中兴“IP直通车”营帐服务系统接口方案 一、功能 中兴“IP 直通车”营帐服务系统提供以下功能： 1、手机开户/销户 受理台提供手机（为业务支付费用的账户）开户/销户功能所需的手机号码、用户 姓名等信息。 　　2、绑定电话开户/销户 受理台提供绑定电话（手机使用业务的用户）开户/销户功能所需的固定电话号码、 手机号码 、帐号密码等信息。 3、手机激活/去激活 　　 受理台提供手机激活/去激活功能所需的手机号码、激活/去激活标志信息。 4、绑定电话 停/复机 受理台提供绑定电话停/复机功能所需的固定电话号码、停/复机标志等信息。 　　5、修改绑定电话密码 　　受理台提供修改绑定电话密码功能所需的固定电话号码、旧密码、新密码等信息。 6、取消绑定电话密码 　　 受理台提供取消绑定电话密码功能所需的固定电话号码、密码等信息。 7、开通/禁拨 绑定电话国际长途 　受理台提供开通/禁拨绑定电话国际长途功能所需的固定电话号码、开通/禁拨标志等信息。 8、设置/取消绑定电话禁拨号码 　受理台提供设置/取消绑定电话禁拨号码功能所需的固定电话号码 、禁拨号码等信息。 9、查询绑定电话信息 　受理台提供查询绑定电话信息功能所需的固定电话号码信息。 返回信息： 　　　　所属手机号码、电话现有状态（开机/停机）、通话级别（国际长途开通情况）有 　　无密码等。 二、接口协议 2.1 连接 “IP直通车”营帐系统与SMP在发送消息前，必须与SMP建立TCP/IP SOCKET连接。在”IP直通车”营帐系统不再需要与SMP进行交互后，必须拆除与SMP的SOCKET连接。在空闲时，可以保持与SMP的连接，此时只需要发送心跳消息。 SMP与各”IP直通车”营帐系统间可以建立的最大连接数参见有关部门的相关要求。 2.2 消息 接口协议的业务消息用于传递用户的操作信息，是“IP直通车”营帐系统与SMP进行交互的最小单位。在创建了连接、会话并确定了事务ID之后，“IP直通车”营帐系统根据接口协议的消息格式将功能命令打成消息包发送给SMP，并将接收到的包根据接口协议的消息格式进行解码。消息结构如图1所示： 接口协议的心跳消息用于检测综合业务中心与SMP间的连接是否正常，在检测到连接空闲120秒后发送。心跳消息结构如图2所示： 2.2.1业务消息的编码 接口协议的参数编码 参数编码应符合以下原则： 传送的消息数据流以网络字节序为准。 如果字符串不满规定长度，用空格填充； 2..2.1.1 消息开始标志 消息开始标志用于确定消息的开始和结束，长度为4Byte。编码为：`SC`。 2.2.1.2 消息长度(4Byte) 消息长度用来指出从消息头到操作信息的总长度。长度值用16进制字符(0-F)表示的4位整数来表示。消息长度取值范围为0到65000(0000-FFFF)。 2.2.1.3 消息头(20Byte) 消息头包含以下参数： - 版本号：用来识别接口的协议版本。编码为4个八位位组的字符串。目前的版本为1.00。如果以后有协议升版，按新版本进行编码即可。 - 终端标识：用于标识接入SMP的”IP直通车”营帐系统的前置机和终端。编码为8个八位位组的字符串，即PPZZABCD，其中，PP和ZZ可以是字母和数字的任意组合，ABCD只能是数字。 特别地，在首次登录时，“终端标识”的内容必须填写分配给”IP直通车”营帐系统前置机的终端标识。在以后发送的消息中，应该填写具体终端的终端标识。 SMP只对前置机的终端标识进行鉴权。 PP表示省、自治区和直辖市。PP的编码暂时使用下表定义的方式。 名称 编码 北京 BJ 天津 TJ 河北 HB 山西 SX 内蒙古 NM 辽宁 LN 吉林 JL 黑龙江 HL 上海 SH 江苏 JS 浙江 ZJ 安徽 AH 福建 FJ 江西 JX 山东 SD 河南 HN 湖北 UB 湖南 UN 广东 GD 海南 IN 广西 GX 重庆 CQ 四川 SC 贵州 GZ 云南 YN 陕西 HX 甘肃 GS 青海 QH 宁夏 NX 新疆 XJ ZZABCD表示终端序号，由各省公司自行分配。