中国移动一级BOSS接口规范12580业务单行本V28.docx
《中国移动一级BOSS接口规范12580业务单行本V28.docx》由会员分享，可在线阅读，更多相关《中国移动一级BOSS接口规范12580业务单行本V28.docx（84页珍藏版）》请在冰豆网上搜索。
中国移动一级BOSS接口规范12580业务单行本V28
中国移动通信有限公司
12580业务接口规范
单行本V2.8
中国移动通信集团公司
二○○七年三月
文档变更记录
序号
变更内容说明
版本号
版本日期
执笔人
1.
初稿
1.0
2007-3-19
王进
2.
修订：
在投诉流程中增加投诉归档交易
1.1
2007-4-2
王进
3.
修订：
在2.5.5确认请求报文中增加工单状态
1.2
2007-4-4
王进
4.
修订：
删除一些无关文字并赠加2.5.5，2.7.4报文中的过失方编码
1.3
2007-4-6
余兆成
5.
修订：
在2.4.5、2.5.5、2.7.4请求交易报文中增加用户姓名
1.4
2007-4-11
王进
6.
修订：
2.7.4应答报文中增加用户投诉时间、投诉提交时间、投诉归档时间
1.5
2007-4-17
王进
7.
修订：
2.4.3增加12580用户查询业务编码，2.4.4增加12580用户查询交易编码
1.5
2007-4-17
王进
8.
修订：
2.5.5投诉确认请求报文中18.1.6改为status
1.6
2007-4-18
王进
9.
修订：
2.6.3增加BIPCodeBIP2C002
1.7
2007-4-23
王进
10.
修订：
2.5.4中的投诉归档交易属性方向反了，现改正。
1.8
2007-4-24
王进
11.
修订：
2.7工单查询交易应答报文的工单状态与投诉中的工单状态一致
1.9
2007-5-17
王进
12.
修订：
在2.6省客服投诉升级中增加投诉升级确认、投诉归档交易及相关说明
2.0
2007-5-22
王进
13.
修订：
在1.2接口概述中增加投诉升级业务的确认、归档接口
2.0
2007-5-22
王进
14.
修订：
在2.5.5投诉相关交易请求报文中增加投诉工单编号的编码规则
2.0
2007-5-22
王进
15.
修订：
在2.6.5投诉升级的相关交易请求报文中增加投诉工单编号的编码规则
2.0
2007-5-22
王进
16.
修订:
4.2.1文件名中增加省代码
2.1
2007-6-6
王进
17.
修订：
2.4.5中的品牌代码字段宽度由F2改为F1
2.2
2007-8-6
王进
18.
修订:
新增2.4小节
2.3
2008-12-12
王进
19.
修订:
删除2.4小节二级应答编码表中编号为10的应答信息
2.3
2008-12-12
王进
20.
修订:
新增2.5小节
2.4
2008-12-16
王进
21.
修订:
新增2.6小节
2.4
2008-12-17
王进
22.
修订:
2.5.4.2变更通知请求交易报文中新增BizCode字段
2.5
2008-12-19
王进
23.
修订：
2.5.4.2请求报文中增加SPID企业代码字段
2.6
2009-1-17
王进
24.
修订：
将2.4.5.2、2.5.4.2中的BizType字段的取值由33改为52
2.6
2009-1-17
王进
25.
修订：
取消2.4.3.2省BOSS退订流程中关于统一查询退订的描述
2.6
2009-1-17
王进
26.
修订：
2.6.4.2中的Opr字段取消02－注销操作码
2.7
2009-1-17
王进
27.
修订：
2.6.4.2中的SPID字段取消长度为0的错误描述
2.7
2009-1-17
王进
28.
修订：
修改2.6.2业务流程中的笔误，因用户状态改变产生的暂停、恢复等变更，省BOSS也要发往内容计费系统
2.8
2009-2-27
王进
目录
1.综述7
1.1.范围7
1.2.接口概述7
1.3.术语8
1.4.参考文档9
2.12580综合信息服务10
2.1.12580信息服务简介10
2.2.与本文相关的接口描述11
2.3.12580组网结构图11
2.4.12580全网前向业务受理13
2.4.1.业务功能13
2.4.2.业务约束13
2.4.3.业务流程14
2.4.3.1.省BOSS对12580业务的受理流程14
2.4.3.2.12580平台业务受理流程15
2.4.4.业务属性16
2.4.5.交易单元16
2.4.5.1.交易属性16
2.4.5.2.交易报文17
2.5.12580订购信息变更通知21
2.5.1.业务功能21
2.5.2.业务流程21
2.5.3.业务属性23
2.5.4.交易单元23
2.5.4.1.交易属性23
2.5.4.2.交易报文25
2.6.省BOSS12580订购关系同步至内容计费系统27
2.6.1.业务功能27
2.6.2.业务流程27
2.6.3.业务属性28
2.6.4.交易单元29
2.6.4.1.交易属性29
2.6.4.2.交易报文30
2.7.12580用户信息查询31
2.7.1.业务功能31
2.7.2.业务流程32
2.7.3.业务属性32
2.7.4.交易属性33
2.7.5.交易报文34
2.8.12580中央信息库受理投诉36
2.8.1.业务功能36
2.8.2.业务流程36
2.8.3.业务属性36
2.8.4.交易属性37
2.8.5.交易报文39
2.9.省客服投诉升级41
2.9.1.业务功能41
2.9.2.业务流程41
2.9.3.业务属性42
2.9.4.交易属性42
2.9.5.交易报文44
2.10.省客服投诉工单查询46
2.10.1.业务功能46
2.10.2.业务属性46
2.10.3.交易属性47
2.10.4.交易报文47
3.管理类交易50
3.1.机构签到50
3.1.1.业务功能50
3.1.2.业务属性50
3.1.3.交易单元51
3.1.3.1.交易属性51
3.1.3.2.交易报文52
3.2.机构签退53
3.2.1.业务功能53
3.2.2.业务属性53
3.2.3.交易单元54
3.2.3.1.交易属性54
3.2.3.2.交易报文54
3.3.连通测试1
3.3.1.业务功能1
3.3.2.业务属性1
3.3.3.交易单元1
3.3.3.1.交易属性2
3.3.3.2.交易报文2
4.对帐文件接口3
4.1.对帐文件接口功能3
4.2.文件格式3
4.2.1.文件名3
4.2.2.文件格式说明3
4.3.文件的传输4
4.4.对帐文件的比对4
5.附录5
5.1.客户品牌编码表5
5.2.省代码表5
5.3.用户级别编码表7
6.省BOSS与12580接口技术规范8
6.1.联机交易参与方8
6.2.业务8
6.2.1.编码规则8
6.3.交易9
6.3.1.交易属性9
6.3.2.编码规则10
6.3.3.交易流程分类11
6.3.3.1.大圈类交易流程11
6.3.3.2.存储转发类流程11
6.4.消息结构12
6.4.1.MessageHeader12
6.4.2.ServiceContent14
6.5.接口方式14
1.综述
1.1.范围
本接口规范描述省12580呼叫中心与省BOSS间以及省12580呼叫中心与12580中央信息库间的接口操作，包括其功能、流程和相关交易的接口报文定义，业务提供范围和有关受理规定请参见参考文档。
1.2.接口概述
接口概述见下表
表1省行业网关与BOSS系统间接口中的业务操作一览表
业务名称
交易名称
业务发起方
业务落地方
备注
12580全网前向业务受理
12580用户信息查询
12580用户查询
省12580呼叫中心
省BOSS
省12580呼叫中心查询用户信息时使用。
交易报文头参考5.4.1，也可以自行实现
12580省间用户查询
12580省间用户查询
省BOSS
省BOSS
MessageHaeder使用1.4参考文档里接口V1.4.5中2.1.4.1节公共报文头的描述
12580投诉
投诉
省BOSS
12580中央库
同上
投诉确认
12580中央库
省BOSS
同上
投诉归档
省BOSS
12580中央库
同上
12580投诉升级
投诉升级
省BOSS
12580中央库
同上
投诉确认
12580中央库
省BOSS
同上
投诉归档
省BOSS
12580中央库
同上
12580投诉查询
投诉查询
省BOSS
12580中央库
同上
管理类交易接口
签到
12580中央库
一级BOSS枢纽
同上
签退
12580中央库
一级BOSS枢纽
连通测试
12580中央库
一级BOSS枢纽
文件接口
日对帐文件接口
省BOSS
12580中央库
见第4章
1.3.术语
术语
解释
用户
使用12580业务的所有电信运营商的电话用户。
登记用户
使用过12580业务，且在中央信息库中有用户信息登记的用户。
省12580座席
在各省12580呼叫中心设立的座席，完成12580语音人工接入和呼出，包括为用户提供信息查询服务，并能将用户转接至中央12580呼叫中心。
省12580呼叫中心
各省运营的12580呼叫中心。
用户拨打12580后接入到省12580呼叫中心。
中央12580座席
指设置在中央12580呼叫中心的座席，包括中央商旅座席、中央客服座席、中央订单座席
中央客服座席
指中央12580座席中处理客户投诉的话务座席。
中央订单座席
指中央12580座席中处理代订业务的话务座席。
中央商旅座席
为用户提供机票预订、酒店预订等商旅服务的座席。
中央12580呼叫中心
指负责管理中央12580座席，维护中央信息库、处理由省12580呼叫中心转入的包括商旅服务、投诉处理等业务的运营操作场所。
中央信息库
是12580综合信息服务门户业务的数据中心，主要是信息数据库及各类应用服务器组成，支撑全国各省12580呼叫中心和中央12580呼叫中心的综合信息服务。
信息元
指12580综合信息服务门户中信息所描述的具体各企业、单位及机构等。
1.4.参考文档
《12580信息服务门户设备规范_v1.0.0（评审稿）》
《12580接口规范V1.0.0（评审稿）》
《省BOSS与业务管理平台（业务平台）接口规范》
《中国移动有限公司一级BOSS接口规范_总体架构和系统管理分册v1.4.5》
2.12580综合信息服务
2.1.12580信息服务简介
12580综合信息服务门户为用户提供餐饮、娱乐、交通、旅游、便民等各类信息查询，以及机票预订和酒店预订等商旅服务。
用户采用语音、短信、WAP、互联网等多种接入方式使用12580综合信息服务门户业务。
业务开展初期只采用人工语音接入的服务方式。
信息反馈给用户采用人工语音播报和短信相结合的方式。
12580综合信息服务门户由中央信息库、中央12580呼叫中心、各省12580呼叫中心组成。
Ø中央信息库：
中央信息库是12580综合信息服务门户业务的数据中心，主要由信息数据库及各类应用服务器组成，支撑全国各省12580呼叫中心和中央12580呼叫中心的综合信息服务。
Ø中央12580呼叫中心：
指负责管理中央12580座席，维护中央信息库、处理由省12580呼叫中心转入的包括商旅服务、投诉处理等业务的运营操作场所。
Ø省12580呼叫中心：
省12580呼叫中心是12580综合信息服务门户业务在各省的语音接入点，设置人工座席，为用户提供信息查询和代订服务。
2.2.与本文相关的接口描述
ØIF9：
12580中央信息库处理各省客服系统的工单，返回处理结果
ØIF12：
省12580呼叫中心从省BOSS获取本省用户和漫游用户信息
2.3.12580组网结构图
2.4.12580全网前向业务受理
2.4.1.业务功能
12580业务受理是由省BOSS受理12580业务和12580平台业务受理两个独立的交易构成的。
1、12580平台业务受理是由12580平台发起的，旨在请求省BOSS在BOSS侧为用户完成与12580业务相关的订购服务/退订服务等业务操作。
2、省BOSS对12580业务的受理是由省BOSS发起的，旨在通知12580平台在12580平台侧完成用户与12580业务相关的订购服务/退订服务等业务操作。
2.4.2.业务约束
1、业务受理渠道
本业务的受理渠道主要由12580平台侧受理渠道和省公司受理渠道两部分组成。
省BOSS侧的业务受理渠道目前为受理地营业厅、归属地10086（IVR/SMS/客服热线）、各地移动公司的网上营业厅。
12580平台侧的业务受理渠道目前为：
SMS、WAP、IVR、WEB
2、业务开放范围
本业务在全国31省范围内面向中国移动手机用户。
3、开通模式
本业务开通模式为同步模式,即客户申请后10086/营业厅服务人员/12580平台根据交易应答立即告知客户受理结果。
4、其它说明
本规范仅描述省BOSS与一级BOSS交换枢纽、12580平台间的接口操作，包括其功能、流程和相关交易的接口报文定义。
2.4.3.业务流程
省BOSS和12580平台对业务受理的处理方式
业务受理操作代码
落地方处理方式
06-订购服务
订购指定的服务
07-退订服务
退订指定的服务
99–全业务退订
退订平台上的所有服务
2.4.3.1.省BOSS对12580业务的受理流程
省BOSS的受理流程分为发起方流程和落地方流程。
1、发起方流程：
订购流程：
用户通过10086、营业厅、移动Portal提出12580平台的业务受理申请，按照系统提示输入客服密码等信息，省BOSS系统接到业务申请后，进行手机状态鉴权、客服密码检查等工作，如果鉴权和检查失败，则返回失败并根据情况通知用户（注1）。
如果鉴权和检查通过，则通过业务受理接口发送请求给一级BOSS系统，由一级BOSS系统将数据转发给12580平台进行业务受理。
省BOSS系统根据应答进行相应成功与失败时的处理，并通知用户受理结果，记录业务受理日志，失败时需回滚已经执行过的操作。
退订流程：
用户通过10086、营业厅、移动Portal提出12580平台的业务退订申请，按照系统提示输入客服密码等信息，省BOSS系统接到业务申请并通过客服密码检查后，通过业务受理接口发送信息给一级BOSS系统，由一级BOSS系统将数据转发给12580平台进行业务处理,。
省BOSS系统根据应答进行相应成功与失败时的处理。
如果12580平台返回交易超时，则省BOSS先取消用户订购关系后并告知用户，随后再次发起退订。
2、落地方流程：
省BOSS作为接口落地方的流程是系统的后台处理过程，省BOSS收到12580的业务受理申请后首先进行用户状态检查和订购关系检查，如一切正常则生成用户订购关系或变更用户订购关系，将处理结果通过应答报文告知12580平台，并完成通知计费、结算模块等内部流程。
2.4.3.2.12580平台业务受理流程
12580平台的受理流程分为发起方流程和落地方流程。
1、发起方流程：
12580平台作为业务发起方的流程为12580内部处理流程，详见12580业务规范。
此处对接口相关部分简单描述。
订购流程：
用户通过SMS、WAP或其它12580受理渠道向12580平台提出业务申请，12580平台收到申请后，对于订购请求做平台方的业务预开通处理，然后通过业务受理接口发送给一级BOSS系统，由一级BOSS系统将数据转发给省BOSS进行业务处理。
并根据省BOSS处理结果修正平台方的开通信息，并返回结果以及告知用户。
退订流程：
对于退订请求，直接通过业务受理接口发送给一级BOSS系统，由一级BOSS系统将数据转发给省BOSS进行业务处理。
省BOSS系统接到业务申请后，进行处理并返回处理结果的应答报文。
12580平台根据应答进行相应成功与失败时的处理，如果应答为失败则通知用户，如果应答为成功则对用户进行退订后再根据省BOSS和平台侧的退订结果告知用户受理结果。
2、落地方流程：
12580平台作为接口落地方流程是系统的后台处理过程，12580平台收到省BOSS的业务受理申请后的具体处理流程请参见12580业务规范。
2.4.4.业务属性
冲正处理
无
安全性要求
无
业务编码：
分业务进行编码，如下表所列：
业务名称
业务编码
12580平台业务受理
BIP2B247
省BOSS受理12580业务
2.4.5.交易单元
2.4.5.1.交易属性
12580业务受理
交易编码：
T2001113
名称
取值
交易类型
00：
大圈类流程
冲正
0：
不需要冲正
人工冲正
0：
不需要
对帐标记
1：
参与对帐
安全性：
密码加密
0：
不需要
安全性：
防篡改
0：
不需要
发起方机构DOMAIN
1258、BOSS
落地方机构DOMAIN
BOSS、1258
路由类型
发起方为1258时：
路由类型01，路由关键值手机号（智能网用户无法路由）
发起方为BOSS时:
：
路由类型00，路由关键值000
2.4.5.2.交易报文
报文分为报文头（MessageHeader）和报文体（ServiceContent）两部分，关于报文头的内容及格式参见接口规范1.4.4中2.1.4.1节公共报文头的描述。
在此只描述报文体部分。
（1）请求SvcCont：
序号
父元素名称
元素名称
约束
类型
宽度
描述
取值说明
18
InterBOSS
SvcCont
1
String
—
请求内容
XML格式的字符串，以CDATA区表达
18.1
SvcCont
BizReq
1
—
—
业务受理请求
18.1.1
BizReq
IDType
1
String
F2
用户ID标识类型
01-手机号码
18.1.2
BizReq
IDValue
1
String
V32
用户ID标识值
手机号码
18.1.3
BizReq
BizOrder
+
—
—
业务订购/退订
18.1.3.1
BizOrder
OprNumb
1
String
V32
本次操作的流水号
操作流水号规则的说明见注1
18.1.3.2
BizOrder
OprCode
1
String
F2
操作代码
06-订购服务
07-退订服务
99-全业务退订
18.1.3.2
BizOrder
BizType
1
String
F2
业务类型代码
52-12580业务
18.1.3.3
BizOrder
EffetiTime
1
String
F14
发起方希望的生效时间
YYYYMMDDHHMISS，如EffetiTime与操作流水号中的日期相同，表示立即生效；否则表示在指定日期（EffetiTime）生效。
EffetiTime必须>=操作流水号中的日期。
18.1.3.4
BizOrder
NewPwd
?
String
V64
业务密码/新业务密码
不需要填写
18.1.3.5
BizOrder
SPID
?
String
V18
SP企业代码
必须填写12580企业代码
18.1.3.6
BizOrder
SPCont
?
—
—
SP提供的服务内容
18.1.3.6.1
SPCont
PackNumb
?
String
V10
SP提供的套餐
不填写
18.1.3.6.2
SPCont
BizCode
1
String
V10
SP业务代码
全业务退订操作，业务代码长度为0
注1：
A）平台的编码规则－4位平台机构编码+8位业务编码（BIPCode）+14位组包时间YYYYMMDDHH24MMSS+6位流水号（定长），序号从000001开始，增量步长为1。
B）省BOSS的编码规则－3位省代码+8位业务编码（BIPCode）+14位组包时间YYYYMMDDHH24MMSS+6位流水号（定长），序号从000001开始，增量步长为1。
（2）应答SvcCont：
序号
父元素名称
元素名称
约束
类型
宽度
描述
取值说明
18
InterBOSS
SvcCont
1
String
—
请求内容
XML格式的字符串，以CDATA区表达
18.1
SvcCont
BizRsp
1
—
—
业务受理应答
18.1.2
BizRsp
IDType
1
String
F2
用户ID标识类型
01-手机号码
18.1.3
BizRsp
IDValue
1
String
V32
用户ID标识值
手机号码
18.1.4
BizRsp
OprResult
+
—
—
业务操作应答
18.1.4.1
OprResult
OprNumb
1
String
V32
发起方的操作流水号
操作流水号规则的说明见请求报文注1
18.1.4.2
OprResult
BizOrderResult
1
String
F2
业务请求的结果
当应答报文头中的RsRspCode=0000时填写00；
当应答报文头中的RspType=2,RspCode=2998时，填写内容见下面的二级应答编码表；
18.1.4.3
OprResult
Reserve
?
String
V256
保留字段
12580业务受理的二级应答编码表
二级应答编码
错误描述
错误理由说明
收到应答后，业务发起方的后续处理
BOSS为业务发起方
12580平台为业务发起方
00
成功
应答报文头中的RsRspCode=0000
请求成功
请求成功
01
企业代码错误
按请求失败处理
按请求失败处理
02
操作代码错误。
06、07、99之外的操作编码
按请求失败处理
按请求失败处理
03
业务代码错误。
按请求失败处理
按请求失败处理
04
生效时间错误。
生效时间<操作时间（操作时间即操作流水号中的组包时间）
按请求失败处理
按请求失败处理
11
升级会员 