中国移动BBOSS系统话单规范基于公众服务云业务话单文件说明v12.docx
- 文档编号:12725268
- 上传时间:2023-04-21
- 格式:DOCX
- 页数:23
- 大小:32.40KB
中国移动BBOSS系统话单规范基于公众服务云业务话单文件说明v12.docx
《中国移动BBOSS系统话单规范基于公众服务云业务话单文件说明v12.docx》由会员分享,可在线阅读,更多相关《中国移动BBOSS系统话单规范基于公众服务云业务话单文件说明v12.docx(23页珍藏版)》请在冰豆网上搜索。
中国移动BBOSS系统话单规范基于公众服务云业务话单文件说明v12
中国移动BBOSS系统话单规范
-公众服务云业务话单文件说明
V1.2
版本历史
修订号
修订日期
修订内容简述
修订人
修订后
版本号
1.0
2012/3/31
创建文档
黄德光
1
概述
本文档是对中国移动BBOSS系统基于公众服务云业务下发话单的详细描述,是计费结算系统输入、输出的依据。
2文件接口
2.1文件格式
2.1.1文件命名规则
文件采用纯文本格式,文件名定义如下表:
文件名称
文件描述
有效范围
(NNN)
方向
取文件规则
CSMPYYYYMMDDHH24MISSNNN
公众服务云平台上传的业务话单文件
000-999
CSMP平台BBOSS
BBOSS获取文件后由BBOSS删除
CSMPYYYYMMDD999
上传汇总文件,每日一次
BBOSSCSMP平台
CSMP获取文件后由CSMP平台删除
ECSMPYYYYMMDDHH24MISSNNN
错单文件,有错时包括错误内容,无错时只有尾记录,一个有效上传的云服务业务话单文件对应生成一个错单记录文件
000-999
BBOSSCSMP平台
CSMP平台获取文件后由CSMP平台删除
FxxxCSMPYYYYMMDDHH24MISSNNN
拒收文件,重复的文件名、文件名错或文件格式错在原上发的文件名前加‘Fxxx’返回
000-999
BBOSSCSMP平台
CSMP平台获取文件后由CSMP平台删除
CSMPYYYYMMDDHH24MISSZZZ.NNN
BBOSS下发给省公司的业务话单文件,格式同CSMPYYYYMMDDHH24MISSNNN
000-999
BBOSS各省BOSS
各省BOSS获取文件后由各省BOSS删除
CSMPYYYYMMDDZZZ.999
BBOSS下发给省公司的汇总文件,每日下发一次
BBOSS各省BOSS
各省BOSS获取文件后由各省BOSS删除
注:
(1)文件名中的“CSMP”表示该文件为云服务业务话单文件;
(2)“YYYYMMDDHH24MISS”表示文件生成的时间;
(3)“ZZZ”表示接收文件的省代码,如北京:
“100”,黑龙江:
“451”;
(4)“NNN”表示当日文件序号(范围:
000-999),每日文件序号从000开始;
(5)文件名前加“E”表示错单文件,BOSS接收并处理完一个话单文件后,生成该文件对应的错单文件,文件名为“E”+业务话单文件名;
(6)“Fxxx”代表文件级错误代码,见《中国移动BBOSS系统话单规范---基于公众服务云业务话单文件检错标准》-文件级检错标准;
(7)公众服务云平台生成话单文件采取下面的原则:
∙包月计费产品不提供话单,按时长计费产品按小时提供话单,按流量计费产品按天提供话单,按次计费产品按小时提供话单。
话单文件以小时为单位生成,该小时内如果没有话单记录,也必须生成包含头尾记录的话单文件。
∙如果某小时话单文件大小超过10M,则拆分成多个10M以下的文件传送,同一小时的话单使用序列号来区分不同文件。
2.1.2文件格式说明
文件采用纯文本格式,每条记录以回车换行符结束,话单文件每条记录长度为340字节;BBOSS下发给CSMP的汇总文件每条记录长度为96字节;下发给省公司的汇总文件每条记录长度为78字节;错单文件每条记录的长度为353;文件大小是记录长度的整数倍。
2.1.3文件存放目录
BBOSS与公众服务云平台、省BOSS之间的文件交换通过一级BOSS枢纽来实现,具体的主机目录如下:
1、218.206.191.171:
/$HOME/incoming/rawdata/work该目录存放以下文件:
∙CSMPYYYYMMDDHH24MISSNNN:
公众服务云平台上传业务话单文件;
2、218.206.191.171:
/$HOME/outgoing/errdata/work该目录接收以下文件:
∙CSMPYYYYMMDD999:
上传汇总文件;
∙ECSMPYYYYMMDDHH24MISSNNN:
错单文件;
∙FxxxCSMPYYYYMMDDHH24MISSNNN:
拒收文件;
3、10.1.140.123:
/$HOME/outgoing/file_interface/CSMP/work该目录接收以下文件:
∙CSMPYYYYMMDDHH24MISSZZZ.NNN:
BBOSS下发给省公司的业务话单文件;
∙CSMPYYYYMMDDZZZ.999:
BBOSS下发给省公司的汇总文件,每日下发一次;
2.1.4文件校验
文件接受方应对文件进行校验。
2.2话单文件格式
文件名:
CSMPYYYYMMDDHH24MISSNNN
业务话单文件由一条头记录、多行话单记录和一条尾记录构成,用“回车&换行”来标识一条记录,每条记录由如下表格所示的字段组成。
若字符串型的字段值长度不足,则左对齐,右补空格;若整数/浮点数型的字段值长度不足,则右对齐,左补零。
字段排列顺序按下表所示序号规定填写和读取。
2.2.1头记录
头记录字段名称
位置
长度(字节)
有效值
头记录标记
1
2
“10”
上传文件的省代码
2
3
如100北京
有限公司为000
接收文件的省代码
3
3
如100北京
有限公司为000
文件序号
4
3
“NNN“,文件名中的序号
文件产生时间
5
14
YYYYMMDDHH24MISS
文件版本号
6
2
“01”
保留1
7
311
空格
回车
8
1
CarriageReturn
换行
9
1
LineFeed
2.2.2话单记录
序号
名称
域名
位置
类型
长度
含义
填写说明
1
RecType
话单记录标记
1
String
2
标记文件中的记录类型
填固定值:
20
2
Separator
分隔符
2153
String
1
逗号分隔符
固定值:
“,”(单字节)
3
StreamNumber
话单序列号
3
String
22
话单流水号
本段话单的唯一标识
由提交时间+序列号。
(YYYYMMDDHH24MI(12位)+序列号(10位)
其中:
序列号为10位数字,从零开始,顺序累加,步长为1
4
Separator
分隔符
4153
String
1
逗号分隔符
固定值:
“,”(单字节)
5
TimeStamp
话单产生时间
5
String
14
话单产生时间
格式为:
YYYYMMDDHH24MISS
6
Separator
分隔符
6153
String
1
逗号分隔符
固定值:
“,”(单字节)
7
ECID
集团客户编号
7
String
30
集团客户账号
集团客户账号:
省代码+企业编码
8
Separator
分隔符
8153
String
1
逗号分隔符
固定值:
“,”(单字节)
9
ServiceID
业务编码
9
String
10
业务ID
云业务ID,固定值(商品id)
10
Separator
分隔符
10153
String
1
逗号分隔符
固定值:
“,”(单字节)
11
productID
产品编码
11
String
50
产品规格编码
12
Separator
分隔符
12153
String
1
逗号分隔符
固定值:
“,”(单字节)
13
ServiceType
业务类型
13
String
4
业务类型
八类(与局数据同步)
14
Separator
分隔符
14153
String
1
逗号分隔符
固定值:
“,”(单字节)
15
OrderID
订购关系编码
15
String
30
产品订购实例ID
订单与产品关系标识
16
Separator
分隔符
16153
String
1
逗号分隔符
固定值:
“,”(单字节)
17
ChargeMode
话单类型
17
String
2
话单类型
选择如下其一:
01—按次数计费
02—按时长计费
03—按流量计费
18
Separator
分隔符
18153
String
1
逗号分隔符
固定值:
“,”(单字节)
19
resouceInstanceId
资源实例编码
19
String
30
资源实例ID
平台填写资源实例编码
20
Separator
分隔符
20153
String
1
逗号分隔符
固定值:
“,”(单字节)
21
BeginTime
使用开始时间
21
String
14
使用开始时间
格式为:
YYYYMMDDHH24MISS;*对于订购关系为包月计费类型的产品不提供;*对于订购关系为按时长类型的产品,首话单为BBOSS反馈给平台订购关系的生效时间,次话单到末话单,为xx点00分00秒,每小时一个话单;*对于订购关系为按流量类型的产品,首话单为BBOSS反馈给平台订购关系的生效时间,次话单到末话单,为xx日00点00分00秒,一天一个话单;*对于订购关系包含按次计费费项的产品,首话单为BBOSS反馈给平台订购关系的生效时间,次话单到末话单,xx点00分00秒,每小时一个话单;
22
Separator
分隔符
22153
String
1
逗号分隔符
固定值:
“,”(单字节)
23
EndTime
使用结束时间
23
String
14
使用结束时间
格式为:
YYYYMMDDHH24MISS;*对于订购关系为包月计费类型的产品不提供;*对于订购关系为按时长类型的产品,首话单为订购首小时内用户BBOSS侧订购关系取消时间或xx点00分00秒,次话单为xx点00分00秒,末话单为用户BBOSS侧订购关系取消时间,每小时一个话单;*对于订购关系为按流量类型的产品,首话单为订购首天内用户BBOSS侧订购关系取消时间或xx日00点00分00秒,次话单为xx日00点00分00秒,末话单为用户BBOSS侧订购关系取消时间,一天一个话单;*对于订购关系包含按次计费费项的产品,首话单为订购首小时内用户BBOSS侧订购关系结束时间或xx点00分00秒,次话单为xx点00分00秒,末话单为用户BBOSS侧订购关系结束时间,每小时一个话单;
24
Separator
分隔符
24153
String
1
逗号分隔符
固定值:
“,”(单字节)
25
SessionDuration
会话时长
25
Int
10
会话时长。
单位:
分
目前填空
26
Separator
分隔符
26153
String
1
逗号分隔符
固定值:
“,”(单字节)
27
Amount
会话次数
27
Int
4
次数
ChargeMode为1时填写
28
Separator
分隔符
28153
String
1
逗号分隔符
固定值:
“,”(单字节)
29
InVolume
输入流量
29
Int
16
输入的数据流量,Byte
ChargeMode为3时填写
30
Separator
分隔符
30153
String
1
逗号分隔符
固定值:
“,”(单字节)
31
OutVolume
输出流量
31
Int
16
输出的数据流量,Byte
ChargeMode为3时填写
32
Separator
分隔符
32153
String
1
逗号分隔符
固定值:
“,”(单字节)
33
Partial_id
话单分割标志
33
String
4
*按时长按以下规则填写:
话单分割标志,取值0000~XXXX(十进制数)或FFFF。
0000:
未切割;
0001~XXXX(十进制数):
第n条分割话单(不包括最后一条);
FFFF:
最后一条切割话单。
如果跨月,则当月最后一条话单填写FFFF;次月从0001开始重新记录,一直到订购关系取消为止
*按流量、按次话单固定填写0000
34
Separator
分隔符
34153
String
1
逗号分隔符
固定值:
“,”(单字节)
35
UnitPrice
计费单价
35
Int
8
计费单价,单位:
元
填写零
36
Separator
分隔符
36153
String
1
逗号分隔符
固定值:
“,”(单字节)
37
Fee
产品费用
37
Int
8
产品费用,单位:
元
填写零
38
Separator
分隔符
38153
String
1
逗号分隔符
固定值:
“,”(单字节)
39
Reserved
预留
39
31
预留字段
空格
40
CR
回车
40
1
CarriageReturn
41
LF
换行
41
1
LineFeed
2.2.3尾记录
尾记录字段名称
位置
长度(字节)
有效值
尾记录标记
1
2
“90”
文件序号
2
3
文件名中的序号,左对齐右填空
文件产生时间
3
14
YYYYMMDDHH24MISS
文件中话单记录总数
4
9
右对齐,左补0
不含头尾记录
保留1
5
310
空格
回车
6
1
CarriageReturn
换行
7
1
LineFeed
2.3汇总文件格式
2.3.1上传汇总文件格式
文件名:
CSMPYYYYMMDD999
它给出了当日(即YYYYMMDD)BBOSS接收CSMP平台上传文件并处理的结果,由一条头记录,多条接收文件处理汇总记录和一条尾记录组成,每条接收文件处理汇总记录与一个上发文件对应,记录了BBOSS对该文件接收及处理的结果。
上传汇总文件的记录长度为96字节,文件大小为96字节的整数倍。
2.3.1.1汇总头记录
头记录字段名称
位置
长度(字节)
有效值
头记录标记
1
2
“10”
上传文件的省代码
2
3
如100北京
有限公司为000
保留1
3
10
空格
归属局代码
4
8
46000000
保留2
5
10
空格
文件产生日期
6
14
YYYYMMDDHHMISS
文件版本号
7
2
“01”
保留3
8
45
填空格
回车
9
1
CarriageReturn
换行
10
1
LineFeed
2.3.1.2汇总话单记录
序号
名称
位置
长度
填写说明
1
记录标记
1
2
“40”
2
原文件名
2
30
CSMPYYYYMMDDHHMISSNNN
3
有效话单总数
3
9
即有效记录条数合计
右对齐,左填0
4
错单数(不含重单)
4
9
右对齐,左填0
5
重单数
5
9
右对齐,左填0
6
有效通信费合计
6
15
单位:
厘,右对齐,左填0
7
保留
7
20
空格
8
回车
8
1
CarriageReturn
9
换行
9
1
LineFeed
2.3.1.3汇总尾记录
尾记录字段名称
位置
长度(字节)
有效值
尾记录标记
1
2
“90”
有效文件总数
2
4
右对齐,左填0
有效话单数合计
3
9
即有效记录条数合计
右对齐,左填0
错单数(不含重单)合计
4
9
右对齐,左填0
重单数合计
5
9
右对齐,左填0
保留
6
61
空格
回车
7
1
CarriageReturn
换行
8
1
LineFeed
2.3.2下发汇总文件格式
文件名:
CSMPYYYYMMDDZZZ.999
给出当日(即YYYYMMDD)BBOSS下发各省的基于云服务业务文件的汇总,由一条头记录、多条汇总记录和一条尾记录组成。
每条汇总记录与一个下发文件对应,记录了BBOSS下发到“ZZZ”省的业务文件的统计结果。
下发汇总文件记录长度为78字节,文件大小为78字节的整数倍。
2.3.2.1下发汇总头记录
头记录字段名称
位置
长度(字节)
有效值
头记录标记
1
2
“10”
接收文件的省代码
2
3
如100北京
有限公司为000
保留1
3
20
空格
归属局代码
4
10
46000000,左对齐右填空
文件产生日期
5
14
YYYYMMDDHHMISS
文件版本号
6
2
“01”
保留2
7
25
填空
回车
8
1
CarriageReturn
换行
9
1
LineFeed
2.3.2.2下发汇总文件记录
序号
名称
位置
长度
填写说明
1
记录标记
1
2
“40”
2
下发文件名
2
30
CSMPYYYYMMDDHHMISSZZZ.NNN
3
话单总数
3
9
即有效记录条数合计
右对齐,左填0
4
保留
4
35
空格
5
回车
5
1
CarriageReturn
6
换行
6
1
LineFeed
2.3.2.3下发汇总尾记录
尾记录字段名称
位置
长度(字节)
有效值
尾记录标记
1
2
“90”
归属局代码
2
10
46000000,左对齐右填空
接收文件的省代码
3
3
如100北京
有限公司为000
文件总数
4
4
右对齐,左填0
话单数合计
5
9
即有效记录条数合计
右对齐,左填0
保留
6
48
空格
回车
7
1
CarriageReturn
换行
8
1
LineFeed
2.4错单文件格式
文件名:
ECSMPYYYYMMDDHHMISSNNN
错单文件包括错单记录和尾记录,若无错单,则只有尾记录。
错单记录长度为353字节,文件大小为353字节的整数倍。
2.4.1错单记录
错单录字段名称
位置
长度(字节)
有效值
错误代码
1
4
见《中国移动BBOSS系统话单规范---基于公众服务云业务话单文件检错标准》文件
错误行号
2
9
右对齐,不足填零
原错误话单记录
3
340
包含原记录中的回车换行符号
2.4.2尾记录
错单录字段名称
位置
长度(字节)
有效值
记录类型
1
2
有效值‘90’
错单总数(不包含重单)
2
9
右对齐,不足填零
重单总数
3
9
右对齐,不足填零
保留
4
331
空格
回车
5
1
CR
换行
6
1
LE
2.5拒收文件格式
上发的云服务话单文件,在进行文件级校验时如发现文件级错误,则在原文件名前加上字母串“Fxxx”,如:
因F000错误打回的拒收文件,名称为F000CSMPYYYYMMDDHHMISSNNN。
并返回公众服务云平台。
拒收文件的格式和内容保持不变。
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 中国移动 BBOSS 系统 规范 基于 公众 服务 业务 文件 说明 v12