wdqp3-02qr03.docVIP

东北亚物流信息服务网络 目次 前言 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 集装箱在港口状态查询 概述 服务需求方通过集装箱号、提单号等关键字向服务提供方进行精确匹配查询，获取与集装箱在港状态 集装箱在港口状态一般分为出口和进口，其出口事件状态分为提空箱、货物装箱、港区进门、海关放行、进场、出场、装船； 进口事件分为卸船、进场、出场、海关放行、港区出门、货物卸箱、还空箱。 请求参数 集装箱在港口状态查询请求参数样例见表2, 详细请求查询参数见附录3。 表2集装箱在港口状态查询请求参数 序号 层次 参数名称 数据项中文名称 出现次数 数据类型和长度 1 1 MATCH_epc Container Number 集装箱号 0..1 an..12 2 1 EQ_bizTransaction_urn:un:unece:uncefact:codelist:standard:UNECE:ReferenceTypeCode:BM Bill Of Lading Number 提单号 0..1 an..35 EQ_bizTransaction_urn:un:unece:uncefact:codelist:standard:UNECE:ReferenceTypeCode:BN Booking Reference Number 订舱号 0..1 an..35 响应结果 集装箱在港口状态查询响应结果见表3。 集装箱状态信息分为出口和进口，其状态代码分别见附录2代码集表6和表7. 表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 4 Aggre