保密等级：公开发放
中国电信集团公司技术标准
Q/CT 2043.04-2008
中国电信 CDMA 业务网络接口协议技术规 范－SP 管理接口协议规范（V1.0）
200X-XX-XX 发布
200X-XX-XX 实施
中国电信集团公司
发布
Q/CT 2043.04-2008
目
录
目 录..................................................................... I 前 言.................................................................... II 中国电信 CDMA 业务网络接口协议技术规范－SP 管理接口协议规范 ................... 1 1 范围....................................................................... 1 2 规范性引用文件............................................................. 1 3 缩略语..................................................................... 1 4 ISMP 与 SP 之间的接口 ....................................................... 2 4.1 管理信息通知接口 ......................................................... 2 4.2 定购/使用通知接口......................................................... 4 4.3 ISMP 和 SP 反向退订接口 .................................................. 10 4.4 集团定购信息同步接口 .................................................... 11 规范性附录 A SP 接口结果码定义 ............................................. 13
I
Q/CT 2043.04-2008
前
言
本标准是中国电信综合业务管理平台 ISMP 的系列标准之一， 该系列标准的结构及名称 预计如下： （1）中国电信 CDMA 业务网络设备技术规范 （2）中国电信 CDMA 业务网络接口协议技术规范
本标准主要依据中国电信集团公司的需求，结合中国电信企业技术标准的特点进行编 写，随着中国电信企业技术标准管理系统的发展完善，还将制定后续的相关标准。
本规范为中国电信综合业务管理平台 ISMP（Integrated Service Management Platform） 的接口规范，定义了 ISMP 与 SP 之间的相关接口。
本标准的附录 A 是规范性附录。 本标准由中国电信集团公司提出并归口。 本标准起草单位：中国电信股份有限公司上海研究院。 本标准主要起草人：韩彬斌，王铮，任华，方燕萍，黄铖斌，杨迪，游玉容，桂思思。
II
中国电信 CDMA 业务网络接口协议技术规范－SP 管理接口 协议规范
1 范围 本规范适用于中国电信综合业务管理平台（ISMP）产品的设计及研发，提供给为中 国电信开发制造 ISMP 的设备供应商。 2 规范性引用文件 下列文件通过本文的参考而成为本规范的条款。凡是注日期的参考文件，其随后所 有的修改单（不包括勘误的内容）或修订版均不适用于本文，凡是不注日期的参考文件， 其最新版本适用于本文。 《中国电信 CDMA 业务网络技术体制》 《中国电信 CDMA 业务网络设备技术规范》 3 缩略语 缩略语 3G AOMT CP CRM DRM EOMT IP ISMAP ISMP IVR Java LCS MMS MOAT MOET 英文全名 3rd Generation 信 Application Originated Mobile Terminated Content Provider Customer Relation Management Digital Rights Management Email Originated Mobile Terminated 结束 Internet Protocol Integrated Service Management Access Protocol Integrated Service Management Platform Interactive Voice Response Java Location Service Multimedia Message Service Mobile Originated Application Terminated Mobile Originated Email Terminated 结束 结束 终端发起 email 因特网协议 综合业务管理 接入协议 综合业务管理 平台 声讯系统 JAVA 下载 定位业务 多媒体消息 终端发起应用 应用发起终端 结束 内容提供商 客户关系管理 数字版权管理 email 发起终端 中文全名 第三代移动通
中国电信 CDMA 业务网络接口协议技术规范-SP 管理接口协议规范(V1.0)
1
缩略语 MOMT MPSS MSOP MSNMC NMS OMC PDU PHS PSOP RTBP SAG SCP SMGP SMS SNMP SP SPMS SSO Streaming TCP WAP
英文全名 Mobile Originated Mobile Terminated 结束 Mobile Payment Service System 系统 Metropolis service operator platform Mobile Service National Management Center Network management system Operating and Maitenance Center Protocol Data Unit Personal handset system Province Service Operation Platform 平台 Real Time Billing Protocol Service Access Gateway Service Control Point Short Message Gateway Protocol Short Message Service Simple Network Management Protocol Service Provider SP Management System Single Sign On Streaming Transfer Control Protocol Wireless Application Protocol
中文全名 终端发起终端 移动支付业务 地市级业务操 作平台 移动业务全国 管理中心 网络管理系统 操作维护中心 协议数据单元 小灵通 省级业务操作 实时扣费协议 业务接入网关 业务控制点 短信网关协议 短消息业务 简单网管协议 业务提供商 SP 管理系统 （小灵通） 单点接入 流媒体 传输控制协议 无线应用协议
4
ISMP 与 SP 之间的接口 4.1 管理信息通知接口 notifyManagementInfo（） 接口调用方向：ISMP－> SP 触发条件：SP 的业务能力签约、业务、产品、套餐的状态变化时，通知 SP 该 SP 的
业务能力签约、业务、产品、套餐的编号和状态。 需求约束： 若 SP 收到业务能力签约注销状态则自行注销基于该业务能力签约发布的所有业务
2
中国电信 CDMA 业务网络接口协议技术规范-SP 管理接口协议规范(V1.0)
下的产品的定购关系； 若 SP 收到业务注销状态则自行注销基于该业务发布的所有产品的 定购关系； 若 SP 收到产品/套餐暂停/注销状态则自行暂停/注销该产品/套餐的所有定购 关系。 业务能力签约状态变化导致的业务、产品状态变化，仅将业务能力签约状态同步给 SP；业务状态变化导致的产品状态变化，仅将业务状态同步给 SP。 SP 状态变化及 SP 状态变化导致的业务能力签约、业务、产品、套餐的状态变化不 通知 SP。 跨 SP 的套餐需要将套餐 ID 通知该套餐内产品的所有 SP。 接口交互流程：
图1. 输入参数：
名称 streamingNo 类型 String
管理信息
出现次数 1
描述 流水号，可用于调用／提供双方比较接口调用情况
６０位，从０开始，用满归零
ID
String
1
编号，根据 IDType 填写
中国电信 CDMA 业务网络接口协议技术规范-SP 管理接口协议规范(V1.0)
3
IDType
Integer
1
0：ProductID 1：PackageID 2：ServiceID 3：ServiceCapabilityID
status
Integer
1
0：正常 1：申请 2：暂停（IDType 为 2、3 时不可以填本项枚举 值） 3：预注销 4：注销
输出参数：
名称 类型 出现次数 描述
streamingNo
String
1
将调用的 StreamingNo 原样返回，保证调 用／返回的同步
resultCode
Integer
1
参见附录 A
4.2 定购/使用通知接口 4.2.1 概述 承载协议：WebService（Document Style） 消息列表： 消息名称 业务使用通知消息 定购关系更新通知消息 4.2.1.1 业务执行通知消息
业务使用通知请求（serviceConsumeNotifyReq Syntax） 接口调用方向：ISMP－> SP 触发条件： ISMP 获取用户业务执行请求后，发送该消息，SP 根据业务情况，决定 下发时间。 需求约束：门户发起业务执行时使用本接口通知 SP。 接口交互流程：
4
中国电信 CDMA 业务网络接口协议技术规范-SP 管理接口协议规范(V1.0)
图2. 输入参数：
域名 streamingNo 类型 String
业务使用
出现次数 1
描述 流水号， 可用于调用／提供双方 比较接口调用情况 ６０位，从０开始，用满归零
userID userIDType
String Integer
1 1
用户号码 0：MSISDN 1：ＰＨＳ 2：PSTN 3：Pseudo Code
productID linkID
String String
1 0…1
产品标识 格式如下： MMDDHHMMSS+10 位 随 机 序 列 号。 需要 SP 下发业务，则需要填写本字 段
featureStr 输出参数：
String
0…1
使用特征码
中国电信 CDMA 业务网络接口协议技术规范-SP 管理接口协议规范(V1.0)
5
名称 streaming No resultCode
类型 String
出现次数 1
描述 将调用的StreamingNo原样返回，保证调用／ 返回的同步 参见附录 A
Integer
1
4.2.1.2
定购关系更新消息
定购关系更新通知（orderRelationUpdateNotifyReq Syntax） 接口调用方向：ISMP－> SP 触发条件： I. 定购、退定产品及组合产品、用户定购关系状态暂停、恢复暂停： ISMP 调用本接 口通知 SP； ； II. 组合产品定购关系状态变化时，ISMP 按组合产品一次调用本接口将组合产品 ID 通 知至 SP。
接口交互流程：
图3. 输入参数：
域名 类型
定购关系更新
出现次数
描述
6
中国电信 CDMA 业务网络接口协议技术规范-SP 管理接口协议规范(V1.0)
streamingNo
String
1
流水号， 可用于调用／提供双 方比较接口调用情况 ６０位， 从０开始， 用满归零
userID userIDType
String Integer
1 1
用户号码 0：MSISDN 1：ＰＨＳ 2：PSTN 3：Pseudo Code
productID oldProductID
String String
0…1 0…1 0…1 0…1 1
产品标识, 被替换产品标识（当 , OPType 为 6 时，该字段有效） 套餐标识 被替换套餐标识（当 , OPType 为 6 时，该字段有效） 0：定购 1：暂停 2：暂停恢复 3：退定 4：退定该 SP 的所有产品和套餐 5：暂停该 SP 的所有产品和套餐 6：替换
packageID old packageID
String String
OPType
Integer
输出参数：
名称 streaming No resultCode r Intege 1 类型 String 出现次数 1 描述 将调用的StreamingNo原样返回，保证调用／返 回的同步 参见附录 A
4.2.2
接口异常处理
触发条件： 退定实时消息应答不成功，或者超时无应答。注：定购通知消息 ISMP 需要等待 SP 回应后才能生成定购。
中国电信 CDMA 业务网络接口协议技术规范-SP 管理接口协议规范(V1.0) 7
承载协议：ftp（XML File） 同步时间间隔：可配置 方向： ISMP 生成同步文件，存放在指定目录下，SP 按照可以配置的周期从 ISMP 获 取同步文件信息，并负责将该文件删除。 同步参数及回执文件参数定义：同定购关系更新消息 目录格式如下： 同步数据$HOME/PP/SPID/SP_SUBSCRIPTIONREQ 回执数据$HOME/PP/SPID/SP_SUBSCRIPTIONRSP 文件名生成规则： 同步文件 SPSUBSCRIPTIONPPYYYYMMDDHHMMSS.AAA.REQ 回执文件 SPSUBSCRIPTIONPPYYYYMMDDHHMMSS.AAA.RSP 说明： PP SPID YYYY MM DD HH MM SS AAA 表示归属省代码，《参见中国电信综合业务管理平台规范总册》 SP 编码 表示生成此文件的年份 表示生成此文件的月份 表示生成此文件的日期 表示生成此文件的时 表示生成此文件的分 表示生成此文件的秒 表示文件序列号
同步文件：
参数名 streamingNo 类型 String 出现次数 1 长度 60 注释 流水 号，可用 于调用／ 提供双方
8
中国电信 CDMA 业务网络接口协议技术规范-SP 管理接口协议规范(V1.0)
比较接口 调用情况 ６０ 位，从０ 开始，用 满归零 timeStamp DateTime 1 14 戳 orderRelationUpdateInfo orderRelationUpdateInfoType 1…n 信息 orderRelationUpdateInfoType 数据类型 SP 时间
参数名
类型
出现次 数
长度
注释
SUBStreamingNo
String
1
60
流水号，可用于调用／提供双 方比较接口调用情况 ６０位，从０开始，用满归零
userID userIDType
String Integer
1 1
20 1
用户号码 0：MSISDN 1：ＰＨＳ 2：PSTN 3：Pseudo Code
productID packageID OPType
String String Integer
0…1 0…1 1
21 21 1
产品标识, 套餐标识 0：定购 1：暂停 2：暂停恢复 3：退定 4：退定该 SP 的所有产品和套餐
中国电信 CDMA 业务网络接口协议技术规范-SP 管理接口协议规范(V1.0)
9
5：暂停该 SP 的所有产品和套餐
回执文件：
参数名 streamingNo ing 类型 Str 出现次数 1 60 长度 注释 将 调 用 的
StreamingNo 原样返回， 保证调用／返回的同步 2 参见附录 A
resultCode eger
Int
1
4.3 ISMP 和 SP 反向退订接口 接口名称：spWithdrawSubscription()； 接口协议：Web Service； 接口调用方向：SP－>ISMP 触发条件：SP 在收到用户退订某短信业务的需求后，可以由 SP 通过反向退订接口 直接为用户退订业务，而无需用户自己进行退订。 需求约束：SP 发起的为用户提供退订服务和沉默用户梳理； 消息体定义： 输入参数：
参数名 streamingNo 类型 String 出现次数 1 况 SPID String 1 注释 流水号， 可用于调用／提供双方比较接口调用情 ６０位，从０开始，用满归零 SP编码，ISMP负责升级SP业务退订鉴权。 NMSC负责全国SP业务退订。 Spadmin SpadminPwd String String 1 1 帐号——SP数据统一配置到引擎中的帐号 帐号——SP数据统一配置到引擎中的密码
10
中国电信 CDMA 业务网络接口协议技术规范-SP 管理接口协议规范(V1.0)
userID userIDType
String Integer
1 1
用户号码 0：MSISDN 1：ＰＨＳ 2：PSTN
IDType
Integer
1
0:ProductID 1:PackageID 为销售品时此字段填写0，为捆绑销售品时填写 1
ID
String
1
IDType为0，本字段填销售品ID， IDType为1，本字段填捆绑销售品ID
输出参数：
参数名 streamingN o resultCode Integer 1 类型 String 出现次数 1 注释 将调用的StreamingNo原样返回，保证调用／返回 的同步 参见附录A
4.4 集团定购信息同步接口 4.4.1 触发条件： ISMP 每天定时（可配置）产生集团定购信息，被授权的 SP（提供集团应用的自营 SP 且业务为需要同步集团信息） 以 FTP 方式到指定目录下取得集团信息更新描述文件 （采 用 XML Schema 格式定义） 。SP 收到描述文件后删除目录上的集团信息更新描述文件 ISMP 仅同步正常状态的集团信息和集团成员对应信息。 4.4.2 集团定购信息同步目录及描述文件命名规则： ISMP 每天产生待更新的集团成员归属信息描述文件和集团产品定购/退定信息 描述文件，ISMP 为服务器端，省 SP 或 NMSC 为客户端。 文件目录：$HOME/SPID /ISMPID/CORPSUBSCRIPTIONINFO 集团成员归属信息描述文件命名：CORPMEMBERS_YYYYMMDD.XML，YYYYMMDD
中国电信 CDMA 业务网络接口协议技术规范-SP 管理接口协议规范(V1.0) 11
表示文件产生日期；集团产品信息描述文件命名：CORPPRODUCT_YYYYMMDD.XML， YYYYMMDD 表示文件产生日期。 4.4.3 集团成员归属信息描述文件定义： 参数名 StreamingNo TimeStamp CorpUserInfo 表1. String DateTime CorpUserInfo 类型 类型 出现次数 1 1 1….n 注释 流水号 时间戳 集团成员信 息
CorpUserInfo 类型 参数名 类型 String Integer 出现次数 1 1 注释 用户号码 0：MSISDN 1：PHS 2：PSTN 1：增加 2：修改 3：删除 集团编号
UserID UserType
OpFlag
Integer
1
CorpID
String
1
4.4.4
集团产品定购/退定信息描述文件定义：
参数名 StreamingNo TimeStamp CorpInfo String
类型 DateTime CorpInfo 类型
出现次数 1 1 1…n
注释 流水号 时间戳
表2.
CorpInfo 类型 参数名 类型 String String String 出现次数 1 0…1 1 注释 集团 ID 集团描述信 息 集团定购的 PushEmail 产品 ID 0：定购 1： 退定
CorpID CorpDesc ProductID
OpFlag
Interger
1
12
中国电信 CDMA 业务网络接口协议技术规范-SP 管理接口协议规范(V1.0)
规范性附录 A
SP 接口结果码定义
结果码
描述
0 10 11 12 13 14 15 16 17 18 19 20 21 22 99
成功 发端设备类型非法 发端设备ID非法 用户号码非法 用户类型非法 产品ID非法 套餐ID非法 LinkID 非法 HasFeatureStr 非法 FeatureStr 非法 ID 非法 IDType 非法 Status 非法 OPType 非法 其他
中国电信 CDMA 业务网络接口协议技术规范-SP 管理接口协议规范(V1.0)
13