2024年1月29日发(作者:)
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
中国移动通信有限公司
一级BBOSS与省BOSS两级帐务接口规范
V 2.24
二○一四年四月
第 1 页 共 36 页
中国移动通信有限公司
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
文档变更记录
序号
1
2
初始化版本
1.对于EC帐单文件下发接口的使用进行了重新定义:详见2.6.1。
2.取消一点支付销帐接口。
1.修改2.5.4.2:
2.1.2.1.3.1.2.1.1业务区域类型增加枚举值:03香港(由于GPRS流量的资费在香港与其它国际和地方区域不一样,所以增加枚举值)
2.修改2.6.4.1.2. EC帐单下发文件命名规则
原来由于笔误:
BBOSS_ACC_E_BILL_000
_YYYYMMDD_
改为:
BBOSS_ACC_E_BILL_YYYYMMDD_000 _
将帐期(Term)拆分为计费(应收)帐期(BillingTerm)和销帐帐期(PayTerm)。
如果上传应收帐单是只填写计费(应收)帐期,PayTerm元素不填写.
如果上传实收帐单则必需计费(应收)帐期(BillingTerm)和销帐帐期(PayTerm)
1. 对清单与帐单的业务流程进行了重新描述;
2. 在EC帐单文件命名规范中增加帐单用途标记。
3. 在EC帐单文件接口增加了成员归属省代码(可选标记)(参见2.6.3.2),用于在下发帐单主办省,标明成员的归属省。
4. 增加了对于个人帐单代付的报销金额的判断(F071)。
5. EC帐单:F056“帐期大于等于当前月份,返回此错”改为:F056“帐期大于当前月份,返回此错”.
6. 全网集团编码位长改为32位
增加账单文件中UuseTag的描述(参见2.6.3.1.3)
变更内容说明 版本号
2.0
2.1
版本日期
2008-6-10
2008-6-10
杨渝
杨渝
执笔人
3
2.11 2009-02-19 杨渝
4
2.20 2009-08-28 杨渝
5
2.21 2010-3-31
6
2.21 2010-11-3 丁驰
第 2 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
2010-1-31
2011-1-31
丁弛
丁驰
7
8
修订账单文件中UuseTag的描述(参见2.6.3.1.3中实收结算流程)
增加2.6中UuseTag=6的预下发流程
1. 增加了UuseTag=7的下发流程,删除了UuseTag=6的预下发流程
2. 增加了分省支付的业务及接口流程
3. 修改了文中的描述,用支付省替代了主办省,用非支付省替代了配合省;对文中的流程图进行了修改;对文中的格式进行修改。
4.增加了2.6.4.2中成员号码支持固定电话的描述
5. 附录3.1省公司代码表增加“001 国际公司”
2.6.4.2数据文件格式中商品、产品和成员级FeeInfo下增加税率、税和不含税金额字段
2.5.3.2修订了业务量区域类型说明
2.6.1增加一点支付类业务营改增支撑说明
2.6.4.2增加省内计费话单费用项ID和费用项名称字段
2.21
2.22
9
2.23 2012-5-21
黄德光
10
2.24 2013-11-12
黄德光
11
2.24 2014-4-25
李翠芳
第 3 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
目 录
1. 概述 ...................................................................................................................................................................................... 6
1.1. 文档概述.................................................................................................................................................................................. 6
1.2. 参考文档.................................................................................................................................................................................. 6
1.3. 符号和缩略语 .......................................................................................................................................................................... 6
2. 接口规则定义 ...................................................................................................................................................................... 7
2.1. 文件的发送和获取 .................................................................................................................................................................. 8
2.2. 文件校验.................................................................................................................................................................................. 8
2.3. 文件命名规则和存放目录 ...................................................................................................................................................... 9
2.4. 文件格式约定 ........................................................................................................................................................................ 10
2.5. EC清单文件 .......................................................................................................................................................................... 11
2.5.1. 业务功能........................................................................................................................................................................ 11
2.5.2. 业务流程........................................................................................................................................................................ 11
2.5.2.1. 有限公司 一点受理、一点支付 ............................................................................................................................. 11
2.5.2.2. 主办省一点受理、一点支付 .................................................................................................................................. 12
2.5.3. 数据文件........................................................................................................................................................................ 13
2.5.3.1. 文件命名规则 ......................................................................................................................................................... 13
2.5.3.1.1. 上传文件命名规则 .......................................................................................................................................... 13
2.5.3.1.2. 下发文件命名规则 .......................................................................................................................................... 14
2.5.3.2. 数据文件格式 .......................................................................................................................................................... 14
2.5.4. 反馈文件........................................................................................................................................................................ 15
2.5.4.1. 文件命名规则 ......................................................................................................................................................... 15
2.5.4.1.1. 上传文件反馈文件命名规则 .......................................................................................................................... 15
2.5.4.1.2. 下发文件反馈文件命名规则 .......................................................................................................................... 15
2.5.4.2. 反馈文件格式 .......................................................................................................................................................... 15
2.6. EC帐务结算交互文件 .......................................................................................................................................................... 16
2.6.1. 业务功能........................................................................................................................................................................ 16
2.6.2. 业务流程........................................................................................................................................................................ 17
2.6.2.1. 有限公司 一点受理、一点支付 ........................................................................................................................... 17
2.6.2.2. 有限公司一点受理、分省支付 .............................................................................................................................. 19
2.6.2.3. 主办省一点受理、一点支付 ................................................................................................................................. 19
2.6.2.4. 主办省一点受理、分省支付 .................................................................................................................................. 21
2.6.2.5. 本省受理、本省支付 .............................................................................................................................................. 22
2.6.3. 接口流程........................................................................................................................................................................ 22
2.6.3.1. 分省出帐、一点合帐流程 ...................................................................................................................................... 23
2.6.3.1.1. 主办省一点受理、一点支付 .......................................................................................................................... 23
2.6.3.1.2. 有限公司一点受理、一点支付 ...................................................................................................................... 23
2.6.3.2. 一点出帐、分省结算 ............................................................................................................................................. 24
2.6.3.2.1. 主办省一点受理、一点支付 .......................................................................................................................... 24
2.6.3.2.2. 有限公司一点受理、一点支付 ...................................................................................................................... 25
2.6.3.2.3. 有限公司受理、分省支付;主办省受理、分省支付 .................................................................................. 26
2.6.3.3. SI结算 .................................................................................................................................................................... 27
第 4 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
2.6.3.3.1. 本省受理、本省支付 ...................................................................................................................................... 27
2.6.4. 数据文件........................................................................................................................................................................ 28
2.6.4.1. 文件命名规则 .......................................................................................................................................................... 28
2.6.4.1.1. 上传文件命名规则 ........................................................................................................................................... 28
2.6.4.1.2. 下发文件命名规则 ........................................................................................................................................... 28
2.6.4.2. 数据文件格式 .......................................................................................................................................................... 29
2.6.5. 反馈文件........................................................................................................................................................................ 31
2.6.5.1. 文件命名规则 ......................................................................................................................................................... 31
2.6.5.1.1. 上传文件反馈文件命名规则 .......................................................................................................................... 31
2.6.5.1.2. 下发文件反馈文件命名规则 ........................................................................................................................... 32
2.6.5.2. 反馈文件格式 .......................................................................................................................................................... 32
2.7. 文件对帐............................................................................................................................................................................... 33
2.7.1. 文件的传输 .................................................................................................................................................................... 33
2.7.2. 文件格式........................................................................................................................................................................ 33
2.7.2.1. 文件命名 ................................................................................................................................................................. 33
2.7.2.2. 文件格式说明 .......................................................................................................................................................... 33
2.7.3. 文件的传输 .................................................................................................................................................................... 34
2.7.4. 对帐文件的比对 ............................................................................................................................................................ 34
3. 附录 .................................................................................................................................................................................... 34
3.1. 省公司代码表 ....................................................................................................................................................................... 35
3.2. 成员代付出账一级费用项 .................................................................................................................................................... 35
第 5 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
1.
概述
1.1.
文档概述
一级BBOSS与省BOSS两级帐务接口实现了一级BBOSS与省BOSS之间上传清单数据、上传与下发帐单数据及下发销帐数据等功能。
1.2.
参考文档
《中国移动通信集团公司一级BOSS枢纽系统接口规范(V1.5.3)》
《中国移动通信集团公司一级BBOSS系统与省业务支撑系统接口规范》
1.3.
符号和缩略语
序号 名词
1 业务主办省
2
业务配合省
3
支付省
4
5
6
解释
指集团客户业务受理所在省
指在业务开通过程中,需要做网元开通的省
指集团客户做帐单支付的省
指计费系统每月按EC+PID(产品实例ID)+成员为关键字对流EC清单文件
量、时长和次进行累计。
是指集团客户使用中国移动提供的产品和服务,在一定的帐应收帐单
期应该支付的费用,帐期通常为自然月。
是指集团客户支付因为使用中国移动提供的产品和服务所产实收帐单
生的费用,这部份费用可以一个帐期也可以是多个帐期的。
是指在省BOSS代采话单后,根据EC+产品实例ID+成员号码一点支付销进行累计后(省BOSS也根据这部份清单出个人帐单),并帐 上传到有限公司进行计费,并在有限公司或者主办省一点支付(销帐)后,由一级BBOSS下发销帐记录给省公司进行个第 6 页 共 36 页
7
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
人帐单的销帐。(有限公司受理、分省支付和主办省受理、分省支付由成员归属省进行支付,成员归属省应对成员个人帐单销帐)。
8
帐单文件
由BBOSS计费或由省BOSS上传,用于BBOSS出帐或结算的应收或实收数据。
9 结算文件
由BBOSS按照一定的规则进行省间结算后生成的结入或结出数据,包括应收或实收。
2.
接口规则定
第 7 页 共 36 页
义
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
2.
2.1.
文件的发送和获取
本文件接口使用FTP协议发送和获取文件,文件发送和获取目录由中国移动通信有限公司一级BOSS枢纽系统确定。
2.2.
文件校验
文件接收方应对文件进行校验。
对于文件命名格式错误,由一级FTP枢纽将错误文件发送到文件发送方的错误目录下;
文件接收方在FTP枢纽取完文件后,应在FTP枢纽上删除;
对于文件级错误,一级BBOSS将全部拒收并通过错误反馈文件反馈给文件发送方;
对于文件级错误,文件发送方修正格式后重新发送的文件需要按照文件命名规范重新命名,避免重复。
对于记录级错误,将把出现错误的记录通过错误反馈文件反馈给文件发送方;
对于成功接收的文件, 将返回一个成功反馈文件给发送方;
如果业务开展省没有开展集团业务,或者此集团业务本月没有业务量,则必须上传一个按文件命名规则命名的空文件,对端系统应对此做相应处理,包含两个文件接口的空文件:
EC清单空文件
EC帐单空文件
第 8 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
2.3.
文件命名规则和存放目录
文件名
BBOSS_ACC_M_LIST_YYYYMMDD_ZZZ_
方向
省BOSS一级BBOSS
发送目录 接收目录 备注
EC清单文件(上传)
10.1.140.123// 10.1.140.123/$HOME/incomin//
g/bbss2
/$HOME/outgoing/bbss2
RESP_BBOSS_ACC_M_LIST_YY一级10.1.140.123// 10.1.140.123YYMMDD_ZZZ_
BBOSS
/$HOME/incomin//
省g/bbss2
/$HOME/outgoBOSS
ing/bbss2
BBOSS_ACC_M_LIST_YYYYMM一级10.1.140.123// 10.1.140.123DD_000_ZZZ.9999
BBOSS
/$HOME/incomin//
省g/bbss2
/$HOME/outgoBOSS
ing/bbss2
BBOSS_ACC_E_BILL_{UuseTag}_省10.1.140.123// 10.1.140.123YYYYMMDD_ZZZ_
BOSS/$HOME/incomin//
一级g/bbss2
/$HOME/outgoBBOSS
ing/bbss2
RESP_BBOSS_ACC_E_BILL__{Uu一级10.1.140.123// 10.1.140.123seTag}YYYYMMDD_ZZZ_S
/$HOME/incomin//
NN
省g/bbss2
/$HOME/outgoBOSS
ing/bbss2
BBOSS_ACC_E_BILL_{UuseTag}_一级10.1.140.123// 10.1.140.123YYYYMMDD_000_
BBOSS
/$HOME/incomin//
省g/bbss2
/$HOME/outgoBOSS
ing/bbss2
RESP_BBOSS_ACC_E_BILL_{Uus省10.1.140.123// 10.1.140.123eTag}_YYYYMMDD_000_/$HOME/incomin//
NN
一级g/bbss2
/$HOME/outgoBBOSS
ing/bbss2
BBOSS_ACC_E_BILL_YYYYMM省10.1.140.123// 10.1.140.123DD_000_ZZZ.9999
BOSS/$HOME/incomin//
一级g/bbss2
/$HOME/outgoBBOSS
ing/bbss2
备注:发送和接收目录由有限公司业务支撑部下发联调和上线计划中确定。
ACC—表示帐务相关;
ZZZ—表示文件三位省代码;
NNNN—表示文件序号,四位数字,从0000-9998,每天重复使用;
M—表示EC成员;
E—表示EC
LIST—表示清单;
BILL—表示帐单;
YYYYMMDD—表示发送文件当天的年月日;
第 9 页 共 36 页
EC清单反馈文件(下发)
EC清单对帐文件(下发)
EC帐单文件(上传)
EC帐单反馈文件(下发)
EC帐单文件(下发)
EC帐单反馈文件(上传)
EC帐单日对帐文件
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
反馈文件命名规则:RESP_[原文件名]
UuseTag指用途标记:
0. 省BOSS上传给BBOSS,用于BBOSS合帐的应收帐单;
1. 省BOSS上传给BBOSS,用于BBOSS给SI或者基地省结算的帐务数据。
2. BBOSS下发给非支付省,用于非支付省列收入的应收结入数据;
3. BBOSS下发给非支付省,用于非支付省销帐的实收结入数据;
4. BBOSS下发给支付省,用于集团客户在支付省出帐的应收帐单;
5. 支付省上传给BBOSS,用于BBOSS结算的实收帐单;
6. (作废)
7. BBOSS下发给支付省,用于支付省列支出的应结出数据;
营改增后,UuseTag=0/2/3/4/5/6/7的文件需要按不同税率上传和下发,一个税率对应一组数据,包括(费项,含税金额,税率,税额,不含税金额),UuseTag=1的文件这些节点不填。详细格式见数据文件格式章节;
2.4.
文件格式约定
文件是以XML格式表达的。在本文档中以表格的形式表示XML格式;以下为表格中对元素约束(出现次数)的表示方法的描述:
元素的约束条件使用以下符号表示
符号
?
*
+
1
XML的编码方式为UTF-8。
每个文件大小不超过2M。
0..1,可选项
0..n,可以没有,也可以有多项
1..n,至少有1项,也可以有多项
数字1,代表必须且只能填1项
含义
第 10 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
2.5.
EC清单文件
2.5.1.
业务功能
本接口文件用于省BOSS上传按集团客户成员某种话单类型按次累计、时长累计和流量累计的清单文件,用于在一级BBOSS计费。
2.5.2.
业务流程
流程中所有的文件接收方均需对文件格式校验(文件级)和业务逻辑校验(记录级)并反馈结果。
2.5.2.1.
有限公司 一点受理、一点支付
第 11 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
省BOSSBBOSS1.上传帐务清单文件2.计费出帐3.应收结算4.应收结算下发5.上传应收帐单6.计费合帐出帐7.应收结算8.应收结算下发9.缴费销帐11.实收结算下发10.实收结算
场景一:省BOSS上传清单,BBOSS计费出帐
1. 省BOSS每个帐期结束后,对受理模式为1.有限公司一点受理、一点支付的且产品规格定义需要上传帐务清单文件的订购,按成员上传;
2. BBOSS收到清单文件进行文件格式校验(文件级)和业务逻辑校验(记录级)后,向省BOSS反馈结果。
2.5.2.2.
主办省一点受理、一点支付
第 12 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
非支付省BBOSS支付省1.上传帐务清单文件1.上传帐务清单文件2.计费出帐3.下发应收帐单4.应收结算5.下发应收结入7.上传应收帐单6.下发应收结出7.上传应收帐单8.计费合帐出帐9.下发应收帐单10.应收结算11.下发应收结入12.下发应收结出14.上传实收帐单15.实收结算13.缴费销帐16.实收结算下发场景一:省BOSS上传清单,BBOSS计费出帐
1. 省BOSS每个帐期结束后,对受理模式为3.主办省一点受理、一点支付的且产品规格定义需要上传帐务清单文件的订购,按成员上传;
2. BBOSS收到清单文件进行文件格式校验(文件级)和业务逻辑校验(记录级)后,向省BOSS反馈结果。
2.5.3.
数据文件
2.5.3.1. 文件命名规则
2.5.3.1.1.
上传文件命名规则
BBOSS_ACC_M_LIST_YYYYMMDD_ZZZ_
ZZZ—指文件上传省公司代码。
其它的请参见本文档--2.3文件命名规则和存放目录.
第 13 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
2.5.3.1.2.
下发文件命名规则
BBOSS_ACC_M_LIST_YYYYMMDD_000_
ZZZ—指文件上传省公司代码。
其它的请参见本文档--2.3文件命名规则和存放目录.
2.5.3.2.
数据文件格式
根据XML的定义,每个XML文件需要有特定的Root Tag(根标记),在本文件中的Root Tag为“BillList”,各字段解释如下表
序号
1
2
2.1
2.1.1
2.1.2
2.1.2.1
父元素名称
BillList
BillList
ECList
ECInfo
ECInfo
元素名称
ProvCode
ECList
ECInfo
CustomerNumber
BizList
BizInfo
ProductID
约束
类型 长度
F3
——
——
V32
——
——
V11
F6
——
——
描述
文件发送方省代码
EC列表
EC信息列表
全网集团客户编码
业务列表
取值说明
全数字,格式: YYYYMM
三种格式:
0086+手机号码;
86+手机号码;
手机号码
1 String
1
+
——
——
1 String
1 ——
+ ——
1 String
1 String
1 ——
+ ——
BizList
2.1.2.1.1 BizInfo
2.1.2.1.2 BizInfo
2.1.2.1.3 BizInfo
2.1.2.1.3UserList
.1
2.1.2.1.3.1.1
2.1.2.1.3.1.2
2.1.2.1.3.1.2.1
User
Term
UserList
User
业务信息
产品订购实例ID
帐期
成员列表
一个成员信息
MSISDN 1 String V15 手机号码
User
AmountList
AmountList
AmountInfo
1
+
——
——
——
——
业务量信息
第 14 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
业务量的区域类型不在规范中统一约定,在每个使用清单的业务支撑方案中分别约定
2.1.2.1.3.1.2.1.1
2.1.2.1.3.1.3.1.2
AmountInfo AreaType 1 String F2 业务区域类型
AmountInfo Amount 1 String V15 业务量
2.5.4.
反馈文件
2.5.4.1.
文件命名规则
2.5.4.1.1.
上传文件反馈文件命名规则
RESP_BBOSS_ACC_M_LIST_YYYYMMDD_ZZZ_
2.5.4.1.2.
下发文件反馈文件命名规则
RESP_BBOSS_ACC_M_LIST_YYYYMMDD _000_
2.5.4.2.
反馈文件格式
根据XML的定义,每个XML文件需要有特定的Root Tag(根标记),在本文件中的Root Tag为“BillList”,各字段解释如下表
序号
1
2
3
父元素名称
BillList
BillList
BillList
元素名称
Org_FileName
Resp_Date
FileStatus
约类型
束
1 String
1
1
String
String
长度
V100
F14
F1
描述
原始文件名
反馈时间
文件状态
取值说明
YYYYMMDDHHMMSS
0 成功处理
1 文件级错误
2 记录级错误
当FileStatus为1时有此节点填写
4
BillList ErrorCode ? String V4 文件级错误代码
第 15 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
V256
F4
V256
文件级错误节点
记录级错误代码
错误文本记录(字段之间以逗号分隔)
当FileStatus节点填写
当FileStatus节点
当FileStatus节点填写
当FileStatus节点填写
为1时有此为2生成此5
6
6.1
6.1.1
6.1.2
BillList
BillList
ErrorRecords
ErrorRecord
ErrorRecord
ErrorNode
ErrorRecords
ErrorRecord
ErrorCode
ErrorNode
?
?
*
?
?
String
String
String
为2时有此为2时有此
2.6.
EC帐务结算交互文件
2.6.1.
业务功能
本接口涉及文件的范围:
• 省BOSS上传给BBOSS, 用于BBOSS合帐的应收帐单, UuseTag=0;
• 省BOSS上传给BBOSS,用于BBOSS给SI或者基地省结算的帐务数据及上传成员账单代付业务成员出账一级费用, UuseTag=1;
• BBOSS下发给支付省,用于集团客户在支付省出帐的应收帐单, UuseTag=4;
• 支付省上传给BBOSS,用于BBOSS结算的实收帐单, UuseTag=5;
• BBOSS下发给非支付省,用于非支付省列收入的应收结入数据, UuseTag=2;
• BBOSS下发给非支付省,用于非支付省销帐的实收结入数据, UuseTag=3;
• BBOSS下发给支付省,用于支付省列支出的应结出数据, UuseTag=7;
说明:
1、营改增后,两级之间均需分税率传商品、产品费用,交互信息包括费用项ID、费用(含税金额)、税率、税额、不含税金额,详细格式见数据文件格式章节。
2、营改增后成员费用,目前包括集团客户成员账单代付(产品编码为99903、99902)、跨省行业应用卡(产品编码911601)、M2M通道型(产品编码110802、110803)业务,两级间的交互要求为:
➢ 对集团客户成员账单代付业务,不再上传代付总额。
➢ M2M通道型、行业应用卡两级之间均需价税分离上传,费项ID不做调整,交互信息包括包括费用(含税金额)、税率、税额、不含税金额
➢ 成员账单代付:代付费用按省内最细账单费用项上传,包括(省内费项标识、省内费项名称、费用(含税金额)、税率、税额、不含税金额,号码归属省使用UuseTag=0上传,
第 16 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
一级BBOSS用UuseTag=4、UuseTag=7下发支付省应收及结出数据,一级BBOSS适用UuseTag=2、UuseTag=3下发非支付省应收及销赃数据。
➢ 成员出账费用:目前系统中成员账单代付的分套餐及固定费、语音通信费、上网费、短信/彩信费、增值业务费、代收业务费、其他费用、优惠及减免8个费项上传的成员出账费用不做调整,无需按价税分离上传,仅上传费用(含税金额),使用Uusetag=1。
文件的格式和内容见2.6.4章节。
2.6.2.
业务流程
流程中所有的文件接收方均需对文件格式(文件级)和业务逻辑(记录级)进行校验,并反馈结果。
2.6.2.1.
有限公司 一点受理、一点支付
第 17 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
省BOSSBBOSS1.上传帐务清单文件2.计费出帐3.应收结算场景一4.应收结算下发5.上传应收帐单6.计费合帐出帐场景二8.应收结算下发7.应收结算9.缴费销帐场景三11.实收结算文件下发10.实收结算流程描述:
场景一:BBOSS计费出帐
1. BBOSS对总部自行计费的客户进行出帐;
2. BBOSS按如下规则进行结算:a.集团客户归属省 b.成员归属省 c.业务接入省,然后向各省下发对应的应收结算。
场景二:省BOSS上传帐单给BBOSS合帐
1. 省BOSS在月初上传上月的应收帐单,用于BBOSS合帐、结算;
2. BBOSS合帐出集团客户应收帐单;
3. BBOSS按如下规则进行应收结算:a.集团客户归属省 b.成员归属省 c. 业务接入省,然后向各省下发对应的应收结算。
场景三:BBOSS完成实收结算后,下发实收结算文件
在BBOSS进行缴费销帐后,BBOSS按如下规则进行实收结算:a.集团客户归属省 b.成员归属省 c. 业务接入省,然后向各省下发对应的实收结算;
第 18 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
2.6.2.2.
有限公司一点受理、分省支付
有限公司一点受理、分省支付包括两种情况:
1. 有限公司受理,各省自行计费、出帐和缴费,此情况不做结算,没有帐务结算文件交互;
2. 有限公司受理,指定省支付,帐务结算文件交互流程如下:
支付省BBOSS非支付省1.计费出帐2.下发应收帐单场景一4.下发应收结出6.缴费销帐7.上传实收帐单8.实收结算9.下发实收结算3.应收结算5.下发应收结入场景二
场景一:应收结算下发
1. BBOSS对总部自行计费的客户进行出帐,然后向支付省下发集团客户应收帐单;
2. BBOSS按如下规则进行结算:a.集团客户归属省 b.成员归属省 c.业务接入省,然后向支付省下发对应的应收结出,向非支付省下发对应的应收结入;
场景二:BBOSS完成实收结算后,下发实收结算文件
1. 支付省BOSS在月初上传上月的实收帐单,用于支付结算;
2. 对于采用应收进行结算的情况,不需要支付省上传实收帐单,BBOSS用当月的应收进行结算;
3. BBOSS按如下规则进行结算:a.集团客户归属省 b.成员归属省 c. 业务接入省,然后向非支付省下发对应的实收结入。
2.6.2.3.
主办省一点受理、一点支付
第 19 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
非支付省BBOSS支付省1.上传帐务清单文件1.上传帐务清单文件2.计费出帐3.下发应收帐单场景一5.下发应收结入7.上传应收帐单4.应收结算6.下发应收结出7.上传应收帐单8.计费合帐出帐场景二9.下发应收帐单10.应收结算11.下发应收结入12.下发应收结出14.上传实收帐单13.缴费销帐场景三16.实收结算文件下发15.实收结算
流程描述:
场景一:BBOSS计费出帐
1) BBOSS对总部自行计费的客户进行出帐,然后向支付省下发集团客户应收帐单;
2) BBOSS按如下规则进行结算:a.集团客户归属省 b.成员归属省 c.业务接入省,然后向支付省下发对应的应收结出,向非支付省下发对应的应收结入。
场景二:省BOSS上传帐单给BBOSS合帐
1) 省BOSS在月初上传上月的应收帐单,用于BBOSS合帐、结算;
2) BBOSS合帐出帐,然后向支付省下发集团客户应收帐单;
3) BBOSS按如下规则进行应收结算:a.集团客户归属省 b.成员归属省 c.业务接入省,然后向支付省下发对应的应收结出,向非支付省下发对应的应收结入。
场景三:BBOSS完成实收结算后,下发实收结算文件
1) 支付省BOSS在月初上传上月的实收帐单,用于支付结算;
2) 对于采用应收进行结算的情况,不需要支付省上传实收帐单,BBOSS用当月的应收进行结算;
第 20 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
3) BBOSS按如下规则进行结算:a.集团客户归属省 b.成员归属省 c.业务接入省,然后向非支付省下发对应的实收结入。
2.6.2.4.
主办省一点受理、分省支付
主办省一点受理、分省支付包括两种情况:
1. 主办省受理,各省自行计费、出帐和缴费,此情况不做结算,没有帐务结算文件交互;
2. 主办省受理,指定省支付,帐务结算文件交互流程如下:
支付省BBOSS非支付省1.计费出帐2.下发应收帐单场景一4.下发应收结出6.缴费销帐7.上传实收帐单8.实收结算9.下发实收结算3.应收结算5.下发应收结入场景二
场景一:应收结算下发
1. BBOSS对总部自行计费的客户进行出帐,然后向支付省下发集团客户应收帐单;
2. BBOSS按如下规则进行结算:a.集团客户归属省 b.成员归属省 c.业务接入省,然后向支付省下发对应的应收结出,向非支付省下发对应的应收结入;
场景二:BBOSS完成实收结算后,下发实收结算文件
1. 支付省BOSS在月初上传上月的实收帐单,用于支付结算;
2. 对于采用应收进行结算的情况,不需要支付省上传实收帐单,BBOSS用当月的应收进行结算;
3. BBOSS按如下规则进行结算:a.集团客户归属省 b.成员归属省 c. 业务接入省,然后向非支付省下发对应的实收结入。
第 21 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
2.6.2.5.
本省受理、本省支付
省BOSSBBOSS1.上传应收帐单场景一3.应收结算4.缴费销帐4.上传实收帐单场景二6.实收结算
场景一:省BOSS上传应收帐单,BBOSS用于运营支撑费用或者基地省的结算
1. 省BOSS对受理模式为5.本省受理、本省支付的订购在月初上传上月的应收帐单;
场景二:省BOSS上传实收帐单,BBOSS用于运营支撑费用或者基地省虚拟的实收结算
1. 省BOSS对受理模式为5.本省受理、本省支付的订购在月初上传上月的实收帐单;
2.6.3.
接口流程
分批出帐场景下,不同UuseTag文件在业务中的扭转参考流程。
第 22 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
2.6.3.1.
分省出帐、一点合帐流程
集团客户成员账单代付、M2M通道型产品、企业飞信等业务。
2.6.3.1.1.
主办省一点受理、一点支付
非支付省BBOSS计费结算支付省每月2日前出帐后的应收帐单,UuseTag=4每月2日前应收结入文件,UuseTag=2每月2日前应收结出文件,UuseTag=7不包括省公司上传的数据 每月4日前上传本省账单,UuseTag=0每月4日前上传本省账单,UuseTag=0合帐 每月8日前合帐后的应收账单,UuseTag=4应收结算每月10日前应收结入文件,UuseTag=2每月10日前应收结出文件,UuseTag=7省公司上传的数据EC缴费、销账每月4日前上传实收销账账单,UuseTag=5实收结算每月10日前实收结算文件,UuseTag=3销账
2.6.3.1.2.
有限公司一点受理、一点支付
第 23 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
省BOSSBBOSS计费出帐结算每月2日前应收结算文件,UuseTag=2不包括省公司上传的数据每月4日前上传本省账单,UuseTag=0合帐应收结算每月10日前应收结算文件,UuseTag=2省公司上传的数据EC缴费、销账每月10日前实收结算文件,UuseTag=3销账实收结算
2.6.3.2.
一点出帐、分省结算
2.6.3.2.1.
主办省一点受理、一点支付
第 24 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
非支付省BBOSS计费出账支付省每月2日前出帐后的应收帐单,UuseTag=4应收结算每月2日前应收结入文件,UuseTag=2每月2日应收结出文件,UuseTag=7EC缴费、销账每月4日前上传实收账单,UuseTag=5每月10日前实收结入文件,UuseTag=3实收结算销账
2.6.3.2.2.
有限公司一点受理、一点支付
第 25 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
省BOSSBBOSS计费出账 每月2日前应收结算文件,UuseTag=2EC缴费、销账每月10日前实收结算文件,UuseTag=3
2.6.3.2.3.
有限公司受理、分省支付;主办省受理、分省支付
分省支付包括两种情况:
1.各省自行计费、出帐和缴费,此情况不做结算,没有帐务结算文件交互;
2.指定省支付,帐务结算文件交互流程如下:
第 26 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
非支付省BBOSS计费出帐支付省每月2日前出帐后的应收帐单,UuseTag=4应收结算每月2日前应收结入文件,UuseTag=2每月2日应收结出文件,UuseTag=7EC缴费、销账每月4日前上传实收销账账单,UuseTag=5每月10日前实收结入文件,UuseTag=3实收结算销账
2.6.3.3.
SI结算
400、车务通、本省ADC、农政通等
2.6.3.3.1.
本省受理、本省支付
第 27 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
BBOSS省BOSS计费出账每月4日前上传应收或实收账单,UuseTag=1结算
2.6.4.
数据文件
2.6.4.1.
文件命名规则
2.6.4.1.1.
上传文件命名规则
BBOSS_ACC_E_BILL_{UuseTag}_YYYYMMDD_ZZZ_
ZZZ—指文件上传省公司代码。
UuseTag指用途标记:
UuseTag=0: 帐务合帐帐单——省BOSS上传给BBOS,用于BBOSS合帐的帐单;
UuseTag=1: SI结算帐单——省BOSS上传给BBOSS,用于BBOSS SI费用结算或者基地省结算的帐单;成员帐单一点支付——省BOSS上传给BBOSS,用于BBOSS生成成员帐单一点支付一级费用项清单;
UuseTag=5: 支付省实收帐单——支付省上传给BBOSS,用于BBOSS结算的实收帐单;
其它的请参见本文档——2.3文件命名规则和存放目录。
2.6.4.1.2.
下发文件命名规则
BBOSS_ACC_E_BILL_{UuseTag}_YYYYMMDD_000_
ZZZ:表示文件接收方省代码;
UuseTag指用途标记:
第 28 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
UuseTag=4:支付省应收帐单-BBOSS下发给支付省,用于集团客户在支付省出帐的应收帐单;
UuseTag=2:非支付省应收结入-BBOSS下发给非支付省,用于非支付省列收入的应收结算;
UuseTag=3:非支付省实收结入-BBOSS下发给非支付省,用于非支付省销帐的实收结算;
UuseTag=7:支付省应收结出-BBOSS下发给支付省,按应收帐单计算出的支付省应结出费用;
其它的请参见本文档--2.3文件命名规则和存放目录。
2.6.4.2.
数据文件格式
根据XML的定义,每个XML文件需要有特定的Root Tag(根标记),在本文件中的Root
Tag为“BillList”,各字段解释如下表
序号 父元素名称 元素名称
约束
类型 长度 描述
文件发送方或者接收方省代码
应收或者实收标记
EC列表
EC信息列表
EC集团客户编码
业务列表
业务的信息
商品实例ID
计费帐期
销帐帐期
费用信息
商品费用项ID
取值说明
省BOSS上传到BBOSS:
填写上传省公司代码;
一级BBOSS下发到省BOSS:
填写接收省公司代码;
0. 应收
1. 实收
6位数字,格式:YYYYMM
6位数字,格式:YYYYMM,实收帐单填写
请参见业务支撑部下发有关业务的说明文件中的商品费用项ID。
单位厘
1 BillList ProvCode 1 String F3
2
3
3.1
3.1.1
3.1.2
3.1.2.1
3.1.2.1.1
3.1.2.1.2
3.1.2.1.3
3.1.2.1.4
3.1.2.1.4.1
3.1.2.1.4.1.1
3.1.2.1.4.1.2
3.1.2.1.4.1.3
BillList
BillList
ECList
ECInfo
ECInfo
BizList
BizInfo
BizInfo
BizInfo
BizInfo
FeeList
FeeInfo
FeeInfo
FeeInfo
PayTag
ECList
ECInfo
CustomerNumber
BizList
BizInfo
ProductOfferingID
BillingTerm
PayTerm
FeeList
FeeInfo
POChargeCode
FeeVal
TaxRate
1
1
+
1
1
+
1
1
?
?
+
1
1
1
String
——
——
String
--
——
String
String
String
——
——
String
Num
Num
F1
——
——
V32
--
——
V11
F6
F6
——
——
V20
V16.0 费用
V3.2 税率
第 29 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
V16.0 税
V16.0 不含税费用
——
V20
——
——
V20
产品实例ID
费用信息
产品费用项ID
单位厘
单位厘
请参见业务支撑部下发有关业务的说明文件中的产品费用项ID。
单位厘
单位厘
单位厘
3.1.2.1.4.1.4
3.1.2.1.4.1.5
3.1.2.1.5
3.1.2.1.5.1
3.1.2.1.5.1.1
3.1.2.1.5.1.2
3.1.2.1.5.1.2.1
3.1.2.1.5.1.2.1.1
3.1.2.1.5.1.2.1.2
3.1.2.1.5.1.2.1.3
3.1.2.1.5.1.2.1.4
3.1.2.1.5.1.2.1.5
3.1.2.1.5.1.3
3.1.2.1.5.1.3.1
FeeInfo
FeeInfo
BizInfo
ProductList
ProductInfo
ProductInfo
FeeList
FeeInfo
FeeInfo
FeeInfo
FeeInfo
FeeInfo
ProductInfo
Tax
FeeNoTax
ProductList
ProductInfo
ProductID
FeeList
FeeInfo
ProductChargeCode
1
1
?
+
1
?
+
1
1
1
1
1
Num
Num
——
String
——
——
String
Num
Num
Num
Num
FeeVal
TaxRate
Tax
FeeNoTax
V16.0 费用
V3.2
V16.0
税率
税
V16.0 不含税费用
UserList
User
?
+
——
——
——
——
成员列表
一个成员信息
按成员计费的业务有此节点
UserList
3.1.2.1.5.1.3.1.1
四种格式:
0086+手机号码(11位);
86+手机号码(11位);
手机号码(11位)
User
MSISDN
1
String
V15
手机号码
固定电话(10-12位)
一个账期一个成员仅能出现一次本节点,该成员所有费用项必须都在此节点下
3.1.2.1.5.1.3.1.2
3.1.2.1.5.1.3.1.3
3.1.2.1.5.1.3.1.3.1
User
User
FeeList
MemProvCode
FeeList
FeeInfo
? String
1
+
——
——
3
——
——
成员归属省代码
费用信息
参见附录《省公司代码表》
第 30 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
请参见业务支撑部下发有关业务的说明文件中的产品费用项ID
3.1.2.1.5.1.3.1.3.1.1
3.1.2.1.5.1.3.1.3.1.2
3.1.2.1.5.1.3.1.3.1.3
3.1.2.1.5.1.3.1.3.1.4
3.1.2.1.5.1.3.1.3.1.5
FeeInfo
ProductChargeCode
1
String
V20
产品费用项ID
FeeInfo FeeVal 1 Num V16.0 费用
省内计费话单费用项ID
省内计费话单费用项名称
单位:厘
仅适用于成员账单代付Uusetag!=1的场景,其他场景无此节点
仅适用于成员账单代付Uusetag!=1的场景,其他场景无此节点
Uusetag=1时无此节点;Uusetag=0/2/3/4/5/6/7时此节点必填
单位厘
Uusetag=1时无此节点;Uusetag=0/2/3/4/5/6/7时此节点必填
单位厘
Uusetag=1时无此节点;Uusetag=0/2/3/4/5/6/7时此节点必填
FeeInfo CDRChargeCode ? String V20
FeeInfo CDRChargeName ? String V20
FeeInfo TaxRate ? Num V3.2 税率
3.1.2.1.5.1.3.1.3.1.6
FeeInfo Tax ? Num V16.0 税
3.1.2.1.5.1.3.1.3.1.7
FeeInfo FeeNoTax ? Num V16.0 不含税费用
2.6.5.
反馈文件
2.6.5.1.
文件命名规则
2.6.5.1.1.
上传文件反馈文件命名规则
RESP_BBOSS_ACC_E_BILL_{UuseTag}_YYYYMMDD_ZZZ_
其中:BBOSS_ACC_E_BILL_{UuseTag}_YYYYMMDD_ZZZ_是指原文件名。
第 31 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
2.6.5.1.2.
下发文件反馈文件命名规则
RESP_BBOSS_ACC_E_BILL_{UuseTag} _YYYYMMDD_000_
其中:BBOSS_ACC_E_BILL_{UuseTag} _YYYYMMDD_000_是指原文件名。
2.6.5.2.
反馈文件格式
根据XML的定义,每个XML文件需要有特定的Root Tag(根标记),在本文件中的Root Tag为“BillList”,各字段解释如下表
序号
1
2
3
父元素名称
BillList
BillList
BillList
元素名称
Org_FileName
Resp_Date
FileStatus
约类型
束
1 String
1
1
String
String
长度
V100
F14
F1
描述
原始文件名
反馈时间
文件状态
取值说明
YYYYMMDDHHMMSS
0 成功处理
1 文件级错误
2 记录级错误
当FileStatus为此节点填写
当FileStatus为此节点填写
当FileStatus为此节点
当FileStatus为此节点填写
当FileStatus为此节点填写
4
5
6
6.1
6.1.1
6.1.2
BillList
BillList
BillList
ErrorRecords
ErrorRecord
ErrorRecord
ErrorCode
ErrorNode
ErrorRecords
ErrorRecord
ErrorCode
ErrorNode
?
?
?
*
?
?
String
String
String
String
V4
V256
F4
V256
文件级错误代码
文件级错误节点
记录级错误代码
错误文本记录(字段之间以逗号分隔)
1时有1时有2生成2时有2时有
第 32 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
2.7.
文件对帐
2.7.1.
文件的传输
一级BBOSS系统每日凌晨3点向省BOSS发送一次日对帐文件,日对帐文件主要核对BBOSS昨日发送和接收的数据文件和反馈文件列表。
2.7.2.
文件格式
2.7.2.1.
文件命名
对于帐单、清单的两个接口,分别生成对帐文件下发省BOSS。
命名如下:
1. EC清单对帐文件:
BBOSS_ACC_M_LIST_YYYYMMDD_000_ZZZ.9999
2. EC帐单对帐文件:
BBOSS_ACC_E_BILL_YYYYMMDD_000_ZZZ.9999
2.7.2.2.
文件格式说明
根据XML的定义,每个XML文件需要有特定的Root Tag(根标记),在本文件中的Root Tag为“FileList”.各个字段解释如下表
序号
父元素名称
元素名称 约束 类型 长度 描述
对帐日期
BOSS系统发送的数据文件信息
发送的数据文件总数
发送数据文件名列表
BOSS发送的文件名
取值说明
YYYYMMDD
1
2
2.1
2.2
2.2.1
2.2.2
FileList
FileList
SendDataList
SendDataList
FileInfo
FileInfo
CheckDate
SendDataList
FileCount
FileInfo
FileName
FileSum
1
+
1
*
1
1
String
—
String
—
String
String
F8
—
V5
-
V64
V20
BOSS系统内该数据包的唯一标识
文件的金额或者流量合计
第 33 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
—
V5
-
V64
—
V5
-
V64
V20
—
V5
-
V64
BOSS系统发送的反馈文件信息
发送的反馈文件总数
发送反馈文件名列表
BOSS发送的文件名
BOSS系统接收的数据文件信息
接收数据文件总数
接收数据文件名列表
BOSS接收的文件名
BOSS系统内该数据包的唯一标识
3
3.1
3.2
3.2.1
4
4.1
4.2
4.2.1
4.2.2
5
5.1
5.2
5.2.1
FileList
SendRespList
SendRespList
FileInfo
FileList
ReceDataList
ReceDataList
FileInfo
FileInfo
FileList
ReceRespList
ReceRespList
FileInfo
SendRespList
FileCount
FileInfo
FileName
ReceDataList
FileCount
FileInfo
FileName
FileSum
ReceRespList
FileCount
FileInfo
FileName
+
1
*
1
+
1
*
1
1
+
1
*
1
—
String
—
String
—
String
—
String
String
—
String
—
String
BOSS系统内该数据包的唯一标识
文件的金额或者流量合计
BOSS系统接收的反馈文
件信息
文件总数
接收反馈文件名列表
BOSS接收的文件名
文件总数
BOSS系统内该数据包的唯一标识
2.7.3.
文件的传输
BBOSS系统在每日凌晨3点,生成昨日的日对帐文件后,通过FTP put到文件服务器的下面目录中。省BOSS 3点后到文件服务器的相应目录中去取日对帐文件,然后从一级FTP服务器删除。
2.7.4.
对帐文件的比对
使用自动/人工方式比对,如发现差错,可人工干预或系统自动干预。
3.
附录
第 34 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
3.
3.1.
省公司代码表
100
200
210
220
230
240
250
270
280
290
311
351
371
431
451
471
北京
广东
上海
天津
重庆
辽宁
江苏
湖北
四川
陕西
河北
山西
河南
吉林
黑龙江
内蒙古
531
551
571
591
731
771
791
851
871
891
898
931
951
971
991
山东
安徽
浙江
福建
湖南
广西
江西
贵州
云南
西藏
海南
甘肃
宁夏
青海
新疆
有限公000
司
国际公001 司
3.2.
成员代付出账一级费用项
费用项名称
套餐及固定费
费用项ID
YDZF01
第 35 页 共 36 页
错误!未知的文档属性名称
一级BBOSS与省BOSS两级帐务接口规范
语音通信费
YDZF02
上网费
YDZF03
短信/彩信费
YDZF04
增值业务费
YDZF05
代收业务费
YDZF06
其他费用
YDZF07
优惠及减免
YDZF08
第 36 页 共 36 页


发布评论