DB11∕T 1164.2-2020 城市轨道交通自动售检票系统技术规范 第2部分：接口数据格式.docx

ICS 35.240.60CCS L 67DB11北京市地方标准DB11/T 1164.22020代替 DB11/T 1164.22015城市轨道交通自动售检票系统技术规范第 2 部分：接口数据格式Network toll system of rail transit technical requirementsPart II: Interface data format2020 - 12 - 24 发布2021 - 04 - 01 实施北京市市场监督管理局发 布DB11/T 1164.22020目次前言. III1 范围. 12 规范性引用文件. 13 术语和定义. 14 缩略语. 25 数据类型. 25.1 ACC 与 MLC. 25.2 MLC、SC 和 SLE. 76 参数数据. 256.1 ACC 与 MLC. 256.2 MLC、SC 和 SLE. 367 交易数据. 857.1 ACC 与 MLC 一票通交易数据格式 . 857.2 AFC 系统内部交易数据 . 1457.3 ACC 与 MLC 一卡通交易数据格式 . 1477.4 MLC、SC、设备一票通一卡通交易数据格式 . 1488 业务数据. 1498.1 业务数据分类. 1498.2 业务数据结构. 1498.3 公共数据部分. 1498.4 事件数据个性部分. 1508.5 业务数据个性部分. 1579 控制数据. 1699.1 控制代码. 1699.2 命令数据. 1729.3 请求数据. 1939.4 通知数据. 1969.5 反馈数据. 20010 状态数据. 21410.1 状态数据结构. 21410.2 公共数据部分. 21410.3 设备完整状态数据. 21410.4 设备状态变更数据. 21410.5 设备故障状态数据. 21511 系统初值. 215附 录A （资料性） 车费计算方案. 216A.1 车费计算流程 . 216IDB11/T 1164.22020A.2 费率方案实例. 217A.3 场景示例. 219附 录B （资料性） AFC 系统中线路、车站、乘客类型及设备编码 . 220B.1 线路编码. 220B.2 车站编码. 221B.3 系统运营商数据. 235B.4 乘客类型. 236B.5 车票数据. 236B.6 设备编码. 237IIDB11/T 1164.22020城市轨道交通自动售检票系统技术规范第2部分：接口数据格式1范围本文件规定了城市轨道交通自动售检票系统内的通用数据约定、数据分类、参数数据、交易数据以及系统内的业务数据、控制数据和状态数据。本文件适用于城市轨道交通自动售检票系统的设计、建设、验收和运营管理。2规范性引用文件本文件没有规范性引用文件。3术语和定义下列术语和定义适用于本文件。3.1配置数据configuration data指具有唯一标识符，带有一组定义对象属性的数据。3.2有效数据payloadAFC系统内能被识别的配置数据XML文件，或者是一组相关的配置数据对象。3.3事件event交易类型，通常由AFC的设备行为引发。3.4车票ticket智能卡、二维码或其它介质乘车凭证（如生物介质）。3.5产品product以车票为载体，实现不同消费方式的功能。3.61DB11/T 1164.22020钱包产品 purse product有效期内包含一定金额的乘车费用的产品。3.7计次产品multiride product有效期内包含一定数量的乘车次数的产品。3.8定期产品pass period product在一定的时间期限内可反复使用的有效产品。3.9黑名单blacklist系统判定车票需要加锁/解锁时用到的车票唯一标识。4缩略语下列缩略语适用于本文件：ACC：轨道交通自动售检票系统清算中心（Automatic Fare Collection Clearing Center)AG：自动检票机（Automatic Gate）BMACS：北京市政交通一卡通结算系统（Beijing Municipal Administration & Communication CardSystem）BOM：半自动售票机（Booking Office Machine）MAC：消息验证码（Message Authentication Code）MLC：多线路中心（Multiple Line Center）SC：车站计算机（Station Computer）SLE：车站终端设备（Station Level Equipment）TAC：交易验证码（Transaction Authorization Code）TPU：车票处理单元（Ticket Processing Unit）TVM：自动售票机（Ticket Vending Machine）5数据类型5.1ACC 与 MLC5.1.1基础数据类型基础数据类型见表 1。2类型名基本类型类型大小取值范围说明Byte_tU810.255用于表示8位字节数据类型DateC19_tU3211.4294967295用于表示日期，天数从1799年12月31日算起。0 = “未设定”表示在有效期限字段情况下“无有效期限”。1 = 1800年1月1日。用于需要确定“范围”（比如生日）的日期。DateC20_tU1611.65535用于表示日期，天数从1899年12月31日算起。0 = “未设定”，表示在有效期限字段情况下“无有效期限”。1 =1900年1月1日，依此类推。ExceptionID_tChar3用于表示异常类型IDS8_tS81-128.127用于表示带符号的整数S16_tS161-32768.32767用于表示带符号的整数S32_tS321-2147483648.2147483647用于表示带符号的整数S64_tS641-9223372036854775808.9223372036854775807用于表示带符号的整数Time_Days_tU1610.65535用于在系统CD表中指定日期的天数。Time_tS3210.2147483647用于以秒表示的自从1970年1月1日开始计算的时间，UTC 00:00:00。0 = “未设定”，表示在有效期限字段情况下“无有效期限”。U8_tU810.255用于表示无符号的整数U16_tU1610.65535用于表示无符号的整数U32_tU3210.4294967295用于表示无符号的整数U64_tU6410.18446744073709551615用于表示无符号的整数类型名基本类型类型大小取值范围说明Ar_tU16_t1用于枚举不同类型的可重复使用的审计寄存器AccountState_tU8_t11.255用于说明票卡/应用/产品帐户的状态ActionSequenceNumber_tU8_t10.15用于排序的二进制值，类型属性的含义取决于使用它的子系统。Address_tChar410.40用于表示具体的街道地址3DB11/T 1164.22020表 1 基础数据类型数据5.1.2业务数据类型业务数据类型见表 2。表 2 业务数据类型数据类型名基本类型类型大小取值范围说明ApplicationPersonalisationCat_tU8_t11.31用于指定个性化卡的种类ApplicationSerialNumber_tU32_t1用于在票卡上标识应用的号码ApplicationType_tU8_t1用于指定枚举的类型ApportionmentRuleType_tU8_t1用于定义分帐规则的类型，表示相关度（用百分比）或绝对值（用固定的数量）。ArSnapshotReason_tU8_t1用于定义要进行审查寄存器转储的审查寄存器原因代码AuditRegisterValue_tU32_t1用于存储计数器型或累加器型审核数据的值。若所存储的数据是累加器型审核数据，则认为数据存储时不含小数点(若数据中存在小数点的话)且计量单位由相关审核数据类型决定。例如，若审核数据类型表示货币价值，且实际价值是人民币1234.56元，则存储的数据是123456。AutoloadDisableReason_tU8_t1用于定义关闭自动充值功能的原因AutoloadTypeCode_tU8_t1用于定义所使用的自动充值的类型Boolean_tU8_t10.1用于说明结果，TRUE（正确）或FALSE（错误）CalendarId_tU16_t1用于定义日历标识CardActionCode_tU8_t10.15用于定义通过黑名单对票卡采取的行为CardBatchNumber_tU16_t1用于定义票卡发行时的批次编号，票卡若不再流通，则可用此号码锁定票卡。CardholderFeeType_tU8_t1用于定义向持卡人收取的费用类型CardholderName_tChar61用于标识持卡人的编号，ASCII字符CardholderNum_tChar190.18用于定义持卡人提供的个人标识CardholderNumType_tU8_t11.15用于定义用来标识持卡人的编号系统CardholderSerialNumber_tU32_t1用于标识持卡人CardholderTitle_tChar5用于持卡人的头衔CardIssuerId_tU32_t11.4294967295用于根据ISO/IEC 7812定义发行人:000,000 到 999,999，或者，所有权分配如下：F000,000,00到F999,999,999最有效的2位 = type (0 = ISO7812, 1=“A”,2 =“F”)余下的30位 = 2进制表示 (不包括 “A”或“F”前缀)。CardSerialNumber_tU32_t1用于以二进制值标识物理票卡CardStatusCode_tU8_t11.15用于定义票卡的状态CardType_tU8_t1用于定义票卡与票卡代理通信的基本格式CartonId_tChar10用于标识存有票卡的票箱，ASCII字符。CdAttributeId_tU32_t1标识CD数据属性CdAttributeName_tChar510.50用于定义CD属性的名称CdPayloadDataVersion_tU16_t11.65535用于定义有效数据内的数据，当数据发生改变时该值增加。CdPayloadFormatVersion_tU16_t11.65535用于标识有效数据结构的版本，当有效数据发生结构性改变（如增加属性、删除属性或附加查找关联时等）时增加。CdPayloadId_tU16_t1用于标识CD有效数据的类型CdPayloadName_tChar12用于CD有效数据唯一名称标识（12字符）CdSetVersion_tU16_t11.65535用于定义CD集的版本DB11/T 1164.22020表  2  业务数据类型数据（续）4类型名基本类型类型大小取值范围说明Char8_tChar1用于表示不带符号的字符类型ClassificationLevel_tU8_t11.7用于定义乘客分类ContractCategory_tU8_t1用于标识合同类别CounterEight_tU8_t1用于定义8位计数器CounterSixteen_tU16_t1用于定义16位计数器CString_tChar用于定义“C”样式（以null为终结符）字符串DayType_tU16_t1用于标识该日类型（如周末、假日，等）的位字段，此字段可在一个项目内配置DeviceFeedbackId_tU8_t1用于标识设备音频和或视频输出DeviceId_tU32_t1用于定义设备唯一标识。此类型包含下列几个类型：HardwareType_t （占用最高有效的16位）。HardwareSequenceNumber_t （占用最低有效的16位）。DeviceStatus_tU8_t1用于标识设备状态Duration_tU16_t1用于定义通过单位或值来表示持续时间。Duration_t= DurationUnit_t+DurationValue_t。DurationUnit_t 占用最高有效的4位。DurationValue_t 占用最低有效的12位DurationUnit_tU8_t11.15用于定义产品的持续时间单位DurationValue_tU16_t10.4095用于标识某事物的持续时间（如某项产品的持续时间）EmailAddress_tChar129用于标识电子邮件地址EventId_tU16_t1用于标识事件IDFare_tU16_t1用于标识费用值FareCode_tU16_t1用于标识费用表中相应的费用代码FareCodeTableId_tU16_t1用于标识用于费用计算的费用代码表IDFareCodeTableType_tU8_t1用于标识费用代码表类型FarePatternId_tU16_t1用于标识费用模式FarePatternType_tU8_t1用于定义费用模式结构FareSetId_tU8_t1用于定义费用设置标识符FareTableId_tU16_t1用于定义费用表的唯一标识FinancialType_tS8_t1用于定义财务交易类型GraphicId_tU16_t1用于定义票卡图案标识HardwareSequenceNumber_tU16_t1用于定义AFC系统硬件序号标识，一般由人工指派。HardwareType_tU16_t1A用于定义FC系统硬件类型标识。双字节U16的编码规则如下：最低有效位（右字节）表示设备类型的范围编号。最高有效位（左字节）按BJ-ACC-0110表示设备类型的id。JourneyType_tU16_t1用于标识乘客旅程费用方案KeyVersion_tU16_t1用于定义密钥版本标识KeyNumber_tU16_t1用于定义加密系统使用的密钥编号，表示一个安全密钥（但非其版本号）。LanguageId_tU16_t1用于定义系统所用自然语言，参见ISO639-2自然语言编码列表。LifeCycleCounter_tU16_t1用于标识票卡“生命周期”的二进制值DB11/T 1164.22020表  2  业务数据类型数据（续）5类型名基本类型类型大小取值范围说明LocationCode_tU32_t11.16777215用于标识位置代码的二进制值LocationNumber_tU32_t1用于标识位置编号。LocationNumber_t =(LocationType_t << 24)+LocationCode_t。通过位置类型和位置代码标识位置。LocationType_tU8_t1用于标识位置类型MapOffsetType_tU8_t1用于标识地图的末节点是另一个地图或名称的结构类型MatrixElementType_tU8_t1用于定义存储在矩阵中的元素类型MatrixType_tU8_t1用于指定矩阵的类型ModeChangeReason_tU8_t1用于标识触发器的模式改变ModeReason_tU8_t1用于标识车站设为特定操作模式的原因NameEncodingType_tU8_t10.15用于定义类型，在编码格式中作为NameRepresentationType_t的一部分。NameRepresentationType_tU16_t1用于定义编码类型(NameEncodingType_t)和名称特定变化(NameVariantType_t)的信息NameVariantType_tU16_t11.4095用于标识NameVariant_t中数据表示的变量类型，NameVariant_t由项目及上下文列举的变量进行定义。OperationalMode_tU8_t11.15用于标识设备模式。根据设备能力，设备可以被置于费用支付、销售或查询模式。只有当设备处于IN_SERVICE时，这些值才适用，但可能被设定为任何初级模式。对于费用支付模式，将被计算的费用类型将由此类型确定。ParticipantId_tU32_t11.4294967295用于标识模式参与方PassengerType_tU8_t11.255用于标识乘客分类Password_tChar16用于标识口令，以Null为终结符的ASCII字符。PasswordClue_tChar21用于定义口令线索的ASCII字符PaymentMethod_tU8_t11.15用于标识付费方法Percent_tU16_t10.10000用于定义精确到2个小数位的百分比值(0.100)PointFlags_tU8_t1确定与某个点相关的全局标记ProcessingStatus_tU8_t11.255用于标识票卡应用处理状态ProductActionCode_tU8_t11.15用于标识通过黑名单对产品采取的操作ProductCategory_tU8_t11.255用于标识系统中所有相关产品的种类ProductIssuerId_tU32_t1用于标识产品发行。取值范围为:000,000到 999,999或F000,000,000 到F999,999,999- 包括用“A” 或 “F”表示的类型标识符，其中:最高 2位 = 类型(0 = ISO7812, 1=“A”, 2 =“F”)。其他 30位 = 二进制数 (除首标 “A”或“F”之外)ProductSerialNumber_tU16_t1用于标识票卡应用中的产品ProductStatusCode_tU8_t11.15用于标识产品状态编码ProductType_tU16_t1用于标识产生交易的产品的二进制值ProductTypeVariant_tU16_t1用于标识特定ProductType_t的变量Ptsn_tU16_t1用于标识产品使用流水号的二进制值，产品创建时为0。DB11/T 1164.22020表  2  业务数据类型数据（续）6类型名基本类型类型大小取值范围说明ReceiptNum_tU16_t11.9999用于标识收据号码RefundLevel_tU8_t1用于标识延时退款进度的二进制值RefundMethod_tU8_t1用于标识退款的支付方法RefundReason_tU8_t1用于标识退款理由，同时适用于被退或归还的票卡。RemovalReason_tU8_t1用于标识某项目从票卡上被移走的原因ReplacementReason_tU8_t11.255用于标识更换票卡原因ReversalReasonCode_tU16_t1用于标识撤销交易原因Rides_tU8_t1用于标识乘坐次数，适用于基于乘坐次数的产品。RoleType_tU8_t1用于定义操作员角色。其值由CD定义。SamId_tU32_t1用于定义票卡的唯一标识码一票通：SAM或HSM唯一标识一卡通：一卡通原始SAM ID右边的个BCD位转换成十进制数Sex_tU8_t1用于定义性别标识ShiftSequenceNumber_tU32_t1用于标识特定操作员的轮班号码，由SAM维护SortingFlags_tU32_t1用于指定排序和搜索细节的位图标志StaffCodeNumber_tChar10用于标识员工编码数StaffId_tChar10用于标识某个应用供应商范围内的工作人员ID。SurrenderReason_tU8_t11.255用于定义退回票卡的可能原因TelephoneNumber_tChar21用于标识电话号码，ASCII字符。TicketStockStatus_tU8_t1用于标识当前票存情况TimeCode_tU8_t1用于定义时间期限的引用（通过CD解释）TransactionStat_tU8_t11.255用于标识交易的状态TxnMac_tU8_t8用于标识有关交易的安全信息。该类型为字节，便于与ACC兼容，但交易MAC本身是字节。该类型的字段在前字节中应包含MAC，但字段的后个字节将设为。UD_Subtype_tU8_t1用于标识数据源中源/类型的消息UD_Type_tU8_t1用于标识数据源包含的源/类别UDSNum_tU32_t11.4294967295用于标识用量数据序列号ValidityDistance_tU16_t11.65535用于标识产品有效的地区。有效性单位由产品发行人确定。ValueOneUnit_tS32_t1用于标识现行货币最小单位表示的货币价值Version_tU16_t1用于标识写入票卡的密钥的“SecurityKeyTable”的版本的二进制值XSDate_tCString_tN/A用于标识CD接口函数的返回值XSDateTime_tCString_tN/A用于标识CD接口函数的返回值XSDuration_tCString_tN/A用于标识CD接口函数的返回值XSTime_tCString_tN/A用于标识CD接口函数的返回值Years_tU8_t1用于定义年计数器DB11/T 1164.22020表  2  业务数据类型数据（续）5.2MLC、SC 和 SLE5.2.1数据交换7编码格式字段长度（字节）类型说明hh小时1BCD24 小时制。mm分钟1BCDss秒1BCD编码格式字段长度（字节）类型说明YYYY年2BCDMM月1BCDDD日1BCDDB11/T 1164.22020数据在交换双方之间应以本标准中的数据包组织形式进行交换。定时进行交换的数据在到达规定时间间隔时、业务结束时、建立连接时进行交换；即时进行交换的数据在数据产生时、建立连接时进行交换。在上位要求时、操作员指定时均应进行数据交换。5.2.2基础编码编码类型包括：BCD、HEX、LLVAR和AFCSTR。5.2.2.1BCDBCD是一种字符编码，它是用二进制的编码表示十进制数。5.2.2.2HEXHEX是用二进制的编码表示十六进制数。5.2.2.3AFCSTRAFCSTR是本标准定义的一种汉字存储和编码的方式，采用GB2312字符集。5.2.2.4LLVARLLVAR是一个可变长度的数据编码，首字节表示后面包含的十六进制数据字节长度（采用BCD编码）。5.2.3基础数据类型核心数据类型包括：日期数据类型、时间数据类型、日期时间数据类型、金额数据类型、预留字段以及各字段的默认值。5.2.3.1日期数据日期数据的数据结构见表 3。表 3 日期数据结构5.2.3.2时间数据时