JTT 1438-2022 快件铁路运输安检数据交换规范

目　　次前言Ⅱ…………………………………………………………………………………………………………引言Ⅲ…………………………………………………………………………………………………………1　范围1………………………………………………………………………………………………………2　规范性引用文件1…………………………………………………………………………………………3　术语和定义、缩略语1………………………………………………………………………………………4　信息交换需求2……………………………………………………………………………………………5　信息交换流程2……………………………………………………………………………………………6　通信协议2…………………………………………………………………………………………………7　数据接口4…………………………………………………………………………………………………8　异常处置11…………………………………………………………………………………………………附录A(资料性)　快件异常类型编号对照表12……………………………………………………………附录B(规范性)　站点和安检设备编号生成规则14………………………………………………………附录C(规范性)　安检图像文件、安检员和包裹标识编号生成规则15…………………………………参考文献16……………………………………………………………………………………………………ⅠJT/T1438—2022前　　言本文件按照GB/T1.1—2020《标准化工作导则　第1部分:标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由全国综合交通运输标准化技术委员会(SAC/TC571)提出并归口。本文件起草单位:国家邮政局邮政业安全中心、同方威视技术股份有限公司、中国铁道科学研究院集团有限公司电子计算技术研究所、邮政科学研究规划院有限公司、中国标准化研究院、无锡日联科技股份有限公司、中国邮政集团有限公司、顺丰多式联运有限公司、顺丰科技有限公司、中通供应链管理有限公司、北京京邦达贸易有限公司、国邮恒安(北京)科技有限公司。本文件主要起草人:任仰奇、张婷婷、邱培刚、齐飞帅、刘旭东、吕晓军、刘奇峰、曾毅、刘骏、沈强、杜衍栋、陈奕言、赖建法、芦彬。ⅡJT/T1438—2022引　　言铁路运输是快件运输的重要方式。目前,快件铁路运输市场仍处于发展初期,尚未形成统一的信息交换规范,尤其是快件铁路运输安检环节,信息共享不充分,影响了快件铁路运输的发展。推行多式联运,减少快件铁路运输安检复杂度和工作量,是提高快件转运效率、降低快递服务组织和铁路运输企业安检成本的重要途径。本标准旨在确定快递服务组织和铁路运输企业之间快件安检信息交换内容、格式和规则,促进快件安检信息共享互认,提升安检效率。ⅢJT/T1438—2022快件铁路运输安检数据交换规范1　范围本文件规定了快件铁路运输安检的信息交换需求、信息交换流程、通信协议、数据接口和异常处置。本文件适用于快件铁路运输安检信息数据交换。邮件铁路运输安检信息数据交换参照使用。2　规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T27917.1　快递服务　第1部分:基本术语GB32100　法人和其他组织统一社会信用代码编码规则3　术语和定义、缩略语3.1　术语和定义GB/T27917.1界定的以及下列术语和定义适用于本文件。3.1.1快递服务组织　expressdeliveryserviceorganization在中国境内依法注册的,提供快递服务的企业及其加盟企业、代理企业。注:快递服务组织包括快递企业和邮政企业提供快递服务的机构。[来源:GB/T27917.1—2011,2.2]3.1.2快件　expressitem快递服务组织依法递送的信件、快件、印刷品等的统称。[来源:GB/T27917.1—2011,2.3]3.1.3快递服务组织信息系统　expressdeliveryserviceorganizationinformationsystem快递服务组织用来对快件信息进行数据采集、接收,并对相关数据进行转发交换的信息系统。3.1.4铁路运输企业信息系统　railwaytransportenterpriseinformationsystem铁路运输企业用来对铁路运输行业信息进行数据接收,并对相关数据进行转发、交换、共享的信息系统。3.2　缩略语下列缩略语适用于本文件。HTTP:超文本传输协议(HyperTextTransferProtocol)。HTTPS:安全超文本传输协议(HyperTextTransferProtocoloverSecureSocketLayer)。1JT/T1438—2022JSON:JavaScript对象简谱(JavaScriptObjectNotation)。URL:统一资源定位系统(UniformResourceLocator)。FTP:文件传输协议(FileTransferProtocol)。UTF:Unicode转换格式(UnicodeTransformationForma)。4　信息交换需求快件铁路运输安检信息交换需求应符合表1的规定。表1　信息交换需求序号信息交换类型交换信息项索引发　送　方接　收　方1快件信息　总包号、运单号、品名7.5、7.6快递服务组织信息系统铁路运输企业信息系统2快递服务组织信息　快递服务组织名称、机构代码、联系人、地理位置7.2快递服务组织信息系统铁路运输企业信息系统3安检设备信息　安检设备基础信息(品牌、设备型号)、设备状态7.3、7.4快递服务组织信息系统铁路运输企业信息系统4快件安检信息　过机时间、快件单号、判图结论、处置结果、判图员7.5快递服务组织信息系统铁路运输企业信息系统5安检员信息　安检员基础信息、安检员状态7.8、7.9快递服务组织信息系统铁路运输企业信息系统6图像调取信息　调取图像单号、名称、存储位置7.5铁路运输企业信息系统快递服务组织信息系统7快件结论信息　总包号、单号和原因、嫌疑类型、处置信息7.7铁路运输企业信息系统快递服务组织信息系统5　信息交换流程快递服务组织信息系统应将数据通过点对点模式传输给铁路运输企业信息系统,铁路运输企业信息系统应通过专网或互联网接收数据,并将接收的结果反馈给快递服务组织信息系统。快件铁路运输安检信息交换流程见图1。6　通信协议6.1　传输协议快件铁路运输安检数据交换的接口普通文本信息应使用HTTP协议进行交互,安检员信息及嫌疑快件相关信息应使用HTTPS协议交互,图像文件信息应使用FTP协议传输。6.2　报文格式数据传输与数据返回应采用JSON格式。如接口中涉及中文传递,应通过UTF-8方式转码后再发送。2JT/T1438—2022图1　快件铁路运输安检信息交换流程6.3　接口内容6.3.1　参数、返回值描述属性接口参数和返回值用序号、字段名、中文名称、数据类型、最大长度、约束/条件、描述及要求7个属性描述,参数、返回值内容描述属性见表2。表2　参数、返回值内容描述属性序号描述属性说　　明1序号　数据元在传入参数、返回参数中的排序2字段名　数据库的字段名称3中文名称　数据库的字段名称的对应中文名称4数据类型　数据元的数据取值类型5最大长度　数据传输允许的最大长度,单位为字节6约束/条件　数据元是必备的或可选的,“M”表示该数据元为必备的,“O”表示该数据元为可选的7描述及要求　数据元的简要解释和要求说明6.3.2　数据类型和格式数据类型和格式应符合表3的规定。3JT/T1438—2022表3　数据类型和格式序号数据类型说　　明1String字符串类型2Bool布尔类型3Int整型类型6.4　报文参数快件铁路运输安检数据交换接口参数应符合表4的规定。表4　快件铁路运输安检数据交换接口参数序号字段名中文名称参　数　值约束/条件1Data数据内容　真正传输的信息,实际参考7.1~7.10M2SiteCode站点编号　系统分配,为每个快递服务组织快件安检场地标识号。新增时传“Add”M3DeviceCode安检设备编号　系统分配,为每台入网的安检机标识号。新增时传“Add”,上传站点或人员信息时,传空M4Vstr校验码　加密方式:公共加密方法　加密规则:安检设备编号+URL+公钥+时间(“YYYY-MM-DDHH:mm:ss”)M7　数据接口7.1　网络状态监听网络应连通。当无法连接上层系统时应进行轮询调用,轮询时间为30s。网络状态接口参数应符合表5的规定。表5　网络状态接口参数URL:GetNetState方式:post传入参数Data部分序号字段名中文名称数据类型最大长度约束/条件描述及要求1UpdateTime更新时间String30M　格式“YYYY-MM-DDHH:mm:ss”返回参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1Status返回结果Bool1M　True:成功;False:失败2Remsg提示信息String100O3Recode返回编号Int4M　0:参数不正确;1:成功;2:站点或安检设备不存在;3:失败4JT/T1438—20227.2　快递服务组织信息更新快递服务组织信息应及时更新。在首次初始化信息时应调用本接口,后续信息更新时需再次调用。快递服务组织信息变更接口参数应符合表6的规定。表6　快递服务组织信息更新接口参数URL:UpLoadEnterpriseInfo方式:post传入参数Data部分序号字段名中文名称数据类型最大长度约束/条件描述及要求1EnterpriseBrand快递服务组织名称String50M2EnterpriseCode统一社会信用代码String30M　统一社会信用代码为一组长度为18位的用于法人和其他组织身份识别的代码。该代码按照GB32100规定取值3BranchName分支机构名称String50O　例:北京大兴××分拨中心4BranchCode分支机构编号String30O5ContactsPeople联系人String30M　例:张××6ContactsNumber联系方式String20M　例:139××××56237EnterpriseDesc企业描述String2000O8Position地理位置String500M　需要详细到门牌号返回参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1Status返回结果Bool1M　True:成功;False:失败2Remsg提示信息String100O3Recode返回编号Int4M　0:参数不正确;1:成功;2:站点或安检设备不存在;3:失败4SiteCode站点编号String30M　第一次入网,为系统分配的编号值。生成规则按附录B执行7.3　安检设备状态更新安检设备状态应及时更新,更新内容为开机、关机以及心跳状态,心跳宜为每次60s。安检设备状态更新接口参数应符合表7的规定。表7　安检设备状态更新接口参数URL:UpLoadDeviceState方式:post传入参数Data部分序号字段名中文名称数据类型最大长度约束/条件描述及要求1UpdateTime更新时间String30M　格式“YYYY-MM-DDHH:mm:ss”2DeviceState安检设备状态Int4M　0:关机;1:开机;2:心跳5JT/T1438—2022表7　安检设备状态更新接口参数(续)返回参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1Status返回结果Bool1M　True:成功;False:失败2Remsg提示信息String100O3Recode返回编号Int4M　0:参数不正确;1:成功;2:站点或安检设备不存在;3:失败7.4　安检设备参数传输安检设备参数应及