东北亚物流信息服务网络.docx

1、东北亚物流信息服务网络 东北亚物流信息服务网络目次前言标准起草单位：东北亚物流信息服务网络秘书处、中日韩三国工作组集装箱船舶动态信息标准11范围本标准给出了东北亚物流信息服务网络集装箱船舶动态信息接口的数据标准。本标准适用于东北亚物流信息服务网络集装箱船舶动态信息接口服务相关功能的设计、开发与应用。12报文结构及属性服务调用接口由请求参数和响应结果两部分组成：a） 请求参数：指查询服务调用接口中描述业务的查询条件数据组成； b） 响应结果：指根据特定的查询条件，返回给信息调用方所需要的查询结果数据组成。服务调用接口的属性见表1。表1 报文结构属性序号属性名称说明1报文层Level标识数据元在报

2、文结构中的位置和层次关系。2参数名称对查询请求里参数格式进行描述3英文名称对数据元的英文描述。4中文名称对数据元的中文描述。5出现次数指该数据元在报文中重复出现的次数：a）0.1数据元值域可填，且出现一次；b）0.n数据元值域可填，且可出现多次；c）1.1数据元值域必填，且出现一次；d）1.n数据元值域必填，且可出现多次。6数据类型和数据格式数据类型是用于表示数据元的符号、字符或其他表示的类型。数据元值的类型可能的取值有：“字符型”、“数字型”、“日期型”、“时间型”、“日期时间型”、“布尔型”、“二进制型”。数据格式中使用的字符含义如下：1)a = 字母字符2)n = 数字字符3)an =

3、字母数字字符4)m(m=为自然数) = 定长m个字符（字符集默认为GB2312）5).ul = 长度不确定的文本6). = 从最小长度到最大长度，前面附加最小长度，后面附加最大长度7)CCYYMMDDhhmmss = “CCYY”表示世纪和年份，“MM”表示月份，“DD”表示日期，“hh”表示小时，“mm”表示分钟，“ss”表示秒，可以视具体实际情况组合使用。8)True/False =布尔型示例1：an5(aannn)表示定长5个字母数字字符，前2个为字母字符，后3个为数字字符。示例2：an3.8 表示最大长度为8，最小长度为3的不定长字符。示例3：n.8,4表示该数值最大长度为8位整数、4

4、位小数。示例4：True/False表示该数值为布尔型。 7引用文件代码型数据元值域引用的标准。8说明对标记名的简要解释和应用说明。13服务调用接口3.1 动态船期查询概述服务需求方通过船舶呼号、船名、航次、IMO号等关键字向NEAL-NET服务提供商进行精确匹配查询，获取与船舶相关的数据。集装箱船舶动态信息共分5个事件，其中3个实际发生的事件对应的状态编码bizStep为ATA是139、ATB是1、ATD是24 ，有2个计划事件的状态编码bizStep为空，分别为预计到港ETA，预计离港ETD，对应的时间是扩展项的EstimatedTimeOfArrival 和EstimatedTimeOf

5、Departure。请求参数动态船期查询请求参数样例见表2, 详细请求查询参数见附录3。表2 动态船期查询请求参数序号层次参数名称数据项英文名称数据项中文名称出现次数数据类型和长度11MATCH_epcCallSign船舶呼号0.1an4.521EQ_http:/www.nealnet.org/tracking/extensions/#VoyageNumberVoyageNumber航次0.1an.1031EQ_http:/www.nealnet.org/tracking/extensions/#VesselNameVesselName船舶名称0.1an.20041EQ_http:/www.n

6、ealnet.org/tracking/extensions/#IMONumberIMONumberIMO编号0.1n.10响应结果动态船期查询响应结果见表3。表3动态船期查询响应结果序号层次XML标记中文名称出现次数数据类型和长度说明11soap:Envelope信封1.1标签22soap:Header报文头0.1标签32soap:Body报文体1.1标签41QueryResults查询结果1.1标签52queryName查询名称1.1常量62resultsBody查询结果集1.1标签73EventList事件列表1.1标签84ObjectEvent对象事件1.n标签95eventTime事

