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

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

《东北亚物流信息服务网络.docx》由会员分享，可在线阅读，更多相关《东北亚物流信息服务网络.docx（20页珍藏版）》请在冰点文库上搜索。

东北亚物流信息服务网络

东北亚物流信息服务网络

目次

前言

标准起草单位：

东北亚物流信息服务网络秘书处、中日韩三国工作组

集装箱船舶动态信息标准

11　范围

本标准给出了东北亚物流信息服务网络集装箱船舶动态信息接口的数据标准。

本标准适用于东北亚物流信息服务网络集装箱船舶动态信息接口服务相关功能的设计、开发与应用。

12　报文结构及属性

服务调用接口由请求参数和响应结果两部分组成：

a）请求参数：

指查询服务调用接口中描述业务的查询条件数据组成；

b）响应结果：

指根据特定的查询条件，返回给信息调用方所需要的查询结果数据组成。

服务调用接口的属性见表1。

表1报文结构属性

序号

属性名称

说明

1

报文层Level

标识数据元在报文结构中的位置和层次关系。

2

参数名称

对查询请求里参数格式进行描述

3

英文名称

对数据元的英文描述。

4

中文名称

对数据元的中文描述。

5

出现次数

指该数据元在报文中重复出现的次数：

a）0..1——数据元值域可填，且出现一次；

b）0..n——数据元值域可填，且可出现多次；

c）1..1——数据元值域必填，且出现一次；

d）1..n——数据元值域必填，且可出现多次。

6

数据类型和数据格式

数据类型是用于表示数据元的符号、字符或其他表示的类型。

数据元值的类型可能的取值有：

“字符型”、“数字型”、“日期型”、“时间型”、“日期时间型”、“布尔型”、“二进制型”。

数据格式中使用的字符含义如下：

1）a=字母字符

2）n=数字字符

3）an=字母数字字符

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：

True/False表示该数值为布尔型。

7

引用文件

代码型数据元值域引用的标准。

8

说明

对标记名的简要解释和应用说明。

13　服务调用接口

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_http:

//www.nealnet.org/tracking/extensions/#VoyageNumber

VoyageNumber

航次

0..1

an..10

3

1

EQ_http:

//www.nealnet.org/tracking/extensions/#VesselName

VesselName

船舶名称

0..1

an..200

4

1

EQ_http:

//www.nealnet.org/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

10

5

recordTime

记录时间

1..1

an..19

11

5

eventTimeZoneOffset

事件发生时区

1..1

常量

12

5

epcList

Epc列表

1..1

标签

13

6

Epc

船舶呼号

1..1

an4..5

14

5

Action

操作类型

1..1

an70

15

5

bizStep

业务阶段代码

0..1

an..3

为空时，表示该事件为“计划状态”，非实际发生时间

16

5

bizLocation

港口（码头）代码

1..1

标签

17

6

Id

港口代码

1..1

an..6

18

5

nealnet:

VesselName

船舶名称

1..1

an..35

19

5

nealnet:

VoyageNumber

航次

1..1

an..10

20

5

nealnet:

IMONumber

IMO编号

1..1

n..10

21

5

nealnet:

ShippingCompanyCode

船公司代码

1..1

an..35

22

5

nealnet:

EstimatedTimeOfArrival

预计到港时间

1..1

an..19

23

5

nealnet:

EstimatedTimeOfBerthing

计划靠泊日期时间

1..1

an..19

24

5

nealnet:

EstimatedTimeOfDeparture

预计离港日期时间

1..1

an..19

25

5

nealnet:

CyOpenDateTime

进箱开始日期时间

1..1

an..19

26

5

nealnet:

CyCutDateTime

进箱截止日期时间

1..1

an..19

27

5

nealnet:

LastPortCode

上一个停靠地点

0..1

an..19

28

5

nealnet:

NextPortCode

下一个停靠地点

0..1

an..35

29

5

nealnet:

CourseLine

航线代码

0..1

an..6

附录1：

数据源

集装箱船舶动态信息

1、呼号

标签：

epc

数据元名称：

呼号

英文名称：

CallSign

定义：

IMO组织为每条船舶分配的呼号c

数据类型：

字符型

数据格式：

12

出现次数：

1:

1

URI:

urn:

un:

unece:

uncefact:

codelist:

standard:

UNECE:

