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

ⅠJT/T1352—2020前言 2规范性引用文件 4基本要求 5接口描述 附录A(规范性附录)海铁联运列车运行与货物追踪接口XMLSchema 附录B(资料性附录)海铁联运列车运行与货物追踪接口应用实例 ⅡJT/T1352—2020本标准由全国综合交通运输标准化技术委员会(SAC/TC571)提出并归口。本标准起草单位:连云港港口集团有限公司、连云港电子口岸信息发展有限公司、交通运输部科学研究院、中国铁路上海局集团有限公司、大连港集团有限公司、青岛港(集团)有限公司。1JT/T1352—2020海铁联运列车运行与货物追踪接口本标准规定了海铁联运参与方之间进行列车与货物追踪所使用的电子数据交换接口的基本要求和接口描述。本标准适用于海铁联运领域中列车运行与货物的追踪系统。内河水铁联运等相关类型的信息系统建设及电子数据交换可参照使用。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T7407中国及世界主要海运贸易港口代码JT/T697.3—2013交通信息基础数据元第3部分:港口信息基础数据元JT/T1350海铁联运列车磅单报文JT/T1350界定的术语和定义适用于本文件。为了便于使用,以下重复列出了JT/T1350中的某些术语和定义。采用海运和铁路两种运输方式完成的多式联运。下列缩略语适用于本文件。4基本要求列车运行与货物追踪接口应满足以下要求:a)接口保持开放性,部署在开放WEB环境,用户可通过互联网访问;2JT/T1352—2020c)接口的参数及返回值采用JSON方式进行封装;d)接口应满足以下性能指标:1)请求响应时间不大于80ms;2)支持并发连接数不小于50个;3)事务最长处理时间不大于200ms。5接口描述列车运行与货物追踪接口的主要组成部分见表1。表1列车运行与货物追踪接口主要组成部分序号功能说明1列车车号位置实时追踪接口按列车车号追踪列车当前位置2车号历史轨迹追踪接口按车号追踪车辆在列车运行过程中停靠各站点的历史轨迹,本接口返回多条记录3列车车次追踪接口按发运车次追踪列车位置信息,本接口返回多条记录4列车箱号位置实时追踪接口按集装箱箱号追踪列车当前位置5海运提单列车位置追踪接口按海运的船名航次提单号查询本提单下列车位置,本接口可返回多个记录6港口委托列车位置追踪接口按用户在码头办理的作业委托号查询本委托下对应列车所在位置7车号货物轨迹追踪接口按列车车号追踪货物在港口的海铁联运作业历史轨迹8箱号货物轨迹追踪接口按箱号追踪货物在港口的海铁联运作业历史轨迹,本接口返回多条记录9提单号货物轨迹追踪接口按海运提单号追踪货物在港口的海铁联运作业历史轨迹港口委托货物轨迹追踪接口按码头作业委托号追踪货物在港口的海铁联运作业历史轨迹3JT/T1352—20205.2主要接口内容接口参数用参数名、约束/条件、数据类型和格式、说明、引用文件5序号描述属性解释说明1序号数据元在参数、返回值中的排序2参数名参数中数据元对应代码3返回值名返回值中数据元对应代码4约束/条件说明该数据元是必备的或可选的,“M”表示该数据元为必备的,“O”表示该数据元为可选的5数据类型和格式说明数据元的数据取值类型和最大字节数,见5.2.26说明对数据元的简要解释和应用说明7引用文件对数据元引用的国家标准加以说明5.2.2数据类型和格式数据类型和格式见表3。表3数据类型和格式序号数据类型格式说明1n表示固定或变长数字型,例如:n8表示定长8位的数字型,n..8表示最短为1位,最长为8位的数字型2表示固定或变长数字字符型,例如:an8表示定长8位的数字字符型,an..8表示最短为1位,最长为8位的数字字符型3日期,YYYY表示年份,MM表示月份,DD表示天4时间,hh表示小时,mm表示分钟,ss表示秒5.2.3列车车号位置实时追踪表4列车车号位置实时追踪接口参数序号参数名约束/条件数据类型和格式说明引用文件1M访问标识—2M应用认证信息—3M列车车号—4JT/T1352—20205.2.3.2接口返回值见表5。表5列车车号位置实时追踪接口返回值序号约束/条件数据类型和格式说明引用文件1M调用结果标志:0-接口调用成功;1-未找到用户;2-未获得授权;3-服务访问超时—2M发站名—3M到站名—4O集装箱箱号—5M当前位置,铁路货车所在车站 6M铁路货车所在车站的最新作业时间—7M状态(在途、终到)—8O船名航次—9O提单号—M品名M收货人—M发运时间 O到达专用线—O出发专用线—M口岸代理—M预计终到时间—5.2.4车号历史轨迹追踪5JT/T1352—2020表6车号历史轨迹追踪接口参数序号参数名约束/条件数据类型和格式说明引用文件1M访问标识—2M应用认证信息—3M列车车号—5.2.4.2接口返回值见表7。表7车号历史轨迹追踪接口返回值序号约束/条件数据类型和格式说明引用文件1M调用结果标志:0-接口调用成功;1-未找到用户;2-未获得授权;3-服务访问超时 2M发站名—3M到站名—4O集装箱箱号—5M当前位置,铁路货车所在车站—6M铁路货车所在车站的最新作业时间—7M状态(在途、终到) 8O船名航次 9O提单号—M品名M收货人—M发运时间—O到达专用线—O出发专用线—M口岸代理 6JT/T1352—2020表8列车车次追踪接口参数序号参数名约束/条件数据类型和格式说明引用文件1M访问标识 2M应用认证信息—3M列车车次—5.2.5.2接口返回值见表9。表9列车车次追踪接口返回值序号约束/条件数据类型和格式说明引用文件1M调用结果标志:0-接口调用成功;1-未找到用户;2-未获得授权;3-服务访问超时—2M发站名—3M到站名—4M车号—5O集装箱箱号—6M当前位置,铁路货车所在车站 7M铁路货车所在车站的最新作业时间—8M状态(在途、终到) 9O船名航次—O提单号—M品名M收货人—M发运时间—O到达专用线—O出发专用线—M口岸代理—M预计终到时间 7JT/T1352—20205.2.6列车箱号位置实时追踪表10列车箱号位置实时追踪接口参数序号参数名约束/条件数据类型和格式说明引用文件1M访问标识—2M应用认证信息 3M列车车号 5.2.6.2接口返回值见表11。表11列车箱号位置实时追踪接口返回值序号约束/条件数据类型和格式说明引用文件1M调用结果标志:0-接口调用成功;1-未找到用户;2-未获得授权;3-服务访问超时—2M发站名—3M到站名—4M车号—5M当前位置,铁路货车所在车站 6M铁路货车所在车站的最新作业时间—7M状态(在途、终到)—8O船名航次—9O提单号—M品名M收货人—M发运时间—O到达专用线 O出发专用线 M口岸代理—M预计终到时间—8JT/T1352—20205.2.7海运提单列车位置追踪接口表12海运提单列车位置追踪接口参数序号参数名约束/条件数据类型和格式说明引用文件1M访问标识—2M应用认证信息—3M船名,为国际通行标准英文船名—4M航次—5M提单号—5.2.7.2接口返回值见表13。表13海运提单列车位置追踪接口返回值序号约束/条件数据类型和格式说明引用文件1M调用结果标志;0-接口调用成功;1-未找到用户;2-未获得授权;3-服务访问超时 2M发站名—3M到站名—4M车号—5O集装箱箱号—6M当前位置,铁路货车所在车站—7M铁路货车所在车站的最新作业时间—8M状态(在途、终到) 9O船名航次 O提单号—M品名M收货人—M发运时间,格式—9JT/T1352—2020表13(续)序号约束/条件数据类型和格式说明引用文件O到达专用线—O出发专用线 M口岸代理 M预计终到时间—5.2.8港口委托列车位置追踪表14港口委托列车位置追踪接口参数序号参数名约束/条件数据类型和格式说明引用文件1M访问标识 2M应用认证信息—3M码头作业委托号,委托类型限定为装卸铁路货过程委托—4M作业港口代码5.2.8.2接口返回值见表15。表15港口委托列车位置追踪接口返回值序号约束/条件数据类型和格式说明引用文件1M调用结果标志:0-接口调用成功;1-未找到用户;2-未获得授权;3-服务访问超时—2M发站名 3M到站名 4M车号—5M集装箱箱号—6M当前位置,铁路货车所在车站—7M铁路货车所在车站的最新作业时间—JT/T1352—2020表15(续)序号约束/条件数据类型和格式说明引用文件8M状态(在途、终到)—9O船名航次 O提单号 M品名M收货人—M发运时间—O到达专用线—O出发专用线—M口岸代理—M预计终到时间—5.2.9车号货物轨迹追踪表16车号货物轨迹追踪接口参数序号参数名约束/条件数据类型和格式说明引用文件1M访问标识—2M应用认证信息 3M列车车号 4M作业港口代码5.2.9.2接口返回值见表17。表17车号货物轨迹追踪接口返回值序号约束/条件数据类型和格式说明引用文件1M调用结果标志:0-接口调用成功;1-未找到用户;2-未获得授权;3-服务访问超时—2M作业地点—3M车号—4O集装箱箱号—JT/T1352—2020表17(续)序号约束/条件数据类型和格式说明引用文件5M作业时间—6M 7M船名航次—8M提单号—9M品名M收货人—M需求受理号—M发运时间 M口岸代理—表18箱号货物轨迹追踪接口参数序号参数名约束/条件数据类型和格式说明引用文件1M访问标识 2M应用认证信息—3M集装箱箱号—4M作业港口代码表19箱号货物轨迹追踪接口返回值序号约束/条件数据类型和格式说明引用文件1M调用结果标志:0-接口调用成功;1-未找到用户;2-未获得授权;3-服务访问超时—2M作业地点—JT/T1352—2020表19(续)序号约束/条件数据类型和格式说明引用文件3M车号—4M作业时间—5M 6M船名航次—7M提单号—8M品名9M收货人—M需求受理号—M发运时间—M口岸代理 5.2.11提单号货物轨迹追踪接口表20提单号货物轨迹追踪接口参数序号参数名约束/条件数据类型和格式说明引用文件1M访问标识—2M应用认证信息 3M船名,为国际通行标准英文船名—4M航次—5M提单号—表21提单号货物轨迹追踪接口返回值序号约束/条件数据类型和格式说明引用文件1M调用结果标志:0-接口调用成功;1-未找到用户;2-未获得授权;3-服务访问超时—JT/T1352—2020表21(续)序号约束/条件数据类型和格式说明引用文件2M作业地点—3M车号—4O集装箱箱号—5M作业时间 6M—7O船名航次—8O提单号—9M品名M收货人—M需求受理号 M发运时间 M口岸代理—5.2.12港口委托货物轨迹追踪表22港口委托货物轨迹追踪接口参数序号参数名约束/条件数据类型和格式说明引用文件1M访问标识—2M应用认证信息—3M码头作业委托号—4M作业港口代码表23港口委托货物轨迹追踪接口返回值序号约束/条件数据类型和格式说明引用文件1M调用结果标志:0-接口调用成功;1-未找到用户;2-未获得授权;3-服务访问超时—JT/T1352—2020表23(续)序号约束/条件数据类型和格式说明引用文件2M作业地点—3M车号—4O集装箱箱号—5M作业时间 6M—7M船名航次—8M提单号—9M品名M收货人—M需求受理号 M发运时间 M口岸代理—5.3数据交换结构和实例列车运行与货物追踪接口应用实例参见附录B。JT/T1352—2020(规范性附录)海铁联运列车运行与货物追踪接口XMLSchemaA.1列车车号位置实时追踪JT/T1352—2020JT/T1352—2020JT/T1352—2020JT/T1352—2020A.2车号历史轨迹追踪JT/T1352—2020JT/T1352—2020JT/T1352—2020JT/T1352—2020A.3列车车次追踪JT/T1352—2020JT/T1352—2020JT/T1352—2020JT/T1352—2020A.4列车箱号位置实时追踪JT/T1352—2020JT/T1352—2020JT/T1352—2020JT/T1352—2020JT/T1352—2020A.5海运提单列车位置追踪JT/T1352—2020JT/T1352—2020JT/T1352—2020JT/T1352—2020A.6港口委托列车位置追踪JT/T1352—2020JT/T1352—2020JT/T1352—2020JT/T1352—2020JT/T1352—2020A