NEAL-NET标准接入指引.DOC

NEAL-NET试点示范项目 文档编号： NEAL-NET 当前版本号： Draft 最初发布日期： 必威体育精装版修订日期：  版本号 版本日期 修改内容 修订人 Draft 2011-8-31 创建初稿 Draft 0.2 2011-9-14 修改查询接口与返回接口部分内容 吴一舟 Draft 0.3 2011-11-23 添加直连和通过中间平台访问两种使用场景 添加Frosstrek使用说明 万鹏洲 Draft 0.4 2012-4-14 添加其他要求章节 万鹏洲 Draft 0.5 2012-4-24 添加10.4章节 万鹏洲 Draft 0.6 2012-6-25 完善10.4章节内容 胡歆 Draft 0.6 2012-7-18 添加5.3章节用户认证接口内容 林浩庭  目 录 1 概述 5 2 服务交换理念 5 3 规范性引用文件 5 4 应用场景 6 4.1 服务提供方---服务调用方直接互联 6 4.2 服务提供方---服务交换中心---服务调用方互联 7 5 接口描述 7 5.1 查询接口（动态船舶查询） 7 5.1.1 查询报文结构 7 5.1.2 数据项说明 8 5.1.3 查询参数 9 5.1.4 Request示例 9 5.2 返回接口（动态船舶查询） 11 5.2.1 返回报文结构 11 5.2.2 数据项说明 12 5.2.3 Response示例 15 5.3 查询接口（集装箱状态查询） 19 5.3.1 查询报文结构 19 5.3.2 数据项说明 19 5.3.3 查询参数 20 5.3.4 Request示例 21 5.4 返回接口（集装箱状态查询） 22 5.4.1 返回报文结构 22 5.4.2 数据项说明 23 5.4.3 Response示例 25 5.5 用户认证接口 27 5.5.1 用户认证描述 27 5.5.2 数据项说明 27 5.5.3 REQUEST示例中的用户认证部分： 27 6 其他要求 28 6.1 数据更新要求 28 6.2 数据保存要求 28 6.3 服务响应要求 28 7 服务提供商接入指南 28 7.1 获取资料 28 7.2 服务培训 29 7.3 系统开发 29 7.4 测试环境联调 29 7.5 正式环境联调与发布 29 8 服务调用方接入指南 29 8.1 获取资料 29 8.2 服务培训 30 8.3 系统开发 30 8.4 应用场景 30 8.5 测试联调 30 9 附录 30 A-数据元定义概要(动态船舶查询) 30 B- Outline of Data Item Definition（集装箱状态查询） 32 C-Fosstrak EPCIS 介绍 33 9.1 JDK/JRE 34 9.2 Apache Tomcat 34 9.3 MySQL下载安装配置 35 9.4 App应用下载安装配置 35 9.5 建立数据库和测试数据导入 36 9.6 客户端使用 36 10 附件 37 10.1 数据元字典定义 37 10.2 接口事件格式定义 38 10.3 查询客户端工具 38 10.4 SOAP报文监听工具 38  概述 NEAL-NET是东北亚物流信息服务网络（Northeast Asia Logistics Information Service Network）的英文缩写，是一个实现网络内各国之间物流信息互联互通的物流高速通的平台。其目的是为了提高网络内各个国家内和各个国家之间物流效率和服务能力，推进物流信息资源共享,促进经济和运输服务贸易发展。 NEAL-NET是以服务交换的理念为设计原则，以国际上物流行业通用的EPCIS为设计标准进行建设的。目前已经完成了中日韩三国的动态船期查询服务，并已经接入相关企业进行试点运行。 本指南给出了NEAL-NET平台的信息查询服务的接口规范以及接入方法。 本指南适用于NEAL-NET平台船舶动态信息查询服务的设计与开发。 服务交换理念 所谓的服务交换，是指作为数据拥有方的各类企业单位或实体，通过服务交换中心发布自身的已有服务，作为服务提供方对外提供数据服务。服务需求方通过服务交换中心，有选择性的调用已发布的服务。 包括建立一套统一的服务交换技术标准体系；发布一组服务交换标准函数；搭建一个为服务提供方发布服务，服务需求方检索服务，并有服务整合能力的服务交换中介平台。 建立一套统一的服务交换技术标准体系是指依据目前国际上在物流行业有成熟应用的EPCIS系统，结合国内物流行业实际应用环境与需求，建立一套可以在物流链上下游的政府部门，企事业单位之间使用的通信体系，为提供统一，安全，有序、开放的服务交换制定标准，从而实现货品在整个物流链的全程化，全方位的状态跟踪。 发