中国移动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。
并返回公众服务云平台。
拒收文件的格式和内容保持不变。
升级会员 