东北亚物流信息服务网络集装箱船舶动态信息标准.DOC

东北亚物流信息服务网络 目次 前言 3 1 范围 4 2 报文结构及属性 4 3 服务调用接口 5 附录1 ： 数据源 7 附录2 ： 代码集 12 附录3 ： 查询参数表 13  前言 标准起草单位：东北亚物流信息服务网络秘书处、中日韩三国工作组 集装箱船舶动态信息标准 范围 本标准给出了东北亚物流信息服务网络集装箱船舶动态信息接口的数据标准。 本标准适用于东北亚物流信息服务网络集装箱船舶动态信息接口服务相关功能 报文结构及属性 a） 请求参数：指查询服务调用接口中描述业务的查询条件数据组成； b） 响应结果：指根据特定的查询条件，返回给信息调用方所需要的查询结果数据组成。 服务调用接口的属性见表1。 表1 报文结构属性 序号 属性名称 说明 1 报文层Level 标识数据元在报文结构中的位置和层次关系。 2 参数名称 对查询请求里参数格式进行描述 3 英文名称 对数据元的英文描述。 4 中文名称 对数据元的中文描述。 5 出现次数 指该数据元在报文中重复出现的次数： a）0..1——数据元值域可填，且出现一次； b）0..n——数据元值域可填，且可出现多次； c）1..1——数据元值域必填，且出现一次； d）1..n——数据元值域必填，且可出现多次。 6 数据类型和数据格式 数据类型是用于表示数据元的符号、字符或其他表示的类型。数据元值的类型可能的取值有：“字符型”、“数字型”、“日期型”、“时间型”、“日期时间型”、“布尔型”、“二进制型”。 数据格式中使用的字符含义如下： a = 字母字符 n = 数字字符 an = 字母数字字符 m(m=为自然数) = 定长m个字符（字符集默认为GB2312） ..ul = 长度不确定的文本 .. = 从最小长度到最大长度，前面附加最小长度，后面附加最大长度 CCYYMMDDhhmmss = “CCYY”表示世纪和年份，“MM”表示月份，“DD”表示日期，“hh”表示小时，“mm”表示分钟，“ss”表示秒，可以视具体实际情况组合使用。 True/False =布尔型 示例1： an5(aannn)表示定长5个字母数字字符，前2个为字母字符，后3个为数字字符。 示例2： an3..8 表示最大长度为8，最小长度为3的不定长字符。 示例3： n..8,4表示该数值最大长度为8位整数、4位小数。 示例4： True/False表示该数值为布尔型。 7 引用文件 代码型数据元值域引用的标准。 8 说明 对标记名的简要解释和应用说明。 服务调用接口 3.1 动态船期查询 概述 服务需求方通过船舶呼号、船名、航次、IMO号等关键字向NEAL-NET服务提供商进行精确匹配查询，获取与船舶相关的数据。 集装箱船舶动态信息共分5个事件，其中3个实际发生的事件对应的状态编码bizStep为ATA是139、ATB是1、ATD是24 ，有2个计划事件的状态编码bizStep为空，分别为预计到港ETA，预计离港ETD，对应的时间是扩展项的EstimatedTimeOfArrival 和EstimatedTimeOfDeparture。 请求参数 动态船期查询请求参数样例见表2, 详细请求查询参数见附录3。 表2 动态船期查询请求参数 序号 层次 参数名称 数据项中文名称 出现次数 数据类型和长度 1 1 MATCH_epc CallSign 船舶呼号 0..1 an4..5 2 1 EQ_/tracking/extensions/#VoyageNumber VoyageNumber 航次 0..1 an..10 3 1 EQ_/tracking/extensions/#VesselName VesselName 船舶名称 0..1 an..200 4 1 EQ_/tracking/extensions/#IMONumber IMONumber IMO编号 0..1 n..10 响应结果 动态船期查询响应结果见表3。 表3动态船期查询响应结果 序号 层次 XML标记 中文名称 出现次数 数据类型和长度 说明 1 1 soap:Envelope 信封 1..1 标签 2 2 soap:Header 报文头 0..1 标签 3 2 soap:Body 报文体 1..1 标签 4 1 QueryResults 查询结果 1..1 标签 5 2 queryName 查询名称 1..1 常量 6 2 resultsBody 查询结果集 1..1 标签 7 3 EventList 事件列表 1..1 标签 8 4 ObjectEvent 对象事件 1..n 标签 9 5 eventTime 事件发生时间 1..1 an..19