中国移动一级BOSS接口规范WLANV15.docx
《中国移动一级BOSS接口规范WLANV15.docx》由会员分享，可在线阅读，更多相关《中国移动一级BOSS接口规范WLANV15.docx（100页珍藏版）》请在冰豆网上搜索。
中国移动一级BOSS接口规范WLANV15
中国移动通信集团公司
一级BOSS枢纽系统
接口规范
WLAN业务部分
V1.5
中国移动通信集团公司
二○一○年七月
文档变更记录
序号
变更内容说明
版本号
版本日期
执笔人
1
初稿
1.0
2008-1-25
王进
2
根据接口规范讨论修订，业务受理扩展支持套餐申请和取消；增加智能网用户状态编码；部分流程文字描述
1.1
2008-02-21
杨扬、盛英辉
3
1.新增Domain:
WLAN，专用于WLAN,物理上就是原Radius平台；原Domain:
RADI用于17201
2.新增BIP2B147,BIP2B256,BIP3B022,BIP2B262专用于WLAN
1.2
2008-2-28
杨扬，林进峰
4
1.5节静态密码报文修订
1.2.1
2008-3-4
杨扬
5
修订：
1．增加综述；
2．增加管理交易；
3．增加统一编码。
1.3
2008-3-7
杨扬
6
1．修订：
2．WLAN业务受理增加WLAN侧发起，并修订描述；
3．WLAN业务受理请求报文标识类型增加预付费卡；操作代码增加用户暂停、用户恢复和套餐变更；增加对应注1、注2、注5描述，修改注4描述。
1.4
2010-6-7
盛英辉
7
根据新的预付费卡管理业务规范要求，修订此版本。
1．WLAN业务受理的请求报文的标识类型，去掉预付费卡的标识类型；
2．增加2.7包单位时间电子卡销售业务章节；
3．增加第4章节，满足序列号通过一级BOSS分发到序列号中省份代码对应的省BOSS的文件传输业务功能。
1.5
2010-7-10
盛英辉
目录
文档变更记录1
1.综述7
1.1.一级BOSS总体架构7
1.2.系统管理7
1.3.参考文档8
2.WLAN平台与一级BOSS枢纽实时接口9
2.1.范围9
2.2.接口概述9
2.2.1.WLAN业务背景9
2.2.2.静态密码与动态密码10
2.2.3.WLAN业务与WLAN业务资费套餐10
2.2.4.WLAN业务接口概述10
2.3.WLAN业务受理13
2.3.1.业务功能13
2.3.2.业务流程14
2.3.3.业务属性14
2.3.4.交易单元15
2.3.4.1.交易属性15
2.3.4.2.交易报文15
2.4.WLAN平台对BOSS用户相关数据同步19
2.4.1.1.业务功能19
2.4.1.2.业务流程20
2.4.1.3.业务属性20
2.4.1.4.交易单元21
2.4.1.4.1.交易属性21
2.4.1.4.2.交易报文22
2.5.WLAN静态密码修改25
2.5.1.业务功能25
2.5.2.业务流程25
2.5.3.业务属性25
2.5.4.交易单元26
2.5.4.1.交易属性26
2.5.4.2.交易报文27
2.6.WLAN用户状态变更通知27
2.6.1.业务功能27
2.6.2.业务流程28
2.6.3.业务属性29
2.6.4.交易单元29
2.6.4.1.交易属性29
2.6.4.2.交易报文30
2.7.包单位时间电子卡销售31
2.7.1.业务功能31
2.7.2.业务流程32
2.7.3.业务属性33
2.7.4.交易单元34
2.7.4.1.交易属性34
2.7.4.2.交易报文36
3.系统管理39
3.1.1.机构签到39
3.1.1.1.业务功能39
3.1.1.2.业务属性39
3.1.1.3.交易单元40
3.1.1.3.1.机构签到40
1..1.1.1.1交易属性40
1..1.1.1.2交易报文41
3.1.2.机构签退43
3.1.2.1.业务功能43
3.1.2.2.业务属性43
3.1.2.3.交易单元44
3.1.2.3.1.机构签退44
1..1.1.1.3交易属性44
1..1.1.1.4交易报文45
3.1.3.连通测试47
3.1.3.1.业务功能47
3.1.3.2.业务属性47
3.1.3.3.交易单元47
3.1.3.3.1.连通测试47
3.1.3.3.2.属性47
3.1.4.申请更新密钥48
3.1.4.1.业务功能48
3.1.4.2.业务属性48
3.1.4.3.交易单元49
3.1.4.3.1.申请更新密钥49
3.1.4.3.2.属性49
3.1.4.3.3.交易报文49
3.1.5.密钥下发52
3.1.5.1.业务功能52
3.1.5.2.业务属性52
3.1.5.3.交易单元52
3.1.5.3.1.密钥下发52
3.1.5.3.2.属性52
3.1.5.3.3.交易报文53
3.1.6.对帐54
3.1.6.1.业务功能54
3.1.6.2.业务属性55
3.1.6.3.交易单元55
3.1.6.3.1.对帐56
3.1.6.3.2.交易属性56
3.1.6.3.3.交易报文56
3.1.7.对帐结果上发63
3.1.7.1.业务功能63
3.1.7.2.业务属性63
3.1.7.3.交易单元63
3.1.7.3.1.对帐结果上发64
3.1.7.3.2.交易属性64
3.1.7.3.3.交易报文65
4.非实时联机接口67
4.1.卡管理67
4.1.1.功能概述67
4.1.2.文件传输流程67
4.1.2.1.实体卡营销管理平台流程67
4.1.2.2.省BOSS流程68
4.1.3.卡管理文件68
4.1.3.1.文件命名规则68
4.1.3.2.文件格式69
4.1.3.2.1.头记录格式69
4.1.3.2.2.记录格式69
5.统一编码71
5.1.交换中心71
5.2.交换节点71
5.3.DOMAIN编码73
5.4.机构系统编码73
5.5.路由类型编码75
5.6.省代码75
5.7.系统应答类型以及应答代码75
5.8.用户状态编码78
5.9.资料/受理信息编码79
1.综述
1.1.一级BOSS总体架构
WLAN平台接入一级BOSS枢纽系统须遵循一级BOSS的技术规范和系统管理要求，详情见1.3参考文档的
《中国移动有限公司一级BOSS接口规范_总体架构和系统管理分册v1.4.5.doc》。
1.2.系统管理
需要实现的系统管理交易见下表：
簇名称：
代码
业务名称：
代码
交易名称：
代码
系统管理：
0
日对帐：
BIP0A003
日对帐：
T0120003
月对帐：
BIP0A006
月对帐：
T0120012
日对帐结果上发：
BIP0A004
日对帐结果上发：
T0010009
月对帐结果上发：
BIP0A007
月对帐结果上发：
T0010013
密钥更新请求：
BIP0B001
密钥更新申请：
T0011004
密钥下发通知：
BIP0B002
密钥下发：
T0121005
机构签到：
BIP0C001
机构签到：
T0010006
机构签退：
BIP0C002
机构签退：
T0010007
连通测试：
BIP0C003
连通测试：
T0020008
1.3.参考文档
《中国移动有限公司一级BOSS接口规范_总体架构和系统管理分册v1.4.5.doc》
2.WLAN平台与一级BOSS枢纽实时接口
2.1.范围
本接口规范描述国内WLAN平台与一级BOSS枢纽、省BOSS间的接口操作，包括其功能、流程和相关交易的接口报文定义，业务提供范围和有关受理规定请参见参考文档。
2.2.接口概述
2.2.1.WLAN业务背景
WLAN是应用无线通信技术构成可以互相通信和实现资源共享的网络体系。
其本质特点及优点是不再使用通信电缆，从而使网络的构建和移动更加灵活。
在中国移动提供WLAN网络覆盖的区域，用户通过WLAN终端可以接入互联网，获取信息、娱乐或进行移动办公。
现阶段，接入认证方式为“帐号+密码”认证方式。
业务开展方式包括：
1．用户可通过短信、10086、营业厅等途径，通过“帐号+密码”认证方式向中国移动申请业务，按月缴纳通信费。
2．对于重要的合作业主，可以根据其热点产生的总业务量进行一定比例的收入分成；
中国移动与代理商（SP）合作。
用户向代理商申请业务，通过“帐号+密码”的形式认证，暂定为“手机号码@SP+密码”。
中国移动代SP收费，SP与中国移动进行结算，与SP的合作由集团公司具体负责，相关规范另文制定。
2.2.2.静态密码与动态密码
客户在第一次使用WLAN业务之前必须申请WLAN客户密码，以后可以根据需要修改自己的WLAN业务密码，密码有效期分一次性有效和永久有效两种，并给客户明确提示。
一次性有效的密码（动态密码）是客户临时申请临时分配的密码；永久性密码（静态密码）是指为方便客户的使用，在客户得到密码后如无变更密码的需要，可以一直有效使用的密码。
2.2.3.WLAN业务与WLAN业务资费套餐
WLAN业务是使用WLAN服务的基础通信能力，WLAN业务存在注册、注销、暂停三个状态，用户在省BOSS侧申请开通WLAN业务，开通信息同步至WLAN平台，由WLAN平台据此控制用户的WLAN业务使用权限；WLAN业务资费套餐是在已经开通WLAN业务的基础上，申请对WLAN业务按时长使用资费的优惠，如果不申请任何资费套餐则按照WLAN标准资费收取，资费套餐在省BOSS侧申请后同步至WLAN平台，由WLAN平台据此向用户提供套餐内剩余时长等客户服务信息。
2.2.4.WLAN业务接口概述
WLAN业务接口概述见下表：
为了和原先的Radius平台区别，将原先的17201业务归属平台依然称为RADI,详见一级BOSS接口规范V1.4.5版本；新增domain为WLAN，专门用于WLAN。
2.3.WLAN业务受理
2.3.1.业务功能
WLAN业务是由业务受理省BOSS发起的，旨在要求WLAN平台为用户实现注册/注销/套餐申请/套餐取消/套餐变更/变更密码等WLAN业务操作。
WLAN作为业务发起方，只能发送10-套餐申请和12-套餐变更的操作。
业务功能如下表
省BOSS业务受理操作代码
业务平台处理方式
01-用户注册
为用户开指定的WLAN业务
02-用户注销
注销用户指定的WLAN业务
03-BOSS静态密码修改
修改用户指定的业务的密码（注2）
04-业务暂停
加锁用户指定的业务
05-业务恢复
解锁用户指定的业务
06-服务定购
为用户开通指定的业务
07-服务订购取消
注销用户指定的业务
08-与业务平台相关的用户资料变更
修改用户指定的业务相应的信息
10-资费套餐申请
为用户添加指定的套餐信息
11资费套餐取消
注销用户指定的套餐信息
12自费套餐变更
变更用户指定的套餐信息
业务约束
1、受理渠道
本业务的受理渠道为省BOSS受理渠道（WLAN业务注册/注销、静态密码修改/重置、资费套餐申请/取消），包括营业厅、IVR、短信营业厅、网上营业厅。
WLAN平台的受理渠道是WEB门户（静态密码修改）。
2、业务开放范围
网内用户（省内普通用户、省内高校用户、省间普通漫游用户）
外网用户（国内非中国移动用户、国际漫游来访用户）
3、开通模式
业务开通模式为同步模式，即客户申请后10086/营业厅服务人员根据交易应答立即告知客户受理结果。
4、其它说明
本接口规范仅描述受理省BOSS、归属省BOSS、WLAN业务平台与一级BOSS交换枢纽间的接口操作，包括其功能、流程和相关交易的接口报文定义。
2.3.2.业务流程
用户通过10086、短信、营业厅或网上营业厅提出业务申请，按照系统提示输入客服密码等信息，省BOSS系统接到业务申请后，进行客服密码检查、业务当前状态、用户状态检查等受理约束的处理工作，如果受理约束检查没有通过，则以短信或其它方式（如在营业厅受理时由营业员告知用户）通知用户受理失败。
受理约束检查成功后省BOSS将变更信息发送给一级BOSS系统，由一级BOSS系统将数据转发给业务平台进行业务处理。
一级BOSS收到业务平台的应答后转发给省BOSS系统，省BOSS系统根据应答进行相应成功与失败时的处理--通过短信（密码必须以此方式）或其它方式（如在营业厅受理时由营业员告知用户）通知用户受理结果，记录业务受理日志，成功时还需要更新用户资料。
WLAN作为业务发起方，只能发送10-套餐申请和12-套餐变更的操作。
2.3.3.业务属性
业务编码：
WLAN业务受理BIP2B147
手续费
不收手续费
服务费
不收服务费
冲正处理
有
人工冲正处理
有
安全性要求
客服密码需加密
清分结算
不结算
对帐
参与对帐
冲正处理
有
安全性要求
密码字段需加密
说明：
1、手续费是指向用户收取的办理某项业务的人工费用。
当收取手续费时，一般是在用户受理省账户上作为一次性营业费用记账。
2、服务费是指受理方向受理方（受理地移动公司向受理省移动公司、受理地移动公司向合作伙伴、受理省移动公司向合作伙伴、合作伙伴向受理省移动公司）收取的业务服务费用，由中国移动集团公司负责结算。
服务费不向用户收取，也不得转嫁到用户身上。
3、安全性要求是指对于客服密码、帐户密码等用户私有信息以及交易报文或者报文中的关键信息项在传输过程中的保密要求。
4、清分结算是指对业务受理过程中产生的、需要在受理方、受理方及全国中心之间进行转移或分配的费用的处理，包括手续费、服务费、用户办理业务的本金（如缴纳的手机话费）、押金（如业务押金）等。
2.3.4.交易单元
2.3.4.1.交易属性
1、WLAN业务的受理
交易编码：
T2001101
名称
取值
交易类型
00：
大圈类流程
冲正
1：
需要冲正
对帐标记
1：
参与对帐
安全性：
密码加密
1：
需要
安全性：
防篡改
N/A
发起方机构DOMAIN
BOSS/WLAN
落地方机构DOMAIN
WLAN/BOSS
路由类型
如果是省BOSS发给WLAN：
00：
000
如果是WLAN发给省BOSS：
01：
手机号码
2.3.4.2.交易报文
报文分为报文头（MessageHeader）和报文体（ServiceContent）两部分，关于报文头的内容及格式参见2.1.4.1节中公共报文头的描述。
在此只描述报文体部分，对报文取值范围的说明，以各个业务接口规范单行本为准，这里只继承接口规范1.4.4已有的部分。
（1）请求SvcCont：
序号
父元素名称
元素名称
约束
类型
宽度
描述
取值说明
18
InterBOSS
SvcCont
1
String
—
请求内容
XML格式的字符串，以CDATA区表达
18.1
SvcCont
BizProcReq
1
—
—
业务受理请求
18.1.1
BizProcReq
IDType
1
String
F2
标识类型
01-手机号码
18.1.2
BizProcReq
IDValue
1
String
V32
标识值
此处输入手机号码
18.1.3
BizProcReq
OprCode
1
String
F2
操作代码
01-用户注册02-用户注销03-密码修改
04-用户暂停05-用户恢复
06-服务订购07-服务订购取消
10-套餐申请11-套餐取消12-套餐变更
18.1.4
BizProcReq
BizType
1
String
F2
业务类型代码
02-WLAN
18.1.5
BizProcReq
NewPasswd
?
String
V64
业务密码/新业务密码
18.1.6
BizProcReq
OprTime
1
String
F14
套餐申请/取消生效时间
YYYYMMDDHHMMSS，当OprCode为10，11，12时填写套餐申请/取消/变更生效时间，其它操作填写BOSS受理用户申请时间
18.1.7
BizProcReq
BizOrder
*
—
—
业务/注销数据
OprCode为用户注销、静态密码修改时不填写本字段
18.1.7.1
BizOrder
SPID
1
String
F6
企业代码
企业代码，OprCode为10、11和12填写六个空格
18.1.7.2
BizOrder
SPBizCode
1
String
V10
业务代码
业务代码，OprCode为10、11和12时填写套餐编码（注4）
18.1.8
BizProcReq
OprInfo
*
—
—
资料/受理信息
OprCode为注册时填写，其它操作不填写
18.1.8.1
OprInfo
InfoCode
1
String
F3
信息代码
参见资料/受理信息编码；注3
18.1.8.2
OprInfo
InfoValue
1
String
V256
信息值
注3
18.1.9
BizProcReq
UserStatus
?
String
F2
用户状态代码
参见用户状态编码，只在注册时用
18.1.10
BizProcReq
StatusChgTime
?
String
F14
用户状态变更时间
YYYYMMDDHHMMSS
18.1.11
BizProcReq
OtherStatus
?
String
F2
其它状态代码
备用
18.1.12
BizProcReq
HomeProv
?
String
F3
用户归属省代码
省BOSS发起必填；平台发起没有此节点内容
注1：
WLAN作为业务发起方，只能发送10-套餐申请和12-套餐变更的操作，其他操作不能在WLAN平台侧发起。
当WLAN平台发起套餐申请或套餐变更操作，省BOSS收到请求后，立即给WLAN平台回应成功，然后和用户做二次确认，确认成功后，依然通过此接口作为业务的发起方，发给WLAN平台。
也就是说wlan平台发起的不可作为受理结果依据，只有省boss发起的才是最终的受理结果依据。
注2：
12-套餐变更操作，仅对标识类型是01-手机号码时，才可进行此操作。
注3：
用户在注册、注销、暂停WLAN业务时，可以选择分级的注册、注销、暂停方式，即：
用户注册WLAN业务时，可以选择注册“仅国内使用”、“国内连同国际漫游使用”或“追加注册国际漫游使用”三种级别，缺省为“仅国内使用”，前两种操作用于为用户新开通WLAN业务，后一种操作用于为已开通WLAN业务的用户变更权限状态（即追加国际漫游权限）；注销时，可以选择“注销国际漫游使用”或“全部注销”两种级别，缺省为“全部注销”；暂停时可以选择“暂停国际漫游使用”或“全部暂停”两种级别，缺省为“全部暂停”；
在注册WLAN业务时，注册“国内连同国际漫游使用”与“追加注册国际漫游使用”是两种不同的业务操作，省移动公司BOSS系统必须通过不同的OprInfo.InfoValue表达该两种操作。
“追加注册国际漫游使用”时，需在请求报文中的NewPasswd字段填写用户的原业务密码；
分级
操作代码
OprCode
仅国内
仅国际
国内连同国际
追加国际
（原国内权限不变）
注册（01）
缺省值，10
11
12
注销（02）
01
缺省值，11
暂停（04）
01
缺省值，11
注：
OprInfo.InfoValue的取值为两位宽的字符串，编码原则是，第一位是国内标识符，代表是否注册/注销/暂停国内WLAN，第二位代表国际漫游标识符，代表是否注册/注销/暂停国际漫游WLAN。
国内标识符、国际漫游标识符位置上，取值为0代表在该位置上没有操作，取值为1代表在该位置上进行初始化操作（如初始注册、注销、暂停等），取值为2代表在该位置上进行追加操作（如追加注册WLAN业务）；操作的内容由报文中的操作代码OprCode决定；
注4：
套餐名称
套餐编号
WLAN无线宽带上网套餐30元包月
00001
WLAN无线宽带上网套餐50元包月
00002
WLAN无线宽带上网套餐100元包月
00003
高校WLAN优惠套餐10元包月
10001
高校WLAN优惠套餐20元包月
10002
高校WLAN优惠套餐40元包月
10003
WLAN包单位时间资费包小时
20001
WLAN包单位时间资费包天
20002
WLAN包单位时间资费包周
20003
WLAN包单位时间资费包月
20004
WLAN包时长资费30元/15小时
30001
WLAN包时长资费50元/40小时
30002
WLAN包时长资费100元/200小时
30003
注5：
双峰顶原则：
为了有效保护网络资源，防止恶意使用，在以下资费套餐中，均设置了流量封顶规则或者流量/费用双封顶规则。
对于流量封顶规则，同一个号码用户在当月或者资费有效期内到达40G，则停止用户当月的WLAN业务功能或资费失效。
对于流量/费用双封顶规则，费用封顶是指用户在当月WLAN费用超过500元后，按500元计费；流量封顶是指当用户在当月WLAN流量达到40G后，停止用户当月的WLAN业务功能。
停止用户当月的WLAN业务功能,要使用本接口的“04-用户暂停”操作代码；如果下个月恢复的话，要使用本节接口的“05-用户恢复”操作代码。
（2）应答SvcCont：
空
2.4.WLAN平台对BOSS用户相关数据同步
本接口对应着BOSS与业务管理平台接口规范中规定的“用户及业务信息同步接口”中的“用户相关数据同步”部分。
2.4.1.1.业务功能
通过该接口实现WLAN平台向BOSS实时同步用户相关数据，以满足计费结算、客户服务和经营分析的需要。
WLAN平台通过此接口定期的向一级BOSS发送相关用户的用户信息（如注册注销）、业务变更信息或服务订购/退订信息，一级BOSS系统将该信息转发给用户的归属省。
用户业务变更信息同步
WLAN平台在将用户的相关业务进行“暂停”、“取消暂停”操作成功后（不论该操作是由用户申请还是由用户状态变更通知等其他条件触发），或WLAN平台为用户进行“服务订购”、“服务订购取消”操作成功后，需将上述信息同步到BOSS中。
2.4.1.2.业务流程
用户通过WLAN平台（包括在10086、营业厅直接通过业务平台的终端）完成业务受理后，业务平台将受理的用户相关信息发送给一级BOSS系统，由一级BOSS系统将数据转发给省BOSS进行处理。
注：
1）业务平
升级会员 