中国移动政企BOSS系统话单规范移动云业务话单文件说明v1 7 2 1.docx
《中国移动政企BOSS系统话单规范移动云业务话单文件说明v1 7 2 1.docx》由会员分享,可在线阅读,更多相关《中国移动政企BOSS系统话单规范移动云业务话单文件说明v1 7 2 1.docx(22页珍藏版)》请在冰豆网上搜索。
中国移动政企BOSS系统话单规范移动云业务话单文件说明v1721
中国移动政企BOSS系统话单规范
-移动云业务话单文件说明
V1.7
版本历史
修订号
修订日期
修订内容简述
修订人
修订后
版本号
1.0
2014/10/21
创建文档
赵振功
1.0
1.6
2014/11/15
按照移动云3期要求修订
赵振功
1.6
1.7
2014/12/5
增加话单类型chargemode的枚举值:
5、6、7、8、9、10、11及相应类型的数值单位说明
启用预留字段Reserved,传输新增枚举值对应的数值
丁驰
1.7
1概述
本文档是对中国移动政企BOSS系统基于移动云业务下发话单的详细描述,是计费结算系统输入、输出的依据。
2文件接口
2.1文件格式
2.1.1文件命名规则
文件采用纯文本格式,文件名定义如下表:
文件名称
文件描述
有效范围
(NNN)
方向
取文件规则
CSMPYYYYMMDDHH24MISSNNN
移动云平台上传的业务话单文件
000-999
CSMP平台政企BOSS
政企BOSS获取文件后由政企BOSS删除
CSMPYYYYMMDD999
上传汇总文件,每日一次
政企BOSSCSMP平台
CSMP获取文件后由CSMP平台删除
ECSMPYYYYMMDDHH24MISSNNN
错单文件,有错时包括错误内容,无错时只有尾记录,一个有效上传的云服务业务话单文件对应生成一个错单记录文件
000-999
政企BOSSCSMP平台
CSMP平台获取文件后由CSMP平台删除
FxxxCSMPYYYYMMDDHH24MISSNNN
拒收文件,重复的文件名、文件名错或文件格式错在原上发的文件名前加‘Fxxx’返回
000-999
政企BOSSCSMP平台
CSMP平台获取文件后由CSMP平台删除
注:
(1)文件名中的“CSMP”表示该文件为云服务业务话单文件;
(2)“YYYYMMDDHH24MISS”表示文件生成的时间;
(3)“NNN”表示当日文件序号(范围:
000-999),每日文件序号从000开始;
(4)文件名前加“E”表示错单文件,BOSS接收并处理完一个话单文件后,生成该文件对应的错单文件,文件名为“E”+业务话单文件名;
(5)“Fxxx”代表文件级错误代码,见《中国移动政企BOSS系统话单规范---基于移动云业务话单文件检错标准》-文件级检错标准;
(6)移动云平台生成话单文件采取下面的原则:
∙包月计费产品不提供话单,按时长计费产品按小时提供话单,按流量计费产品按天提供话单,按次计费产品按小时提供话单。
话单文件以小时为单位生成,该小时内如果没有话单记录,也必须生成包含头尾记录的话单文件。
∙如果某小时话单文件大小超过10M,则拆分成多个10M以下的文件传送,同一小时的话单使用序列号来区分不同文件。
2.1.2文件格式说明
文件采用纯文本格式,每条记录以回车换行符结束,话单文件每条记录长度为340字节;政企BOSS下发给CSMP的汇总文件每条记录长度为96字节;下发给省公司的汇总文件每条记录长度为78字节;错单文件每条记录的长度为353;文件大小是记录长度的整数倍。
2.1.3文件存放目录
政企BOSS与移动云平台的文件交互通过网状网系统实现,具体的主机目录如下:
文件名
文件描述
发起方
一级BOSS发起方目录
落地方
一级BOSS落地方目录
CSMPYYYYMMDDHH24MISSNNN
云平台上传业务话单文件
移动云平台
172.16.6.156:
1160/$HOME/incoming/rawdata/CSMP/
政企BOSS
10.1.128.113:
1160/$HOME/outgoing/rawdata/CSMP
CSMPYYYYMMDD999
政企BOSS汇总文件
政企BOSS
10.1.128.113:
1160/$HOME/incoming/errdata/CSMP
移动云平台
172.16.6.156:
1160/$HOME/outgoing/errdata/CSMP
ECSMPYYYYMMDDHH24MISSNNN
错单文件
政企BOSS
10.1.128.113:
1160/$HOME/incoming/errdata/CSMP
移动云平台
172.16.6.156:
1160/$HOME/outgoing/errdata/CSMP
FxxxCSMPYYYYMMDDHH24MISSNNN
拒收文件
政企BOSS
10.1.128.113:
1160/$HOME/incoming/errdata/CSMP
移动云平台
172.16.6.156:
1160/$HOME/outgoing/errdata/CSMP
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
订单与产品关系标识,即产品订购关系ID
16
Separator
分隔符
16153
String
1
逗号分隔符
固定值:
“,”(单字节)
17
ChargeMode
话单类型
17
String
2
话单类型
选择如下其一:
01-按次数计费
02-按时长计费
03-按流量计费(byte)
04-按license数量计费
05-按内存计费(byte)
06-按存储、备份计费(byte)
07-按head/get请求计费(次)
08-按其他请求计费(次)
09-按带宽计费(byte)
10-峰值带宽静态网页(byte)
11-峰值带宽动态网页(byte)
18
Separator
分隔符
18153
String
1
逗号分隔符
固定值:
“,”(单字节)
19
resouceInstanceId
资源实例编码
19
String
30
资源实例ID
平台填写资源实例编码
20
Separator
分隔符
20153
String
1
逗号分隔符
固定值:
“,”(单字节)
21
BeginTime
使用开始时间
21
String
14
使用开始时间
格式为:
YYYYMMDDHH24MISS;*对于订购关系为包月计费类型的产品不提供;*对于订购关系为按时长类型的产品,首话单为政企BOSS反馈给平台订购关系的生效时间,次话单到末话单,为xx点00分00秒,每小时一个话单;*对于订购关系为按流量类型的产品,首话单为政企BOSS反馈给平台订购关系的生效时间,次话单到末话单,为xx日00点00分00秒,一天一个话单;*对于订购关系包含按次计费费项的产品,首话单为政企BOSS反馈给平台订购关系的生效时间,次话单到末话单,xx点00分00秒,每小时一个话单;
22
Separator
分隔符
22153
String
1
逗号分隔符
固定值:
“,”(单字节)
23
EndTime
使用结束时间
23
String
14
使用结束时间
格式为:
YYYYMMDDHH24MISS;*对于订购关系为包月计费类型的产品不提供;*对于订购关系为按时长类型的产品,首话单为订购首小时内用户政企BOSS侧订购关系取消时间或xx点00分00秒,次话单为xx点00分00秒,末话单为用户政企BOSS侧订购关系取消时间,每小时一个话单;*对于订购关系为按流量类型的产品,首话单为订购首天内用户政企BOSS侧订购关系取消时间或xx日00点00分00秒,次话单为xx日00点00分00秒,末话单为用户政企BOSS侧订购关系取消时间,一天一个话单;*对于订购关系包含按次计费费项的产品,首话单为订购首小时内用户政企BOSS侧订购关系结束时间或xx点00分00秒,次话单为xx点00分00秒,末话单为用户政企BOSS侧订购关系结束时间,每小时一个话单;
24
Separator
分隔符
24153
String
1
逗号分隔符
固定值:
“,”(单字节)
25
SessionDuration
会话时长
25
Int
10
会话时长。
单位:
分
目前填空
26
Separator
分隔符
26153
String
1
逗号分隔符
固定值:
“,”(单字节)
27
Amount
会话次数或license数量
27
Int
4
次数
ChargeMode为1或4时填写
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
Int
31
新增计费类型参数值
ChargeMode为5、6、7、8、9、10、11时填写,单位参见chargemode字段中的备注
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汇总文件格式
上传汇总文件名:
CSMPYYYYMMDD999
它给出了当日(即YYYYMMDD)政企BOSS接收CSMP平台上传文件并处理的结果,由一条头记录,多条接收文件处理汇总记录和一条尾记录组成,每条接收文件处理汇总记录与一个上发文件对应,记录了政企BOSS对该文件接收及处理的结果。
上传汇总文件的记录长度为96字节,文件大小为96字节的整数倍。
2.3.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.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.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.4错单文件格式
文件名:
ECSMPYYYYMMDDHHMISSNNN
错单文件包括错单记录和尾记录,若无错单,则只有尾记录。
错单记录长度为353字节,文件大小为353字节的整数倍。
2.4.1错单记录
错单录字段名称
位置
长度(字节)
有效值
错误代码
1
4
见《中国移动政企BOSS系统话单规范---基于移动云业务话单文件检错标准》文件
错误行号
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。
并返回移动云平台。
拒收文件的格式和内容保持不变。