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

《DB11∕T 1164.2-2020 城市轨道交通自动售检票系统技术规范 第2部分：接口数据格式.docx》由会员分享，可在线阅读，更多相关《DB11∕T 1164.2-2020 城市轨道交通自动售检票系统技术规范 第2部分：接口数据格式.docx（242页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、ICS35.240.60CCSL67DB11北京市地方标准DB11/T1164.22020代替DB11/T1164.22015城市轨道交通自动售检票系统技术规范第2部分：接口数据格式NetworktollsystemofrailtransittechnicalrequirementsPartII:Interfacedataformat2020-12-24发布2021-04-01实施北京市市场监督管理局发布DB11/T1164.22020目次前言.III1范围.12规范性引用文件.13术语和定义.14缩略语.25数据类型.25.1ACC与MLC.25.2MLC、SC和SLE.76参数数据.256

2、.1ACC与MLC.256.2MLC、SC和SLE.367交易数据.857.1ACC与MLC一票通交易数据格式.857.2AFC系统内部交易数据.1457.3ACC与MLC一卡通交易数据格式.1477.4MLC、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公共数

3、据部分.21410.3设备完整状态数据.21410.4设备状态变更数据.21410.5设备故障状态数据.21511系统初值.215附录A（资料性）车费计算方案.216A.1车费计算流程.216IDB11/T1164.22020A.2费率方案实例.217A.3场景示例.219附录B（资料性）AFC系统中线路、车站、乘客类型及设备编码.220B.1线路编码.220B.2车站编码.221B.3系统运营商数据.235B.4乘客类型.236B.5车票数据.236B.6设备编码.237IIDB11/T1164.22020城市轨道交通自动售检票系统技术规范第2部分：接口数据格式1范围本文件规定了城市轨道交通

4、自动售检票系统内的通用数据约定、数据分类、参数数据、交易数据以及系统内的业务数据、控制数据和状态数据。本文件适用于城市轨道交通自动售检票系统的设计、建设、验收和运营管理。2规范性引用文件本文件没有规范性引用文件。3术语和定义下列术语和定义适用于本文件。3.1配置数据configurationdata指具有唯一标识符，带有一组定义对象属性的数据。3.2有效数据payloadAFC系统内能被识别的配置数据XML文件，或者是一组相关的配置数据对象。3.3事件event交易类型，通常由AFC的设备行为引发。3.4车票ticket智能卡、二维码或其它介质乘车凭证（如生物介质）。3.5产品product以

5、车票为载体，实现不同消费方式的功能。3.61DB11/T1164.22020钱包产品purseproduct有效期内包含一定金额的乘车费用的产品。3.7计次产品multirideproduct有效期内包含一定数量的乘车次数的产品。3.8定期产品passperiodproduct在一定的时间期限内可反复使用的有效产品。3.9黑名单blacklist系统判定车票需要加锁/解锁时用到的车票唯一标识。4缩略语下列缩略语适用于本文件：ACC：轨道交通自动售检票系统清算中心（AutomaticFareCollectionClearingCenter)AG：自动检票机（AutomaticGate）BMACS

6、：北京市政交通一卡通结算系统（BeijingMunicipalAdministration&CommunicationCardSystem）BOM：半自动售票机（BookingOfficeMachine）MAC：消息验证码（MessageAuthenticationCode）MLC：多线路中心（MultipleLineCenter）SC：车站计算机（StationComputer）SLE：车站终端设备（StationLevelEquipment）TAC：交易验证码（TransactionAuthorizationCode）TPU：车票处理单元（TicketProcessingUnit）TVM：

7、自动售票机（TicketVendingMachine）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日，依

8、此类推。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日开始计算的时间，UTC00:00:00。0=“未设定”，表示在有效

9、期限字段情况下“无有效期限”。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.4

10、0用于表示具体的街道地址3DB11/T1164.22020表1基础数据类型数据5.1.2业务数据类型业务数据类型见表2。表2业务数据类型数据类型名基本类型类型大小取值范围说明ApplicationPersonalisationCat_tU8_t11.31用于指定个性化卡的种类ApplicationSerialNumber_tU32_t1用于在票卡上标识应用的号码ApplicationType_tU8_t1用于指定枚举的类型ApportionmentRuleType_tU8_t1用于定义分帐规则的类型，表示相关度（用百分比）或绝对值（用固定的数量）。ArSnapshotReason_tU8_t1

11、用于定义要进行审查寄存器转储的审查寄存器原因代码AuditRegisterValue_tU32_t1用于存储计数器型或累加器型审核数据的值。若所存储的数据是累加器型审核数据，则认为数据存储时不含小数点(若数据中存在小数点的话)且计量单位由相关审核数据类型决定。例如，若审核数据类型表示货币价值，且实际价值是人民币1234.56元，则存储的数据是123456。AutoloadDisableReason_tU8_t1用于定义关闭自动充值功能的原因AutoloadTypeCode_tU8_t1用于定义所使用的自动充值的类型Boolean_tU8_t10.1用于说明结果，TRUE（正确）或FALSE（错

12、误）CalendarId_tU16_t1用于定义日历标识CardActionCode_tU8_t10.15用于定义通过黑名单对票卡采取的行为CardBatchNumber_tU16_t1用于定义票卡发行时的批次编号，票卡若不再流通，则可用此号码锁定票卡。CardholderFeeType_tU8_t1用于定义向持卡人收取的费用类型CardholderName_tChar61用于标识持卡人的编号，ASCII字符CardholderNum_tChar190.18用于定义持卡人提供的个人标识CardholderNumType_tU8_t11.15用于定义用来标识持卡人的编号系统CardholderS

