公积金语音与网站系统交易接口规范V1.0new探析.doc

编号： 省直公积金语音与网站系统 交易接口规范说明书 V1.0 REFMS项目组 2011年4月 文档信息 项目名称 作者 审核 建立日期 文档编号 密级 2011-04-29 文档名称 版本号 最近更新日期 语音与网站系统交易接口规范说明书 V1.0 用户信息 修订记录 日期 修订说明 修订人 审核人 2011.6.13 根据6月9日四方会议讨论结果，修订如下内容： 4.2交易流程说明 4.3交易报文定义说明 4.4文件报文结构说明 5交易文件定义文件格式调整并增加个人姓名和单位名称模糊查询交易定义 吴毅娟  前言 省直机关住房公积金管理中心拟搭建住房公积金语音与网站系统，以提升面向省直机关各公积金缴交单位及个人的服务水平。该系统将基于住房公积金业务系统抽取的查询数据平台，以查询交易方式与该平台进行实时交互，以提供来自互联网及专用服务电话的公积金业务查询服务。为进一步确保查询数据平台的信息安全性，查询数据平台和语音与网站系统之间实行数据库分离，并部署防火墙、限制端口等网络安全措施。 本文档就住房公积金语音与网站系统和公积金业务查询数据平台间的数据接口规范进行定义，作为双方开发人员的接口开发依据。 术语及定义 公积金业务系统REFMS 住房公积金管理中心日常业务管理系统。 段Segment 一个已标识、命名和结构化的、在功能上相互关联的复合数据元和/或独立数据元的集合。 报文头Message Head 开始并唯一标识报文的服务段。 报文体Message Body 数据发布报文的主体内容，包含一条或多条客户记录。 报文Message 由报文头和报文体组成。 系统架构 逻辑架构 语音与网站系统和公积金业务查询数据平台采用C/S模式； 语音与网站系统作为客户端（C），业务系统作为服务端（S）。 公积金业务系统每日夜间提供当日增量数据发往查询数据平台，查询数据平台完成数据更新； 语音与网站系统根据客户提交的各类查询请求，经前置向业务查询数据平台提交相应查询申请交易； 查询数据平台根据查询申请交易处理相应查询并反馈查询结果。 物理架构 客户接入区的互联网用户经互联网接口通过防火墙访问DMZ区的公积金网站查询系统，该系统处理相应的请求，通过防火墙并限定端口与后台的公积金业务系统进行数据逻辑处理。 客户接入区的语音用户经专用的语音接入设备通过防火墙访问DMZ区的公积金网站查询系统，该系统处理相应的请求，通过防火墙与后台的公积金业务系统进行数据逻辑处理。 交易规则 交互方式 语音与网站系统与公积金业务查询数据平台之间采用socket、短连接的通讯方式，同步接口调用方式。 交易采用请求应答方式，所有交易均采用文件传输+交易报文方式；其中文件传输要求在发送和接收文件之前都必须发送文件发送和接收请求报文，报文结构见4.4；发送和接收文件结构见5。 交易流程 由语音与网站系统生成数据文件，向业务系统前置发送报文类别为“1”的发送文件请求报文； 若业务系统前置返回发送文件响应报文“2”的响应码为0，则语音与网站系统循环调用结构3，4向业务系统前置发送打包的数据文件，直到文件发送完成； 语音与网站系统向业务系统前置发送“交易请求”报文，并等待业务系统前置应答； 业务系统前置收到“交易请求”报文转发到业务数据查询平台处理交易，结束后向语音与网站系统发送“交易响应”报文（内含反馈文件名）； 语音与网站系统接收“交易响应”报文，根据响应文件里的反馈文件名，发送接收文件请求报文“5”，业务系统前置返回接收文件响应报文“6”的响应为0，则语音与网站系统到业务系统前置指定目录取文件（业务系统发送数据结构7，接收数据结构8响应，该过程与发送时相反）； 交易结束。 交易报文定义 交易报文分请求与响应两种，均采用XML报文格式。 交易请求报文 字段名称 字段说明 取值范围 备注 Jydm 交易代码 PUTFILE/GETFILE Jyrq 交易日期 Wjlx 文件类型 A—单位账户信息查询（1） B—单位往来明细查询（2） C—个人基本信息查询（3） D—个人账户信息查询（4） E—个人账户往来明细查询（5） F—个人贷款账户信息查询（6） G－个人贷款还款明细查询（7） H－个贷共同还款人登记信息查询（8） I－楼盘信息查询（9） J-开发商信息查询（10） K-冲还贷信息查询（11） L-基数核定信息查询（12） M-参数查询（13） N-个人姓名模糊查询（14） O-单位名称模糊查询（15） 根据交易代码与文件类型可以唯一标识一个交易 Wjm 文件名 例如： ro