1、社区政务综合受理平台 技术规范 v1.0 服务总线 接口规范 福建省数字福建建设领导小组办公室 发布 目 录 1. 范围 . 1 2. 规范性引用文件 . 1 3. 术语和定义 . 1 4. 总 体架构 . 2 4.1. 架构组成 . 2 4.2. 业务流程 . 3 5. 服务接口 . 5 5.1. 编码约定 . 5 5.2. 用户身份验证接口 . 6 5.3. 面向社区政务综合受理平台的接口 . 7 5.3.1. 业务受理信息提交接口 . 7 5.3.2. 信息综合查询接口 . 9 5.4. 面向省厅各类业务系统的接口 . 10 5.4.1. 业务受理对接接口 . 10 5.4.2. 业务受
2、理结果返回接口 . 11 1 1. 范围 本规范规定社区综合受理 平台服务总线 的总体架构和系统接口。 本规范适用于指导社区综合受理平台建设和部门业务系统对接。 2. 规范性引用文件 3. 术语和定义 3.1 社区 政务 综合受理平台 社区 政务 综 合受理平台是各 级 部门窗口便民业务的统一受理入口，以设区市为单位部署于政务外网公用区， 在 街道、社区 的 综合窗口 中 使用 。 引入社区综合受理平台后，各 部门业务系统 将 业务受理和业务办理功能 作 分离，由社区综合受理平台 负责业务受理 ，部门业务系统仅负责业务 办 理 ， 从而实现“前台统一受理、部门分工办理”的服务新模式 。 3.2
3、 服务总线 服务总线 是传统中间件技术与 XML、 Web服务等技术相互结合的产物， 它 可以消除不同应用之间的技术差异，让不同的应用服务器协调运作，实现了不同服务之间的通信与整合。从功能上看， 服务总线 提供了事件驱动和 文档导向的处理模式，以及分布式的运行管理机制，它支持基于内容的路由和过滤，具2 备了复杂数据的传输能力，并可以提供一系列的标准接口。 4. 总体架构 4.1. 架构组成 社区综合受理的系统架构 如下图所示： 图 1 “ 福建省级 政务服务总线 社区政务 ” 系统架构 服务总线 上连省直部门相关业务系统，下连 各设区市 社区政务综合受理平台 。通过 Web Services接
4、口，实现上下数据交换。 服务总线 作为 政务业务协同服务总线，具有支持多 个 任务的业务协同管理能力。 由于由 社区政务综合受理平台 实现面向居民的多业务统一受理、反馈和查询等服务，故省 直各部门需要抛弃原先的终端服务界面，改由接口方式接收 社区政务综合受理平台 推送的受3 理信息，并向 社区政务综合受理平台 反馈办理结果。 根据省直相关部门的运行网络不同，设计了三种接入方式： 1、业务系统运行在电子政务外网公用区的，则可以直接通过 Web Services 接口进行数据交互。 2、业务系统运行在政务网（或政务外网互联网区）的，需要在政务外网公用区部署一台交换前置服务器， 服务总线 将要交换给
5、部门的数据推送到前置服务器，或者从前置服务器读取部门推送的数据。部门架设网闸连接政务外网公用区与政务网（或政务外网互联网 区），通过前置服务器实现数据交换。 3、业务系统运行在部门业务专网的，需要在政务外网公用区部署一台交换前置服务器， 服务总线 将要交换给部门的数据推送到前置服务器，或者从前置服务器读取部门推送的数据。部门业务系统可以通过 2 种方式实现数据交换：（ 1）架设网闸连接政务外网与业务专网，通过前置服务器实现数据交换；（ 2）架设网络专线连接政务外网与业务专网，通过前置服务器实现数据交换。 4.2. 业务流程 受理信息交换 和反馈 的通用数据 时序图 如下图所示： 4 社 区 政
6、 务 综 合 受 理 平 台 服 务 总 线 平 台省 级 / 市 级 部 门 业 务 系 统省 级 / 市 级 部 门 业 务 系 统1 、 封 装 受 理 信 息2 、 发 送 受 理 信 息5 、 业 务 办 理3 、 记 录 受 理 信 息 、 增 加 描 述 信 息 。重 新 封 装 受 理 信 息4 、 发 送 受 理 信 息6 、 封 装 反 馈 结 果7 、 发 送 办 理 结 果8 、 记 录 结 果 信 息 、 增 加 描 述 信 息 。重 新 封 装 结 果 信 息9 、 发 送 办 理 结 果图 2 受理信 息交换 和反馈 数据 时序图 社区政务综合受理平台 受理居民办
7、事申请后，将受理信息按格式 按 要求 提交 到服务总线 。 服务 总线接收 信息 后 ， 将 受理信息进行拆包 和记录相关流转信息，然后将信息 转换成 省直部门业务系统 所规定的 格式 发送给部门业务系统 。 省直部门业务系统办理事项后，将办理结果信息按格式要求进行封装后交换给 服务总线 ， 服务总线 记录相关流转信息后重新封装办理结果信息并推送给 社区政务综合受理平台 。 社区政务综合受理平台 在受理居民办事申请时，经常需要查询相关部门业务信息以识别居民是否需要提交材料以及需要提交的材料种类。因此除业务 受理信息和办理结果信息交换外，社区政务综合受理平台 还有部门业务信息查询需求，信息查询5
8、 的通用数据 时序图 如下图所示： 社 区 政 务 综 合 受 理 平 台 服 务 总 线 平 台省 级 / 市 级 部 门 业 务 系 统省 级 / 市 级 部 门 业 务 系 统1 、 封 装 查 询 请 求 信 息2 、 发 送 查 询 请 求 信 息5 、 封 装 反 馈 结 果3 、 记 录 查 询 请 求 信 息 、 增 加 描 述 信 息 。重 新 封 装 查 询 请 求 信 息4 、 发 送 查 询 请 求 信 息6 、 发 送 查 询 结 果 信 息7 、 记 录 查 询 结 果 信 息 、 增 加 描 述 信 息 。重 新 封 装 查 询 结 果 信 息8 、 发 送 查
9、询 结 果 信 息图 3 信息查询数据 时序图 社区政务综合受理平台 将查询请求信息按格式要求 提交 给服务总线，服务总线接收后将查询请求信息进行拆包和记录相关流转信息，然后将信息转换成省直部门业务系统所规定的格式发送给部门业务系统 ；省直部门业务系统接收查询请求信息后，执行系统查询并将查询结果信息反馈给 服务总线 ， 服务总线 再将查询结果信息转发给 社区政务综合受理平 台 。 5. 服务接口 5.1. 编码约定 下表规定了本技术规范中各个接口的返回值约定。 表 1 接口返回值 约定 返回值编码 编码描述 6 00 接口调用成功 10 未找到匹配的信息 11 要求必填的输入参数值为空 12
10、身份验证不通过或 GUID 过期 13 用户无权限操作该接口 14 单位找不到（单位需用全称） 15 XML 文件的格式不对 16 XML 文件节点不全 17 XML 文件中必填节点值为空 18 附件名称数组个数与附件内容数组个数不一致 19 附件名称包含 exe 等可执行文件扩展名 20 附件内容为 0 字节 21 时间格式不正确，应为 2012-12-01 或 2012-12-01 15:01:59 22 未知事项 23 申报号已存在（重复推送申报受理信息） 24 申报流程不存在（推送审批结果时候未找到申报受理信息） 99 调用接口失败（系统内部错误） 5.2. 用户身份验证接口 部门业务
11、系统调用 服务总线 接收推送接口时， 服务总线 首先会对调用方的身份进行验证，调用方的用户名和密码由 服务总线 分配。本接口负责部门业务系统的身份认证功能，部门业务系统通过调用本接口，通过 服务总线 身份认证后将获取到一个身份验证串，用户使用该身份验证串就可以调用 服务总线 接收推送接口 。 原型接口： public string Authorization (string userName, string password) 参数说明： userName 用户帐号 必填 password 用户密码 必填 返回值： 7 guid 验证串，通过身份验证用户，将获取身份验证串；如果身份验证失败，将
12、返回失败内容（格式是 ERR:具体原因 ，如 ERR:账号不存在！ ）。 功能描述： 用于对访问该接收推送服务进行身份验证，只有 已经注册为单点登录用户的才能过身份验证获得身份验证串。通过身份验证串来访问该服务的其它接口。 5.3. 面向社区政务综合受理平台 的 接口 5.3.1. 业务受理信息提交 接口 本接口用于接收社区政务综合受理平台或其他业务平台办理业务时提交的材料。提交的材料包括：各类申请表单信息、扫描件和附件等。 接口 1 适用于附件文件总大小不超过 20M的情况。 原型接口 1： public string PushApplyData( string guid,string in
13、fo, string fileName, byte fileContent) 参数说明： guid 身份验证串 必填 info 表单信息 fileName 附件名称数组 fileContent 附件内容数组 返回值： 接口调用成功返回 00，接口调用失败返回（ 99、 11、 12、13、 15、 16、 17、 18、 19、 20、 21）之一 功能描述： 8 用于服务总线平台接收综合受理平台推送的申请单信息 ；本接口适用于附件文件总大小不超过 20M 的情况。 接口 2 适用于附件文件总大小超过 20M的情况。 其中，参数 info的格式约定如下 : 原型 接口 2： public St
14、ring PushApplyData( string guid,string info, string fileName, String fileAddress,String fileVerificationCode,Integer verificationTime) 参数说明： guid 身份验证串 必填 info 表单信息 fileName 附件名称数组 fileAddress 附件内容 的 链接地址 fileVerificationCode 附 件链 接 的验 证 码 verificationTime 验 证 下 载时长 返回值： 接口调用成功返回 00，接口调用失败返回（ 99、 11、 12、13、 15、 16、 17、 18、 19、 20、 21）之一 功能描述： 用于服务总线平台接收综合受理平台推送的申请单信息包 含大文件处理。 350205001001201606290010001 350103197308140074 程杰
