彩铃与业务支撑系统接口规范V13.docx
《彩铃与业务支撑系统接口规范V13.docx》由会员分享，可在线阅读，更多相关《彩铃与业务支撑系统接口规范V13.docx（37页珍藏版）》请在冰豆网上搜索。
彩铃与业务支撑系统接口规范V13
彩铃
与业务支撑系统接口规范
（V1.3）
中兴通讯股份有限公司
2004年2月
版本号
拟制人/
修改人
拟制/修改日期
更改理由
主要更改内容
（写要点即可）
V1.1
周富星
2004-2
V1.2
周富星
增加集团操作
增加5.6节
V1.3
李明
2006-07-19
增加变更用户等级通知/响应命令
注1：
每次更改归档文件（指归档到事业部或公司档案室的文件）时，需填写此表
注2：
文件第一次归档时，“更改理由”、“主要更改内容”栏写“无”
目录
目录3
前言5
1、范围1
2、相关术语与缩略语解释1
3、彩铃中心向业务支撑系统提供的MML命令集1
4、彩铃系统向业务支撑系统提供的MML命令集详解2
5.1返回公用代码3
5.2彩铃登录/退出4
5.2.1操作员登录4
5.2.2．操作员登录ACK4
5.2.3．操作员退出5
5.2.4．操作员退出ACK6
5.3彩铃开户/销户6
5.3.1开户6
5.3.2开户ACK8
5.3.3销户8
5.3.4销户ACK9
5.3.5鉴权10
5.3.6鉴权ACK11
5.3.7注销12
5.3.8注销ACK13
5.4激活/去激活13
5.4.1强制激活/去激活13
5.4.2强制激活/去激活ACK15
5.5用户信息查询更改15
5.5.1用户属性更改操作15
5.5.2用户属性更改操作ACK16
5.5.3修改用户密码16
5.5.4修改用户密码ACK17
5.5.5变更用户等级17
5.5.6变更用户等级ACK18
5.5.7修改用户号码18
5.5.8修改用户号码ACK19
5.5.9查询用户状态20
5.5.10查询用户状态ACK20
5.5.11变更用户等级通知21
5.5.12变更用户登记通知ACK21
5.6集团操作户指令22
5.6.1创建彩铃集团22
5.6.2创建彩铃集团ACK23
5.6.3更改彩铃集团信息24
5.6.4更改彩铃集团信息ACK25
5.6.5删除彩铃集团25
5.6.6删除彩铃集团ACK26
5.6.7用户加入到彩铃集团26
5.6.8用户加入到彩铃集团ACK27
5.6.9注销彩铃用户的集团属性28
5.6.10注销彩铃用户的集团属性ACK28
5.6.11彩铃用户加入集团通知28
5.6.12彩铃用户加入集团通知ACK29
5.6.13彩铃用户退出集团通知29
5.6.14彩铃用户退出集团通知ACK29
5.6.15增加集团操作员30
5.6.16增加集团操作员ACK30
5.6.17封锁彩铃集团31
5.6.18封锁彩铃集团ACK31
5.6.19解锁彩铃集团31
5.6.20解锁彩铃集团ACK32
附录32
前言
为通过运营商的业务支撑系统提供彩铃的开户和销户等操作，本接口规范规定了业务支撑系统与彩铃中心之间所应遵从的MML命令集。
本规范由中兴通讯股份有限公司提出并负责解释。
1、范围
适用彩铃与业务支撑系统之间关于业务开通、激活等操作的交互，包括主叫彩铃业务和被叫彩铃业务，是针对使用签约方式及交换机改造方式开通彩铃的接口规范。
2、相关术语与缩略语解释
SMP：
ServiceManagementPoint，业务管理点
MML:
Man-MachineLanguage，人机语言
CRBT：
ColorRingBackTone
保留字段：
在本文档的一些命令中，对某些参数有保留字段或者保留值，对这些保留的内容，各省公司可以根据实际情况进行扩充使用。
特别说明：
·由业务支撑系统端负责保持链路和会话的可用性（如果彩铃端在主动发起操作时找不到可用链路和会话，直接返回失败）
·对于彩铃端主动发起的消息，事务号使用不小于0Xa0000000的值
3、彩铃中心向业务支撑系统提供的MML命令集
彩铃中心需要支持的MML命令见下文。
MML命令及其确认命令的具体内容详见第五部分。
一、彩铃用户的开户/销户
1
彩铃开户/响应
2
彩铃销户/响应
3
鉴权请求/响应
4
注销请求/响应
二、激活/去激活
1
强制激活
2
强制去激活
三、用户信息查询更改
1
用户属性更改/响应
2
修改用户密码/响应
3
变更用户等级/响应
4
变更用户号码/响应
5
查询用户状态信息/响应
6
变更用户等级通知/响应
四、集团操作指令
1
创建彩铃集团/响应
2
更改彩铃集团信息/响应
3
删除彩铃集团/响应
4
用户加入到彩铃集团/响应
5
注销彩铃用户的集团属性/响应
6
彩铃用户加入集团通知/响应
7
彩铃用户退出集团通知/响应
8
增加集团操作员/响应
9
封锁彩铃集团/响应
10
解锁彩铃集团/响应
4、彩铃系统向业务支撑系统提供的MML命令集详解
5.1返回公用代码
公用代码
描述
0
成功
1
非法数据包
2
会话控制字错误
3
事务控制字错误
4
语法错误或命令码非法
5
会话已经建立
6
接入代理连接到系统失败
7
系统内部错误
8
参数输入错误
9
命令码不匹配
10
操作个数错误
11
操作超时
12
无权访问数据
13
操作鉴权失败
14
彩铃系统数据库操作失败
15
彩铃SCP执行错误
16
彩铃SCP未连接上
17
彩铃SCP无响应
21
查找彩铃SCP失败
23
手机号码与彩铃SCP对照关系不存在
24
手机号码在彩铃SCP中不存在
25
服务名错误
26
消息转发失败
27
系统强行结束当前会话
28
操作码不存在
29
省区最大用户LICENSE数已到
30
省区最大流量已到
31
系统最大用户LICENSE数已到
32
系统最大操作LICENSE数已到
33
终端标识错误
34
客户端事务ID错误
35
事务取消失败
36
会话ID错误
37
文件操作失败
38
IP未连接
39
系统负载超出限定，禁止操作请求
5.2彩铃登录/退出
5.2.1操作员登录
用于操作员登录到彩铃系统。
输入格式：
LOGIN:
USER=,PSWD=
输入参数
USER操作员登录标志。
使用1...8位字符串表示。
PSWD操作员登录口令。
使用1...8位字符串表示。
5.2.2．操作员登录ACK
收到操作员登录命令后，返回此命令。
输出格式：
ACK:
LOGIN:
RETN=[,DESC=]
输出参数
RETNACK命令的返回值。
十进制整数类型，范围：
0：
成功，
1001：
操作员不存在
1002：
密码不符
1003：
操作员登录标识已经到期
1004：
操作员口令已经到期
1005：
操作员处于失效或黑名单状态
1006：
当前时间不允许该操作员接入
1007：
终端标识不存在
1008：
当前时间不允许该终端接入
1009：
操作员最大连续登录失败次数已到
1010：
登录鉴权失败
公用错误返回码
0002：
会话控制字错误
0003：
事务控制字错误
0007：
系统内部错误
0008：
参数输入错误
0009：
命令码不匹配
0010：
操作个数错误
0011：
操作超时
0029：
省、区最大用户LICENSE数已到
0031：
系统最大用户LICENSE数已到
DESC错误原因说明。
使用1...256位字符串表示。
当RETN为成功时，不需要该参数；
当RETN为其他返回值时，该参数是可选的。
5.2.3．操作员退出
用于操作员结束与SMP系统的会话。
输入格式：
LOGOUT[:
USER=]
输入参数
USER要退出的操作员的操作员登录标志。
使用1...8位字符串表示。
仅当清除其他操作员的登录时，需要此参数。
DEFAULT：
当前会话的操作员登录标志。
5.2.4．操作员退出ACK
收到操作员退出命令后，返回此命令。
输出格式：
ACK:
LOGOUT:
RETN=[,DESC=]
输出参数
RETNACK命令的返回值。
十进制整数类型，范围：
0000：
成功。
1001：
当前操作员无权退出此操作员
1002：
所指定退出的操作员未登录
1003：
所指定退出的操作员不存在
公用错误返回码
0002：
会话控制字错误
0003：
事务控制字错误
0007：
系统内部错误
0008：
参数输入错误
0009：
命令码不匹配
0010：
操作个数错误
0011：
操作超时
DESC错误原因说明。
使用1...256位字符串表示。
当RETN为成功时，不需要该参数；
当RETN为其他返回值时，该参数是可选的。
5.3彩铃开户/销户
5.3.1开户
用户通过业务支撑系统开户，业务支撑系统请求彩铃系统为用户分配彩铃帐户。
在签约方式下，业务支撑系统在向彩铃系统发起本操作的同时，需要请求HLR进行相关签约信息的设置或者请求原来的智能网系统增加用户的彩铃属性。
如果是非智能网用户开通彩铃，由业务支撑系统到HLR进行彩铃的签约设置，设置彩铃签约需要的数据如彩铃系统的GT、业务键等由业务支撑系统通过静态配置数据获得。
在本操作中，智能网标志与实时扣费操作标志都置为为“0”。
如果是智能网用户开通彩铃，由业务支撑系统发起到用户的智能网系统为用户增加彩铃属性，并在本操作中需要指明是否需要实时扣费以及该用户原有的智能业务签约信息（含智能业务标志、业务键、归属SCP的GT数据等）。
在交换机改造方式下，业务支撑系统在向彩铃系统发起本操作的同时，需要请求HLR进行相关彩铃属性的设置。
在本操作中，需要根据用户的实际情况正确填写实时扣费标志及智能业务签约信息。
输入格式：
CREATCRBTCARD:
MSISDN=,PWD=，CHARGE=，INFLAG=[,SERKEY=][,INSCPGT][，UTYPE=][,PHYUSERID][,CLRTYPE=]
操作方向：
业务支撑系统－>彩铃系统
输入参数
MSISDN指定开户的号码。
必选参数，使用数字字符串，带有区号的用户号码。
PWD用户使用彩铃的密码
必选参数，使用数字串表示。
CHARGE是否实时扣费，例如预付费业务
必选参数，使用1位数字串表示：
0－不要实时扣费
1－要实时扣费
INFLAG智能用户标记
必选参数，使用1位数字串表示：
0－非智能网用户
1－智能网用户
SERKEY智能业务键，仅在INFLAG=1时有效
可选参数，使用数字串表示，缺省填0。
INSCPGT智能业务归属SCP的GT号码，仅在INFLAG=1时有效
可选参数，使用1到26位数字串表示
UTYPE用户等级
非必需参数，使用1位数字字符串表示。
没有此参数时表示普通用户。
1－普通用户
2－VIP用户
PHY
升级会员 