JT∕T 1352-2020 海铁联运 列车运行与货物追踪接口

目　　次前言Ⅱ…………………………………………………………………………………………………………1　范围1………………………………………………………………………………………………………2　规范性引用文件1…………………………………………………………………………………………3　术语和定义、缩略语1………………………………………………………………………………………4　基本要求1…………………………………………………………………………………………………5　接口描述2…………………………………………………………………………………………………附录A(规范性附录)　海铁联运　列车运行与货物追踪接口XMLSchema15…………………………附录B(资料性附录)　海铁联运　列车运行与货物追踪接口应用实例58………………………………ⅠJT/T1352—2020前　　言本标准按照GB/T1.1—2009给出的规则起草。本标准由全国综合交通运输标准化技术委员会(SAC/TC571)提出并归口。本标准起草单位:连云港港口集团有限公司、连云港电子口岸信息发展有限公司、交通运输部科学研究院、中国铁路上海局集团有限公司、大连港集团有限公司、青岛港(集团)有限公司。本标准主要起草人:朱卫新、金帅、李宏、王明文、王星浩、路璐、徐岩、郭培森、高旻、孙可朝、水玉超、赵超、刘绍杰、吴迪、任玲利。ⅡJT/T1352—2020海铁联运　列车运行与货物追踪接口1　范围本标准规定了海铁联运参与方之间进行列车与货物追踪所使用的电子数据交换接口的基本要求和接口描述。本标准适用于海铁联运领域中列车运行与货物的追踪系统。内河水铁联运等相关类型的信息系统建设及电子数据交换可参照使用。2　规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T7407　中国及世界主要海运贸易港口代码JT/T697.3—2013　交通信息基础数据元　第3部分:港口信息基础数据元JT/T1350　海铁联运　列车磅单报文3　术语和定义、缩略语3.1　术语和定义JT/T1350界定的术语和定义适用于本文件。为了便于使用,以下重复列出了JT/T1350中的某些术语和定义。3.1.1海铁联运　sea-railintermodaltransport采用海运和铁路两种运输方式完成的多式联运。[JT/T1350—2020,定义3.1.1]3.2　缩略语下列缩略语适用于本文件。FTP:文件传输协议(FileTransferProtocol);HTTP:超文本传输协议(HyperTextTransferProtocol);JSON:JavaScript脚本语言对象符号,一种轻量级的数据交换格式(JavaScriptObjectNotation);SOAP:简单对象访问协议,用于交换XML编码信息的轻量级协议(SimpleObjectAccessProtocol);XML:可扩展标记语言(ExtensibleMarkupLanguage)。4　基本要求列车运行与货物追踪接口应满足以下要求:a)　接口保持开放性,部署在开放WEB环境,用户可通过互联网访问;1JT/T1352—2020b)　接口基于WebService方式交换数据;c)　接口的参数及返回值采用JSON方式进行封装;d)　接口应满足以下性能指标:1)　请求响应时间不大于80ms;2)　支持并发连接数不小于50个;3)　事务最长处理时间不大于200ms。5　接口描述5.1　概述列车运行与货物追踪接口的主要组成部分见表1。表1　列车运行与货物追踪接口主要组成部分序号接口名称功能说明函数声明1列车车号位置实时追踪接口　按列车车号追踪列车当前位置Stringgetlcinfobytrainno(Stringparams)2车号历史轨迹追踪接口　按车号追踪车辆在列车运行过程中停靠各站点的历史轨迹,本接口返回多条记录Stringgetlcinfohisbytrainno(Stringparams)3列车车次追踪接口　按发运车次追踪列车位置信息,本接口返回多条记录Stringgetlcinfobycc(Stringparams)4列车箱号位置实时追踪接口　按集装箱箱号追踪列车当前位置Stringgetlcinfobyctn(Stringparams)5海运提单列车位置追踪接口　按海运的船名航次提单号查询本提单下列车位置,本接口可返回多个记录Stringgetlcinfobyblno(Stringparams)6港口委托列车位置追踪接口　按用户在码头办理的作业委托号查询本委托下对应列车所在位置Stringgetlcinfobywtno(Stringparams)7车号货物轨迹追踪接口　按列车车号追踪货物在港口的海铁联运作业历史轨迹Stringgetportinfobytrainno(Stringparams)8箱号货物轨迹追踪接口　按箱号追踪货物在港口的海铁联运作业历史轨迹,本接口返回多条记录Stringgetportinfobyctn(Stringparams)9提单号货物轨迹追踪接口　按海运提单号追踪货物在港口的海铁联运作业历史轨迹Stringgetportinfobyblno(Stringparams)10港口委托货物轨迹追踪接口　按码头作业委托号追踪货物在港口的海铁联运作业历史轨迹Stringgetportinfobywtno(Stringparams)2JT/T1352—20205.2　主要接口内容5.2.1　参数、返回值描述属性接口参数用参数名、约束/条件、数据类型和格式、说明、引用文件5个属性描述,接口返回值用返回值名、约束/条件、数据类型和格式、说明、引用文件5个属性描述,描述属性和解释说明见表2。表2　参数、返回值内容描述属性序号描述属性解释说明1序号　数据元在参数、返回值中的排序2参数名　参数中数据元对应代码3返回值名　返回值中数据元对应代码4约束/条件　说明该数据元是必备的或可选的,“M”表示该数据元为必备的,“O”表示该数据元为可选的5数据类型和格式　说明数据元的数据取值类型和最大字节数,见5.2.26说明　对数据元的简要解释和应用说明7引用文件　对数据元引用的国家标准加以说明5.2.2　数据类型和格式数据类型和格式见表3。表3　数据类型和格式序号数据类型格式说明1n　表示固定或变长数字型,例如:n8表示定长8位的数字型,n..8表示最短为1位,最长为8位的数字型2an　表示固定或变长数字字符型,例如:an8表示定长8位的数字字符型,an..8表示最短为1位,最长为8位的数字字符型3YYYYMMDD　日期,YYYY表示年份,MM表示月份,DD表示天4hhmmss　时间,hh表示小时,mm表示分钟,ss表示秒5.2.3　列车车号位置实时追踪5.2.3.1　接口参数见表4。表4　列车车号位置实时追踪接口参数序号参　数　名约束/条件数据类型和格式说　　明引用文件1access_idMn..10访问标识—2access_tokenMan..22应用认证信息—3trainnoMan7列车车号—3JT/T1352—20205.2.3.2　接口返回值见表5。表5　列车车号位置实时追踪接口返回值序号返回值名约束/条件数据类型和格式说　　明引用文件1messageMan1　调用结果标志:　0-接口调用成功;　1-未找到用户;　2-未获得授权;　3-服务访问超时—2departure_station_nameMan..20　发站名—3destination_station_nameMan..20　到站名—4ctnnoOan11　集装箱箱号—5current_locationMan..20　当前位置,铁路货车所在车站—6operation_timeMYYYYMMDDhhmm　铁路货车所在车站的最新作业时间—7statusMan..10　状态(在途、终到)—8vesselOan..100　船名航次—9blnoOan..100　提单号—10cargo_nameMan..40　品名　符合JT/T697.3—2013中数据元GK030101003规定11consigneeMan..60　收货人—12ship_timeMYYYYMMDDhhmm　发运时间—13destination_special_lineOan..60　到达专用线—14departure_special_lineOan..60　出发专用线—15port_agentMan..40　口岸代理—16estimated_arrival_timeMYYYYMMDDhhmm　预计终到时间—5.2.4　车号历史轨迹追踪5.2.4.1　接口参数见表6。4JT/T1352—2020表6　车号历史轨迹追踪接口参数序号参　数　名约束/条件数据类型和格式说　　明引用文件1access_idMn..10访问标识—2access_tokenMan..22应用认证信息—3trainnoMan7列车车号—5.2.4.2　接口返回值见表7。表7　车号历史轨迹追踪接口返回值序号返回值名约束/条件数据类型和格式说　　明引用文件1messageMan1　调用结果标志:　0-接口调用成功;　1-未找到用户;　2-未获得授权;　3-服务访问超时—2departure_station_nameMan..20　发站名—3destination_station_nameMan..20　到站名—4ctnnoOan11　集装箱箱号—5current_locationMan..20　当前位置,铁路货车所在车站—6operation_timeMYYYYMMDDhhmm　铁路货车所在车站的最新作业时间—7statusMan..10　状态(在途、终到)—8vesselOan..100　船名航次—9blnoOan..100　提单号—10cargo_nameMan..40　品名　符合JT/T697.3—2013中数据元GK030101003规定11consigneeMan..60　收货人—12ship_timeMYYYYMMDDhhmm　发运时间—13destination_special_lineOan..60　到达专用线—14departure_special_lineOan..60　出发专用线—15port_agentMan..40　口岸代理—5.2.5　列车车次追踪5.2.5.1　接口参数见表8。5JT/T1352—2020表8　列车车次追踪接口参数序号参　数　名约束/条件数据类型和格式说　　明引用文件1access_idMn..10访问标识—2access_tokenMan..22应用认证信息—3trainsnumMan5列车车次—5.2.5.2　接口返回值见表9。表9　列车车次追踪接口返回值序号返回值名约束/条件数据类型和格式说　　明引用文件1messageMan1　调用结果标志:　0-接口调用成功;　1-未找到用户;　2-未获得授权;　3-服务访问超时—2departure_station_nameMan..20　发站名—3destination_station_nameMan..20　到站名—4trainnoMan7　车号—5ctnnoOan11　集装箱箱号—6current_locationMan..20　当前位置,铁路货车所在车站—7operation_timeMYYYYMMDDhhmm　铁路货车所在车站的最新作业时间—8statusMan..10　状态(在途、终到)—9vesselOan..100　船名航次—10blnoOan..100　提单号—11cargo_nameMan..40　品名　符合JT/T697.3—2013中数据元GK030101003规定12consigneeMan..60　收货人—13ship_timeMYYYYMMDDhhmm　发运时间—14destination_special_lineOan..60