7、件发生时间1.1an.19105recordTime记录时间1.1an.19115eventTimeZoneOffset事件发生时区1.1常量125epcListEpc列表1.1标签136Epc船舶呼号1.1an4.5145Action操作类型1.1an70155bizStep业务阶段代码0.1an.3为空时，表示该事件为“计划状态”，非实际发生时间165bizLocation港口（码头）代码1.1标签176Id港口代码1.1an.6185nealnet:VesselName船舶名称1.1an.35195nealnet:VoyageNumber航次1.1an.10205nealnet:IMON

8、umberIMO编号1.1n.10215nealnet:ShippingCompanyCode船公司代码1.1an.35225nealnet:EstimatedTimeOfArrival预计到港时间1.1an.19235nealnet:EstimatedTimeOfBerthing计划靠泊日期时间1.1an.19245nealnet:EstimatedTimeOfDeparture预计离港日期时间1.1an.19255nealnet:CyOpenDateTime进箱开始日期时间1.1an.19265nealnet:CyCutDateTime进箱截止日期时间1.1an.19275nealnet:

9、LastPortCode上一个停靠地点0.1an.19285nealnet:NextPortCode下一个停靠地点0.1an.35295nealnet:CourseLine航线代码0.1an.6附录1 ： 数据源集装箱船舶动态信息1、呼号 标签：epc数据元名称：呼号英文名称：CallSign定义：IMO组织为每条船舶分配的呼号c数据类型：字符型数据格式：12出现次数：1:1URI: urn:un:unece:uncefact:codelist:standard:UNECE:ReferenceTypeCode:VM样例：urn:un:unece:uncefact:codelist:standa

10、rd:UNECE:ReferenceTypeCode:VM:ABCD123值域：ITU2、状态码 标签：bizstep数据元名称：状态码英文名称：StatusCode定义：事件状态代码标识，表明当前事件的含义数据类型：字符型数据格式：3出现次数：1:1URI: urn:un:unece:uncefact:codelist:standard:UNECE:StatusCode样例：urn:un:unece:uncefact:codelist:standard:UNECE:StatusCode:139值域：UN/ECE3、港区位置 标签：bizlocation数据元名称：港区位置英文名称：PortC

11、ode定义：港口的联合国编码数据类型：字符型数据格式：5出现次数：1:1URI: urn:un:unece:uncefact:codelist:standard:UNCEFACT:LocationCode样例：urn:un:unece:uncefact:codelist:standard:LocationCode:CNNGB值域：UN/ECE4、码头位置 标签：bizlocation数据元名称：码头位置英文名称：SubLocationCode定义：船舶靠港或者货物卸载的码头位置数据类型：字符型数据格式：10出现次数：1:1URI: urn:un:nealnet:codelist:standar

12、d:SubLocationCode样例：urn:un:nealnet:codelist:standard:SubLocationCode:CNNGBBLCT5值域：NEAL-NET5、记录时间 标签：recordTime数据元名称：记录时间英文名称：System Time定义：数据插入系统的时间数据类型：日期型数据格式：29出现次数：1:1样例：2011-10-31T11:57:20.000+08:006、事件时间 标签：eventTime数据元名称：事件时间英文名称：ActualTimeofArrival, ActualTimeofBerthing, ActualTimeofDepartur

13、e定义：实际到港时间， 实际靠泊时间， 实际开船时间数据类型：日期型数据格式：29出现次数：1:1样例：2011-10-31T11:57:20.000+08:007、IMO号 标签：IMONumber数据元名称：IMO号英文名称：IMO Number定义：IMO组织给船舶分配的标识号数据类型：字符型数据格式：10出现次数：1:1样例：IMO1234567值域：IMO8、船名标签：VesselName数据元名称：船名英文名称：Vessel Name定义：船舶英文名称数据类型：字符型数据格式：35出现次数：1:1样例：President9、船公司代码标签：ShippingCompanyCode数据

14、元名称：船公司代码英文名称：ShippingCompanyCode定义：船公司的代码数据类型：字符型数据格式：4出现次数：1:1样例：12PD值域：National Motor Freight Traffic Association10、航次标签：VoyageNumber数据元名称：航次英文名称：VoyageNumber定义：航次数据类型：字符型数据格式：17出现次数：1:1样例：1125E值域：NEAL-NET11、预计到港时间标签：EstimatedTimeOfArrival数据元名称：预计到港时间英文名称：EstimatedTimeOfArrival定义：预计到港时间数据类型：字符型数据

