一级局数据中心与BBOSS接口规范V112.docx
《一级局数据中心与BBOSS接口规范V112.docx》由会员分享,可在线阅读,更多相关《一级局数据中心与BBOSS接口规范V112.docx(50页珍藏版)》请在冰点文库上搜索。
一级局数据中心与BBOSS接口规范V112
中国移动通信有限公司
一级局数据中心与BBOSS
接口规范
V1.1.2
中国移动通信集团公司
二○一四年一月
1.编制历史
版本号
更新时间
主要内容或重大修改
执笔人
1.0.0
2014-1-27
建立文档
1.0.1
2014-2-20
1、修改BBOSS给一级BDC的定向统计GPRS业务内容计费代码局数据信息文件中APP_NAME字段的含义为客户产品简称
1.1.0
2014-3-4
1、新增一级BDC给BBOSS的集团业务信息文件接口及相应的记录级检错标准
2、新增一级BDC给BBOSS的手机阅读内容详情信息文件接口及相应的记录级检错标准
3、局数据类型编码表中添加集团业务信息局数据(000111)
1.1.1
2014-3-14
1、去除文件命名及说明“一级BDC给BBOSS的GPRS业务内容计费业务代码信息拒收文件、一级BDC给BBOSS的GPRS业务内容计费业务代码信息回执文件、一级BDC给BBOSS的定向统付GPRS业务内容计费代码局数据信息拒收文件、一级BDC给BBOSS的定向统付GPRS业务内容计费代码局数据信息回执文件”中“_<省代码>_<网元类型>”
2、新增一级BDC给BBOSS的通知局数据加载状态文件接口及相关内容
3、修订定向统付GPRS业务内容计费代码局数据记录级检错标准中单用户封顶流量(NF_LIMIT)的校验规范,只能为正整数;增加业务计费代码(SERVICE_ID)的F033错误检错码定义,集团业务信息文件记录级检错标准中信息费(FEE)只能为正整数
4、修订接口约定章节,增加8,9,10,11的约定说明
5、去除文件级检错标准中的F003错误码
1.1.2
1、修改定向统付GPRS业务计费代码局数据接口约定中的关键字说明,并修改相应的记录级检错标准。
2.适用范围
本规范适用于指导一级BDC与BBOSS的接口的开发和测试,是一级BDC与BBOSS互联建设的主要依据。
本规范规定了一级BDC与BBOSS互联的接口定义、统一编码等内容。
3.术语与缩略语
下列术语和定义适用于本规范:
关键字
用来表达信息特征和属性的词语。
合作伙伴
合作伙伴特指与中国移动紧密合作、具有某些方面核心优势的组织。
集团产品
面向集团客户提供的服务与资费的组合。
集团客户
与中国移动签属协议,使用或可能使用中国移动通信(或第三方合作伙伴)产品和服务,并在中国移动建立起集团客户关系管理的法人单位、个体经营户、聚类客户等单位组织。
结算
当一次电信服务使用了多个合作伙伴的通信资源或增值服务资源时,根据各个合作伙伴的资源使用情况,并按合作伙伴之间所事先拟定的协议进行费用分成。
结算规则
结算规则是中国移动与新业务合作伙伴之间进行业务收入分摊的各类结算模式。
界面元素
界面元素是指构成界面的具有独立功能的最小单位。
全网业务平台
基于全网面向个人或集团客户提供业务使用和接入的系统平台。
业务运营支撑系统
业务运营支撑系统(BOSS)是基于计算机应用技术、用以支持中国移动业务运营的信息系统。
中国移动各省公司的BOSS系统包含客户管理、产品管理、计费、帐务、结算等多方面的功能。
主要为中国移动的客户、合作伙伴、移动公司业务管理者和营销服务人员提供服务。
总部BOSS
总部BOSS为有限公司进行全网业务管理和业务运营提供支撑和保障,实现全网信息的交换和管理,具有管理、实体和枢纽功能。
省级业务
仅向省公司提供的本省业务或服务
第三方业务平台
泛指第三方所有业务平台,如音乐平台、彩铃平台等
基地业务
泛指集团规划、某省建设和运营、为全网用户提供服务的业务
全网业务
业务或服务可以跨省提供
下列缩略语适用于本规范:
缩写
英文描述
中文描述
4A
Authentication、Account、Authorization、Audit
认证、帐号、授权、审计
BASS
BusinessAnalyseSupportSystem
业务分析支撑系统
BOMC
BusinessOperationManagementCenter
业务运营管理中心
BOSS
BusinessOperationSupportSystem
业务运营支撑系统
CM
ChinaMobile
中国移动,即中国移动通信集团的简称。
CRM
CustomerRelationshipManagement
客户关系管理
DSMP
DataServiceManagementPlatform
数据业务管理平台
EOMS
ElectricOperationMainteinanceSystesm
电子运营维护系统
SIMS
ServiceInformationManagementSystem
新业务信息管理系统
BDC
BasicDataCenter
局数据管理与发布系统,简称局数据中心
GPRS
GenerallyPacketRadioSystem
通用无线分组业务系统
GSM
GlobalSystemforMobileCommunications
全球移动通讯系统
NGBOSS
NewGenerationBusinessOperation&SupportSystem
新一代业务运营支撑系统
OA
OfficeAutomation
办公自动化
SP
ServiceProvider
业务供应商
WAP
WirelessApplicationProtocol
无线应用协议
WLAN
WirelessLocalAreaNetworks
无线局域网络
4.局数据发布流程
4.1.GPRS业务内容计费业务代码局数据发布流程
流程步骤说明:
1)一级BBOSS作为发布源将局数据自动同步到一级局数据中心;
2)一级局数据中心对局数据进行校验、加载;
3)一级局数据中心将局数据的加载结果反馈一级BBOSS
4)一级局数据中心将校验通过的局数据发布给一级内容计费系统
5)一级内容计费系统进行校验加载;
6)一级内容计费系统反馈加载结果;
7)
1.a.一级内容计费系统加载成功,则一级局数据中心将一级内容计费系统加载成功的记录正式加载并下发增量局数据文件给省级局数据中心;
2.b.一级内容计费系统加载失败,则流程接收;
8)省级局数据中心反馈已接收到一级局数据中心下发数据;
9)一级内容计费系统每天定时下发全量局数据文件给省级局数据中心;
10)省级局数据中心将一级局数据中心下发的增量局数据和中央内容计费系统下发的数据进行比对校验;
11)省级局数据中心将比对校验结果反馈到一级局数据中心,如果有不一致的数据,则将差异数据上传到一级局数据中心;
12)省级局数据中心将比对一致的数据发布到省BOSS和省CRM;
13)省级局数据中心将给各网元的发布情况反馈到一级局数据中心
14)省BOSS和省CRM加载局数据;
15)省BOSS和省CRM将加载结果反馈到省级局数据中心;
16)省级局数据中心将省BOSS和省CRM的加载结果反馈到一级局数据中心。
17)一级局数据中心将各省网元的加载结果反馈给一级BBOSS;
18)一级局数据中心在各省网元全部加载成功后,给一级BBOSS反馈发布结果通知。
4.2.定向统付GPRS业务内容计费代码局数据发布流程
流程步骤说明:
1)一级BBOSS作为发布源将局数据自动同步到一级局数据中心;
2)一级局数据中心对局数据进行校验、加载;
3)一级局数据中心将局数据的加载结果反馈一级BBOSS;
4)一级局数据中心将校验成功的局数据,发布给省级局数据中心;
5)省局数据中心对局数据进行校验、加载;
6)省级局数据中心反馈一级局数据中心下发数据的加载结果;
7)省级局数据中心将局数据发布到省BOSS和省CRM;
8)省级局数据中心将给省各网元的发布情况反馈到一级局数据中心;
9)省BOSS和省CRM加载局数据;
10)省BOSS和省CRM将加载结果反馈到省级局数据中心;
11)省级局数据中心将省BOSS和省CRM的加载结果反馈到一级局数据中心;
12)一级局数据中心将各省网元的加载结果反馈给一级BBOSS;
13)一级局数据中心在各省网元全部加载成功后,给一级BBOSS反馈发布结果通知。
5.文件命名及说明
文件类型
文件名称
BBOSS给一级BDC的GPRS业务内容计费业务代码信息文件
GPRS_SERVICECODE_<日期>.<序号>
一级BDC给BBOSS的GPRS业务内容计费业务代码信息拒收文件
FXXX_GPRS_SERVICECODE_<日期>.<序号>
一级BDC给BBOSS的GPRS业务内容计费业务代码信息回执文件
E_GPRS_SERVICECODE_<日期>.<序号>
BBOSS给一级BDC的定向统付GPRS业务内容计费代码局数据信息文件
NFPAY_GPRS_FEE_<日期>.<序号>
一级BDC给BBOSS的定向统付GPRS业务内容计费代码局数据信息拒收文件
FXXX_NFPAY_GPRS_FEE_<日期>.<序号>
一级BDC给BBOSS的定向统付GPRS业务内容计费代码局数据信息回执文件
E_NFPAY_GPRS_FEE_<日期>.<序号>
一级BDC给BBOSS的集团业务信息文件
CORPOPERATOR_<日期>.<序号>
BBOSS给一级BDC的集团业务信息回执文件
E_CORPOPERATOR_<日期>.<序号>
BBOSS给一级BDC的集团业务信息拒收文件
FXXX_CORPOPERATOR_<日期>.<序号>
一级BDC给BBOSS的手机阅读内容详情信息文件
CMREAD_INFO_<日期>.<序号>
BBOSS给一级BDC的手机阅读内容详情信息拒收文件
FXXX_CMREAD_INFO_<日期>.<序号>
BBOSS给一级BDC的手机阅读内容详情信息回执文件
E_CMREAD_INFO_<日期>.<序号>
一级BDC给BBOSS的各省网元通知加载状态文件
NOTIFY_INFO_<局数据类型>_<系统编码>_<省代码>_<日期>.<序号>
一级BDC给BBOSS的发布结果通知文件
NOTIFY_RESULT_<局数据类型>_<日期>.<序号>
注释说明:
(1)日期为YYYYMMDD的年月日格式,8位数字;
(2)序号为三位数字,文件序号从“000”到“299”,对于错单文件重传,从“700”到“899”。
(3)局数据类型参见附录《局数据类型编码表》
(4)省代码参见:
《省代码编码表》;
(5)网元类型参见:
《系统编码表》;
(6)文件内容以半角分号字符“;”作为字段分割符,最后一个字段后面无需半角分号“;”,每条记录以回车换行符结束;
(7)拒收文件时,文件名中定义FXXX表示为文件级检错标准中的错误编码;
(8)文件采用FTP文件传输协议,TXT文件格式,GBK编码方式。
6.文件格式
6.1.头记录
序号
头记录字段名称
数据类型及长度
有效值
1.
头记录标记
F1
H
2.
接收文件操作类型
F1
全量:
0
增量:
1
3.
文件序号
F3
文件名中的序号
4.
文件产生时间
F14
格式(24小时制):
YYYYMMDDHHMMSS
头记录以半角分号字符“;”作为字段分割符,最后一个字段后面无需半角分号“;”,以回车换行符结束。
针对以下局数据信息文件都需加上头记录和尾记录。
6.2.BBOSS给一级BDC的GPRS业务内容计费业务代码信息文件
序号
字段名
数据类型及长度
含义
填写说明
1.
PROC_ID
F30
业务流水号
BBOSS发布文件中,业务流水号字段填空。
一级BDC接收到同步文件并校验通过后对该条记录产生唯一标识,回执时将值返回BBOSS。
标识生成规则为:
X+局数据类型编码(6位)+14位时间戳+9位序号为业务流水号。
X为G表示全网业务局数据,L表示省级业务局数据。
局数据类型编码参见《局数据类型编码表》
2.
OPER_TYPE
F3
操作类型
操作类型定义:
ADD(新增)
MOD(修改)
DEL(删除)
3.
SERVICE_CODE
V10
业务代码ID
业务代码ID
4.
VALID_DATE
F8
生效日期
格式:
YYYYMMDD
5.
EXPIRE_DATE
F8
失效日期
格式:
YYYYMMDD
6.
DESCRIPTION
V256
描述
不能含有半角字符“;”
7.
IS_CHARGE
F1
是否收费
0:
免费
1:
收费
8.
FEE
V8
信息费
单位:
厘
9.
TIME_STAMP
F14
时间戳
格式(24小时制):
YYYYMMDDHHMMSS
BBOSS发布文件中,时间戳字段填空。
一级BDC接收到同步文件并校验通过后对该条记录产生时间戳,回执时将值返回BBOSS。
6.3.BBOSS给一级BDC的定向统付GPRS业务内容计费代码局数据信息文件
序号
字段名
数据类型及长度
含义
填写说明
1.
PROC_ID
F30
业务流水号
BBOSS发布文件中,业务流水号字段填空。
一级BDC接收到同步文件并校验通过后对该条记录产生唯一标识,回执时将值返回BBOSS。
标识生成规则为:
X+局数据类型编码(6位)+14位时间戳+9位序号为业务流水号。
X为G表示全网业务局数据,L表示省级业务局数据。
局数据类型编码参见《局数据类型编码表》
2.
OPER_TYPE
F3
操作类型
操作类型定义:
ADD(新增)
MOD(修改)
DEL(删除/注销)
3.
SERVICE_ID
V10
业务计费代码
业务计费代码必须在GPRS业务内容计费代码信息文件中的“业务代码ID”中存在
4.
APP_NAME
V64
客户产品简称
客户产品简称
5.
SERVICE_TYPE
F1
业务模式
1:
不限用户,全量统付
2:
不限用户,定量统付
3:
指定用户,全量统付
4:
指定用户,定额统付
5:
指定用户,定量统付
6.
NF_LIMIT
V10
单用户封顶流量
单位:
MB
当业务模式为1、3、4、5时,单用户封顶流量为空;
当业务模式为2时,单用户封顶流量为数字,流量单位固定为MB,无须填写。
如单用户封顶流量为500MB,填写:
500。
7.
VALID_PROVINCE
V256
局数据作用省
指定局数据作用省时,填写省代码,多个省代码之间用半角逗号“,”分隔,如:
100,200,210;作用范围为全国时,填写31省的代码
8.
VALID_DATE
F14
生效时间
格式(24小时制):
YYYYMMDDHHMMSS
1、针对操作类型为新增、修改的生效时间为新增、修改的开始时间
2、针对操作类型为删除/注销的生效时间为删除/注销时间
9.
EXPIRE_DATE
F14
失效时间
格式(24小时制):
YYYYMMDDHHMMSS
1、当操作类型为新增、修改时,失效时间为局数据新增、修改后的结束时间,如果失效时间不确定,则BBOSS填写29991231235959
2、当操作类型为删除/注销时,失效时间无具体意义,BBOSS可填写比生效时间大的任意时间。
10.
TIME_STAMP
F14
时间戳
格式(24小时制):
YYYYMMDDHHMMSS
BBOSS发布文件中,时间戳字段填空。
一级BDC接收到同步文件并校验通过后对该条记录产生时间戳,回执时将值返回BBOSS。
6.4.一级BDC给BBOSS的集团业务信息文件
序号
字段名
数据类型及长度
含义
填写说明
1.
PROC_ID
F30
业务流水号
基地平台发布文件中,业务流水号字段填空。
一级BDC接收到同步文件并校验通过后对该条记录产生唯一标识,回执时将值返回基地平台。
标识生成规则为:
X+局数据类型编码(6位)+14位时间戳+9位序号为业务流水号。
X为G表示全网业务局数据,L表示省级业务局数据。
局数据类型编码参见《局数据类型编码表》
2.
OPER_TYPE
F3
操作类型
操作类型定义:
ADD(新增)
MOD(修改)
DEL(删除)
3.
SERV_TYPE
F6
业务类型
企业阅读业务:
190508
4.
SP_CODE
F6
企业代码
全数字的企业代码
5.
OPERATOR_CODE
V24
业务代码
业务代码必须由大写字母、数字或“+”或“-”组成的字符串,仅第一位可以为“+”或“-”(半角字符),字符总长不超过10位
6.
OPERATOR_NAME
V64
业务产品名称
业务产品名称,不能含有半角字符“;”
7.
BILL_FLAG
V2
计费类型
2:
按次/按条计费
8.
FEE
V8
信息费
单位:
厘
9.
VALID_DATE
F8
生效日期
格式:
YYYYMMDD
10.
EXPIRE_DATE
F8
失效日期
格式:
YYYYMMDD
失效日期大于生效日期
11.
SERV_DESC
V512
业务描述
填写业务的描述信息,可填空
12.
TIME_STAMP
F14
时间戳
格式(24小时制):
YYYYMMDDHHMMSS
13.
VALID_PROVINCE
V256
生效省份
指定生效省份,统一填写省代码,多个省代码之间用半角逗号“,”分隔,如:
100,200,210,全网生效填写“ALL”
6.5.一级BDC给BBOSS的手机阅读内容详情信息文件
序号
字段名
数据类型及长度
含义
填写说明
1.
PROC_ID
F30
业务流水号
基地平台发布文件中,业务流水号字段填空。
一级BDC接收到同步文件并校验通过后对该条记录产生唯一标识,回执时将值返回基地平台。
标识生成规则为:
X+局数据类型编码(6位)+14位时间戳+9位序号为业务流水号。
X为G表示全网业务局数据,L表示省级业务局数据。
局数据类型编码参见《局数据类型编码表》
2.
OPER_TYPE
F3
操作类型
操作类型定义:
ADD(新增)
MOD(修改)
DEL(删除)
3.
CONTENT_TYPE
F2
内容类型
00:
图书
01:
杂志
02:
漫画
03:
听书
04:
报纸
99:
其他
4.
CONTENT_ID
F12
内容代码
内容代码,每个内容代码唯一代表一本图书、杂志、漫画或书籍组合;每本书的章节体现在按次计费话单中章节字段。
不能含有半角分号“;”、换行符、半角管道符“|”
5.
CONTENT_NAME
V64
内容名称
业务内容名称。
不能含有半角分号“;”、换行符、半角管道符“|”
6.
MCP_ID
F6
MCP代码
不能含有半角分号“;”、换行符、半角管道符“|”
7.
MCP_NAME
V128
MCP名称
MCP名称。
不能含有半角分号“;”、换行符、半角管道符“|”
8.
AUTHOR_NAME
V64
作家名称
作家名称(多个作家之间用半角逗号“,”分隔)。
不能含有半角分号“;”、换行符、半角管道符“|”
9.
VALID_DATE
F8
生效日期
格式:
YYYYMMDD
10.
EXPIRE_DATE
F8
失效日期
格式:
YYYYMMDD
失效日期大于生效日期
11.
TIME_STAMP
F14
时间戳
基地平台发布文件中,时间戳字段填空。
一级BDC接收到同步文件并校验通过后对该条记录产生时间戳,回执时将值返回基地平台。
格式(24小时制):
YYYYMMDDHHMMSS
6.6.一级BDC给BBOSS的发布结果通知文件
序号
字段名
数据类型及长度
含义
填写说明
1.
PROC_ID
F30
业务流水号
2.
STATUS
F1
状态
取值:
1:
全网发布成功
其它状态预留扩展
3.
REMARK
V256
备注
预留,填空
6.7.一级BDC给BBOSS的各省网元通知加载状态文件
该接口适用于GPRS业务内容计费业务代码、定向统付GPRS业务内容计费代码文件接口。
序号
字段名
数据类型及长度
含义
填写说明
4.
PROC_ID
F30
业务流水号
一级或省级局数据中心产生的对该条记录的唯一标识,生成规则为:
X+局数据类型编码(6位)+14位时间戳+9位序号为业务流水号,流水号以000000001开始。
X为G标识一级局数据中心,L标识省级局数据中心,基地平台发布时该字段填空,一级局数据中心加载成功时产生,回执时加上这个值,基地平台需将流水号进行加载
5.
NODE_TYPE
F4
网元类型
参见《系统编码表》
6.
PROVINCE_ID
F3
省代码
参见《省代码编码表》
7.
STATUS
F1
加载状态
发布通知填写:
0:
发布失败
1:
发布成功
8.
RSP_CODE
F4
局数据校验检错码
发布成功填写“DONE",发布失败填写相应出错的代码
9.
RSP_DESC
V256
错误描述
填空
6.8.尾记录
序号
字段名
数据类型及长度
有效值及说明
1.
尾标记
F1
T
2.
记录数合计
V9
全数字
尾记录以半角分号字符“;”作为字段分割符,最后一个字段后面无需半角分号“;”,以回车换行符结束。
7.回执文件格式
7.1.拒收文件
一级BDC接收到BBOSS同步的局数据文件后,在文件级校验失败时反馈拒收文件。
一级BDC接收到省级BDC、省BOSS、省CRM反馈的拒收文件后,也会向BBOSS反馈拒收文件。
拒收文件格式定义如下
1)回执文件名在原文件名前加“FXXX_”,FXXX为9.附录中文件级检错标准中的代码定义。
2)文件内容原样返回,目标系统不处理文件内容。
7.2.回执文件
一级BDC接收到BBOSS同步的局数据文件后,在记录级校验完成时反馈回执文件。
一级BDC接收到省级BDC、省BOSS、省CRM反馈的回执文件后,也会向BBOSS反馈回执文件。
回执文件格式定义如下:
1)回执文件名请参考4.文件命名及说明,无论记录是否正确都将返回处理结果信息。
2)回执记录格式为:
<错误代码>;<记录内容>,错误代码参见附录相关章节。
3)正确记录格式为:
DONE;<记录内容>。
说明:
1)<记录内容>:
a)一级BDC校验加载成功的记录,其记录内容是