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