ReferenceTypeCode:

VM

样例：

urn:

un:

unece:

uncefact:

codelist:

standard:

UNECE:

ReferenceTypeCode:

VM:

ABCD123

值域：

ITU

2、状态码

标签：

bizstep

数据元名称：

状态码

英文名称：

StatusCode

定义：

事件状态代码标识，表明当前事件的含义

数据类型：

字符型

数据格式：

3

出现次数：

1:

1

URI:

urn:

un:

unece:

uncefact:

codelist:

standard:

UNECE:

StatusCode

样例：

urn:

un:

unece:

uncefact:

codelist:

standard:

UNECE:

StatusCode:

139

值域：

UN/ECE

3、港区位置

标签：

bizlocation

数据元名称：

港区位置

英文名称：

PortCode

定义：

港口的联合国编码

数据类型：

字符型

数据格式：

5

出现次数：

1:

1

URI:

urn:

un:

unece:

uncefact:

codelist:

standard:

UNCEFACT:

LocationCode

样例：

urn:

un:

unece:

uncefact:

codelist:

standard:

LocationCode:

CNNGB

值域：

UN/ECE

4、码头位置

标签：

bizlocation

数据元名称：

码头位置

英文名称：

SubLocationCode

定义：

船舶靠港或者货物卸载的码头位置

数据类型：

字符型

数据格式：

10

出现次数：

1:

1

URI:

urn:

un:

nealnet:

codelist:

standard:

SubLocationCode

样例：

urn:

un:

nealnet:

codelist:

standard:

SubLocationCode:

CNNGBBLCT5

值域：

NEAL-NET

5、记录时间

标签：

recordTime

数据元名称：

记录时间

英文名称：

SystemTime

定义：

数据插入系统的时间

数据类型：

日期型

数据格式：

29

出现次数：

1:

1

样例：

2011-10-31T11:

57:

20.000+08:

00

6、事件时间

标签：

eventTime

数据元名称：

事件时间

英文名称：

ActualTimeofArrival,ActualTimeofBerthing,ActualTimeofDeparture

定义：

实际到港时间，实际靠泊时间，实际开船时间

数据类型：

日期型

数据格式：

29

出现次数：

1:

1

样例：

2011-10-31T11:

57:

20.000+08:

00

7、IMO号

标签：

IMONumber

数据元名称：

IMO号

英文名称：

IMONumber

定义：

IMO组织给船舶分配的标识号

数据类型：

字符型

数据格式：

10

出现次数：

1:

1

样例：

IMO1234567

值域：

IMO

8、船名

标签：

VesselName

数据元名称：

船名

英文名称：

VesselName

定义：

船舶英文名称

数据类型：

字符型

数据格式：

35

出现次数：

1:

1

样例：

President

9、船公司代码

标签：

ShippingCompanyCode

数据元名称：

船公司代码

英文名称：

ShippingCompanyCode

定义：

船公司的代码

数据类型：

字符型

数据格式：

4

出现次数：

1:

1

样例：

12PD

值域：

NationalMotorFreightTrafficAssociation

10、航次

标签：

VoyageNumber

数据元名称：

航次

英文名称：

VoyageNumber

定义：

航次

数据类型：

字符型

数据格式：

17

出现次数：

1:

1

样例：

1125E

值域：

NEAL-NET

11、预计到港时间

标签：

EstimatedTimeOfArrival

数据元名称：

预计到港时间

英文名称：

EstimatedTimeOfArrival

定义：

预计到港时间

数据类型：

字符型

数据格式：

29

出现次数：

1:

1

样例：

2011-10-31T11:

57:

20.000+08:

00

值域：

NEAL-NET

12、预计靠泊时间

标签：

EstimatedTimeOfBerthing

数据元名称：

预计靠泊时间

英文名称：

EstimatedTimeOfBerthing

定义：

预计靠泊时间

数据类型：

字符型

数据格式：

29

出现次数：

1:

1

样例：

2011-10-31T11:

57:

20.000+08:

00

值域：

NEAL-NET

13、预计离港时间

标签：

EstimatedTimeOfDeparture

数据元名称：

预计离港时间

英文名称：

EstimatedTimeOfDeparture

定义：

预计离港时间

数据类型：

字符型

数据格式：

29

出现次数：

1:

1

样例：

2011-10-31T11:

