接口规范独立路段050111Word文档格式.docx
- 文档编号:17643195
- 上传时间:2022-12-07
- 格式:DOCX
- 页数:19
- 大小:31.94KB
接口规范独立路段050111Word文档格式.docx
《接口规范独立路段050111Word文档格式.docx》由会员分享,可在线阅读,更多相关《接口规范独立路段050111Word文档格式.docx(19页珍藏版)》请在冰豆网上搜索。
子包体
……
8字节校验码
图1-2通讯文件结构
注:
包中校验码的生成算法及检验方法参看“附录校验码定义”中描述。
1.2.2包头
包头的信息有:
文件类型、文件名称、发送方编码、接收方编码、日期时间、子包个数等,其组成结构如图1-3所示。
包头结构如下所示:
1
128
10
19
4
文件类型
制表符
文件名称
发送方编码
接收方编码
日期时间
子包个数
换行符
图1-3包头结构图
1文件类型表示该文件的类型,具体定义如下:
0:
省联网收费结算中心→各独立路段收费中心;
1:
各独立路段收费中心→省联网收费结算中心;
2文件名称指明了要传输的文件的具体路径与名称,如文件名称为C:
\inetpub\ftproot\tmp\send\ofile。
3发送方编码表示该文件的来源地。
4接收方编码表示该文件的目的地。
5日期时间表示该文件传输的时间,以“CCYY-MM-DDhh:
mm:
ss”的格式表示,日期与时间用一个空格分开。
如2002-01-2311:
01:
01表示该文件在2002年1月23日上午11时01分01秒生成。
6子包个数表示该文件所包含的子包数。
发送方、接收方编码的定义规则如下:
XXY1Y2Y3Y4
①XX:
省内收费区域编码
②Y1Y2Y3Y4
省联网收费结算中心
02:
粤西区域
03:
广州区域
04:
深圳区域
05:
粤北区域
06:
粤东区域
07:
珠三角区域
08:
区域结算中心
Y1Y2Y3Y4:
路段收费中心编码
其中:
0000:
0001~9999:
各路段收费中心编码
1.2.3子包头
子包头结构如图1-4所示(数字代表长度):
子包代码
记录数目
操作类型
行结束符
图1-4子包头结构图
①子包代码:
指定子包类型。
②记录数目:
表示该子包记录的数目。
③操作类型:
固定为i,表示插入(insert)操作。
1.2.4子包体
子包体由相同类型的记录组成。
每行表示一条记录,记录与记录之间用换行符分隔,子包体结构如图1-5所示。
记录一
记录二
记录三
图1-5子包体结构图
1.2.5记录
记录是实际传输的数据,由字段组成,每个字段之间用制表符分隔,如图1-6所示。
x
y
z
数据字段
图1-6记录结构图
1.2.6校验码
校验码采用32位CRC校验和,为增加可读性,将此32位(4字节)长整型数用8个十六进制字符(’0’~’9’,’a’~’f’)表示,如计算结果为0x6af5d397的校验和在文件中用字符串“6af5d397”表示。
校验码的生成算法及检验方法参看“附录校验码定义”中描述。
1.3通信子包编码定义
子包编码
通信数据名称
接收方数据表名
省联网收费结算中心――>
独立路段
0101
储值卡黑名单
(文件)
0102
记帐卡黑名单
0103
储值卡的有效启用日期
0104
记帐卡的有效启用日期
0105
OBU的有效启用日期
0106
需重传拆分及分帐数据起止时间
0107
区域粤通卡统一折扣率
0108
路段粤通卡统一折扣率
0109
路段单张粤通卡折扣率
0110
业主收支金额汇总
独立路段――>
省联网收费结算中心
1001
粤通卡的拆分原始通行费数据
1002
业主分帐数据
第二章数据管理接口规范
2.1导入/导出接口文件格式
-文本格式
-第一行为字段名
-一行一条数据记录,以换行符分割
-数据记录字段之间以制表符(TAB)分割
第1行
字段名1
…
字段名n
第2行
数据1
数据n
.
第n行
2.2独立路段收费中心系统数据导入/导出接口
2.2.1独立路段收费中心系统数据导出接口
●传输内容
独立路段收费中心上传到省收费结算中心的数据内容包括:
粤通卡的拆分原始通行费数据、业主分帐数据。
●传输格式
1、粤通卡原始通行费数据
名称
字段
数据类型
长度
强制
主要识别字
序列号
ListNO
Char
8
TRUE
车道序列号
DetailNO
33
粤通卡编码
ICCode
16
粤通卡类型
ICType
入口信息
Entry
20
入口日期时间
EnTime
15
出口信息
Export
出口日期时间
ExTime
出口车道类型
ExpType
收费金额
Toll
储值卡余额
TollBala
7
脱机交易序列号
TrSeq
终端机编码
TermCode
12
终端交易序列号
TermSeq
交易验证码
Tac
业主代码
OwnerCode
路段编码
RoadCode
拆分日期时间
GenTime
(1)序列号:
指该记录的顺序号,顺序号码由1开始。
(2)入口信息=入口路段编码(4位)+入口收费站编码(4位)+入口车道编码(4位)+入口收费站名(8位)。
(3)出口信息=出口路段编码(4位)+出口收费站编码(4位)+出口车道编码(4位)+出口收费站名(8位)。
(4)出口车道类型:
02――封闭MTC出口;
04――封闭ETC出口;
05――MTC开放式;
06――ETC开放式。
(5)收费金额:
以元为单位。
(6)储值卡余额:
以分为单位。
(7)脱机交易序列号、终端机编码、终端交易序列号、交易验证码:
均为8位BCD码,使用现金收费时这些字段自动写零。
记帐卡的脱机交易序列号、交易验证码均为“00000000”。
(8)业主代码、路段编码:
不足4位的,均要求前补零补足4位。
(9)拆分日期时间:
指区域结算中心对粤通卡通行记录拆分时形成该接口数据的时间。
对于独立收费路段,此字段代表该批接口数据插入上传数据表的时间。
采用格式CCYYMMDDThhmmss,如20011201T143005代表2001年12月1日14时30分05秒。
如果该独立路段需要省联网收费结算中心提供工班日报表,则必须将“拆分日期时间”字段写入该条原始通行费流水产生的正确工班日期。
(10)此表采用增量方式发送。
2、业主分帐数据
业主分帐数据是指按业主和粤通卡类型对原始通行费数据进行统计后生成的数据。
起始拆分日期时间
StarTime
终止拆分日期时间
EndTime
总收入
Gross
生成日期时间
GenDate
(2)总收入:
(3)业主代码:
(4)起始、终止拆分日期时间:
如果该独立路段需要省联网收费结算中心提供工班日报表,则必须将“起始拆分日期时间”、“终止拆分日期时间”的定义均改为工班日期。
(5)此表采用增量方式发送。
2.2.2独立路段收费中心系统数据导入接口
省联网收费结算中心向独立路段收费中心下发的数据,其中包括:
储值卡黑名单、记帐卡黑名单、储值卡有效启用日期、记帐卡有效启用日期、OBU有效启用日期、需重传拆分及分帐数据起止时间、粤通卡折扣率、业主收支金额汇总等。
未注释说明的数据表均为全表下发。
1、储值卡黑名单表
储值卡编码
SCCode
PK
生成原因
GenCau
生成日期
(1)储值卡黑名单生成原因如下:
1―挂失卡,2―无卡注销,3―伪卡
(2)日期格式采用CCYYMMDD,如:
20011201代表2001年12月1日。
2、记帐卡黑名单表
记帐卡编码
ACCode
(1)记帐卡黑名单生成原因如下:
1―挂失卡,2―无卡注销,3―伪卡,4―止付卡。
3、储值卡的有效启用日期
储值卡有效启用日期
FirTime
(1)储值卡有效启用日期:
标示了可用储值卡的日期范围,有效启用日期之后制作的储值卡为有效卡。
反之,有效启用日期之前制作的储值卡为无效卡,车道系统应该进行拦截。
日期格式采用CCYYMMDD,如:
4、记帐卡的有效启用日期
记帐卡有效启用日期
(1)记帐卡有效启用日期:
标示了可用记帐卡的日期范围,有效启用日期之后制作的记帐卡为有效卡。
反之,有效启用日期之前制作的记帐卡为无效卡,车道系统应该进行拦截。
5、OBU的有效启用日期
OBU有效启用日期
(1)OBU有效启用日期:
标示了可用OBU的日期范围,有效启用日期之后制作的OBU为有效卡。
反之,有效启用日期之前制作的OBU为无效OBU,ETC车道系统应该进行拦截。
6、需重传拆分及分帐数据起止时间
当该类数据存在时,表示省联网收费结算中心要求独立路段收费中心重新传送规定时间段的数据。
独立路段收费中心收到需重传拆分数据起止时间后,将该时间段内的原始数据重新发送到省联网收费结算中心。
拆分记录的起始日期时间
StartTime
拆分记录的终止日期时间
(1)日期时间采用格式CCYYMMDDThhmmss,如20011201T143005代表2001年12月1日14时30分05秒。
7、粤通卡折扣率
1)区域粤通卡折扣率
区域编码
AreaNo
Privilege
起始日期
结束日期
(1)折扣率:
指定某区域在起止日期时间内的折扣率,采用格式X.XX(共4位),如0.95,表示折扣率为95%。
(2)起始日期、结束日期:
采用格式CCYYMMDD,如:
20030815表示2003年8月15日。
2)路段粤通卡统一折扣率
RoadNo
路段统一折扣率
(1)路段统一折扣率:
指定某路段在起止日期时间内的折扣率,采用格式X.XX(共4位),如0.95,表示折扣率为95%。
3)路段单张粤通卡折扣率
路段单张粤通卡折扣率说明指定的粤通卡在起止日期时间内在指定路段的优惠率。
折扣率
指定某路段某张粤通卡在起止日期时间内的折扣率,采用格式X.XX(共4位),如0.95,表示折扣率为95%。
8、业主收支金额汇总
业主收支金额汇总说明指定业主在指定时间内的应收金额及应缴的结算服务费。
ListNo
起始日期时间
结束日期时间
OwnCode
业主名称
OwnName
30
实收金额
Income
服务费
ServiceFee
(1)实收金额、服务费:
采用格式XXXXXXXXX.XX(共12位),如100000000.00,表示1个亿。
(2)此表采用增量形式下发。
第三章通信接口规范
3.1省联网收费结算中心系统与独立路段收费中心系统接口
3.1.1独立路段收费中心系统向省联网收费结算中心系统发送数据
省联网收费结算中心下传到独立路段收费中心的数据内容包括:
粤通卡原始通行费数据、业主分帐数据。
●传输方式
省联网收费结算中心与独立路段收费中心之间的数据通信都为每天一次的大批量数据传输,将采用数据文本文件传输的方式进行通信。
独立路段向省联网收费结算中心发送数据暂定为一天一次。
见2.2.1传输格式
3.1.2省联网收费结算中心系统向独立路段收费中心系统发送数据
储值卡黑名单、记帐卡黑名单、储值卡有效启用日期、记帐卡有效启用日期、OBU有效启用日期、需重传拆分及分帐数据起止时间、粤通卡折扣率、业主收支金额汇总表等。
省联网收费结算中心向独立路段下发数据暂定为一天两次,每日上午在帐务结算后,将粤通卡结算数据下发;
每日下午则将储值卡黑名单、记帐卡黑名单、储值卡有效启用日期、记帐卡有效启用日期、OBU有效启用日期等粤通卡参数数据下发。
见2.2.2传输格式
附录校验码定义
附1校验码算法示例程序
检验算法是CRC-32算法。
当需要检验的内容不是文件时,只需将文件改为相应的数据内容即可。
校验码生成算法如下:
(以计算文件校验码为例)
(1)生成CRC初始矩阵
voidCRC_Init_CRC32_Table(unsignedlong*crc32_table)
{/*CallthisfunctiononlyoncetoinitializetheCRCtable.*/
/*ThisistheofficialpolynomialusedbyCRC-32*/
/*inPKZip,WinZipandEthernet.*/
unsignedlongulPolynomial=0x04c11db7;
inti,j;
/*256valuesrepresentingASCIIcharactercodes.*/
for(i=0;
i<
=0xFF;
i++)
{
crc32_table[i]=CRC_Reflect(i,8)<
<
24;
for(j=0;
j<
8;
j++)
crc32_table[i]=(crc32_table[i]<
1)^(crc32_table[i]&
(1<
31)?
ulPolynomial:
0);
crc32_table[i]=CRC_Reflect(crc32_table[i],32);
}
}
unsignedlongCRC_Reflect(unsignedlongref,unsignedcharch)
{/*UsedonlybyInit_CRC32_Table().*/
unsignedlongvalue=0;
inti;
/*Swapbit0forbit7*/
/*bit1forbit6,etc.*/
for(i=1;
(ch+1);
if(ref&
1)value|=1<
(ch-i);
ref>
>
=1;
returnvalue;
(2)计算文件CRC校验码:
unsignedlongGetCRC(FILE*fp)
{
unsignedlongcrc32_table[256],globalCRC;
charlsFileCRC[10];
inti;
unsignedcharch;
intliFileLen;
CRC_Init_CRC32_Table(crc32_table);
/*startcalculation*/
globalCRC=0xffffffff;
fseek(fp,0L,SEEK_END);
liFileLen=ftell(fp);
rewind(fp);
for(i=0;
i<
liFileLen;
i++)
fread(&
ch,1,1,fp);
CRC_AddText(crc32_table,&
globalCRC,(unsignedchar*
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 接口 规范 独立 路段 050111