基地业务平台结算数据接口规范v10.docx
《基地业务平台结算数据接口规范v10.docx》由会员分享，可在线阅读，更多相关《基地业务平台结算数据接口规范v10.docx（53页珍藏版）》请在冰豆网上搜索。
基地业务平台结算数据接口规范v10
增值业务基地平台结算数据
接口规范（V1.1）
中国电信全国计费结算中心
目录
1.计费结算业务流程5
2.数据交换流程7
2.1.正常处理流程7
2.2.拒收处理流程7
2.2.1.基地平台拒收全国计费结算中心下发话单文件的处理流程7
2.3.错误处理流程8
2.3.1.全国计费结算中心和基地平台错误处理流程8
3.数据交换接口和格式检错标准9
3.1.基地上传文件9
3.1.1.拒收话单文件9
3.1.1.1.拒收文件命名规则9
3.1.1.2.文件级错误校验规则9
3.1.1.3.文件名错误规则10
3.1.2.错误话单文件10
3.1.2.1.话单级错误校验11
3.1.2.2.错误话单文件命名11
3.1.2.3.错误文件格式11
3.1.2.3.1.头记录11
3.1.2.3.2.记录体12
3.1.2.3.3.尾记录12
3.1.3.QC确认文件12
3.1.3.1.文件格式13
3.1.3.2.交换频度13
3.1.3.3.传输协议13
3.2.全国计费结算中心下发文件13
3.2.1.正常话单13
3.2.1.1.描述13
3.2.1.2.文件格式13
3.2.1.2.1.文件命名规则13
3.2.1.2.2.文件头/尾记录14
3.2.1.2.3.话单格式与话单级校验标准15
3.2.1.3.方向20
3.2.1.4.交换频度20
3.2.1.5.传输协议21
3.2.2.空话单文件21
3.2.2.1.话单级错误校验21
3.2.2.2.空话单文件命名21
3.2.2.3.空文件格式21
3.2.2.3.1.头记录21
3.2.2.3.2.记录体22
3.2.2.3.3.尾记录22
3.3.全国计费结算中心下发pid汇总文件22
3.3.1.文件格式22
3.3.1.1.文件命名规则22
3.3.1.2.文件头/尾记录23
3.3.1.2.1.文件头记录格式23
3.3.1.2.2.文件尾记录格式23
3.3.1.3.文件内容23
3.3.1.4.方向24
3.3.1.5.交换频度24
3.3.1.6.传输协议24
4.基地主机目录定义24
5.接口目录维护要求24
6.文件发送与接收要求25
7.系统启停要求25
修订记录
日期
章节
修改说明
1.计费结算业务流程
同步产品信息
申请CP，发布内容
同步产品信息
同步计费话单
上传话单
下传业务详单、PID汇总表、分省结算报表
退费信息
生成CP结算表
核对账单
调整分省结算表
分省结算单盖章
将需结算给CP、COP的资金汇总后划拨基地省
查看结算单
支付结算费
1）CP通过基地业务平台进行CP注册、内容上架申请，根据发布内容生成相应的PID及计费URL，基地业务平台负责维护CP与PID之间的对应关系。
2）在新业务上线开通之前，基地需将新业务信息（SPID、PID、业务能力编码，结算规则等，参见附件）打印，由基地及集团公客盖章后传给集团IT部做数据配置。
3）基地省定期将业务平台上新增或变更的相关产品信息及PID录入NMSC，由NMSC负责将产品信息同步给各省ISMP。
ISMP负责提供话单给省计费结算系统，再传到全国计费结算中心。
4）全国计费结算中心根据SPID将话单分拣生成归属基地结算详单、PID/SPID汇总表和分省结算表给基地平台。
5）基地省根据PID/SPID汇总表、CP下的产品编码PID、结算比例的对应关系，生成对CP、COP结算单。
基地根据各省提交的违约、先行赔付等事项对分省分摊表进行调整，形成最终的各省结算报表。
6）集团公众客户事业部每月负责从基地取分省结算表并核对后打印盖章同时发至集团财务部及基地。
a）每月2日全国计费结算中心给出基于详单的结算账单，基地根据全国计费结算中心给出的账单于每月3日给出SP结算报表及对各省的最终结算报表（含调账）。
b）各省收到结算账单后，由各省业务部门会同IT部将结算数据分摊到本地网。
7）集团财务部及各省财务部根据基地提供的分省结算账单进行内部资金转账处理。
8）基地负责协助基地省财务部进行与CP/COP结算。
2.数据交换流程
2.1.正常处理流程
1.各省计费结算中心将从ISMP话单文件中分拣出用户使用全国业务的数据（包含基地业务话单），上传给全国计费结算中心进行结算。
（此流程包含在现有的ISMP话单上传流程中）
2.全国计费结算中心将各省ISMP平台上传的基地业务详细计费话单下发至基地平台。
3.基地平台对收到的计费话单进行处理入库。
2.2.拒收处理流程
2.2.1.基地平台拒收全国计费结算中心下发话单文件的处理流程
基地平台拒收全国计费结算中心上传话单文件的处理流程如下所示：
1）基地平台接收全国计费结算中心转发的话单文件。
2）基地平台接收到话单文件后，发确认文件给全国计费结算中心。
3）基地平台接收到文件后，及时处理。
4）系统自动对系统的文件名和头尾记录按文件名和文件级错误校验规则进行校验，一遇到错误，系统自动生成拒收话单文件，上传给全国计费结算中心。
在原文件名前加5位拒收错误代码为拒收文件名。
拒收文件的内容不变，同原全国计费结算中心文件的内容。
文件名检错规则、文件头尾记录检错规则的详细描述参见第3章全国计费结算中心的拒收话单文件章节。
5）全国计费结算中心接收到拒收文件后，应发起人工处理流程，对拒收话单文件进行解码，检查拒收原因，是否与拒收话单文件的文件名的前5位错误代码一致。
2.3.错误处理流程
2.3.1.全国计费结算中心和基地平台错误处理流程
基地平台接收到全国计费结算中心下发的话单，进行判断，若发现是文件记录属性取值错误，根据错误编码定义，生成错误话单文件给发送方。
基地平台接收全国计费结算中心下发话单文件的错误处理流程如下所示：
1）基地平台接收全国计费结算中心转发的各类话单文件。
2）基地平台接收到话单文件后，发确认文件给全国计费结算中心。
3）基地平台接收到文件后，及时处理。
4）系统自动对系统的文件名和头尾记录按文件名和文件级错误校验规则进行校验。
5）文件名或文件级错误校验通过后，系统接收文件，及时进行错误处理。
6）自动对话单文件每条话单记录按话单级校验标准进行逐条判断，话单级校验标准参见第3章基地平台正常话单文件章节中每种话单的话单格式与话单级校验标准。
并按第3章节基地平台错误话单文件的命名规则和格式要求生成错误话单文件。
7）全国计费结算中心接收到错误话单文件后，启动人工处理流程，对错单文件进行解码，检查拒收原因，是否与错误代码一致。
3.数据交换接口和格式检错标准
本章根据上一章的各具体流程，对数据接口（文件格式、检错标准、交换频度、传输协议）进行描述，包括：
全国计费结算中心下发话单文件；基地平台上传文件。
基地平台上传的文件、全国计费结算中心下发的话单文件均采用ASN.1格式。
基地平台上传文件包括拒收话单文件、错误话单文件、QC确认文件。
全国计费结算中心下发文件包括正常话单文件、空话单文件。
3.1.基地上传文件
3.1.1.拒收话单文件
基地平台接收全国计费结算中心下发的话单文件，按文件名和文件级错误校验规则进行校验，一遇到错误，系统自动生成拒收话单文件，上传给全国计费结算中心。
3.1.1.1.拒收文件命名规则
原文件名前加上5位拒收错误代码，如：
F1001IOSMP_20091010111.0001
拒收文件名格式为：
FxxxxIOSMP_YYYYMMDDZZZ.NNNN
其中Fxxxx为拒收号码
YYYYMMDD：
为文件时间
ZZZ：
为基地平台号
NNNN：
四位序列号（0001-0096）
3.1.1.2.文件级错误校验规则
注1：
拒收文件的修复后上传是需要用新文件名。
注2：
由于话单格式的话费，应直接累计话单的话费金额，再把累加值四舍五入，填入尾记录相应的话费合计字段。
检验尾记录时，允许话单的话费累计值与尾记录话费合计值之间误差小于1分钱。
注3：
尾记录中只针对费用总计和记录总数进行校验。
错误代码
错误描述
F1200
头记录格式不正确。
头记录必须以“10”开头
F1201
尾记录格式不正确。
尾记录必须以“90”开头
F1300
头记录版本号不正确，目前指不是“10”
F1400
文件名中的省代码与头记录中的描述不一致
F1401
文件名中的省代码与尾记录中的描述不一致
F1500
文件名中的文件序号与头记录中的描述不一致
F1501
文件名中的文件序号与尾记录中的描述不一致
F1700
尾记录中的通话次数合计值与文件中的话单总数不等
F1904
尾记录中的总话费合计值与话单文件中总费用累计值不等。
3.1.1.3.文件名错误规则
错误代码
错误描述
F8000
文件名格式错误
F8001
文件名中的日期不合法
F8002
文件名日期大于当前系统日期加一天（即：
今天收到了后天及以后的话单，则F8002拒收）
如遇文件跳号情况（当前处理的文件与上一个成功接收的文件序号不连续），该文件仍然会被基地平台接收，系统写Log记录检测到的跳号情况。
其他文件名异常情况，均会以F文件打回。
注：
文件跳号不拒收，记录告警日志。
3.1.2.错误话单文件
基地平台收到一个没有文件级错误的话单文件，则对该文件进行话单级校验，若发现有严重错误，则系统自动生成错误话单文件，上传给全国计费结算中心。
文件命名方法为在原文件前加上前缀“E”。
3.1.2.1.话单级错误校验
详见文件类型的格式说明。
3.1.2.2.错误话单文件命名
错误文件名格式为：
EIOSMP_YYYYMMDDZZZ.NNNN
其中YYYYMMDD：
为文件时间
ZZZ：
为基地平台号
NNNN：
四位序列号（0001-0096）
3.1.2.3.错误文件格式
3.1.2.3.1.头记录
字段名称
类型
最大长度
Tag
有效值
记录类型
INTEGER
4
50
10
拜访局代码
ASCIISTRING
8
51
有效拜访局代码。
省上发填460xxZZZ（460xx是电信的IMSI前5位，xx取值范围00到99，如46003代表电信C网，后面3位ZZZ是拜访省的省代码）。
全国中心下发固定填460xx000。
归属局代码
ASCIISTRING
8
52
省上发固定填460xx000。
全国中心下发填460xxZZZ（460xx是电信的IMSI前5位，xx取值范围00到99，如46003代表电信C网，后面3位ZZZ是归属省的省代码。
）
文件序号
ASCIISTRING
4
53
文件名中的序号
文件产生日期
ASCIISTRING
14
54
YYYYMMDDHHMISS
文件版本号
INTEGER
4
55
10
3.1.2.3.2.记录体
字段名
类型
最大长度
Tag
有效值
RecordType
记录类型
INTEGER
4
100
01
ErrorCode
错误代码
ASCIISTRING
4
160
话单级检验错码，参见5.1.1节各种格式话单的检验标准。
ErrorLine
错误行号
INTEGER
4
161
错单在原始话单文件中的行数，不含头记录。
OrgRecord
原错误记录
ASCIISTRING
1024
162
ASN.1解码后的文本格式的原始话单。
字段分割符统一为逗号。
解码时要严格按照话单格式解码，话单中没有编码的字段解码时为留空，以逗号分隔。
3.1.2.3.3.尾记录
注：
由于话单格式的话费以厘为单位，全国中心应直接累计话单的话费金额，再把累加值四舍五入转换为以分为单位，填入尾记录相应的话费合计字段。
基地在检验尾记录时，允许话单的话费累计值与尾记录话费合计值之间误差小于1分钱。
字段名称
类型
最大长度
Tag
有效值
记录类型
INTEGER
4
50
90
拜访局代码
ASCIISTRING
8
51
参见头记录
归属局代码
ASCIISTRING
8
52
参见头记录
文件序号
ASCIISTRING
4
53
文件名中的序号
错单数（包含重单）
INTEGER
4
72
3.1.3.QC确认文件
基地平台接收到全国计费结算中心发送的正常话单文件后必须返回QC确认文件给全国计费结算中心。
3.1.3.1.文件格式
QCYYYYMMDDHHMISS_IOSMP_YYYYMMDDZZZ.NNNN
其中YYYYMMDDHHMISS为14位时间
YYYYMMDD：
为文件时间
ZZZ：
为基地平台号
NNNN：
四位序列号（0001-0096）
QC文件为0字节文件。
3.1.3.2.交换频度
收到全国计费结算中心下发的文件，基地平台则立即返回QC确认文件。
3.1.3.3.传输协议
FTP
3.2.全国计费结算中心下发文件
3.2.1.正常话单
3.2.1.1.描述
全国计费结算中心将基地业务的计费详单提供给基地平台。
3.2.1.2.文件格式
3.2.1.2.1.文件命名规则
正常文件名格式为：
IOSMP_YYYYMMDDZZZ.NNNN
其中YYYYMMDD：
为文件时间
ZZZ：
为基地平台号
NNNN：
四位序列号（0001-0096）
3.2.1.2.2.文件头/尾记录
a）文件头记录
字段名称
类型
最大长度
Tag
有效值
记录类型
INTEGER
4
50
10
拜访局代码
ASCIISTRING
8
51
有效拜访局代码。
省上发填460xxZZZ（460xx是电信的IMSI前5位，xx取值范围00到99，如46003代表电信C网，后面3位ZZZ是拜访省的省代码）。
归属局代码
ASCIISTRING
8
52
省上发固定填460xx000。
全国中心下发填460xxZZZ（460xx是电信的IMSI前5位，xx取值范围00到99，如46003代表电信C网，后面3位ZZZ是归属省的省代码。
）
文件序号
ASCIISTRING
4
53
文件名中的序号
文件产生日期
ASCIISTRING
14
54
YYYYMMDDHHMISS
文件版本号
INTEGER
4
55
10
b）文件尾记录格式
注：
由于话单格式的话费以厘为单位，全国计费结算中心应直接累计话单的话费金额，再把累加值四舍五入转换为以分为单位，填入尾记录相应的话费合计字段。
基地平台在检验尾记录时，允许话单的话费累计值与尾记录话费合计值之间误差小于1分钱。
字段名称
类型
长度
Tag
有效值
记录类型
INTEGER
4
50
90
拜访局代码
ASCIISTRING
8
51
有效拜访局代码。
省上发填460xxZZZ（460xx是电信的IMSI前5位，xx取值范围00到99，如46003代表电信C网，后面3位ZZZ是拜访省的省代码）。
归属局代码
ASCIISTRING
8
52
省上发固定填460xx000。
全国中心下发填460xxZZZ（460xx是电信的IMSI前5位，xx取值范围00到99，如46003代表电信C网，后面3位ZZZ是归属省的省代码。
）
文件序号
ASCIISTRING
4
53
文件名中的序号
次数合计
INTGER
4
57
不包括头、尾记录
费用合计
INTEGER
4
63
以分为单位
3.2.1.2.3.话单格式与话单级校验标准
编号
字段名称
字段说明
类型
长度
Tag
错误代码
级别
有效值
1
RecordType
记录类型
共用字段
INTEGER
4
100
F010
S
25：
ISMP话单（值为25时：
所有老sp业务平台字段不校验）
26：
老sp业务平台话单（注：
值为26时，所有新平台字段不校验）
2
TimeStamp
记录产生的时间戳
新平台字段
ASCIISTRING
14
230
F020
S
（0）非有效日期为错单，YYYYMMDDHHMISS
F021
S
（1）早于当前系统时间30天的话单为错单
F022
S
（2）晚于当前系统时间。
误差区间值缺省为暂定60分钟
3
MsgID
消息标识
新平台字段
ASCIISTRING
30
231
F030
S
MMDDHHMMSSYYYYYXXXX，其中：
MMDDHHmmss指当前时间；YYYYY指业务引擎标识；XXXX指序列号。
4
OrderNum
订购号
新平台字段
ASCIISTRING
16
232
F040
S
字符串长度<=16个字节，允许为空。
5
OA
发起端地址
新平台字段
ASCIISTRING
36
233
F050
S
如果是用户发起业务，为MSISDN号码。
如果是应用发起的业务，该字段为空。
6
OaOperatorID
发起端运营商标识
新平台字段
ASCIISTRING
10
234
F060
S
暂不校验
7
DA
目的端地址
新平台字段
ASCIISTRING
36
235
F070
S
目的端地址字段指接收业务的用户的MSISDN号码。
如果是应用接收的业务，该字段为空。
8
DaOperatorID
目的端运营商标识
新平台字段
ASCIISTRING
10
236
F080
S
暂不校验
9
FA
付费方用户
号
新平台字段
ASCIISTRING
36
237
F090
W
可以为OA,DA,SP或者第三方对象。
该字段不为空。
10
FaOperatorID
付费方运营
商标识
新平台字段
ASCIISTRING
10
238
F100
W
暂不校验
11
FAPayType
付费方付费
类型（对应老sp业务平台用户类型）
共用字段
INTEGER
1
239
F110
W
不在以下取值范围内：
0：
后付费
1：
预付费
2：
准预付费【对应老平台原值为9】
3：
PPC（CDMA）【对应老平台原值为1】
4：
WVPN（CDMA）【对应老平台原值为3】
5：
IVPN【对应老平台原值为5】
6：
IPVPN【对应老平台原值为6】
7：
CDMA普通【对应老平台原值为0】
8：
其他
12
CdrType
CDR类型（对应老sp业务平台详单类型）
共用字段
INTEGER
4
240
F120
S
不在以下取值范围内：
0：
用户定购/使用业务
1：
SP签约业务能力
2：
普通业务使用详单【对应老平台原值为0】
3：
普通减免/优惠【对应老平台原值为1】
4：
普通调增【对应老平台原值为2】
13
chargePartyType
计费方类型（对应老sp平台的收费标志）
共用字段
INTEGER
4
241
F130
S
不在以下要求范围内：
仅当CDRType为0时本
字段可填0或1，
CDRType为1时本字段
仅可以填1
0：
用户
1：
SP
2：
集团付费
14
MSISDN
被服务方的MSISDN（对应老sp业务平台MDN号码）
共用字段
ASCIISTRING
15
242
F140
S
（0）11位数字（左对齐填空）
F142
S
（2）在“MSISDN码与长途区号对照表”中有相对应的归属局号码为正确字段
15
SPID
SP代码（对应SP标识）
共用字段
ASCIISTRING
8
243
F150
S
老sp业务平台为5位，电信新平台为8位，校验时<=8位
16
ServiceType
业务类型
共用字段
INTEGER
4
244
F160
S
不在以下取值范围内：
1：
MOAT
（SMS/MMS/WAP）
2：
AOMT
（SMS/MMS/WAP）
3：
MOMT（MMS）
4：
MOET（MMS/Pushmail）
5：
EOMT（MMS/Pushmail）
9：
Reserved（除
SMS/MMS/WAP）
10：
FOMT（MMS）
11：
FOAT（MMS）
12：
FOET（MMS）
13：
铃音复制）
当话单为老平台格式（RecordType=26）时，仅联通在信业务（SPSrvType=90）需要校验该字段，且取值范围为“1”或“2”
17
BeginTime
业务开始时间
共用字段
ASCIISTRING
14
245
F170
S
YYYYMMDDHHMISS
18
EndTime
业务结束时间
共用字段
ASCIISTRING
14
246
F180
S
YYYYMMDDHHMISS
19
Times
次数/条数
共用字段
INTEGER
4
247
F190
S
>=0全数字
20
ChargeResult
计费结果
新平台字段
INTEGER
4
248
F210
S
非0、1、2
0：
成功
1：
失败
2：
未知
21
SrcDeviceType
源设备类型
新平台字段
INTEGER
4
249
F220
不校验
22
SrcDeviceID
源设备标识
新平台字段
ASCIISTRING
20
250
F230
不校验
23
destDeviceType
目的设备类型
新平台字段
INTEGER
4
251
F240
不校验
24
DestDeviceID
目的设备标识
新平台字段
ASCIISTRING
20
252
F250
不校验
25
Duration
时长
共用字段
INTEGER
4
升级会员 