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

标准分享吧http://www.bzfxbJT/T1438—2022前言 引言 2规范性引用文件 4信息交换需求 5信息交换流程 6通信协议 7数据接口 8异常处置 附录A(资料性)快件异常类型编号对照表 附录B(规范性)站点和安检设备编号生成规则 附录C(规范性)安检图像文件、安检员和包裹标识编号生成规则 参考文献 Ⅰ标准分享吧http://www.bzfxbJT/T1438—2022本文件按照GB/T1.1—2020《标准化工作导则第1部分:标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由全国综合交通运输标准化技术委员会(SAC/TC571)提出并归口。本文件起草单位:国家邮政局邮政业安全中心、同方威视技术股份有限公司、中国铁道科学研究院集团有限公司电子计算技术研究所、邮政科学研究规划院有限公司、中国标准化研究院、无锡日联科技股份有限公司、中国邮政集团有限公司、顺丰多式联运有限公司、顺丰科技有限公司、中通供应链管理有限公司、北京京邦达贸易有限公司、国邮恒安(北京)科技有限公司。Ⅱ标准分享吧http://www.bzfxbJT/T1438—2022铁路运输是快件运输的重要方式。目前,快件铁路运输市场仍处于发展初期,尚未形成统一的信息交换规范,尤其是快件铁路运输安检环节,信息共享不充分,影响了快件铁路运输的发展。推行多式联运,减少快件铁路运输安检复杂度和工作量,是提高快件转运效率、降低快递服务组织和铁路运输企业安检成本的重要途径。本标准旨在确定快递服务组织和铁路运输企业之间快件安检信息交换内容、格式和规则,促进快件安检信息共享互认,提升安检效率。Ⅲ标准分享吧http://www.bzfxbJT/T1438—2022快件铁路运输安检数据交换规范本文件规定了快件铁路运输安检的信息交换需求、信息交换流程、通信协议、数据接口和异常处置。本文件适用于快件铁路运输安检信息数据交换。邮件铁路运输安检信息数据交换参照使用。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB32100法人和其他组织统一社会信用代码编码规则GB/T27917.1界定的以及下列术语和定义适用于本文件。在中国境内依法注册的,提供快递服务的企业及其加盟企业、代理企业。注:快递服务组织包括快递企业和邮政企业提供快递服务的机构。快递服务组织用来对快件信息进行数据采集、接收,并对相关数据进行转发交换的信息系统。铁路运输企业用来对铁路运输行业信息进行数据接收,并对相关数据进行转发、交换、共享的信息系统。下列缩略语适用于本文件。1标准分享吧http://www.bzfxbJT/T1438—20224信息交换需求快件铁路运输安检信息交换需求应符合表1的规定。序号信息交换类型交换信息项索引发送方接收方1快件信息快递服务组织信息系统铁路运输企业信息系统2快递服务组织信息快递服务组织名称、机构代码、快递服务组织信息系统铁路运输企业信息系统3安检设备信息安检设备基础信息(品牌、设备快递服务组织信息系统铁路运输企业信息系统4快件安检信息快递服务组织信息系统铁路运输企业信息系统5安检员信息安检员基础信息、安检员状态快递服务组织信息系统铁路运输企业信息系统6图像调取信息铁路运输企业信息系统快递服务组织信息系统7快件结论信息铁路运输企业信息系统快递服务组织信息系统5信息交换流程快递服务组织信息系统应将数据通过点对点模式传输给铁路运输企业信息系统,铁路运输企业信息系统应通过专网或互联网接收数据,并将接收的结果反馈给快递服务组织信息系统。快件铁路运输安检信息交换流程见图1。6通信协议快件铁路运输安检数据交换的接口普通文本信息应使用HTTP协议进行交互,安检员信息及嫌疑快件相关信息应使用HTTPS协议交互,图像文件信息应使用FTP协议传输。数据传输与数据返回应采用JSON格式。如接口中涉及中文传递,应通过UTF-8方式转码后再发送。2标准分享吧http://www.bzfxbJT/T1438—2022图1快件铁路运输安检信息交换流程性描述,参数、返回值内容描述属性见表2。序号描述属性说明1序号数据元在传入参数、返回参数中的排序2字段名数据库的字段名称3中文名称数据库的字段名称的对应中文名称4数据类型数据元的数据取值类型5最大长度数据传输允许的最大长度,单位为字节6约束/条件数据元是必备的或可选的,“M”表示该数据元为必备的,“O”表示该数据元为可选的7描述及要求数据元的简要解释和要求说明6.3.2数据类型和格式数据类型和格式应符合表3的规定。3标准分享吧http://www.bzfxbJT/T1438—2022表3数据类型和格式序号数据类型说明1字符串类型2布尔类型3整型类型快件铁路运输安检数据交换接口参数应符合表4的规定。表4快件铁路运输安检数据交换接口参数序号字段名中文名称参数值约束/条件1数据内容真正传输的信息,实际参考7.1~7.10M2站点编号系统分配,为每个快递服务组织快件安检场地标识号。新增M3安检设备编号系统分配,为每台入网的安检机标识号。新增时传“Add”,上传站点或人员信息时,传空M4校验码加密方式:公共加密方法加密规则:安检设备编号+URL+公钥+时间(“YYYY-MM-M7数据接口网络应连通。当无法连接上层系统时应进行轮询调用,轮询时间为30s。网络状态接口参数应符表5网络状态接口参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1更新时间M返回参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1返回结果1MTrue:成功;False:失败2提示信息O3返回编号4M0:参数不正确;1:成功;2:站点或安检设备不存在;3:失败4标准分享吧http://www.bzfxbJT/T1438—20227.2快递服务组织信息更新快递服务组织信息应及时更新。在首次初始化信息时应调用本接口,后续信息更新时需再次调用。快递服务组织信息变更接口参数应符合表6的规定。表6快递服务组织信息更新接口参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1快递服务组织名称M2统一社会信用代码M统一社会信用代码为一组长度为18位的用于法人和其他组织身份识别的代码。该代码按照GB32100规定取值3分支机构名称O例:北京大兴××分拨中心4分支机构编号O5联系人M6联系方式M7企业描述O8地理位置M需要详细到门牌号返回参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1返回结果1MTrue:成功;False:失败2提示信息O3返回编号4M0:参数不正确;1:成功;2:站点或安检设备不存在;3:失败4站点编号M第一次入网,为系统分配的编号值。生成规则按附录B执行7.3安检设备状态更新安检设备状态应及时更新,更新内容为开机、关机以及心跳状态,心跳宜为每次60s。安检设备状态更新接口参数应符合表7的规定。表7安检设备状态更新接口参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1更新时间M2安检设备状态4M0:关机;1:开机;2:心跳5标准分享吧http://www.bzfxbJT/T1438—2022表7安检设备状态更新接口参数(续)返回参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1返回结果1MTrue:成功;False:失败2提示信息O3返回编号4M0:参数不正确;1:成功;2:站点或安检设备不存在;3:失败7.4安检设备参数传输安检设备参数应及时传输。在安检设备首次入网时应调用本接口,后续安检设备信息更新时需再次调用。安检设备传输参数应符合表8的规定。表8安检设备传输接口参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1安检设备编号M2安检设备序列号M3安检设备状态M4安检设备品牌M5安检设备型号M6穿透力O7速度O8通道尺寸M9具备智能识别1MOOOO返回参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1返回结果1MTrue:成功;False:失败2提示信息O3返回编号4M0:参数不正确;1:成功;2:站点或安检设备不存在;3:失败4安检设备编号M第一次入网将该安检设备分配的编号值返回至系统。生成规则按附录B执行6标准分享吧http://www.bzfxbJT/T1438—20227.5快件安检信息传输与图像调取当快件过机时,应实时将快件的基础信息上传至铁路运输企业信息系统。当重大活动或特定要求铁路运输企业系统需要调取图像文件时,返回图像地址信息,快递服务组织信息系统应按照返回的图像地址信息将图像上传至特定位置(FTP协议);当不需要调取图像文件时,返回的图像地址信息为空,此时无须再上传图像文件。若图像文件上传失败,则应轮询重试,轮询时间每次10s,轮询最大次数为10次,若超过10次仍无法成功,则应调用“上传失败通知”接口通知服务器。安检图像传输参数应符合表9的规定。表9快件安检信息和图像信息传输接口参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1过机时间M2快件单号O无法获取快件单号时传空字符串3快件结论4M0:无结论;1:放行;2:查验放行;3:暂扣4面单信息O|充电宝”}]5快件嫌疑框O6快件处理结果4O1:暂扣;2:放行;3:转运;4:退回7嫌疑类型编号O编号对照表见附录A8判图员M9判图时间M图像名称O当传空字符串时,上层系统返回参数中将指定ImageName,此时需按照上层返回的名称正确上传。当传递图像名称时,上传系统将直接接收,不再重新指定,上传的名称不应包含中文,同一天同一台安检设备不应重复,应包含扩展名返回参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1返回结果1MTrue:成功;False:失败2提示信息O7标准分享吧http://www.bzfxbJT/T1438—2022表9快件安检信息和图像信息传输接口参数(续)序号字段名中文名称数据类型最大长度约束/条件描述及要求3返回编号4M0:参数不正确;1:成功;2:站点或安检设备不存在;3:失败4返回图像上传实体类M序号字段名中文名称数据类型最大长度约束/条件描述及要求1快件安检图像文件名称MImagename参数为空时,该值为系统自动生成,生成规则按附录C执行2快件单号或包裹唯一标识号M当请求参数存在条码号,返回请求的条码号;当请求参数没有,返回系统分配的唯一标识值,用于定位该快件,生成规则按附录C执行3Ftp上传路径O若返回为空时,无须再上传图像4用户名O5密码O7.6条码上传接口若现场没有实现条码与快件的绑定,则在快件进入X光机之前可进行扫码操作,调用本接口,将条码发送至铁路运输企业信息系统。条码扫描位置应固定,每个快件垂直间隔应大于30cm,且在扫码后到入机前不应中途搬离或移动快件。条码上传接口参数应符合表10的规定。表10条码上传接口参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1条码单号M2更新时间M3是否是清除码1O当需要清除时,传True返回参数序号字段名中文名称数据类型长度约束/条件描述及要求1返回结果1MTrue:成功;False:失败2提示信息O3返回编号M0:参数不正确;1:成功;2:站点或安检设备不存在;3:失败8标准分享吧http://www.bzfxbJT/T1438—20227.7快件结论信息反馈安检快件图像上传完成后,上层系统如需修改快件的判图结论,应根据安检图像上传接口返回的条码号定位该快件,更新快件的结果信息。快件结论更新接口参数应符合表11的规定。表11快件结论更新接口参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1快件单号或系统分配唯一标识值M2快件嫌疑框OJson格式,例如:3快件结论4M1:放行;2:查验放行;3:暂扣4嫌疑类型编号M个嫌疑物时,按照顺序用“|”隔开,编号对照表见附录A5判图员M6判图时间M返回参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1返回结果1MTrue:成功;False:失败2提示信息O3返回编号4M0:参数不正确;1:成功;2:站点或安检设备不存在;3:失败7.8安检员信息上传安检员信息应及时上传。当安检员首次登记上传或信息变更时,应调用安检员信息接口。安检员信息接口参数应符合表12的规定。表12安检员信息接口参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1安检员编号M2安检员姓名M9标准分享吧http://www.bzfxbJT/T1438—2022表12安检员信息接口参数(续)序号字段名中文名称数据类型最大长度约束/条件描述及要求3安检员性别4M0:女;1:男4出生日期M5安检员手机号M6籍贯O例如:“河北省衡水市”7所属快递服务组织O8文化程度O9安检证书编号O从业日期O安检员头像FileO返回参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1返回结果1MTrue:成功;False:失败2提示信息O3返回编号4M0:参数不正确;1:成功;2:站点或安检设备不存在;3:失败4安检员编号M安检员首次入网时,返回系统分配的安检员编号,生成规则按附录C执行7.9安检员状态更新安检员状态应及时更新。快递服务组织使用自己的系统管理安检员时,应调用此接口将安检员在岗状态上传给铁路运输企业信息系统。安检员状态更新接口参数应符合表13的规定。表13安检员状态更新接口参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1安检员编号M2更新时间M3安检员状态4M0:离岗;1:上岗;2:心跳返回参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1返回结果1MTrue:成功;False:失败2提示信息O3返回编号4M0:参数不正确;1:成功;2:站点或安检设备不存在;3:失败标准分享吧http://www.bzfxbJT/T1438—2022当文件上传失败次数达到10次时,应调用本接口,通知铁路运输企业信息系统的服务器。上传失败通知参数应符合表14的规定。表14上传失败通知接口参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1快件单号或系统分配唯一标识值M2上传时间M3MFtp服务器信息:全地址|用户名|密码。例如:4错误信息描述M返回参数序号字段名中文名称数据类型最大长度约束/条件描述及要求1返回结果1MTrue:成功;False:失败2提示信息M3返回编号M0:参数不正确;1:成功;2:站点或安检设备不存在;3:失败8异常处置当信息系统连接超时,应将需要上传的数据记录在快递服务组织信息系统进行缓存。当快递服务组织信息系统缓存不为空时,应使用轮询方式调用“网络状态检查”接口,检测网络状态;当网络恢复时,应将缓存的记录逐一上传至铁路运输企业信息系统,并在系统返回成功后,清除快递服务组织信息系统中缓存的记录。当快递服务组织信息系统调用上传接口时,应监控每一次返回结果,若超时或返回结果为失败,应重新上传,上传周期为1次每分钟,直至返回成功。8.3上传信息要求上传的图片等资源文件每张宜不超过200kB。为保证快速读取,在不影响质量的前提下,应减小标准分享吧http://www.bzfxbJT/T1438—2022(资料性)快件异常类型编号对照表快件异常类型编号见表A.1。表A.1快件异常类型编号对照表一级分类类型编号详细描述(含主要零部件)民用枪:气枪、猎枪、运动枪、麻醉注射枪等以及各类配用子弹枪支、子弹类(含主要零部件)的样品、仿制品其他枪支及配用子弹:道具枪、发令枪、钢珠枪等爆炸物品类烟火制品:礼花弹、烟花、鞭炮、摔炮、拉炮、砸炮、发令纸等各类烟花爆竹以爆炸物品类的仿制品其他爆炸物品类,如推进剂、发射药、硝化棉、管制器具管制刀具:匕首、三棱刀(包括机械加工用的三棱刮刀)、带有自锁装置的弹簧刀以及其他类似的单刃、双刃刀等易燃易爆物品及其容器以及打火机等有毒气体:如一氧化碳、一氧化氮、氯气等及含易燃溶剂的制品等自燃物品:如黄磷、白磷、硝化纤维(含胶片)、钛粉、油纸及氧化剂和有机过氧化物:如高锰酸盐、高氯酸盐、氧化氢、过氧化钠、过氧化其他易燃易爆物品毒害品其他毒害品腐蚀性物品或碱液的)、汞(水银)等其他腐蚀性物品放射性物品其他放射性物品标准分享吧http://www.bzfxbJT/T1438—2022表A.1快件异常类型编号对照表(续)一级分类类型编号详细描述其他传染病病原体正当用途麻醉药品和精神药品、非正当用途的易制毒化学品吸毒工具:如冰壶等音像制品等宣传品如含有反动、煽动民族仇恨、破坏国家统一、破坏社会稳定、宣扬邪教、宗教其他非法文宣品间谍专用器材如暗藏式窃听器材、窃照器材、突发式收发报机、一次性密码本、密写工具、用于获取情报的电子监听和截收器材等其他间谍器材非法伪造物品其他非法文宣品侵犯知识产权和假冒伪劣物品侵犯知识产权:如侵犯专利权、商标权、著作权的图书、音像制品等其他侵权假冒伪劣物品濒危野生动物及其制品其他濒危野生动物及制品涉密和禁止出入境物品内容涉及国家秘密的文件、资料及其他物品其他涉密和禁止出入境物品其他禁运物品可能干扰列车信号的强磁化物、有强烈刺激性气味的物品、不能判明性质可国家法律、行政法规、国务院和国务院有关部门规定的其他禁止携带、运输的物品其他禁运物品编号规则参考《禁止携带物品目录》及《禁止寄递物品管理规定》制定:a)对运输过程中的安检异常包裹类型编号以KT开头,其中K表示快件,T表示铁路。b)安检异常包裹编号用完整的3段字符进行标识,共9位长度,每段字符各2位数字,从“11”开始顺序编号,以1)第1段字符代表异常类型的一级分类,如KT11为枪支弹药类,KT12为爆炸物品类;2)第2段字符代表一级分类下的二级分类,如KT11.13为枪支弹药样品和仿制品类;3)第3段字符代表二级分类下的三级分类,本规范不进行强制性的三级分类,各业务系统可以结合自身业c)对一级分类、二级分类未覆盖的其他情况,可使用“90”字符代表该分类层级下的其他类,如KT90为一级分类下的其他禁运物品类,KT11.90.00为KT11枪支弹药类下的其他枪支弹药类。d)根据后续技术发展或业务发展需要,可逐步对本规范编号规则进行修订,可在不改变编号长度和分类规则的情况下增加新的类型编号,每段字符应采用顺序取号的方式