15、格式：29出现次数：1:1样例：2011-10-31T11:57:20.000+08:00值域：NEAL-NET12、预计靠泊时间标签：EstimatedTimeOfBerthing数据元名称：预计靠泊时间英文名称：EstimatedTimeOfBerthing定义：预计靠泊时间数据类型：字符型数据格式：29出现次数：1:1样例：2011-10-31T11:57:20.000+08:00值域：NEAL-NET13、预计离港时间标签：EstimatedTimeOfDeparture数据元名称：预计离港时间英文名称：EstimatedTimeOfDeparture定义：预计离港时间数据类型：字符型

16、数据格式：29出现次数：1:1样例：2011-10-31T11:57:20.000+08:00值域：NEAL-NET14、上一港代码标签：LastPortCode数据元名称：上一港代码英文名称：LastPortCode定义：上一个港口的UN代码数据类型：字符型数据格式：5出现次数：0:1样例：JPUKB值域：UN/ECE15、下一港代码标签：NextPortCode数据元名称：下一港代码英文名称：NextPortCode定义：下一个港口的UN代码数据类型：字符型数据格式：5出现次数：0:1样例：JPUKB值域：UN/ECE16、进箱开始时间标签：CyOpenDateTime数据元名称：进箱开始

17、时间英文名称：CyOpenDateTime定义：码头开始进箱的时间数据类型：日期型数据格式：29出现次数：0:1样例：2011-10-31T11:57:20.000+08:00值域：NEALNET17、进箱结束时间标签：CyCutDateTime数据元名称：进箱结束时间英文名称：CyCutDateTime定义：码头结束进箱的时间数据类型：日期型数据格式：29出现次数：0:1样例：2011-10-31T11:57:20.000+08:00值域：NEALNET18、航线标签：CourseLine数据元名称：航线英文名称：CourseLine定义：说明船舶的航线数据类型：字符型数据格式：11出现次数

18、：0:1样例：CNJPN值域：CHINA GOVERNMENT附录2 ： 代码集表4 事件类型 （eventType）代码名称说明Object对象描述EPCs所指的一个或多个物理对象事件的信息Aggregation聚合描述对象的实际亲子关系和嵌套的亲子关系Transaction交易提供了一种方式来描述特定的EPCs业务交易的联系或分离。表5 动作 (Action)代码名称说明Add增加代表了实体已创建或添加Observe保留代表了实体一直没有改变：它既没有被创建，添加，破坏，或从中删除Delete删除代表了实体已经从完全删除或销毁表6 事件状态代码 (bizStep)代码名称动作类型说明预计到

19、港（ETA）AddObject计划事件预计离港（ETD）ObserveObject计划事件139实际到港（ATA）ObserveObject实际发生事件1实际靠泊（ATB）ObserveObject实际发生事件24实际离港（ATD）DeleteObject实际发生事件附录3 ： 查询参数表参数名称参数类型功能出现次数eventType字符串集事件查询类型1.1GE_eventTime 时间大于等于事件时间1.1LT_eventTime 时间小于事件时间1.1GE_recordTime 时间大于等于记录时间0.1LT_recordTime 时间小于记录时间 0.1EQ_action 字符串集查询

20、动作类型1.1EQ_bizStep字符串集等于事件代码1.1EQ_disposition 字符串集等于disposition0.1EQ_readPoint字符串集等于readPoint0.1WD_readPoint字符串集等于readPoint（包含subLocation）0.1EQ_bizLocation字符串集等于bizLocation1.1WD_bizLocation字符串集等于bizLocation（包含subLocation）1.1EQ_bizTransaction_type字符串集等于 bizTransaction_type0.1MATCH_epc字符串集匹配 epc1.1MATC

21、H_parentID 字符串集匹配parent ID0.1MATCH_anyEPC 字符串集匹配任何 epc0.1MATCH_epcClass 字符串集匹配 epc 类0.1EQ_quantity整数等于数量0.1GT_quantity 整数大于数量0.1GE_quantity整数大于等于数量0.1LT_quantity 整数小于数量0.1LE_quantity 整数小于等于数量0.1EQ_#IMONumber字符串集等于 IMO号1.1EQ_#VoyageNumber字符串集等于 航次1.1orderBy 字符串排序1.1orderDirection 字符串排序1.1eventCountLimit整数最大返回事件数1.1maxEventCount整数服务器可返回的最大事件数1.1