中国电信综合业务管理平台ISMP规范-ISMP与CRM 客服系统集成方案(RC1.0.1)-unprotected
CT
中国电信集团公司
综合业务管理平台-CRM 集成方案SN RC1 ISMP V1.0.1
目 录
1 适用范围.........................................................................4 2 引用标准.........................................................................5 3 缩略语............................................................................6 4 名词对照表.......................................................................7 5 功能界定.........................................................................8 6 ISMP 与CRM 接口.................................................................10 6.1 概述...........................................................................10 6.2 实时接口.......................................................................10 6.2.1 接口列表.....................................................................10 6.2.2 用户信息同步接口...........................................................10 6.2.3 用户业务能力开通接口.......................................................15 6.2.4 定购关系管理接口...........................................................17 6.2.5 错误代码表..................................................................24 6.3 非实时接口....................................................................24 6.3.1 接口列表.....................................................................24 6.3.2 用户信息同步接口...........................................................25 6.3.3 集团信息同步接口(可选)..................................................28 6.3.4 CP/SP 信息同步接口..........................................................31 6.3.5 产品/计费/销售品/捆绑类销售品信息同步接口.................................33 7 ISMP 与10000号客服接口........................................................48 7.1 集成方式.......................................................................48 7.2 页面集成.......................................................................48 7.3 工单接口.......................................................................48 7.3.1 功能界定.....................................................................48 7.3.2 接口列表.....................................................................48 7.3.3 受理接口.....................................................................49 7.3.4 反馈接口.....................................................................50 附录A. 业务能力编号及业务类型. (52)
广
东
电
信分
公司
专
用
ISMP NMSC 与运营支撑系统集成规范SN R2 ISMP V1.0.1 NMSC V1.0.1
前 言
本规范是中国电信第三代移动通信综合业务管理平台ISMP 系列规范之一,本规范定义了中国电信综合业务管理平台ISMP(Integrated Service Management Platform)与运营支撑系统的集成规范,包括功能界定、集成架构、接口定义等。
本规范附录 A 规范性附录。
本规范解释权属于中国电信集团公司。
本规范起草单位:中国电信股份有限公司上海研究院。 本标准主要起草人:韩彬斌、王铮、张亚玫、杨迪。
广
东
电
信分
公司
专
用
综合业务管理平台-CRM 集成方案SN RC1 ISMP V1.0.1
1 适用范围
本规范适用于中国电信综合业务管理平台(ISMP)、CRM 系统产品的设计及研发,提供给为中国电信开发制造ISMP 及相关业务支撑系统的设备供应商。本规范是中国电信各级运营单位进行ISMP 招标采购、工程设计、系统集成、网络运营、管理、维护等方面的技术依据。
广
东
电
信
分
公司
专
用
ISMP NMSC 与运营支撑系统集成规范SN R2 ISMP V1.0.1 NMSC V1.0.1
2 引用标准
下列文件通过本文的参考而成为本规范的条款。凡是注日期的参考文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本文,凡是不注日期的参考文件,其最新版本适用于本文。 【1】 《中国电信综合业务管理平台ISMP 规范总册(V2.1.0)》
广
东
电
信
分
公司
专
用
综合业务管理平台-CRM 集成方案SN RC1 ISMP V1.0.1
3 缩略语
缩略语 英文全名
中文全名
ISMP Integrated Service Management Platform
综合业务管理平台
CRM
Customer Relation Management
客户关系管理
广
东
电
信
分
公司
专
用
ISMP NMSC 与运营支撑系统集成规范SN R2 ISMP V1.0.1 NMSC V1.0.1
4 名词对照表
本集成方案按照中国电信企业数据模型EDM规范要求对ISMP和业务支撑系统中的相关名词进行了统一,名词对照表:
表1. 名词对照表
ISMP 名词
EDM 名词
内容:content 无
业务:service 产品:product 产品:product
销售品:product offer
套餐(增值业务):package
捆绑销售品(增值业务):product offer
套餐(传统业务+增值业务):package 捆绑销售品(传统业务+增值业务):product offer 用户:userID
(主)产品实例:product instance
下文均按照EDM 的要求,使用上述名词。
广
东
电
信分
公司
专
用
综合业务管理平台-CRM 集成方案SN RC1 ISMP V1.0.1
5 功能界定
ISMP与运营支撑系统功能界定: A、目标方案
CRM作为业务支撑系统(BSS)部分的核心系统,是支撑企业客户品牌经营的核心,主要负责客户管理、产品管理、订单管理、客户服务、市场计划、销售管理、营销资源管理以及合作伙伴管理(合作伙伴的基本资质信息)。ISMP作为移动数据增值业务管理系统,主要负责用户管理、内容管理、业务能力管理、业务管理、业务定购、合作伙伴管理(合作伙伴业务管理)、认证鉴权、以及终端信息适配等工作。ISMP与CRM二者之间既相互分工,又彼此合作。其中部分功能虽然有所重叠,但各自有所侧重。
B、过渡方案
目前大部分省集中CRM刚刚上线,少部分省CRM还处在推广过程中,CRM对于合作伙伴、增值业务的产品管理等方面功能还不是很完善,因此当前阶段CRM与ISMP的集成接口和功能界面采用如下过渡方案。
I. 个人用户管理
1、个人用户信息分为个人用户基本信息和增值业务相关信息两部分。个人用户基本信息由
CRM 维护,并同步给ISMP,个人用户的增值业务相关信息由ISMP 维护;
2、个人用户状态由CRM 维护,并将其映射为四种状态同步给ISMP,包括正常、注销、单停机、双停机四种状态;
3、ISMP 以用户号码为单位标识用户的付费类型,ISMP 支持的付费类型包括后付费、准预付费(不通过智能网实时扣费的预付费用户)、预付费,个人用户付费类型由CRM 维护,并同步给ISMP;
4、个人用户业务能力开通及取消由CRM 系统发起,并由ISMP 执行。默认SMS、WAP、MMS、KJAVA、Streaming、LCS 全部用户开通且不收费(用户开通LCS 不表示用户可以发起定位和被定位)。要求CRM 系统默认开通GPRS。如开通业务能力需收费,由ISMP 负责收费。
5、客户的黑红名单由CRM 维护,用户层面移动数据增值业务的黑红名单由ISMP 维护,双方暂不存在约束与关联关系。
6、移动数据业务所需的集团用户管理在CRM 中维护并管理。
II.CP/SP 管理
广
东
电
信
分
公
司
专
用
ISMP NMSC 与运营支撑系统集成规范SN R2 ISMP V1.0.1 NMSC V1.0.1
1、ISMP 完成CP/SP 管理,并将CP/SP 信息同步到CRM。
2、NSMC 完成全国级CP/SP 管理,并将全国级CP/SP 信息同步到全国级CRM。同时,NMSC 将全国SP/CP 信息同步到省级ISMP,再由省级ISMP 同步到省级CRM。 III. 产品/销售品管理
1、ISMP 完成增值业务产品和销售品的管理,并将产品/销售品信息同步到CRM;
2、CRM 完成“传统+增值”捆绑类销售品的管理,并同步到ISMP。
3、NMSC 完成全国级产品/销售品管理,并将全国级产品/销售品信息同步到全国级CRM。同时,NMSC 将全国产品/销售品信息同步到省级ISMP,再由省级ISMP 同步到省级CRM。
IV.销售品定购
1、定购关系以ISMP 中保存的为准;
2、对于纯增值销售品:通过ISMP 门户定购时,由ISMP 生成用户定购关系;通过营业厅或10000号定购时,通过CRM 集成ISMP 管理员门户及界面实现。
3、对于“传统+增值”捆绑销售品:在营业厅和10000号定购时,CRM 生成订购关系,并
送到ISMP 实时开通;ISMP 门户不支持此类销售品的定购。
4、用户可以通过全国CRM 到NMSC 完成全国级增值业务的定购。 V. 内容管理
1、内容由ISMP 管理,不同步到CRM。 VI.投诉
1、ISMP 从客服系统接受投诉工单,由ISMP 操作员根据投诉内容指派给相关人员处理;
2、对于针对全网SP/CP 的投诉,由省级客服系统转发至省级ISMP 受理后,转发至NMSC
处理。
3、投诉处理结束后,ISMP 通过工单接口,将受理结果返回给客服系统。
VII. 客服
1、客服人员使用10000号及CRM 的界面,对于ISMP 纯增值业务的客服处理,界面集成ISMP 管理员门户。
广
东
电
信
分
公司
专
用
综合业务管理平台-CRM 集成方案SN RC1 ISMP V1.0.1
6 ISMP 与CRM 接口
6.1 概述
本文描述ISMP 和运营商支撑系统中CRM 之间的接口,主要用于双方信息的同步。
6.2 实时接口
6.2.1 接口列表
实时接口列表:
表2. ISMP 与CRM 实时接口列表 承载协议 分类 名称
方向
CreateISMPUser() 用户基本信息同步 CRM (客户端)->ISMP (服务器)
NotifyUserState() 用户状态更新
CRM (客户端)->ISMP (服务器)
用户信息同步
NotifyUserFeeType() 用户付费类型切换 CRM (客户端)->ISMP (服务器)
业务能力开通 ServiceCapabilitySubscri ptionSync()
用户业务能力开通
CRM (客户端)->ISMP (服务器)
createSubscription()
CRM (客户端)->ISMP (服务器)
withdrawSubscription()
CRM (客户端)->ISMP (服务器)
withdrawAllSubscription()
CRM (客户端)->ISMP (服务器)
Web
Service(D ocument Style)
定购关系管理
SubscriptionSync()
ISMP (客户端)->CRM (服务器)
6.2.2 用户信息同步接口
6.2.2.1
用户基本信息同步接口
触发条件:用户开户时,从CRM 同步到ISMP 。
广
东
电
信分
公司
专
用
ISMP NMSC 与运营支撑系统集成规范SN R2 ISMP V1.0.1 NMSC V1.0.1
承载协议:Web Service(Document Style)。 方向:CRM->ISMP 。 交互流程:
图1. 用户信息同步流程
流程描述:
I. 用户通过中国电信各种销售渠道提交成为中国电信正式用户的申请; II. CRM 接受用户的申请请求,确认该用户成为中国电信正式用户; III.
CRM 向用户反馈用户开通成功;
IV. CRM 调用用户信息同步接口;向ISMP 发送该用户基本信息; V. ISMP 收到用户基本信息后,存储用户信息; VI. ISMP 返回CRM 用户信息同步应答;
VII.
CRM 向用户反馈用户开通成功。
原型描述:CreateISMPUser() 输入参数:
表3. 用户基本信息同步接口输入参数 参数名称
类型
出现次数
描述信息
streamingNo String 1
流水号
srcDeviceID String 1 CRM 的SrcDeviceID ,取值参见《中
国电信综合业务管理平台ISMP 规范总册》
广
东
电
信分
公司
专
用
综合业务管理平台-CRM 集成方案SN RC1 ISMP V1.0.1
userID String 1
用户号码 userName String 0..1 用户姓名:指CRM 使用客户姓名 provinceID String 1 用户归属省 cityID String 1 用户归属地市 userIDType String 1 用户号码类型 1:Msisdn 2:PHS 3:固定电话 userPayType String 1
用户付费类型
1:后付费用户
2:准预付费用户(不通过智能网实时扣费的预付费用户) 3:预付费用户 prePaidSystemID String 1 预付费系统编号。
返回参数:
表4. 用户基本信息同步接口返回参数 参数名称
类型
出现次数描述信息
streamingNo String 1 流水号
resultCode Integ
er
1
0:成功
1-n :错误代码
6.2.2.2 用户状态更新接口
触发条件:CRM 中用户状态更新后。
承载协议:Web Service(Document Style)。 方向:CRM->ISMP 。 交互流程:
广
东
电
信分
公司
专
用
ISMP NMSC 与运营支撑系统集成规范SN R2 ISMP V1.0.1 NMSC V1.0.1
图2. 用户状态同步流程
流程描述:
I. 用户通过各种方式向CRM 提交用户状态变更申请; II.CRM 中,用户状态变更; III. CRM 通知用户状态变更成功; IV.CRM 向ISMP 同步用户状态信息;
V. ISMP 接受用户状态同步请求后修改相应的用户状态; VI.ISMP 返回CRM 用户状态更新应答; VII. CRM 通知用户状态变更成功。 原型描述:NotifyUserState() 输入参数:
表5. 用户状态更新接口输入参数 参数名称 类型
出现次数
描述信息
streaming No String 1 流水号
srcDeviceI D String 1
CRM 的SrcDeviceID ,参见《中国电信综合业务管理平台规范总册》 userID String 1
用户号码
userIDTyp e
String 1
用户号码类型: 1:Msisdn 2:PHS 3:固定电话
state String 1 用户状态:
0:正常 2:注销 3:单停机 4:双停机
返回参数:
表6. 用户状态更新接口返回参数
参数名称
类型
出现次数
描述信息
streamingNo String 1
流水号
resultCode Integer 1 0:成功
1-n :错误代码
广
东
电
信分
公司
专
用
综合业务管理平台-CRM 集成方案SN RC1 ISMP V1.0.1
6.2.2.3 用户付费类型切换接口
触发条件:CRM 受理付费类型切换请求成功后。 承载协议:Web Service(Document Style)。 方向:CRM->ISMP 。 交互流程:
图3. 用户付费类型切换流程
流程描述:
I. 用户通过各种方式向CRM 提交付费状态变更申请
II.CRM 变更用户付费类型;
III. CRM 通知用户付费类型变更请求成功; IV.CRM 向ISMP 发送用户付费类型切换请求信息; V. ISMP 接受用户付费类型切换请求后修改用户付费类型; VI.ISMP 返回CRM 用户付费类型切换应答。
原型描述:NotifyUserFeeType() 输入参数:
表7. 用户付费类型切换接口输入参数
参数名称
类型
出现次数
描述信息
streamingNo String 1
流水号
广
东
电
信分
公司
专
用
ISMP NMSC 与运营支撑系统集成规范SN R2 ISMP V1.0.1 NMSC V1.0.1
srcDeviceID String 1 CRM 的SrcDeviceID userID String 1 用户号码 userIDType String 1
用户号码类型:
1:Msisdn 2:PHS 3:固定电话 userPayType String 1
用户付费类型: 0:后付费用户 1:预付费用户 2:准预付费用户
prePaidSystemID String 0..1
如果是切换到预付费系统的话,需提供此字段,表明在那个预付费系统扣费。
effectiveDate Date 1 生效日期
返回参数:
表8. 用户付费类型切换接口返回参数 参数名称
类型
出现次数
描述信息
streamingNo String 1
流水号 resultCode Integer 1
0:成功
1-n :错误代码
6.2.3 用户业务能力开通接口
触发条件:用户通过CRM/PF 开通或者关闭业务能力时。
承载协议:Web Service(Document Style)。
方向:CRM/PF->ISMP 。 交互流程:
广
东
电
信
分
公
司
专
用
综合业务管理平台-CRM 集成方案SN RC1 ISMP V1.0.1
图4. 用户业务能力同步流程
流程描述:
I. 用户通过各种渠道申请用户开通/关闭; II.CRM 受理用户的申请;
III. CRM 向ISMP 发送业务能力开通请求;
IV.ISMP 收到用户业务能力开通后,存储用户信息;
V. ISMP 返回CRM 用户业务能力开通应答;
VI.CRM 向用户反馈用户开通/关闭成功。 原型描述:ServiceCapabilitySubscriptionSync() 输入参数:
表9. 用户业务能力开通接口输入参数
参数名
类型
出现次数
注释
streamingNo String 1 流水号
srcDeviceID String 1 CRM 的SrcDeviceID userID String 1 用户号码 userIDType Integer 1
用户号码类型: 1:Msisdn 2:PHS 3:固定电话
广
东
电
信分
公司
专
用
ISMP NMSC 与运营支撑系统集成规范SN R2 ISMP V1.0.1 NMSC V1.0.1
serviceCapabilityID String 1
业务能力ID 。
CRM-ISMP 之间关于业务能力的定义与ISMP 业务能力的定义不同,是否需要统一定义,代讨论。 1. SMS 2. MMS 3. LCS
4. Download
5. WAP
6. Streaming
7. IM
8. CRBT
9-11. Reserved. 12. Pushmail 13. Poc 14. MPSS
updateType Integer 1
更新操作的类型: 1:开通 2:关闭 返回参数:
表10. 用户业务能力开通接口返回参数 参数名
类型
出现次数
注释
streamingNo String
1
流水号 resultCode Integer 1
0:成功
1-n :错误代码
6.2.4 定购关系管理接口
6.2.4.1
定购接口
接口方向:CRM->ISMP。
触发条件:用户在CRM 发起定购请求。
需求约束:必须通过用户认证之后CRM 才能发起定购消息,ISMP 先鉴权计费,再生成定购关系,
最后返回给CRM。从CRM 发起的定购请求不需要二次确认。
交互流程:
广
东
电
信分
公司
专
用
综合业务管理平台-CRM 集成方案SN RC1 ISMP V1.0.1
图5. 定购接口交互流程
原型描述: createSubscription() 消息体定义: 输入参数:
参数名
类型
出现次数
注释
streamingNo String 1
流水号,可用于调用/提供双方比较接口调用情况
60位,从0开始,用满归零 srcDeviceType Integer
1
发端设备类型
参见《中国电信综合业务管理平台ISMP 规范总册》 srcDeviceID String 1
发端设备ID
参见《中国电信综合业务管理平台ISMP 规范总册》 OA String 1 定购方用户号码 OAType Integer 1
0:MSISDN 1:PHS 2:PSTN
DA String 1 使用方用户号码,默认与定购方
相同,用户赠送时为受赠方号码
DAType Integer 1 0:MSISDN
1:PHS
广
东
电
信分
公
司
专
用
ISMP NMSC 与运营支撑系统集成规范SN R2 ISMP V1.0.1 NMSC V1.0.1
2:PSTN
FA String 1 付费方 FAType Integer 1 0:MSISDN
1:PHS 2:PSTN
PProductOfferID String
1
CRM 传统+增值业务的捆绑销售品ID
PackageID String 1..n 增值业务捆绑销售品ID 列表
ProductID String 1..n 增值业务销售品ID 列表
输出参数:
参数名 类型 出现次数 注释
streamingNo String 1
将调用的StreamingNo 原样返回,保证调用/返回的同步
resultCode Integer 1 参见附录D
effectiveTime Datetime 0 (1)
定购关系生效时间,不填表示立即生效
expireTime Datetime 0…1 定购关系失效时间,自动续订的
不填
6.2.4.2 退定接口
接口方向:CRM->ISMP。
触发条件:用户在CRM 发起退定请求。
需求约束:必须通过用户认证之后CRM 才能发起退定消息,要求仅定购类产品定购关系状态为正常、
待生效、暂停及暂停+待生效时,CRM 可以为用户显示退定链接。
交互流程:
广
东
电
信
分
公司
专
用
综合业务管理平台-CRM 集成方案SN RC1 ISMP V1.0.1
图6. 退定接口交互流程
原型描述: withdrawSubscription() 消息体定义: 输入参数:
参数名
类型
出现次数
注释
streamingNo String 1
流水号,可用于调用/提供双方比较接口调用情况
60位,从0开始,用满归零 srcDeviceType Integer
1
发端设备类型
参见《中国电信综合业务管理平台ISMP 规范总册》 srcDeviceID String 1
发端设备ID
参见《中国电信综合业务管理平台ISMP 规范总册》 userID String 1 用户号码 userIDType Integer 1
0:MSISDN 1:PHS 2:PSTN
IDType Integer 1 0:ProductID
1:PackageID
为销售品时此字段填写0,为捆绑销售品时填写1
广
东
电
信分
公
司
专
用