首页 > 交通行业标准(JT) > JT/T 1352-2020 海铁联运列车运行与货物追踪接口
JT/T 1352-2020

基本信息

标准号: JT/T 1352-2020

中文名称:海铁联运列车运行与货物追踪接口

标准类别:交通行业标准(JT)

标准状态:现行

出版语种:简体中文

下载格式:.zip .pdf

下载大小:6414199

相关标签: 联运 列车运行 货物 追踪 接口

标准分类号

关联标准

出版信息

相关单位信息

标准简介

JT/T 1352-2020 Sea-rail intermodal transport-Train and cargo tracking interface.
1范围
JT/T 1352规定了海铁联运参与方之间进行列车与货物追踪所使用的电子数据交换接口的基本要求和接口描述。
JT/T 1352适用于海铁联运领城中列车运行与货物的追踪系统。内河水铁联运等相关类型的信息系统建设及电子数据交换可参照使用。
2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。
GB/T7407中国及世界主要海运贸易港口代码.
JT/T 697.3- -2013交通信息基础数据元第3 部分:港口信息基础数据元
JT/T 1350海铁联运列车磅单报文
3术语和定义、缩略语
3.1术语和定义
JT/T 1350界定的术语和定义适用于本文件。为了便于使用,以下重复列出了JI/T 1350中的某些
术语和定义。
3.1.1海铁联运sea-rail intermodal transport
采用海运和铁路两种运输方式完成的多式联运。
[JT/T 1350- 2020,定义3.1.1]

标准图片预览






标准内容

