合肥住房公积金系统_详细设计说明书v1.0_20110325

文件编号：文件编号： 配置项编号：配置项编号： 中国光大银行合肥分行前置中国光大银行合肥分行前置 合肥住房公积金系统合肥住房公积金系统 设计说明书设计说明书 文档版本号文档版本号 V1.0V1.0 中国光大银行合肥分行中国光大银行合肥分行 文档编号： 文档修订记录文档修订记录 编号章节名称修订内容简述修订日期 修订前 版本号 修订后 版本号 修订人批准人 1. 文档编号： 目录目录 1引言引言.2 1.1目的 2 1.2需求描述 2 1.3定义 2 1.4参考资料 2 2系统架构系统架构.3 2.1网络拓扑图 3 2.2交易列表 3 3功能设计功能设计.4 3.1网关接入 4 3.2业务分组 4 4交易设计交易设计.4 4.1公积金贷款放款 4 4.1.1交易代码4 4.1.2流程描述：4 4.1.3设计要点：5 4.2公积金贷款放款冲正 5 4.2.1交易代码5 4.2.2流程描述：5 4.3公积金批量扣款申请 5 4.3.1交易代码5 4.3.2流程描述：5 4.4公积金批量扣款结果文件查询 6 4.4.1交易代码6 4.4.2流程描述：6 4.5定时处理公积金批量扣款文件 6 4.5.1流程描述6 5系统接口设计系统接口设计.9 5.1分行前置与行内住房公积金管理系统接口 9 5.1.1公积金贷款放款9 5.1.2公积金贷款放款冲正10 5.1.3公积金批量扣款申请11 5.1.4公积金批量扣款结果文件查询12 6其他其他.13 6.1数据库设计 13 6.1.1公积金贷款代扣明细表T_EB_ACCFD_BATSUM13 6.1.2公积金扣款批量文件状态信息表T_EB_ACCFD_FILESTAT14 6.2附录 15 1 1引引言言 1 1. .1 1目目的的 本文档描述了合肥住房公积金系统涉及分行前置部分的交易开发模式， 并为系统开发者、部门主管、软件测试人员以及其他相关人员提供业务开发和 测试依据。 1 1. .2 2需需求求描描述述 为进一步提高金融服务水平，扩大我行业务开办范围，服务广大市民， 中国光大银行合肥分行向合肥市住房公积金管理管理中心申请市直个人住房公 积金贷款业务办理资格并获批，系统主要实现与公积金管理中心信息系统数据 对接，并能自动接收、自动反馈数据信息，达到自动放款（纯公积金贷款） 、手 动放款（组合贷款）及自动还款等功能，为此需要创建、完善相关行内系统， 以支持我行公积金贷款业务的顺利开展。 1 1. .3 3定定义义 序号序号名称名称说明说明备注备注 1行内住房公积金管 理系统 中国光大银行合肥分行自建的用于 与前置和合肥住房公积金中心系统 互通互连、业务报表展现的管理系 统 2分行前置中国光大银行合肥分行前置系统， 用于外围系统的统一接入、报文格 式转换、与行内系统通讯等。 3合肥住房管理中心 系统 合肥市住房公积金管理中心自建系 统（与安泰伟奥合作开发） ，用于向 银行端发送请求和接收数据，实现 公积金贷款相关功能。 1 1. .4 4参参考考资资料料 安泰伟奥银行通讯数据接口标准_合肥 v1.1(新).doc 住房公积金贷款系统开发需求.doc 公积金银行端与秀柏通讯接口 1.1.doc 文档编号： 2 2系系统统架架构构 2 2. .1 1网网络络拓拓扑扑图图 核心业务系统 分行前置行内住房公积金管理系统合肥住房公积金管理中心系统 防火墙 2 2. .2 2交交易易列列表表 合肥住房公积金系统分行前置涉及下列四支联机交易： 序号序号交易名称交易名称交易代码交易代码备注备注 1. 公积金贷款放款 5361 2. 公积金贷款放款冲正 5363 核心系统应答超时等异常，住房 公积金管理系统未收到前置交易 应答时，触发此冲正交易 3. 公积金批量扣款申请 5362 通知分行前置批量扣款文件已上 传 4. 公积金批量扣款结果文件查询 5364 查询批量扣款结果文件是否已生 成 3 3功功能能设设计计 3 3. .1 1网网关关接接入入 接入渠道： 536-合肥住房公积金系统，与行内住房公积金管理系统通 讯采用 TCP/IP 同步短连接方式，文件传输采用 TFT 方式。 3 3. .2 2业业务务分分组组 业务种类： 536-合肥住房公积金系统，业务组号 103，调用服务 PbMain103 4 4交交易易设设计计 4 4. .1 1公公积积金金贷贷款款放放款款 4 4. .1 1. .1 1交交易易代代码码 5361公积金贷款放款 4 4. .1 1. .2 2流流程程描描述述： 行行内内住住房房公公积积 金金管管理理系系统统 分分行行前前置置核核心心业业务务系系统统 12 34 如图： 1行内住房公积金管理系统接收到合肥住房管理中心系统的公积金贷款放 款请求后，按照与前置接口约定，转换成相应报文格式后，发送交易请 求至分行前置。 2分行前置对请求报文解析后，转换报文格式类型至行内核心系统 SOP 报文格式。 3分前通过 TUXEDO 通讯方式，调用核心 7708-转账交易接口。 4分前返回核心应答结果报文至行内住房公积金管理系统。 文档编号： 4 4. .1 1. .3 3设设计计要要点点： 4 4. .2 2公公积积金金贷贷款款放放款款冲冲正正 4 4. .2 2. .1 1交交易易代代码码 5363公积金贷款放款冲正 4 4. .2 2. .2 2流流程程描描述述： 行行内内住住房房公公积积 金金管管理理系系统统 分分行行前前置置核核心心业业务务系系统统 13 42 如图： 1行内住房公积金管理系统发送公积金贷款放款冲正请求至分行前置。 2分行前置接收到公积金贷款放款冲正请求后，同步返回成功应答报文至 住房公积金管理系统（核心冲正默认成功） 。 3分行前置通过 TUXEDO 通讯方式，调用核心 7704-外围系统自动冲正接 口。 4分行前置对核心应答报文解析后，判断核心返回成功标志是否为 7 个 A，若是，则更新相应流水字段 TranStat 标志位为 9-已冲正。 4 4. .3 3公公积积金金批批量量扣扣款款申申请请 4 4. .3 3. .1 1交交易易代代码码 4 4. .3 3. .2 2流流程程描描述述： 行行内内住住房房公公积积 金金管管理理系系统统 分分行行前前置置核核心心业业务务系系统统 12 34 如图： 1行内住房公积金管理系统发起公积金批量扣款申请，通过 TFT 方式将批 量扣款文件发送到分行前置$home/download/credit/YYYYMMDD 目录下， 并发送批量扣款申请请求包至分行前置。 2分行前置到指定$home/download/credit/YYYYMMDD 目录下检查文件， 如果文件存在则返回行内住房公积金管理系统应答包表示文件已收妥； 3分行前置收到行内住房公积金管理系统的批量扣款申请后，将批量扣款 详细信息保存在本地数据库T_EB_ACCFD_BATSUM表中，发送 5625-批 量文件处理交易到核心系统（定时处理程序） 。 4核心处理后返回 5625 交易应答包至分行前置。分行前置接收到返回包 后到核心目录下 TFT 取核心扣款后生成文件，解析文件，更新数据库表 T_EB_ACCFD_BATSUM代扣标志字段，如果成功更新为 1，失败更新为 2，并更新失败原因字段。并汇总生成新的公积金批量代扣结果文件， 并存放于指定目录下（定时处理程序） 。 4 4. .4 4公公积积金金批批量量扣扣款款 结结果果文文件件查查询询 4 4. .4 4. .1 1交交易易代代码码 4 4. .4 4. .2 2流流程程描描述述： 行行内内住住房房公公积积 金金管管理理系系统统 分分行行前前置置核核心心业业务务系系统统 12 34 1行内住房公积金管理系统发起公积金批量扣款结果文件查询交易请求到 分行前置，分行前置解析报文，根据公积金管理中心编号、交易日期和 文件批次号到相关目录下检查文件是否存在。 2如果文件存在分行前置组应答包给行内住房公积金管理系统，表示文件 已存在，行内住房公积金管理系统收到应答包后，根据应答包中文件名 FileName 字段到分行前置$home/download/credit/YYYYMMDD 目录下 TFT 下载该文件。 4 4. .5 5定定时时处处理理公公积积金金批批量量扣扣款款文文件件 4 4. .5 5. .1 1流流程程描描述述 由于核心 5625-批量文件处理的交易处理时间的不确定性以及批量文 件处理耗时时间较长，不宜在前置主控中直接调用流程（以防止交易堵塞，影 响其他业务） ，故需要设计后台定时批量处理程序（SHELL 脚本触发） 。 1.每隔 20 分钟扫描公积金贷款批量文件状态信息表 （T_EB_ACCFD_FILESTAT） ，判断是否存在需要处理的公积金 文档编号： 批量扣款文件，若不存在，则退出，否则解析该批量扣款文件， 将批量扣款详细信息保存在本地数据库 T_EB_ACCFD_BATSUM 中，同时验证客户的身份证件号与扣款储蓄账号是否一致，对于 验证不一致的，更新 T_EB_ACCFD_BATSUM 表中代扣标志 （FLAG）为“2-代扣失败” ，结果描述(Reason)为“扣款账号不 符” 2.根据交易日期和代扣标志的为查询条件，检索本地数据库表 T_EB_ACCFD_BATSUM，按照核心批量文件处理接口生成公积 金批量扣款文件，通过 tft 方式，发送至核心指定目录下。 3.发送 5625 交易请求至核心，通知核心处理公积金批量扣款文件。 4.到核心指定目录下 TFT 取核心扣款后生成文件，解析文件，更新 数据库表T_EB_ACCFD_BATSUM代扣标志字段，如果成功更新为 1-代扣成功，失败更新为 2-代扣失败，并更新失败原因字段。并 汇总生成新的公积金批量代扣结果文件，并存放于指定目录下。 其中步骤 1 的设计流程图如下所示： 文档编号： 查询公积金批量状态文件信息 表T_EB_ACCFD_FILESTAT 是否存在需要处理的批量 扣款文件 读取、解析公积金批量扣款 文件 根据职工储蓄账号，调用核 心0209接口，查询客户号 调用核心0204接口，根据客 户号，查询客户身份证号 验证客户身份证件号与 上送证件号是否一致 公积金批量扣款 文件 是 插入批量代扣明细表 T_EB_ACCFD_BATSUM， 扣款标志设置为2-扣款失 败，原因为“扣款账号不 符” 否 是 批量扣款文件是否读取 至文件尾 否 结束 是 开始 客户身份证件号需考虑 15位与18位的问题 否 5 5系系统统接接口口设设计计 5 5. .1 1分分行行前前置置与与行行内内住住房房公公积积金金管管理理系系统统接接口口 5 5. .1 1. .1 1公公积积金金贷贷款款放放款款 功能说明 单笔代理收付转账交易，可以用于渠道。 业务控制 数据来源渠道 交互过程处理正确时系统返回数据，否则返回错误代码。 参数名称 I/O 数据字典 （hfgjsop ） 长度说明 代理业务号 I2615 （此字段现在不用） 客户姓名 I8380 证件号码 I4630 转出账号类 型 I582 1卡 2活期一本通 0对公账号 9内部账/表外账 转出客户账 号 I3332 住房公积金委贷账号 转出帐户性 质 I354 0001活期（固定） 密码校验方 式 I572 0不校验 1校验查询密码 2校验交易密码 交易密码 I4116 为空 转入账号类 型 I1865 1卡 2活期一本通 0对公账号 9内部账/表外账 转入客户账 号 I3432 开发商或个人银行结算账号 转入帐户性 质 I364 0001活期 转入账号户 名 I3780 开发商或个人银行户名 开发商保证 金账号 I20632 开发商保证金账号 保证金金额 I5216 保证金金额 参数说明 凭证号 I11114 可为空 文档编号： 货币代号 I632 01-人民币 12-英镑 13-港币 14-美元 15-瑞士法郎 21-瑞典克郎 22-丹麦克郎 23-挪威克郎 27-日元 28-加拿大元 29-澳大利亚元 32-新加坡元 38-欧元 81-澳门元 钞汇标志 I592 0钞户 1汇户 交易金额 I4816 贷款金额 摘要代码 I104128 二磁道信息 I7640 可为空 三磁道信息 I77107 可为空 终端号 I1965 银行机构号 I1974 柜员代号 I1986 交易日期 I1998 交易时间 I2006 前台流水号 I20112 传输的密码 字段 I202 16 交易错误码 O2037 错误信息 O204136 转出账号 O3332 帐户中文名 O3780 帐户余额 O4922 转入账号 O3432 对方名称 O3880 对方帐户余 额 O5422 打印凭证无 处理说明 5 5. .1 1. .2 2公公积积金金贷贷款款放放款款冲冲正正 功能说明 外围自动冲证 业务控制 数据来源渠道 交互过程处理正确时系统返回数据，否则返回错误代码。 参数名称 I/O 数据字典 （hfgjsop ） 长度说明 原交易日期 I8 前台流水号 I12 原公积金贷款放款请求报文中上送 的“前台流水号” 交易错误码 O7 七个 A 代表成功，其他为失败 参数说明 错误信息 O136 打印凭证无 处理说明 5 5. .1 1. .3 3公公积积金金批批量量扣扣款款申申请请 功能说明 住房公积金管理系统发送批量扣款文件请求至分行前置 业务控制 数据来源渠道 交互过程处理正确时系统返回数据，否则返回错误代码。 参数名称 I/O 数据字典 （hfgjsop ） 长度说明 公积金管理 中心编号 I124 把公积金管理中心顺序编号，若只 有一家则为 0001 交易日期 I658 文件批次号 I182 01-99 的数字 文件名称 I7640 文件传输方式：tft 工具 只支持人民币扣款 文件名规则： 公积金管理中心编号+业务种类编号 (536)+日期（格式：YYYYMMDD，8 位） +文件批次号（2 位数字，如果每日 一次，该值固定为 01）.txt 文件存放目录： $HOME/download/credit/YYYYMMDD 公积金请求扣款文件格式：以“|” 分割符 格式：批次号|贷款合同编号|职工 姓名|证件号码|职工还款储蓄账号| 还款日期|应还本金|应还利息|应还 罚息|合计应扣金额|经办网点机构 名称|扣款标志| 参数说明 文件记录总 数 I744 表示文件中扣款记录总笔数 文档编号： 银行端流水 号 O12 交易错误码 O7 七个 A 代表成功，其他为失败 错误信息 O136 打印凭证无 处理说明 5 5. .1 1. .4 4公公积积金金批批量量扣扣款款结结果果文文件件查查询询 功能说明 住房公积金管理系统发送批量扣款结果文件查询请求至分行前置 业务控制 数据来源渠道 交互过程处理正确时系统返回数据，否则返回错误代码。 参数名称 I/O 数据字典 （hfgjsop ） 长度说明 公积金管理 中心编号 I4 把公积金管理中心顺序编号，目前 暂为 0001-合肥公积金管理中心 交易日期 I8 文件批次号 I2 01-99 的数字 银行端流水 号 O12 交易错误码 O7 七个 A 代表成功，其他为失败 参数说明 错误信息 O136 文件名称 O9540 文件传输方式：tft 工具 文件名规则： 公积金管理中心编号+业务种类编号 (536)+日期（格式：YYYYMMDD，8 位） +文件批次号（2 位数字，如果每日 一次，该值固定为 01）_result.txt 文件存放目录： $HOME/download/credit/YYYYMMDD 公积金请求扣款结果文件格式：以 “|”分割符 格式：批次号|贷款合同编号|职工 姓名|证件号码|职工还款储蓄账号| 还款日期|应还本金|应还利息|应还 罚息|合计应扣金额|经办网点机构 名称|扣款标志|实扣日期|实扣本金 |实扣利息|实扣罚息|实扣总金额| 扣款结果（0-成功，1-失败）|扣款 结果描述（若扣款结果为 0，则默认 “扣款成功” ，否则填充失败原因） |摘要| 打印凭证无 处理说明 6 6其其他他 6 6. .1 1数数据据库库设设计计 6 6. .1 1. .1 1公公积积金金贷贷款款代代扣扣明明细细表表 T T_ _E EB B_ _A AC CC CF FD D_ _B BA AT TS SU UM M 标识符标识符数据项名称数据项名称类型类型长度长度数据项描述数据项描述是否可空是否可空强制强制 WordDate 工作日期 Char8 前置系统日期 NM CompanyI d 公积金管理中 心编号 Char 4 N TranDate 交易日期 Char8NM SerialNo 文件批次号 Char2NM JobSeqNo 批次号 ID Char28NM CreditId 贷款合同编号 Char20NM CltName 职工姓名 Char 20N CardNo 证件号码 Char30NM AcctNo 职工还款储蓄 账号 Char30 N M 文档编号： RetDate 还款日期 Char8N RetAmt 应还本金 decimal(15,2)15N RetRual 应还利息 decimal(15,2)15N RetPunIn st 应还罚息 decimal(15,2)15 N RetTolAm t 合计应扣金额 decimal(15,2)15 N InstNo 经办网点机构 名称 Char4 N RetFlag 扣款标志