浦发个贷管理系统-设计说明书-公积金冲还贷批量V1.0..doc

个贷项目设计说明书浦发个贷管理系统设计说明书公积金冲还贷浦发个贷项目组2005年10月目 录1概述41.1fund.sh（公积金冲还贷菜单SHELL）41.2数据结构41.3约定42公积金冲还贷流程63公积金冲还贷相关数据格式73.1本期可冲还贷清单73.2公积金冲还贷计划清单73.3本期公积金实际提取信息明细清单83.4冲还贷操作结果信息清单83.5公积金冲还实转差额明细清单93.6到期利息文件93.7上送文件103.8回传文件103.9公积金代发文件114批量处理134.1本期可冲还贷数据导入bh7001134.1.1处理说明134.1.2处理周期134.1.3输出数据134.2下载并导入到期利息bh7002134.2.1处理说明134.2.2处理周期134.2.3输出数据134.3生成BtoC文件bh7003144.3.1处理说明144.3.2处理周期144.3.3输出数据144.4导入CtoB文件bh7004144.4.1处理说明144.4.2处理周期144.4.3输出数据144.5拆分CtoB文件bh7005144.5.1处理说明144.5.2处理周期154.5.3输出数据154.6发送扣款文件bh7006154.6.1处理说明154.6.2处理周期154.6.3输出数据154.7下载并导入核心扣款结果文件bh7007154.7.1处理说明154.7.2处理周期154.7.3输出数据164.8拆分核心扣款结果bh7008164.8.1处理说明164.8.2处理周期164.8.3输出数据165接口协议175.1联机批量接口175.1.1联机批量上送文件接口175.1.1.1 交易说明175.1.1.2 栏位描述175.1.1.3 交易检查175.1.1.4 其他处理及控制175.1.1.5 档案更新175.1.1.6 交易输出171 概述公积金冲还贷作为特殊批量，由机房人员通过批量菜单发起，但并不是日终批量的一部分。本次公积金冲还贷设计仅指上海浦发银行上海分行（机构号：9800）的公积金冲还贷。1.1 fund.sh（公积金冲还贷菜单SHELL）l 路径：/home/gd/sbin/fund.sh1.2 数据结构详见浦发个贷管理系统-设计说明书-数据结构。包含以下数据结构：l fund_status（公积金冲还贷批量进度控制表）l fund_down_rtn（本期可冲还贷清单）l fund_dute_int（到期利息文件）l fund_btoc（冲还贷计划数据表）l fund_ctob（公积金中心返回扣款数据表）l fund_update（公积金冲还贷操作结果数据表）l fund_up_status（上送文件进度控制表）l fund_adjust（公积金冲还实转差额明细表）l fund_result_head（回传文件头记录表）l fund_result_list（回传文件明细记录表）1.3 约定l 程序命名：bh7XXX；l 数据文件存放目录：/home/gd/ifdata/fund/l 个贷生成给核心的扣款文件，每2000条生成一个文件，文件命名中要加入1位的顺序号；l 说明：所有文件为TXT文本格式，用“|”分隔符；l 中心提供给各银行下载冲还贷数据格式：分行代码（2位07）+年月日（8位）+down.txtl 各银行提供贷款余额数据格式：分行代码（2位07）+年月日（8位）+BtoC.txtl 中心返回扣款数据格式：分行代码（2位07）+年月日（8位）+CtoB.txtl 各银行返回调整扣款数据格式：分行（2位07）+年月日（8位）+update.txtl 公积金冲还实转差额明细清单：分行（2位07）+年月日（8位）+ adjust.txt2 公积金冲还贷流程冲还贷操作分为受理阶段、信息生成阶段、实际处理阶段三个步骤，各个阶段主要操作内容详见关于提交上海地区提取住房公积金归还个人住房贷款业务系统开发需求书的请示。其中需要个贷系统处理的步骤有：l 本期可冲还贷数据为每次扣款的预处理前，由银行（分行）从公积金中心的实时系统中全量下载（每月13日）；l 本期可冲还贷数据导入（每月13日）(0720050913down.txt)；l 下载并导入到期利息文件（每月14日）(DOWNLX20050913.9800)；l 根据到期利息数据和期供数据、借据信息生成BtoC文件（每月14日）(0720050914BtoC.txt)；l 导入公积金中心根据BtoC文件生成的CtoB文件（每月19日）(0720050919CtoB.txt)；l 按属性分类拆分CtoB文件，每2000条一个扣款文件（每月20日）；(UPGJJ20050920_0.9800_1公积金贷款UPGJJ20050920_0.9800_2公积金贷款.UPGJJ20050920_1.9800_1商业贷款.)；l 把扣款文件一个一个依次发给核心处理（每月20日）；l 下载并导入核心扣款结果文件（DOWNGJJ20050920_0.9800公积金贷款扣款结果，DOWNGJJ20050920_1.9800商业贷款扣款结果）（每月21日）；l (0720050921update.txt)拆分处理结果，将提取公积金冲还贷款情况表返回给公积金中心（每月21日）；l (0720050921adjust.txt)如提取资金大于当期贷款本息的（如部分提前还款），生成“公积金冲还实转差额明细清单”上报（每月21日）；l 生成(公积金待发文件GJJDF20050921.9800)，上传核心（每月21日）；3 公积金冲还贷相关数据格式3.1 本期可冲还贷清单l 中心提供各银行下载冲还贷数据格式（即本期可冲还贷清单）：ID类型备注banknoC6银行代码(bctl.accum_fund_exchno)fund_actnoC30贷款帐号idnoC18主贷人身份证号txdateC8本次提供日期rtn_typeC2扣款方式1-逐月法、3-余额法不停还natureC2贷款性质01-公积金贷款、02-商业贷款、03-组合贷款公积金部分、04-组合贷款商业部分l 说明：组合贷款分公积金部分和商业贷款部分两条记录提供，分别在贷款性质里用代码注明（下同）；l 说明：贷款性质为商业贷款和组合商业贷款时，贷款帐号对应个贷系统中的“贷款号”loaninfo. accum_fund_actno；l 说明：贷款性质为公积金贷款和组合公积金贷款时，贷款帐号对应个贷系统中的“公积金帐号”loaninfo. accum_fund_actno；l loaninfo. accum_fund_actno栏位有两种含义，所以该栏位不能为空；3.2 公积金冲还贷计划清单l 各银行提供贷款余额数据格式（即冲还贷计划BtoC）：ID类型备注banknoC6银行代码fund_actnoC30贷款帐号idnoC18主贷人身份证号lnbalC12贷款余额金额乘以100，不含小数txamtC12本次需扣款的金额balamtC12还款本金payintC12还款利息paypintC12罚息txdateC8本次提供日期rtn_typeC2扣款方式1-逐月法、3-余额法不停还natureC2贷款性质01-公积金贷款、02-商业贷款、03-组合贷款公积金部分、04-组合贷款商业部分l 说明：扣款方式为余额法以贷款余额为准；扣款方式为逐月法以本次还款额为准；本次还款额为还款合计，包括本金、利息和罚息；3.3 本期公积金实际提取信息明细清单l 中心返回扣款数据格式（即本期公积金实际提取信息明细CtoB）：ID类型备注banknoC6银行代码fund_actnoC30贷款帐号actnoC9主贷人个人帐号idnoC18主贷人身份证号txamtC12扣款金额rtn_typeC2扣款方式1-逐月法、3-余额法不停还txdateC8本次扣款日期natureC2贷款性质01-公积金贷款、02-商业贷款、03-组合贷款公积金部分、04-组合贷款商业部分l 说明：主贷人个人帐号是指公积金中心给个人用来查询的公积金帐号；3.4 冲还贷操作结果信息清单l 各银行返回调整扣款数据格式（即冲还贷操作结果信息fund_update）：ID类型备注banknoC6银行代码actnoC9主贷人个人帐号idnoC18主贷人身份证号lnbalC12贷款余额（本次扣款后的余额）txamtC12本次扣款金额balamtC12还款本金payintC12还款利息paypintC12罚息txdateC8本次扣款日期fund_actnoC30贷款帐号rtn_typeC2扣款方式1-逐月法、3-余额法不停还natureC2贷款性质01-公积金贷款、02-商业贷款、03-组合贷款公积金部分、04-组合贷款商业部分change_typeC2调整标志01-金额调整l 说明：本次扣款额为还款合计，包括本金、利息和罚息；l 说明：调整标志在金额发生误差时置为“01”；3.5 公积金冲还实转差额明细清单l 公积金冲还实转差额数据格式：fund_adjustID类型备注banknoC6银行代码fund_actnoC30贷款帐号actnoC9主贷人个人帐号idnoC18主贷人身份证号getamtC12提取余额txamtC12实际扣款金额balanceC12实转差额rtn_typeC2扣款方式1-逐月法、3-余额法不停还natureC2贷款性质01-公积金贷款、02-商业贷款、03-组合贷款公积金部分、04-组合贷款商业部分3.6 到期利息文件l 文件名：DOWNLX20040413.9800 20040413：系统日期 9800：分行机构号l 到期利息文件数据格式：ID类型备注cinoC16借据号periSMALLINT期次balamtC12到期本金balanceC12到期利息3.7 上送文件l 文件名：UPGJJ20040420_X.9800 20040420：系统日期 X：文件标志（0：公积金1：商业性） 9800：分行机构号l 上送文件数据格式-头记录：ID类型备注txdateChar(8)入帐日期YYYYMMDDcountChar(6)冲还贷记录数sumamtChar(15)冲还贷总金额含两位小数（带小数点）l 上送文件数据格式-明细记录:ID类型备注txdateChar(8)入帐日期YYYYMMDDbrcodeChar(4)营业机构cinoChar(16)借据号natureChar(1)属性0：公积金1：商业性txamtChar(15)冲还贷金额含两位小数（带小数点）rtn_typeChar(1)冲还贷方式0：逐月1：一次性nameChar(62)姓名3.8 回传文件l 文件名：DOWNGJJ20040420_X.9800 20040420：系统日期 X：文件标志（0：公积金1：商业性） 9800：分行机构号l 回传文件数据格式-头记录：ID类型备注txdateChar(8)入帐日期YYYYMMDDok_countChar(6)成功冲还贷记录数ok_sumamtChar(15)成功冲还贷总金额含两位小数（带小数点）fail_countChar(6)失败冲还贷记录数fail_sumamtChar(15)失败冲还贷总金额含两位小数（带小数点）l 回传文件数据格式-明细记录:ID类型备注brcodeChar(4)营业机构cinoChar(16)借据号natureChar(1)属性0：公积金1：商业性payamtChar(15)冲还贷金额含两位小数（带小数点）txamtChar(15)实际扣款金额含两位小数（带小数点）balamtChar(15)实际扣款本金含两位小数（带小数点）payintChar(15)实际扣款利息含两位小数（带小数点）paypintChar(15)实际扣款罚息含两位小数（带小数点）flagChar(1)标志1：成功2：失败commentChar(50)失败原因(成功填空白)nameChar(62)姓名3.9 公积金代发文件l 文件名：GJJDF20050921.9800 20050921：系统日期 9800：分行机构号l 公积金代发文件数据格式-头记录：JIAMBZ：x 加密标志（1位）0-明文，1-密文DANWBH:nnnnnnnn # 单位编号（8位）YWZHBH：nnnn 业务种类（4位）KHZHLX:1 # 外围业务帐户类型 (1位)（可空）KEHUZH:xxxxxxxxxxxx #客户帐号，可为空 (20位)（可空）HUOBDH:01 # 币种 ( 2位)CHUIBZ:0 # 钞汇标志（可空）ZHHUXZ:0001 帐户性质（可空）SHOFBZ:1 # 收付标志，不可为空，1-批量代发，2-批量代扣ZONGJE:1234567.89 # 请求总金额BISHUU:12345 # 请求总笔数RUZHRQ:19000101 # 可空(入帐日期)- # 分隔符，单列一行，至少一个，l 公积金代发文件数据格式-明细记录:帐号|金额|客户姓名|第三方用户编号|摘要|帐号:金额:客户姓名:摘要:第三方用户编号:C,40位。l 内容举例：JIAMBZ:0DANWBH:98020014YWZLBH:1001KHZHLX:1KEHUZH: HUOBDH:01CHUIBZ:0ZHHUXZ:0001SHOFBZ:1ZONGJE: 10698.30BISHUU: 4RUZHRQ:20050921-843018004832915|510.00|843017000532266|5140.00|843017002137680|3780.00|980200001140656|1268.30|4 批量处理该部分主要是公积金冲还贷的批量程序概要设计说明。4.1 本期可冲还贷数据导入bh70014.1.1 处理说明l 判断文件是否存在；l 将数据导入fund_down_rtn表；4.1.2 处理周期l 每月13日处理；4.1.3 输出数据l ；4.2 下载并导入到期利息bh70024.2.1 处理说明l 下载到期利息文件；l 判断文件是否存在；l 将数据导入fund_dute_int表；4.2.2 处理周期l 每月14日处理；4.2.3 输出数据l ；4.3 生成BtoC文件bh70034.3.1 处理说明l 根据到期利息数据和期供数据、借据信息、本期可冲还贷数据生成BtoC文件，即“冲还贷计划”；4.3.2 处理周期l 每月14日处理；4.3.3 输出数据l 按约定格式增加清单内容形成“冲还贷计划”上报；4.4 导入CtoB文件bh70044.4.1 处理说明l 判断文件是否存在；l 将数据导入fund_ctob表；4.4.2 处理周期l 每月19日处理；4.4.3 输出数据l ；4.5 拆分CtoB文件bh70054.5.1 处理说明l 分公积金贷款与商业贷款，按每2000条一个扣款文件,拆分fund_ctob数据； l 格式参照上送文件4.5.2 处理周期l 每月20日处理；4.5.3 输出数据l 每2000条一个扣款文件；4.6 发送扣款文件bh70064.6.1 处理说明l 按顺序一个一个的向核心发送扣款文件； l 每发送一个扣款文件，要等待核心回执确认；如果核心处理成功，则记录该扣款文件名，发送下一个文件；如果核心处理失败，则报错退出；4.6.2 处理周期l 每月20日下午处理；4.6.3 输出数据l 发送扣款文件；4.7 下载并导入核心扣款结果文件bh70074.7.1 处理说明l 下载核心扣款结果文件；l 判断文件是否存在；l 将数据导入fund_update表；l 将提取公积金冲还贷款情况表返回给公积金中心；4.7.2 处理周期l 每月21日下午处理；4.7.3 输出数据l 冲还贷操作结果信息，即提取公积金冲还贷款情况表；4.8 拆分核心扣款结果bh70084.8.1 处理说明l 拆分核心扣款结果；l 生成“公积金冲还实转差额明细清单”上报公积金中心；l 生成“公积金代发文件”上传核心；4.8.2 处理周期l 每月21日下午处理；4.8.3 输出数据l “公积金冲还实转差额明细清单”；l “公积金代发文件”；4.9 公积金冲还贷清单bh70094.9.1 处理说明l 参照核心扣款结果以及BtoC、CtoB文件，生成“公积金冲还贷清单”； l 报表类型：月报；l 报表存放路径：在每月20日报表目录下；l 报表统计范围：上海各支行；l 报表名称：xxxx-20051020-bh7009.csv；l 报表要经过gzip压缩；