13、erialNumber_tU32_t1用于标识持卡人CardholderTitle_tChar5用于持卡人的头衔CardIssuerId_tU32_t11.4294967295用于根据ISO/IEC7812定义发行人: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

14、_tU8_t1用于定义票卡与票卡代理通信的基本格式CartonId_tChar10用于标识存有票卡的票箱，ASCII字符。CdAttributeId_tU32_t1标识CD数据属性CdAttributeName_tChar510.50用于定义CD属性的名称CdPayloadDataVersion_tU16_t11.65535用于定义有效数据内的数据，当数据发生改变时该值增加。CdPayloadFormatVersion_tU16_t11.65535用于标识有效数据结构的版本，当有效数据发生结构性改变（如增加属性、删除属性或附加查找关联时等）时增加。CdPayloadId_tU16_t1用于标识

15、CD有效数据的类型CdPayloadName_tChar12用于CD有效数据唯一名称标识（12字符）CdSetVersion_tU16_t11.65535用于定义CD集的版本DB11/T1164.22020表2业务数据类型数据（续）4类型名基本类型类型大小取值范围说明Char8_tChar1用于表示不带符号的字符类型ClassificationLevel_tU8_t11.7用于定义乘客分类ContractCategory_tU8_t1用于标识合同类别CounterEight_tU8_t1用于定义8位计数器CounterSixteen_tU16_t1用于定义16位计数器CString_tChar

16、用于定义“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+

17、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用于标识用于费用计算的费用代码表IDFar

18、eCodeTableType_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系统硬件类型标识。双字

19、节U16的编码规则如下：最低有效位（右字节）表示设备类型的范围编号。最高有效位（左字节）按BJ-ACC-0110表示设备类型的id。JourneyType_tU16_t1用于标识乘客旅程费用方案KeyVersion_tU16_t1用于定义密钥版本标识KeyNumber_tU16_t1用于定义加密系统使用的密钥编号，表示一个安全密钥（但非其版本号）。LanguageId_tU16_t1用于定义系统所用自然语言，参见ISO639-2自然语言编码列表。LifeCycleCounter_tU16_t1用于标识票卡“生命周期”的二进制值DB11/T1164.22020表2业务数据类型数据（续）5类型名基

20、本类型类型大小取值范围说明LocationCode_tU32_t11.16777215用于标识位置代码的二进制值LocationNumber_tU32_t1用于标识位置编号。LocationNumber_t=(LocationType_t24)+LocationCode_t。通过位置类型和位置代码标识位置。LocationType_tU8_t1用于标识位置类型MapOffsetType_tU8_t1用于标识地图的末节点是另一个地图或名称的结构类型MatrixElementType_tU8_t1用于定义存储在矩阵中的元素类型MatrixType_tU8_t1用于指定矩阵的类型ModeChange

21、Reason_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由项目及上下文列举的变量进

22、行定义。OperationalMode_tU8_t11.15用于标识设备模式。根据设备能力，设备可以被置于费用支付、销售或查询模式。只有当设备处于IN_SERVICE时，这些值才适用，但可能被设定为任何初级模式。对于费用支付模式，将被计算的费用类型将由此类型确定。ParticipantId_tU32_t11.4294967295用于标识模式参与方PassengerType_tU8_t11.255用于标识乘客分类Password_tChar16用于标识口令，以Null为终结符的ASCII字符。PasswordClue_tChar21用于定义口令线索的ASCII字符PaymentMethod_tU

23、8_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-

24、包括用“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/T1164.22020表2业务数据类型数据

25、（续）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用于标识乘坐次数，适用于基于乘坐次数

26、的产品。RoleType_tU8_t1用于定义操作员角色。其值由CD定义。SamId_tU32_t1用于定义票卡的唯一标识码一票通：SAM或HSM唯一标识一卡通：一卡通原始SAMID右边的个BCD位转换成十进制数Sex_tU8_t1用于定义性别标识ShiftSequenceNumber_tU32_t1用于标识特定操作员的轮班号码，由SAM维护SortingFlags_tU32_t1用于指定排序和搜索细节的位图标志StaffCodeNumber_tChar10用于标识员工编码数StaffId_tChar10用于标识某个应用供应商范围内的工作人员ID。SurrenderReason_tU8_t11

27、.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用于标识数据源包

28、含的源/类别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接口函数的返

29、回值XSTime_tCString_tN/A用于标识CD接口函数的返回值Years_tU8_t1用于定义年计数器DB11/T1164.22020表2业务数据类型数据（续）5.2MLC、SC和SLE5.2.1数据交换7编码格式字段长度（字节）类型说明hh小时1BCD24小时制。mm分钟1BCDss秒1BCD编码格式字段长度（字节）类型说明YYYY年2BCDMM月1BCDDD日1BCDDB11/T1164.22020数据在交换双方之间应以本标准中的数据包组织形式进行交换。定时进行交换的数据在到达规定时间间隔时、业务结束时、建立连接时进行交换；即时进行交换的数据在数据产生时、建立连接时进行交换。在上

30、位要求时、操作员指定时均应进行数据交换。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时间数据时