ISMP接口规范(RC1.0.1)-SP接口

中国电信集团公司
综合业务管理平台ISMP接口规范-SP接口SN RC1 ISMP V1.0.1
目 录
1适用范围 (4)
2引用标准 (5)
3缩略语 (6)
4ISMP与SP之间的接口 (7)
4.1管理信息通知接口 (7)
4.2定购/使用通知接口 (8)
4.2.1概述 (8)
4.2.2接口异常处理 (11)
附录A：SP接口结果码定义 (12)
综合业务管理平台ISMP接口规范-SP接口SN R2 ISMP V1.0.1 文档编号：000001
前 言
本规范定义了中国电信综合业务管理平台ISMP（Integrated Service Management Platform）的接口规范，包括ISMP与SS、ISAG、MSNMC、Portal、OCS、IN、运营支撑系统、CP/SP之间的接口。

本规范解释权属于中国电信集团公司。

本规范起草单位：中国电信股份有限公司上海研究院。

本标准主要起草人：韩彬斌，王铮，任华，方燕萍，黄铖斌，杨迪，张亚玫、宋金晶、黄颂尧。

综合业务管理平台ISMP接口规范-SP接口SN RC1 ISMP V1.0.1
1适用范围
本规范适用于中国电信综合业务管理平台（ISMP）产品的设计及研发，提供给为中国电信开发制造ISMP的设备供应商。

本规范是中国电信各级运营单位进行ISMP招标采购、工程设计、网络运营、管理、维护等方面的技术依据。

综合业务管理平台ISMP接口规范-SP接口SN R2 ISMP V1.0.1 文档编号：000001 2引用标准
下列文件通过本文的参考而成为本规范的条款。

凡是注日期的参考文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本文，凡是不注日期的参考文件，其最新版本适用于本文。

【1】 《中国电信移动增值业务网络技术体制》
【2】 《中国电信综合业务管理平台ISMP规范总册》
【3】 《中国电信综合业务管理平台ISMP设备规范》
【4】 《中国电信综合业务管理平台ISMP数据规范》
综合业务管理平台ISMP接口规范-SP接口SN RC1 ISMP V1.0.1
3缩略语
缩略语英文全名中文全名
第三代移动通信
3G 3rd
Generation
应用发起终端结束AOMT Application Originated Mobile Terminated
内容提供商
CP Content
Provider
客户关系管理
CRM Customer Relation Management
数字版权管理
DRM Digital Rights Management
email发起终端结束EOMT Email Originated Mobile Terminated
因特网协议
Protocol
IP Internet
综合业务管理接入协议ISMAP Integrated Service Management Access Protocol
综合业务管理平台
Service Management Platform
ISMP Integrated
声讯系统
IVR Interactive Voice Response
JAVA下载
Java Java
定位业务
LCS Location
Service
多媒体消息
MMS Multimedia Message Service
终端发起应用结束MOAT Mobile Originated Application Terminated
终端发起email结束MOET Mobile Originated Email Terminated
终端发起终端结束MOMT Mobile Originated Mobile Terminated
移动支付业务系统MPSS Mobile Payment Service System
地市级业务操作平台MSOP Metropolis service operator platform
移动业务全国管理中心MSNMC Mobile Service National Management Center
网络管理系统
NMS Network management system
操作维护中心
OMC Operating and Maitenance Center
协议数据单元
PDU Protocol Data Unit
小灵通
PHS Personal handset system
省级业务操作平台PSOP Province Service Operation Platform
实时扣费协议
RTBP Real Time Billing Protocol
业务接入网关
SAG Service Access Gateway
业务控制点
SCP Service Control Point
短信网关协议
SMGP Short Message Gateway Protocol
短消息业务
SMS Short Message Service
简单网管协议
SNMP Simple Network Management Protocol
业务提供商
Provider
SP Service
SP管理系统（小灵通）SPMS SP Management System
单点接入
SSO Single Sign On
流媒体
Streaming Streaming
传输控制协议
TCP Transfer Control Protocol
无线应用协议
WAP Wireless Application Protocol
综合业务管理平台ISMP接口规范-SP接口SN R2 ISMP V1.0.1 文档编号：000001 4ISMP与SP之间的接口
4.1 管理信息通知接口
notifyManagementInfo（）
接口调用方向：ISMP－> SP
触发条件：SP的业务能力签约、业务、产品、套餐的状态变化时，通知SP 该SP的业务能力签约、业务、产品、套餐的编号和状态。