57:

20.000+08:

00

值域：

NEAL-NET

14、上一港代码

标签：

LastPortCode

数据元名称：

上一港代码

英文名称：

LastPortCode

定义：

上一个港口的UN代码

数据类型：

字符型

数据格式：

5

出现次数：

0:

1

样例：

JPUKB

值域：

UN/ECE

15、下一港代码

标签：

NextPortCode

数据元名称：

下一港代码

英文名称：

NextPortCode

定义：

下一个港口的UN代码

数据类型：

字符型

数据格式：

5

出现次数：

0:

1

样例：

JPUKB

值域：

UN/ECE

16、进箱开始时间

标签：

CyOpenDateTime

数据元名称：

进箱开始时间

英文名称：

CyOpenDateTime

定义：

码头开始进箱的时间

数据类型：

日期型

数据格式：

29

出现次数：

0:

1

样例：

2011-10-31T11:

57:

20.000+08:

00

值域：

NEALNET

17、进箱结束时间

标签：

CyCutDateTime

数据元名称：

进箱结束时间

英文名称：

CyCutDateTime

定义：

码头结束进箱的时间

数据类型：

日期型

数据格式：

29

出现次数：

0:

1

样例：

2011-10-31T11:

57:

20.000+08:

00

值域：

NEALNET

18、航线

标签：

CourseLine

数据元名称：

航线

英文名称：

CourseLine

定义：

说明船舶的航线

数据类型：

字符型

数据格式：

11

出现次数：

0:

1

样例：

CNJPN

值域：

CHINAGOVERNMENT

附录2：

代码集

表4事件类型（eventType）

代码

名称

说明

Object

对象

描述EPCs所指的一个或多个物理对象事件的信息

Aggregation

聚合

描述对象的实际亲子关系和嵌套的亲子关系

Transaction

交易

提供了一种方式来描述特定的EPCs业务交易的联系或分离。

表5动作（Action）

代码

名称

说明

Add

增加

代表了实体已创建或添加

Observe

保留

代表了实体一直没有改变：

它既没有被创建，添加，破坏，或从中删除

Delete

删除

代表了实体已经从完全删除或销毁

表6事件状态代码（bizStep）

代码

名称

动作

类型

说明

预计到港（ETA）

Add

Object

计划事件

预计离港（ETD）

Observe

Object

计划事件

139

实际到港（ATA）

Observe

Object

实际发生事件

1

实际靠泊（ATB）

Observe

Object

实际发生事件

24

实际离港（ATD）

Delete

Object

实际发生事件

附录3：

查询参数表

参数名称

参数类型

功能

出现次数

eventType

字符串集

事件查询类型

1..1

GE_eventTime

时间

大于等于事件时间

1..1

LT_eventTime

时间

小于事件时间

1..1

GE_recordTime

时间

大于等于记录时间

0..1

LT_recordTime

时间

小于记录时间

0..1

EQ_action

字符串集

查询动作类型

1..1

EQ_bizStep

字符串集

等于事件代码

1..1

EQ_disposition

字符串集

等于disposition

0..1

EQ_readPoint

字符串集

等于readPoint

0..1

WD_readPoint

字符串集

等于readPoint（包含subLocation）

0..1

EQ_bizLocation

字符串集

等于bizLocation

1..1

WD_bizLocation

字符串集

等于bizLocation（包含subLocation）

1..1

EQ_bizTransaction_type

字符串集

等于bizTransaction_type

0..1

MATCH_epc

字符串集

匹配epc

1..1

MATCH_parentID

字符串集

匹配parentID

0..1

MATCH_anyEPC

字符串集

匹配任何epc

0..1

MATCH_epcClass

字符串集

匹配epc类

0..1

EQ_quantity

整数

等于数量

0..1

GT_quantity

整数

大于数量

0..1

GE_quantity

整数

大于等于数量

0..1

LT_quantity

整数

小于数量

0..1

LE_quantity

整数

小于等于数量

0..1

EQ_#IMONumber

字符串集

等于IMO号

1..1

EQ_#VoyageNumber

字符串集

等于航次

1..1

orderBy

字符串

排序

1..1

orderDirection

字符串

排序

1..1

eventCountLimit

整数

最大返回事件数

1..1

maxEventCount

整数

服务器可返回的最大事件数

1..1