ICS03.220.01
中华人民共和国交通运输行业标准JT/T1352—2020
海铁联运
列车运行与货物追踪接口
Sea-rail intermodal transport-Train and cargo tracking interfaceJT
2020-12-30发布
中华人民共和国交通运输部
2021-03-01实施
规范性引用文件
术语和定义、缩略语
基本要求
5接口描述
附录A(规范性附录)
附录B(资料性附录)
海铁联运
海铁联运
列车运行与货物追踪接口XMLSchema列车运行与货物追踪接口应用实例JT
JT/T1352—2020
JT/T1352—2020
本标准按照CB/T1.1—2009给出的规则起草本标准由全国综合交通运输标准化技术委员会(SAC/TC571)提出并归口。本标准起草单位:连云港港口集团有限公司、连云港电子口岸信息发展有限公司、交通运输部科学研究院、中国铁路上海局集团有限公司、大连港集团有限公司、青岛港(集团)有限公司本标准主要起草人:朱卫新、金帅、李宏、王明文、王星浩、路璐、徐岩、郭培森、高曼、孙可朝、水玉超、赵超、刘绍杰、吴迪、任玲利。JT
1范围
海铁联运
列车运行与货物追踪接口
JT/T1352—2020
本标准规定了海铁联运参与方之间进行列车与货物追踪所使用的电子数据交换接口的基本要求和接口描述
本标准适用于海铁联运领域中列车运行与货物的追踪系统。内河水铁联运等相关类型的信息系统建设及电子数据交换可参照使用。2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T7407中国及世界主要海运贸易港口代码TT/T697.3一2013交通信息基础数据元第3部分:港口信息基础数据元JT/T1350海铁联运列车磅单报文3术语和定义、缩略语
3.1术语和定义
IT/T1350界定的术语和定义适用于本文件。为了便于使用以下重复列出了JT/T1350中的某此术语和定义。
sea-rail intermodal transport海铁联运
采用海运和铁路两种运输方式完成的多式联运,[JT/T1350—2020,定义3.1.1]
3.2缩略语
下列缩略语适用于本文件。
FTP:文件传输协议(FileTransferProtocol);HTTP:超文本传输协议(HyperTextTransferProtocol):UT
JSON:JavaScript脚本语言对象符号,一种轻量级的数据交换SOAP:简单对象访问协议,用于交换XML编码信息的轻量级以XML:可扩展标记语言(ExtensibleMarkupLanguage)。4基本要求
列车运行与货物追踪接口应满足以下要求,a)接口保持开放性,部署在开放WEB环境,用户可通过互联网访间;Notation);
AccessProtocol);
JT/T1352—2020
接口基于WebService方式交换数据:接口的参数及返回值采用JSON方式进行封装;接口应满足以下性能指标:
1)请求响应时间不大于80ms;
2)支持并发连接数不小于50个;3)事务最长处理时间不大于200ms。5接口描述
5.1概述
列车运行与货物追踪接口的主要组成部分见表1表1列车运行与货物追踪接口主要组成部分序号
接口名称
列车车号位置实时追踪接口
车号历史轨迹追踪接口
列车车次追踪接口
列车箱号位置实时追踪接口
海运提单列车位置追踪接口
港口委托列车位置追踪接口
车号货物轨迹追踪接口
箱号货物轨迹追踪接口
提单号货物轨迹追踪接口
港口委托货物轨迹追踪接口
功能说明
按列车车号追踪列车当前位置
按车号追踪车辆在列车运行过程函数声明免费标准bzxz.net
String getlcinfobytrainno(String params)String getlcinfohisbytrainno(String params)中停靠各站点的历史轨迹,本接口返回多条记录
按发运车次追踪列车位置信息
本接口返回多条记录
按集装箱箱号追踪列车当前位置按海运的船名航次提单号查询本提单下列车位置,本接口可返回多个记录
按用户在码头办理的作业委托号查询本委托下对应列车所在位置按列车车号追踪货物在港口的海铁联运作业历史轨迹
按箱号追踪货物在港口的海铁联运作业历史轨迹,本接口返回多条记录
按海运提单号追踪货物在港口的海铁联运作业历史轨迹
按码头作业委托号追踪货物在港口的海铁联运作业历史轨迹
String getlcinfobycc(String params)String getlcinfobyctn(String params)String getlcinfobyblno( String params)String getlcinfobywtno(String params)String getportinfobytrainno(String params)rg getpeaimcobyctn(String params)JT
robyblno(String params)
String getportinfobywtno( String params)5.2主要接口内容
参数、返回值描述属性
JT/T1352—2020
接口参数用参数名、约束/条件、数据类型和格式、说明、引用文件5个属性描述,接口返回值用返回值名、约束/条件、数据类型和格式、说明、引用文件5个属性描述,描述属性和解释说明见表2表2参数、返回值内容描述属性
描述属性
参数名
返回值名
约束/条件
数据类型和格式
引用文件
数据类型和格式
数据类型和格式见表3
数据类型
YYYYMMDD
hhmmss
列车车号位置实时追踪
接口参数见表4,
解释说明
数据元在参数、返回值中的排序参数中数据元对应代码
返回值中数据元对应代码
说明该数据元是必备的或可选的,“M”表示该数据元为必备的,“O”表示该数据元为可选的
说明数据元的数据取值类型和最大字节数见5.2.2对数据元的简要解释和应用说明对数据元引用的国家标准加以说明数据类型和格式
格式说明
表示固定或变长数字型,例如:n8表示定长8位的数字型,n..8表示最短为1位,最长为8位的数字型
表示固定或变长数字字符型,例如:an8表示定长8位的数字字符型,an..8表示最短为1位,最长为8位的数字字符型日期,YYYY表示年份,MM表示月份,DD表示天时间,hh表示小时,mm表示分钟,ss表示秒JT
表4列车车号位置实时追踪接口
参数名
access_id
access_token
trainno
约束/条件
数据类型和格式
访间标识
应用认证信息
列车车号
引用文件
JT/T1352—2020
接口返回值见表5
返回值名
message
departure_
station_name
destination
station_name
current_location
operation_time
status
vessel
cargo_name
consignee
ship_time
destination_special_line
departure_special_line
port_agent
estimated_arrival_time
车号历史轨迹追踪
接口参数见表6。
表5列车车号位置实时追踪接口返回值约束/条件
数据类型和格式
YYYYMMDDhhmm
YYYYMMDDhhmm
YYYYMMDDhhmm
调用结果标志:
0-接口调用成功;
1-未找到用户;
2-未获得授权;
3-服务访问超时
发站名
到站名
集装箱箱号
当前位置,铁路货车所
在车站
铁路货车所在车站的最
新作业时间
状态(在途、终到)
船名航次
提单号
收货人
发运时间
预计终到时间
引用文件
符合JT/T697.3
2013中数据元
GK030101003规定
参数名
acess_id
access_token
trainno
约束/条件
接口返回值见表7。
返回值名
message
departure_station_name
destination_
station_name
current_location
operation_time
status
vessel
cargo_name
consignee
ship_time
destination_special_line
departure_special_line
port_agent
列车车次追踪
接口参数见表8
约束/条件
车号历史轨迹追踪接口参数
数据类型和格式
访问标识
应用认证信息
列车车号
车号历史轨迹追踪接口返回值
数据类型和格式
YYYYMMDDhhmm
YYYYMMDDhhmm
调用结果标志:
0-接口调用成功;
1-未找到用户;
2-未获得授权;
3-服务访问超时
发站名
到站名
集装箱箱号
当前位置,铁路货车所
在车站
铁路货车所在车站的最
新作业时间
状态(在途、终到)
船名航次
提单号
出发专用线
口岸代理
JT/T1352—2020
引用文件
引用文件
符合JT/T697.3-
2013中数据元
GK030101003规定
JT/T1352—2020
参数名
access_id
access_token
trainsnum
约束/条件
接口返回值见表9。
返回值名
message
departure_station_name
destination_station_name
trainno
current_location
operation_time
status
vessel
cargo_name
consignee
ship_time
destination_special_line
departure_special_line
port_agent
estimated_arrival_time
约束/条件
列车车次追踪接口参数
数据类型和格式
访问标识
应用认证信息
列车车次
列车车次追踪接口返回值
数据类型和格式
YYYYMMDDhhmm
YYYYMMDDhhmm
YYYYMMDDhhmm
调用结果标志:
0-接口调用成功;
1-未找到用户;
2-未获得授权;
3-服务访问超时
发站名
到站名
集装箱箱号
当前位置,铁路货车所
在车站
铁路货车所在车站的最
新作业时间
状态(在途、终到)
船名航次
提单号
到达专用线
出发专用线
口岸代理
预计终到时间
引用文件
引用文件
符合JT/T697.3
2013中数据元
GK030101003规定
列车箱号位置实时追踪
接口参数见表10。
参数名
access_id
access_token
trainno
约束/条件
接口返回值见表11
返回值名
message
departure_station_name
destination_station_name
trainno
current_location
operation_time
status
vessel
cargo_name
consignee
ship_time
destination_special_line
departure_special_line
port_agent
estimated_arrival_time
列车箱号位置实时追踪接口参数数据类型和格式
访问标识
应用认证信息
列车车号
列车箱号位置实时追踪接口返回值约束/条件
数据类型和格式
YYYYMMDDhhmm
YYYYMMDDhhmm
YYYYMMDDhhmm
调用结果标志:
0-接口调用成功;
1-未找到用户;
2-未获得授权;
3-服务访问超时
发站名
到站名
当前位置,铁路货车所
在车站
铁路货车所在车站的最
新作业时间
状态(在途、终到)
船名航次
提单号
发运时间
到达专用线
出发专用线
口岸代理
预计终到时间
JT/T1352—2020
引用文件
引用文件
符合JT/T697.3—
2013中数据元
K030101003规定
JT/T1352—2020
海运提单列车位置追踪接口
接口参数见表12。
access_id
access_token
vessel
voyage
约束/条件
接口返回值见表13。
返回值名
message
departure_station_name
destination_station_name
trainno
current_location
operation_time
status
vessel
cargo_name
consignee
ship_time
海运提单列车位置追踪接口参数数据类型和格式
访问标识
应用认证信息
船名,为国际通行标准
英文船名
提单号
海运提单列车位置追踪接口返回值约束/条件
数据类型和格式
YYYYMMDDhhmm
YYYYMMDDhhmm
调用结果标志:
0-接口调用成功;
1-未找到用户;
2-未获得授权;
3-服务访问超时
发站名
到站名
集装箱箱号
当前位置,铁路货车所
在车站
铁路货车所在车站的最
新作业时间
状态(在途、终到)
收货人
发运时间,格式
引用文件
引用文件
符合JT/T697.3-
2013中数据元
GK030101003规定
返回值名
destination_special_line
departure_special_line
port_agent
estimated_arrival_time
约束/条件
港口委托列车位置追踪
接口参数见表14
access_id
access_token
entrustno
portcode
约束/条件
接口返回值见表15。
返回值名
message
departure_station_name
destination_station_name
trainno
current_location
operation_time
表13(续)
数据类型和格式
YYYYMMDDhhmm
到达专用线
出发专用线
口岸代理
预计终到时间
港口委托列车位置追踪接口参数数据类型和格式
访问标识
应用认证信息
码头作业委托号,委托
类型限定为装卸铁路货
车、装船、卸船等货物作业
过程委托
作业港口代码
港口委托列车位置追踪接口返回值约束/条件
数据类型和格式
YYYYMMDDhhmm
调用结果标志:
0-接口调用成功;
1-未找到用户;
2-未获得授权;
3-服务访问超时
集装箱精
当前位置,铁路货车所
在车站
铁路货车所在车站的最
新作业时间
JT/T1352—2020
引用文件
引用文件
符合GB/T7407规定
引用文件
小提示:此标准内容仅展示完整标准里的部分截取内容,若需要完整标准请到上方自行免费下载完整标准文档。