数据结构技术规范.doc

数据结构技术规范数据字典:卡号(CARD_NO):为初始化时写入卡内的一部分数据,长度8BYTE 采用城市代码+行业代码+发行流水号方式比如 3000000012345678 表示城市代码为3000 行业代码为0000 发行流水号为12345678的卡卡序列号(CARD_SERIAL)：即卡片的芯片号(一）数据采集站上传POS交易文件命名规则：数据采集站从采集机收集到的上传数据是一个原始的消费交易文本文件。文本文件的命名规则是：文件名： YYYYMMDDHHMMSSSerialNO.BUS说明：1. SerialNO: 手持机终端编号长度为8位数字型2. YYYYMMDDHHMMSS：日期时间，是手持机数据上传时的时间。3数据结构见后。举例:2006072212234300001234.BUS（二）数据采集站下发文件命名规则：公交数据采集站从上位系统接受到的下发文件是1-2个文本性的任务文件。其中：1. 黑名单任务文件的命名规则是：文件名：black.dat2. 数据结构卡号（10进制ASC数值）（一行一条记录，行分隔符用回车换行）3文件举例（含有5张黑名单卡的黑名单任务文件）：文件名称：black.dat文件内容：30000000123456783000000012345679300000001234568830000000123456983000000012345699三交易POS文件的数据结构（一）、交易文件的构成：交易文件是在手持机上传给计算机时形成的后缀为BUS的文件，也称POS文件。POS文件包括采集盒采集到的车载机各种交易记录，这些记录在POS文件中按一定的顺序存放。其中行分隔符采用分隔符采用回车换行 cr+lf 列分隔符采用逗号,典型的POS文件的结构如下： 司机、售票员上班记录.交易记录.交易记录.交易记录黑名单卡交易记录交易记录.司机、售票员上班记录交易记录.交易记录.POS文件必须以司机和售票员上班记录开始（二）、记录的种类：机具内部记录的刷卡记录包括消费记录、消费灰记录、操作员卡上班记录、黑名单刷卡记录等。各种卡的刷卡记录类型如表2.1所示:表2.1 记录类型对照表:数 据 项记录类型代码(HEX)记录代码1消费记录钱包消费HEX（0x00）月票消费HEX（0x04）2钱包消费灰记录HEX（0x01）3月票消费灰记录HEX（0x05）4黑名单刷卡记录0xE05操作员（司机）卡上班刷卡记录0xE1（一） 记录类型详解：、 消费卡钱包区刷卡记录 (0x00)：消费卡钱包区刷卡的记录格式如表2.2:表2.2 消费卡钱包区刷卡记录格式:序 号数 据 项码制说 明长度11-2序号HEX终端交易流水号2B23记录类型(T)HEX（0x00）1B34-7消费卡卡号HEX卡号(共16字节)4B48-9城市代码BCD2B510-11行业代码BCD2B612-15发卡流水号BCD4B716-19卡认证码(T)HEX4B820卡类BCD卡类1B921-22钱包累计交易次数(T)HEX消费交易计数器2B1023-26原额HEX原额（交易前余额）4B1127-29交易金额(T)HEX交易金额3B1230-33交易日期(T)BCD交易日期（YYYY/MM/DD）4B1334-36交易时间(T)BCD交易时间（HH/MM/SS）3B1437空字节BCDOx00 1B1538-39钱包充值计数器HEX钱包充值交易的累计次数2B1640-43TACHEXTAC4B1744-45空字节FF2B1846-47消费城市代码BCD机具所在城市的代码2B1948校验码HEXBCC1B累 计48B注：l 序号为终端机具记录刷卡记录时形成的流水记录号，用于描述记录的完整性，可作为补采集的判断依据，2字节HEX码；l 记录类型遵照本规范（第3页表2.1），1字节HEX码； l 消费卡卡号为消费卡卡内的唯一序列号，4字节HEX码；l 城市代码为发卡时记录在卡内的发卡城市代码，2字节BCD码；l 行业代码为发卡时记录在卡内的发卡行业代码，2字节BCD码；l 发卡流水号为发卡时记录在卡内的发卡流水号，4字节BCD码；l 卡认证码为发卡时记录在卡内的MAC码，4字节HEX码；l 卡类为发卡时记录在卡内的卡类型代码，1字节HEX码；l 钱包累计交易次数为卡内记载的钱包消费累计次数, 2字节HEX码；l 卡内原额为消费交易前的卡内余额，用4字节HEX码表示，单位为分；l 交易金额为本次交易的金额数，用3字节HEX码表示，单位为分；l 交易日期为本次交易的日期，表示格式为YYYY/MM/DD，4字节BCD码；l 交易时间为本次交易的时间，表示格式为HH/MM/SS，3字节BCD码；l 钱包充值计数器为卡内记载的钱包充值交易累计次数, 2字节HEX码；l TAC码的计算方法是： 暂时取为全0； l 消费城市代码为机具所在城市的代码。l BCC校验码为前39个字节的半加和，用于校验。、 消费卡市区郊线月（季年旬）票区刷卡记录（0x04）：消费卡使用市区郊线月（季年旬）票区刷卡消费的记录格式如表2.3：表2.3 消费卡市区郊线月(季年旬)票区刷卡记录格式:序 号数 据 项码制说 明长度11-2序号HEX终端交易流水号2B23记录类型(T)HEX卡类型（0x04）1B34-7消费卡卡号HEX卡号(共16字节)4B48-9城市代码BCD2B510-11行业代码BCD2B612-15发卡流水号BCD4B716-19卡认证码(T)HEX4B820卡类BCD卡类1B921-22月票累计交易次数(T)HEX卡内记录的月票交易累计次数2B1023-26原额HEX原额（交易前余额）4B1127月季年票标志HEX1=市区旬票,2=市区月票,3=市区季票,4=市区年票，11=郊线旬票,12=郊线月票,13=郊线季票,14=郊线年票1B1228-29交易次数或金额(T)HEX交易次数或金额（分）2B1330-33交易日期(T)BCD交易日期（YYYY/MM/DD）4B1434-36交易时间(T)BCD交易时间（HH/MM/SS）3B1537空字节BCD0x001B1638-39月票充值计数器HEX月票充值交易的累计计数器2B1740-43TACHEX交易认证码4B1844-45空字节FF2B1946-47消费城市代码BCD机具所在城市的代码2B2048校验码HEXBCC1B累 计48B注：l 月季年票标志为本次消费的乘车票种。意义如下：月季年票标志=1/11，表示本次消费市区/郊线旬票；月季年票标志=2/12，表示本次消费市区/郊线月票；月季年票标志=3/13，表示本次消费市区/郊线季票；月季年票标志=4/14，表示本次消费市区/郊线年票；l 其它各字段的表示方法与意义同消费卡记录。、 黑名单卡刷卡记录 (0xE0)：机具黑名单中含有的卡在刷卡时，将在卡内公共信息区存储黑名单标志，同时生成黑名单刷卡记录，如表2.4所示：表2.4 黑名单卡刷卡记录格式:序 号数 据 项码制说 明长度11-2序号HEX终端交易流水号2B23记录类型HEX0xE01B34-7卡号HEX卡号(共16字节)4B48-9发卡城市代码BCD2B510-11发卡行业代码BCD2B612-15发卡流水号BCD4B716-19卡认证码HEX4B820-29应用单位序列号BCD区域行业部门单位消费点代码10B930-33交易日期BCD交易日期（YYYY/MM/DD）4B1034-36交易时间BCD交易时间（HH/MM/SS）3B1137空字节FF1B1238-41消费POS机号BCD车载机、售饭机、出租车计价器等4B1342机具软件版本号HEX1B1443-44黑名单版本号BCD月/日（上位机生成）2B1545空字节FF1B1646-47消费城市代码BCD机具所在城市的代码2B1748校验码HEXBCC1B累 计48B注：l 应用单位序列号由应用区域号（1B）、应用行业号（1B）、应用单位编码（1B，）、独立应用部门路队编号（1B）、线路编号（3B）车辆编号（3B）共10字节BCD码组成。所有代码编号均取自消费终端参数区。例如：1. 应用序列号 02 01 05 02 000132 012052代表： 塘沽区公交行业5公司2路队132线路012052车辆；2. 应用序列号 02110100000201000002代表：塘沽区环卫医疗行业医院系统第2医院挂号处000002号窗口。l 消费POS机号为终端机具生产时的设备编号，4字节BCD码（8位）；l 机具软件版本号和黑名单版本号记录机具相关的应用版本，便于检查；l 其它各字段的表示方法与意义同消费卡记录。、 钱包消费灰记录(0x01)：同钱包消费记录，但是记录类型为0x01、 月（季年旬）票消费灰记录(0x05)： 同月票消费记录，但是记录类型为0x05、 操作员（司机）上班刷卡记录及自动生成的上班记录(0xE1)：操作员（司机）上班刷卡记录格式如表2.5:表2.5 操作员（司机）上班刷卡记录格式:序 号数 据 项码制说 明长度11-2序号HEX终端交易流水号2B23记录类型HEX0xE11B34-7操作员卡卡号HEX卡号(共16字节)4B48-9操作员发卡城市代码BCD2B510-11操作员发卡行业代码BCD2B612-15发卡流水号BCD4B716-19卡认证码HEX4B820-29应用单位序列号BCD区域行业部门单位消费点代码10B930-33交易日期BCD交易日期（YYYY/MM/DD）4B1034-36交易时间BCD交易时间（H