广州港务局危险货物安全监管服务系统接口文档20160817V2.01

广州港务局危险货物安全监管服务系统（三期）接口技术方案北京国交信通科技发展有限公司2016年08月目录1 概述 51.1 编写目的 51.2 项目背景 51.3 应用现状 52 总体设计 62.1 设计约束 62.2 实施分工 62.3 技术路线 62.4 部署架构 72.5 接口规范 83 总体需求 93.1 基础数据 93.2 危险品业务 103.3 危险品业务审批 103.4 附件资料推送 114 服务设计 114.1 基础数据同步接口 114.1.1服务内容 114.1.2服务描述 124.1.3服务定义 124.1.4服务参数 134.1.5服务返回 134.2 业务申报接口 154.2.1服务内容 154.2.2服务描述 164.2.3服务定义 164.2.4服务参数 164.2.5服务返回 174.3 申报进度接口 174.3.1服务内容 175 附件资料报送方案 175.1 附送资料描述 175.2 附送资料约束 186 数据同步分析与策略 187 联调调试内容 197.1 接口服务 197.2 附送资料 208 实施进度计划 20

概述编写目的据广州单一窗口相关业务要求，定义并编写该《广州单一窗口广州港务局危货三期业务数据接口服务技术方案》。该文件可作为开发单位的系统设计人员、测试人员、市场销售人员的指导性文件，也作为用户了解“广州单一窗口广州港务局危货三期业务数据接口服务”的相关内容，进行项目确认与验收测试时的依据。项目背景广州“单一窗口”要实现海事、海关、边防和检验检疫四个单位的单一窗口，建立集通关、物流、外贸、口岸于一体的信息平台实现“一站式”电子政务服务,准备建设实施“广州国际贸易“单一窗口”平台项目”，该项目需要与广州港务局危货三期系统实现业务数据的交换与共享。应用现状广州港务局危险货物安全监管服务系统（三期）（简称危货三期）是向船舶代理，货物运输企业，码头申报危险品作业信息服务。面向港务局管理人员提供危险品审批，危险品堆存实时监控查询等服务。总体设计设计约束1、充分考虑广州港务局已有信息化系统和工具，避免重复建设和投资。2、接口服务的设计与实现要功能完备且扩展灵活。实施分工涉及到的开发商有：北京国交信通科技发展有限公司、广州电子口岸公司、广州创阳软件，北京国交信通科技发展有限公司主要负责“广州港危险货物安全监管服务系统”改造以及接口服务开发，广州电子口岸公司主要负责“广州国际贸易“单一窗口”平台项目”以及接口服务开发，广州创阳软件主要负责数据交换平台集成。1、申报上传的文件资料的传输由电子口岸公司或数据交换平台集成服务商负责将文件资料传输至广州港务局内网指定服务器目录。2、开发商进行业务数据服务开发分工的原则是“数据接收方进行相应服务的设计与开发”。技术路线接口服务根据广州港务局信息化建设顶层设计进行，并遵循广州港务局云数据中心的规范要求。主要设计路线：1、面向服务SOA的架构体系（JSON）本项目基于SOA（ServiceOrientedArchitecture面向服务的架构）的系统架构，通过接口服务（JSON）方式来实现数据交换，从而使各业务应用系统之间具有足够的灵活性和可扩展性2、J2EE技术路线本项目的数据接口服务（JSON）基于J2EE开发技术、使用开发工具Jdeveloper进行开发实现，使得接口服务具有良好的可移植性和可扩展性。3、ESB总线集成服务本项目的数据接口服务通过一体化平台的SOA套件进行应用集成，实现总线型结构应用集成架构。将使用OracleWebLoigicService应用服务器进行部署，通过OracleServiceBus（Oracle服务总线）提供的ESB（EnterpriseServiceBus，企业服务总线）进行服务的注册集成管理、安全管理、运行监控等。部署架构本项目国交信通开发的数据接口服务（JSON）部署在广州港务局weblogic应用服务器上，对外提供服务。接口规范一、接口服务数据交换格式统一为JSON数据格式，具体要求如下：1）并列的数据之间用逗号（","）分隔。2）映射用冒号（":"）表示。3）并列数据的集合（数组）用方括号("[]")表示。4）映射的集合（对象）用大括号（"{}"）表示。实例:{“status”:0“message”:””“data”:{“userId”:1,“username”:”zhangsan”,“worklist”:[{“workId”:1,“workname”:”完成登陆界面设计”},{“workId”:2,“workname”:”完成用户中心功能编码”}]}}二、项中涉及的所有日期、时间格式统一为：yyyy-MM-dd及yyyy-MM-ddhh:mm:ss。总体需求通过本项目建设：1、实现“广州国际贸易“单一窗口”平台”危险品申报业务数据接入到“广州港危险货物安全监管服务系统”；2、实现“广州港危险货物安全监管服务系统”危险品申报业务数据审批结果接入到“广州国际贸易“单一窗口”平台”。基础数据完成基础数据接口服务，通过该接口服务将危险品申报所需的基础基础数据由“广州港危险货物安全监管服务系统”接入到“广州国际贸易“单一窗口”平台数据库”，为系统中的业务办理提供基础数据。涉及的基础数据内容包括：1、码头公司数据2、船舶营运证数据3、拖头数据4、拖卡数据5、司机数据6、押运员数据7、危险品数据（单一窗口提供）危险品业务完成危险品申报数据接口服务，通过该接口服务将危险品申报数据由“广州国际贸易“单一窗口”平台”接入到“广州港危险货物安全监管服务系统”中，由“广州港危险货物安全监管服务系统”进行受理审批。危险品业务审批完成危险品审批数据接口服务，通过该接口服务将危险品审批结果数据由“广州港危险货物安全监管服务系统”系统接入到“广州国际贸易“单一窗口”平台”。涉及的内容是危险品审批结果，包括审核人、审核日期、审核意见等信息。附件资料推送完成申报单附件由“广州国际贸易“单一窗口”平台”接入到“广州港危险货物安全监管服务系统”中。服务设计基础数据同步接口服务内容基础数据同步接口和编码如下表所示：序号服务描述涉及的业务表级内容对象代码对象描述1基础数据PtDock码头基本信息ShipWorkLicence船舶营运证信息DragHead拖头信息Drag拖卡信息Driver司机信息Escort押运员信息服务描述用于同步共通危险品申报相关基础数据的接口服务服务定义每一个基础数据的同步方法，详细如下：序号名称地址1码头基本信息203.88.202.117/dgsrs_api/dataService/ptdock/list2船舶营运证信息203.88.202.118/dgsrs_api/dataService/shipworklicence/list3拖头信息203.88.202.122/dgsrs_api/dataService/draghead/lis4拖卡信息203.88.202.120/dgsrs_api/dataService/drag/list5司机信息203.88.202.119/dgsrs_api/dataService/driver/list6押运员信息203.88.202.121/dgsrs_api/dataService/escort/list7危险品信息单一窗口提供服务参数accessToken：用来鉴定用户身份，由危货三期管理分配，长度64位。服务返回基础数据服务执行成功的返回值是包含基础数据对象的集合，返回值采用JSON数据交换格式。{"Rows":[{"AUDITINGUNIT":"44011200000000","CLIENTDATE":"2010-12-0600:00:00","SENDDATE":"2010-05-1200:00:00","CARTYPE":"解放CA4182P21K2","AUDITINGSTATE":"登记成功","WORKAREA":"危险货物运输(2类1项,3类,8类)","TONNAGE":"0.00","ENTERPRISEID":"44011200000005","TITLEID":"3081","EFFICENCYDATE":"2011-02-0200:00:00","PAPERNO":"湘交运管衡字430405000528","DRIVERNAME":"刘焕文","CLIENTNAME":"广州市广耀物流有限公司","CARNO":"湘D11838","ENTNAME":"衡阳市安泰汽车运输有限公司","TRANSPORTTYPE":"0","DELETEFLAG":"0","ID":"3543","SENDDEPARTMENT":"衡阳市道路运输管理处","PUTOONRECORDSUNIT":"广州市广耀物流有限公司","DRIVERSTANDBY2":"962","DRIVERSTANDBY3":"962"}],"Total":1}基础数据服务执行失败时采用统一的返回值，返回值采用JSON数据交换格式，具体内容如下：{“result”:"true","code":404,"message":"无对应接口"}业务申报接口服务内容业务申报接口和编码如下表所示：序号服务描述涉及的业务表级内容对象代码对象描述1申报单DangerGoodsEntrust主申报DangerGoodsEntrustShip船舶信息DangerGoodsEntrustCar车辆信息DangerGoodsEntrustCargo货物信息DangerGoodsEntrustContainer集装箱信息服务描述用于单一窗口传输申报单数据到危货三期系统服务定义数据报送接口详细如下：序号名称地址1主申报203.88.202.117/dgsrs_api/datatransport/DangerGoodsEntrust2船舶信息203.88.202.117/dgsrs_api/datatransport/DangerGoodsEntrustShip3车辆信息203.88.202.117/dgsrs_api/datatransport/DangerGoodsEntrustCar4货物信息203.88.202.117/dgsrs_api/datatransport/DangerGoodsEntrustCargo5集装箱信息203.88.202.117/dgsrs_api/datatransport/DangerGoodsEntrustContainer服务参数1.accessToken：用来鉴定用户身份，由危货三期管理分配，长度64位。2.各个实体数据，详见数据列表。服务返回1.基础数据服务执行失败时采用统一的返回值，返回值采用JSON数据交换格式，具体内容如下：{“result”:"true","code":404,"message":"无对应接口"}申报进度接口服务内容危货三期系统想单一窗口报送申报单处理进度信息。（单一窗口提供）附件资料报送方案附送资料描述本次项目建设涉及到的业务，需要向广州港务局递交（在系统中上传附件）与相关业务有关的相关资料或证书，如““危险货物技术说明书”、“集装箱装箱证明书”等。执法人员查看上传的附送资料