需求约束：
若SP收到业务能力签约注销状态则自行注销基于该业务能力签约发布的所有业务下的产品的定购关系；若SP收到业务注销状态则自行注销基于该业务发布的所有产品的定购关系；若SP收到产品/套餐暂停/注销状态则自行暂停/注销该产品/套餐的所有定购关系。

业务能力签约状态变化导致的业务、产品状态变化，仅将业务能力签约状态同步给SP；业务状态变化导致的产品状态变化，仅将业务状态同步给SP。

SP状态变化及SP状态变化导致的业务能力签约、业务、产品、套餐的状态变化不通知SP。

跨SP的套餐需要将套餐ID通知该套餐内产品的所有SP。

接口交互流程：
综合业务管理平台ISMP接口规范-SP接口SN RC1 ISMP V1.0.1
图1. 管理信息
输入参数：
名称类型出现次数描述
streamingNo String 1 流水号，可用于调用／提供双方比较接口调用情况
６０位，从０开始，用满归零
ID String 1 编号，根据IDType填写
IDType Integer 1 0：ProductID
1：PackageID
2：ServiceID
3：ServiceCapabilityID
status Integer 10：正常
1：申请
2：暂停（IDType为2、3时不可以填本项枚举
值）
3：预注销
4：注销
输出参数：
名称类型出现次数描述
streamingNo String 1 将调用的StreamingNo原样返回，保证调用／返回的同
步
resultCode Integer 1
参见附录A
4.2 定购/使用通知接口
4.2.1概述
承载协议：WebService（Document Style）
消息列表：
消息名称
业务使用通知消息
定购关系更新通知消息
综合业务管理平台ISMP接口规范-SP接口SN R2 ISMP V1.0.1 文档编号：000001 4.2.1.1 业务执行通知消息
业务使用通知请求（serviceConsumeNotifyReq Syntax）
接口调用方向：ISMP－> SP
触发条件： ISMP获取用户业务执行请求后，发送该消息，SP根据业务情况，决定下发时间。

需求约束：门户发起业务执行时使用本接口通知SP。

接口交互流程：
图2. 业务使用
输入参数：
域名类型出现次数描述
streamingNo String 1 流水号，可用于调用／提供双方比较
接口调用情况
６０位，从０开始，用满归零
1 用户号码
userID String
userIDType Integer 1 0：MSISDN
1：ＰＨＳ
2：PSTN
3：Pseudo Code
productID String 1 产品标识
0…1 格式如下：
linkID String
综合业务管理平台ISMP接口规范-SP接口SN RC1 ISMP V1.0.1
MMDDHHMMSS+10位随机序列
号。

需要SP下发业务，则需要填写本字
段
featureStr String 0…1 使用特征码
输出参数：
名称
类型出现次数描述
streamingNo String 1 将调用的StreamingNo原样返回，保证调用／返回
的同步
resultCode Integer 1 参见附录A
4.2.1.2 定购关系更新消息
定购关系更新通知（orderRelationUpdateNotifyReq Syntax）
接口调用方向：ISMP－> SP
触发条件：
I.定购关系状态变化（正常、暂停、注销）时：用户定购/退定、用户通过客服要求暂停和暂停恢复，
ISMP调用本接口通知SP；
II.套餐定购关系状态变化时，ISMP按产品拆分多次调用本接口将套餐ID和产品ID通知各SP。

接口交互流程：
图3. 定购关系更新
输入参数：
域名
类型出现次数描述
streamingNo String 1 流水号，可用于调用／提供双方比
较接口调用情况
６０位，从０开始，用满归零userID String 1
用户号码
userIDType Integer 1 0：MSISDN
1：ＰＨＳ
2：PSTN
3：Pseudo Code
productID String 0…1 产品标识,
packageID String 0…1 套餐标识
OPType10：定购
Integer
1：暂停
2：暂停恢复
3：退定
4：退定该SP的所有产品和套餐
5：暂停该SP的所有产品和套餐 输出参数：
名称类型出现次数描述
streamingNo String 1 将调用的StreamingNo原样返回，保证调用／返回的
同步
Integer 1 参见附录A
resultCode
4.2.2接口异常处理
触发条件：
实时消息应答不成功，或者超时无应答。

承载协议：ftp（XML File）
同步时间间隔：可配置
方向： ISMP生成同步文件，存放在指定目录下，SP按照可以配置的周期从ISMP获取同步文件信息，并负责将该文件删除。

同步参数及回执文件参数定义：同定购关系更新消息
目录格式如下：
同步数据$HOME/PP/SPID/SP_SUBSCRIPTIONREQ
回执数据$HOME/PP/SPID/SP_SUBSCRIPTIONRSP
文件名生成规则：
同步文件SPSUBSCRIPTIONPPYYYYMMDDHHMMSS.AAA.REQ
回执文件SPSUBSCRIPTIONPPYYYYMMDDHHMMSS.AAA.RSP
说明：
PP 表示归属省代码，《参见中国电信综合业务管理平台规范总册》SPID SP编码
YYYY 表示生成此文件的年份
表示生成此文件的月份
MM
表示生成此文件的日期
DD
表示生成此文件的时
HH
表示生成此文件的分
MM
表示生成此文件的秒
SS
表示文件序列号
AAA
同步文件：
类型注释参数名出现次数长
度
streamingNo String 1
60
流水号，可用于调用／提
供双方比较接口调用情
况
６０位，从０开始，用满
归零
14
timeStamp DateTime 1
时间戳orderRelationUpdateInfo orderRelationUpdateInfoType1…n - SP信息
orderRelationUpdateInfoType数据类型
长度注释
参数名类型出现次
数
SUBStreamingNo String 1 60 流水号，可用于调用／提供双方比较接口调用
情况
６０位，从０开始，用满归零
20 用户号码
1
userID String
1 1 0：MSISDN
userIDType Integer
1：ＰＨＳ
2：PSTN
3：Pseudo Code
0…1 21 产品标识,
productID String
0…1 21 套餐标识
packageID String
Integer 1 1 0：定购
OPType
1：暂停
2：暂停恢复
3：退定
4：退定该SP的所有产品和套餐
5：暂停该SP的所有产品和套餐
回执文件：
参数名类型出现次数长度注释
1 60 将调用的StreamingNo原
streamingNo String
样返回，保证调用／返回
的同步
resultCode Integer 1 2 参见附录A
4.3 集团定购信息同步接口
4.3.1触发条件：
ISMP每天定时（可配置）产生集团定购信息，被授权的SP（提供集团应用的自营SP且业务为需要同步集团信息）以FTP方式到指定目录下取得集团信息更新描述文件（采用XML Schema格式定义）。

SP 收到描述文件后删除目录上的集团信息更新描述文件
ISMP仅同步正常状态的集团信息和集团成员对应信息。

4.3.2集团定购信息同步目录及描述文件命名规则：
ISMP每天产生待更新的集团成员归属信息描述文件和集团产品定购/退定信息描述文件，ISMP为客户端，省SP或NMSC为服务器端。

文件目录：$HOME/SPID /ISMPID/CORPSUBSCRIPTIONINFO
集团成员归属信息描述文件命名：CORPMEMBERS_YYYYMMDD.XML，YYYYMMDD表示文件产生日期；集团产品信息描述文件命名：CORPPRODUCT_YYYYMMDD.XML， YYYYMMDD表示文件产生日期。

4.3.3集团成员归属信息描述文件定义：
参数名类型出现次数注释
StreamingNo String 1 流水号
TimeStamp DateTime 1 时间戳
CorpUserInfo CorpUserInfo类型1….n 集团成员信
息
表1. CorpUserInfo类型
类型出现次数注释
参数名
用户号码
UserID String 1
0：MSISDN
UserType Integer 1
1：PHS
2：PSTN
1：增加
OpFlag Integer 1
2：修改
3：删除
集团编号
CorpID String 1
4.3.4集团产品定购/退定信息描述文件定义：
参数名类型出现次数注释
StreamingNo String 1 流水号
TimeStamp DateTime 1 时间戳
CorpInfo CorpInfo类型1…n
表2. CorpInfo类型
参数名类型出现次数注释
集团ID
CorpID String 1
集团描述信
CorpDesc String 0 (1)
息ProductID String 1 集团定购的
PushEmail
产品ID
0：定购OpFlag Interger 1
1：退定
附录A：SP接口结果码定义结果码描述
0 成功
发端设备类型非法
10
发端设备ID非法
11
用户号码非法
12
用户类型非法
13
产品ID非法
14
套餐ID非法
15
LinkID非法
16
17
Has FeatureStr非法
FeatureStr非法
18
ID非法
19
IDType非法
20
Status非法
21
OPType非法
22
其他
99。