TSA-地方代理财政业务系统-应用系统设计说明书-额度管理.doc

TSA_地方代理财政业务系统_应用系统设计说明书_额度管理752020年5月29日文档仅供参考邮政储蓄银行代理财政业务系统应用系统设计说明书(草稿)中国邮政储蓄银行代理财政业务项目组 1月31日文档标识:AFS-DES-当前版本:0.1当前状态:草稿发布日期: -09-21发布 修改历史日期版本作者修改内容评审号变更控制号 -09-211.0胡美鑫新建1 概述1.1 通讯报文协议约定前台系统向中间业务后台系统发起交易时,交易报文采用TUXEDO FML的格式,即所有的通讯报文都由一系列的FML域构成。中间业务系统后台主机对于FML域的说明及使用规则如下: 所有在报文中出现的FML域,都必须存在于后台主机的报文域列表(数据字典)中cpa.fml。 FML数据域不存在进行对齐和补足长度的问题。 FML域名:指TUXEDO FML域的标识,全部以大写形式表示。 类型长度约定:为了查找方便,将所有数据域进行归类表示,类别说明如下: 数据域类型的表示方法说明:char:单字符。double: 双浮点数,一般用来表示金额。long:长整数,多用于表示个数。 string: 字符串,string(30)表示30位长度。 carry:bity类型,主要是密码密文,mac密文等1.2 公共报文头1.2.1 请求报文序号FML域名中文名称含义1.S_LOCAL_DT交易方日期前端记录的交易日期2.S_INST_ID机构代码交易机构代码,若为外系统,则为外系统的系统代码3.S_SOLE_FRONT_SQ前端唯一流水号字符串类型4.S_CHNL_CD渠道代码5.S_INST_TERM_ID终端编号网点和管理端发起时,外系统发起时,登记外系统代码6.S_TRAN_CD交易码7.S_TLR_ID操作员8.S_BOX_ID尾箱号9.S_CHECKER_ID复核员10.S_AUTH_SEQ_ID授权员11.S_AUTH_PWD_CD授权员密码12.S_SERVER_ID服务器代码当前管理终端服务器代码作为密钥的关键字13.S_MAC请求MAC14.S_TX_CTRL_ATTR交易控制属性主要用于增删改查交易的功能定义备注 管理终端发来的交易请求参与mac计算的FML域:6位交易码8位交易日期9位机构代码8位前端流水号(前面补0)2位渠道代码1位交易控制标志7位操作员(域值之间使用一个空格,首尾不使用空格。字符串按实际长度,没有则为空) 网点发来的交易参与mac计算的FML域:6位交易码7位柜员号9位机构6位流水号(前补0)1.2.2 响应报文序号FML域名中文名称含义1.S_TRAN_DT本系统清算日期2.S_MIDD_TRAN_SQ中心流水号3.S_INST_ID机构代码4.S_FRONT_SQ前端流水号5.S_TRAN_CD交易码6.S_RSP_CD响应码7.S_RSP_DESC_TX响应说明8.S_SUCC_FG成功标志1-失败、0-成功9.S_MAC响应MAC10. 返回网点或管理终端的交易应答参与mac计算的FML域:S_TRAN_DT+S_MIDD_TRAN_SQ+S_RSP_CD1.3 常见FML使用FML域名中文描述使用说明S_MERCH_ID委托单位代码S_OPE_CD业务代码S_PRE_PAY_SQ商家流水号销帐流水等S_MONTH_DT月份日期欠费月份,发票月份等TRANSYS_CODE外部系统代码经过非网点渠道发起的交易时,将渠道代码填入此域;例如ATMP(自助设备)/POS(自助设备)/电话银行/个人网银/企业网银S_ACC_CARD_ID卡折号缴费,预缴费,签约等需要输入账号时,统一使用S_CARD_PWD_TX账户密码输入账户密码时,使用此域S_PAYMENT_WAY_CD支付方式S_ACC_ID帐号用于储蓄系统返回的附加帐号,例如,如果经过卡号查询,则返回其帐号;如果经过帐号查询,则返回卡号。S_CARD_PK_FG卡折标志S_PAYMENT_WAY_CD支付方式0-现金、1-折、2-卡、3-支票票据、4-公司账号、5-信用卡账号、6-押款(押金)S_CHK_PWD_FG验密标志0-验密; 1-不验密;S_TRAN_AT本金(实收金额)DoubleS_FEE手续费DoubleS_FEE_RT异地手续费收取比率。以%为单位S_OWE_FEE_AT欠费金额S_FEE_TOTAL_AT应缴金额S_CERT_ID发票类型S_CERT_START_ID发票起始号码S_TRACK2_DATA_TX磁道2数据S_TRACK3_DATA_TX磁道3数据S_PRT_FG打印发票标志S_CERT_CD发票代码S_CERT_START_ID发票起始号码S_TRAN_QT打印数量/交易数量S_EXT_CPY_CLR_DT商家清算日期1.4 公用函数列表函数命名所属目录功能描述APSowePubProc()$HOME/src/BUSI/PAY/APS1. 调用APFchkMerchForOwe ()函数完成欠费查询时的相关检查。2. 特殊处理配置点;APSpayPubProc()$HOME/src/BUSI/PAY/APS1. 调用APFchkMerchForOwe ()函数完成欠费查询时的相关检查。2. 调用APFpayTranToolChk ()检查缴费方式。3. 调用APFVchUSE() 处理凭证信息。4. 调用APFpayRecJnl()。进行交易流水的初始化处理。5. 调用特殊处理配置。APFchkMerchForOwe ()$HOME/src/BUSI/PAY/APF欠费查询时,检查tb_merch_ope相关参数是否合法。APFchkMerchForPay ()$HOME/src/BUSI/PAY/APF缴费时,检查tb_merch_ope相关参数是否合法。1.5 代码字典(云宏斌、焦洪雷、刘国欣、孙宏滨)序号交易名称交易代号E平台P平台核心接口1.额度批量导入770301是是是2.下载公司系统额度下达结果7703023.额度批量下达汇总信息查询770303是是是4.额度批量下达结果查询770304是是是5.额度批量下达成功明细查询770305是是是6.额度批量下达失败明细查询770306是是是7.额度批量下达冻结明细查询770307是是是8.额度批量下达解冻明细查询770308是是是9.额度反馈EXCEL文件导出770309是是是10.额度反馈文件导出770310是是是11.额度注销77031112.额度冻结770312是是是13.额度解冻770313是是是14.额度结转77031415.额度下达登记簿-汇总信息查询770315是是是16.额度下达登记簿-明细信息查询770316是是是17.额度变动登记簿770317是是是18.额度注销登记簿770318是是是19.额度冻结/解冻登记簿770319是是是20.额度结转登记簿770320是是是21.额度结转科目明细查询770321是是是22.额度到账通知单打印通知接收77032223.额度注销通知单打印通知接收77032324.额度到账通知单打印情况查询770324是是是25.额度到账通知单打印对账77032526.额度注销通知单打印对账77032627.额度冻结对账77032728.额度解冻对账7703281.6 参考文档资料名称作者日期中国邮政 12月中国邮政 12月中国邮政 5月中国邮政 7月财政部国库司 11月财政部国库司 10月中国金融电子化公司 8月原国家邮政局公通字 43号GB4943-85中国邮政中国邮政2 总体流程设计2.1 总体处理流程2.1.1 XXXX处理流程2.1.2 XXXX处理流程3 公共管理部分设计3.1 额度管理3.1.1 760206_额度导入生效 鲁国栋3.1.1.1 功能描述后台此交易将下载到银行端的额度信息导入代理财政业务系统,主要为查询和记录财政发送的额度文件,每次记录的额度信息累加使用,财政为了控制预算单位的额度,能够发送负值额度信息。3.1.1.2 前后台通讯报文后台 请求报文数据域标识数据域名称前端对应域ID(P)前端对应域ID(E)是否必输域类型说明S_OPE_CD业务代码YS6S_MERCH_ID委托单位代码YS12S_CPA_BATCH_NO额度汇总单号YS50重复域S_YEAR_DT年度Y重复域S_QT数量YL所选中的额度汇总单数量 响应报文数据域标识数据域名称前端对应ID(P)前端对应域ID(E)是否必输域类型说明S_SUCC_QT成功总笔数YL10S_ORGN_PB_AT成功总金额YD16,2S_FAIL_QT失败总笔数YL10S_ORGN_RB_AT失败总金额YD16,2S_PB_QT冻结笔数YL10S_FAIL_PB_QT解冻笔数Y3.1.1.3 接口通讯报文3.1.1.4 E平台_界面设计3.1.1.4.1 输入界面前台勾选相应的额度汇总单号,点击导入按钮3.1.1.4.2 输出界面成功总笔数 N 成功总金额 N失败总笔数 N 失败总金额 N额度冻结笔数 N 额度解冻笔数 N3.1.1.4.3 流程说明1、 前台勾选需导入的额度汇总单号,点击导入按钮,将额度汇总单号集合上传到后台。2、 接收后台返回结果,并显示到输出界面。3、 点击取消按钮,可取消本次交易。3.1.1.4.4 后台_流程设计3.1.1.4.5 处理流程图3.1.1.4.6 处理流程说明1. APSTsaQuotaProc(),额度导入公共预处理部分;检查委托单位是否合法;预留配置点函数。2. APSTsaReleace(),额度批量导入本地处理部分;检查下达额度信息是否重复导入、导入额度;预留配置点函数。3. MerchAppInter(),发送委托方,财政系统接口;给财政系统发送通知单消息,预留配置点函数。4. APSTsaPubRet(),额度管理返回前公共处理;预留配置点函数。3.1.1.4.7 APS流程配置编号APS名称子APS/APF使用说明1.APSTsaQuotaProc()APSChkMerchOpe()商家代码、业务代码检查APFIntSpecRun()配置点调用个性化函数2.APSTsaReleace()APFIntSpecRun()配置点调用个性化函数3.MerchAppInter ()APFIntSpecRun()财政系统接口,发送消息通知4.APSTsaPubRet()APFIntSpecRun()配置点调用个性化函数3.1.1.4.8 相关库表额度通知单汇总信息表:tb_tsa_quota_release_sum额度通知单明细信息表:tb_tsa_quota_release_detail财政额度控制要素表:tb_tsa_quota_finance_element额度变动信息表:tb_tsa_quota_vary剩余额度信息表:tb_tsa_remain_quota额度冻结/解冻信息表:tb_tsa_quota_freeze委托单位信息表(tb_tsa_merch_info)公共管理3.1.1.4.9 权限说明交易属性:实时联机交易渠道类型:管理终端交易授权:需要3.1.1.4.10 备注说明无3.1.2 760213_额度结转 鲁国栋3.1.2.1 功能描述后台3.1.2.2 前后台通讯报文后台 请求报文数据域标识数据域名称前端对应域ID(P)前端对应域ID(E)是否必输域类型说明S_OPE_CD业务代码YS6S_MERCH_ID委托方代码YS12S_HOME_ZIP_ID预算单位编码YS50S_OUT_ACC_CARD_ID原零余额账号YS32S_ORGER_PSNL_NM原零余额账户名称YS100S_IN_ACC_CARD_ID新零余额账号YS32S_RECV_PSNL_NM新零余额账户名称YS100S_EFFECT_DT生效日期YS8默认当天 响应报文数据域标识数据域名称前端对应ID(P)前端对应域ID(E)是否必输域类型说明S_SUCC_FG交易结果 YS1S_INST_ID操作机构号YS21S_TLR_ID操作柜员号YS7S_AUTH_SEQ_ID授权柜员号YS7S_TRAN_SQ交易流水号Y3.1.2.3 接口通讯报文3.1.2.4 E平台_界面设计(E平台人员,没有则删除章节)3.1.2.4.1 输入界面额度结转业务代码 ,M委托方代码 ,M预算单位编码 ,A原零余额账号 ,A原零余额账户名称 ,A新零余额账号 ,A新零余额账户名称 ,A生效日期 ,D确认 重置3.1.2.4.2 输出界面交易结果 A 操作机构号 A操作柜员号 A 授权柜员号 A 交易流水号 A3.1.2.4.3 流程说明1. 输入额度结转信息,点击确认按钮,调用后台交易2. 接收后台返回的结果,并显示在输出界面3. 点击重置按钮,能够清空输入的所有信息3.1.2.5 后台_流程设计3.1.2.5.1 处理流程图3.1.2.5.2 处理流程说明1. 调用APSChkMerchOpe检查商家是否合法;2. 判断原零余额账号与预算单位关联的零余额账号是否相符;3. 根据原零余额账号查询额度结转信息表是否有未生效的额度结转记录;如果有返回错误;4. 查询委托单位的是否自动结转标志财政结转参数信息表;5. 如果自动结转,将原零余额账号赋值到S_ACC_CARD_ID,调用账户查询交易,如果余额大于0,返回错误。6. 将新零余额账号赋值到S_ACC_CARD_ID,调用账户查询交易。7. 判断生效日期是否为当日,为当日登记额度结转信息表、额度变动信息表的type,根据原零余额账号信息生成新零余额账号剩余额度信息,将剩余额度信息表的原零余额账号可用额度和剩余额度修改为0;将新零余额账号和预算单位进行关联8. 否则,登记额度结转信息表;9. 将结转的结果信息赋值给g_rspBuf,返回前台3.1.2.5.3 APS流程配置编号APS名称子APS/APF使用说明1.TX_XXXXXX额度结转3.1.2.5.4 相关库表额度结转信息表:tb_tsa_quota_carry额度变动信息表:tb_tsa_quota_vary剩余额度信息表:tb_tsa_remain_quota预算单位基本信息表:tb_tsa_budget_unit3.1.2.5.5 权限说明交易属性:实时联机交易渠道类型:管理终端交易授权:需要3.1.2.5.6 备注说明无3.1.3 760214_额度结转生效鲁国栋(修改为APF)3.1.3.1 功能描述后台此交易用于预算单位更换行内零余额账户开户行并更换账号时,将原账户额度结转至新账户。3.1.3.2 前后台通讯报文后台 请求报文无 响应报文无3.1.3.3 接口通讯报文3.1.3.4 后台_流程设计3.1.3.4.1 处理流程图3.1.3.4.2 处理流程说明1. 查询额度结转信息表中生效日期等于当日的额度结转记录;2. 判断原零余额账号与预算单位关联的零余额账号是否相符;3. 登记额度变动信息表,根据原零余额账号信息生成新零余额账号剩余额度信息,将剩余额度信息表的原零余额账号可用额度和剩余额度修改为0;将新零余额账号和预算单位进行关联3.1.3.4.3 APS流程配置编号APS名称子APS/APF使用说明2.TX_XXXXXX额度结转生效3.1.3.4.4 相关库表额度结转信息表:tb_tsa_quota_carry额度变动信息表:tb_tsa_quota_vary剩余额度信息表:tb_tsa_remain_quota预算单位基本信息表:tb_tsa_budget_unit3.1.3.4.5 权限说明交易属性:日终 渠道类型:后台交易授权:不需要3.1.3.4.6 备注说明无3.2 支付管理3.2.1 760302_授权支付凭证查询下载鲁国栋3.2.1.1 功能描述后台本交易主要用于查询下载到代理财政业务系统本地的支付指令。如在代理财政业务系统本地的支付指令当中查询不到,则系统发起交易去财政端查询并下载该支付指令。3.2.1.2 前后台通讯报文后台 请求报文数据域标识数据域名称前端对应域ID(P)前端对应域ID(E)是否必输域类型说明S_OPE_CD业务代码YS6S_MERCH_ID委托单位代码YS12S_CERT_ID支付凭证编码YS50 响应报文数据域标识数据域名称前端对应ID(P)前端对应域ID(E)是否必输域类型说明S_RECV_DT下载日期YS8S_CERT_ID支付凭证编码YS50S_AVAIL_CD电子支付指令标志YS10待处理1支付2退款3作废8提交9审核S_HOME_ZIP_ID基层单位编码YS42S_DEP_CORP_NM基层单位名称YS100S_ITEM_TYPE_CD科目编码YS42S_PAY_ITEM项目编码YS100S_HOLD_APP_ID指标编号YS50S_BRGON_ID指标文号YS200S_NEED_START_FG是否基建YS1S_YEAR_DT原年度YS4S_RB_AT金额YD12,23.2.1.3 接口通讯报文3.2.1.4 P平台_界面设计3.2.1.4.1 查询主界面电子支付令查询业务代码:,M委托单位:,M3.2.1.4.2 查询条件界面电子支付令查询支付凭证编码:,A10 3.2.1.4.3 查询结果界面下载日期 D8 支付凭证编码 A10电子支付指令标志 N1 基层单位编码 A42基层单位名称 A100科目编码 A42 项目编码 A100指标编号 A10指标文号 A200 原年度 D4是否基建 N1 金额 N12.23.2.1.4.4 打印页面无3.2.1.4.5 流程说明1. 输入授权支付凭证查询查询条件,点击前F4需要授权,调用后台交易2. 接收后台返回结果并显示相应的查询结果信息3.2.1.5 后台_流程设计3.2.1.5.1 处理流程图3.2.1.5.2 处理流程说明1. APSTsaQryDownProc(),授权支付凭证查询公共预处理部分;检查委托单位是否合法;预留配置点函数。2. APSTsaVouQuery(),授权支付凭证本地处理部分;本地查询下载的支付凭证信息;预留配置点函数。3. MerchAppInter(),发送委托方,到财政下载电子支付凭证,预留配置点函数。4. APSTsaPubRet(),额度管理返回前公共处理;预留配置点函数。3.2.1.5.3 APS流程配置编号APS名称子APS/APF使用说明5.APSTsaQryDownProc()APSChkMerchOpe()商家代码、业务代码检查APFIntSpecRun()配置点调用个性化函数6.APSTsaVouQuery()APFIntSpecRun()配置点调用个性化函数7.MerchAppInter ()APFIntSpecRun()财政系统接口,发送消息通知8.APSTsaPubRet()APFIntSpecRun()配置点调用个性化函数3.2.1.5.4 相关库表集中支付信息表:tb_tsa_payment_voucher3.2.1.5.5 权限说明交易属性:实时联机交易渠道类型:网点终端交易授权:需要3.2.1.5.6 备注说明无3.2.2 760320_授权支付业务明细查询鲁国栋3.2.2.1 功能描述后台根据交易流水号、预算单位编码、零余额账号、信息代码、日期段、银行单据类型、交易状态等信息组合查询辖域机构的授权支付、退票信息及状态。3.2.2.2 前后台通讯报文后台 请求报文数据域标识数据域名称前端对应域ID(P)前端对应域ID(E)是否必输域类型说明S_OPE_CD业务代码YS6S_MERCH_ID委托单位代码YS12S_BEGIN_DT起始日期YS8S_DEADLINE_DT截止日期YS8S_HOME_ZIP_ID预算单位编码CS50S_ACC_CARD_ID零余额账号CS32S_TRAN_STAT支付状态C0-待支付1-已支付2-已退款3-已作废4-支付中5-支付失败8-已提交9-已审核S_PAY_SQ交易流水号CS_DEAL_STAT清算状态C0 未清算 响应报文数据域标识数据域名称是否必输域类型说明S_OPE_CD业务代码YS12S_MERCH_ID委托单位代码YS6S_BANK_ID代理银行编码S30S_HOME_ZIP_ID预算单位编码S42S_IN_DEP_CORP_NM预算单位名称S100S_CERT_ID支付凭证编号S50S_ITEM_TYPE_CD功能分类科目代码S50S_ITEM_NM功能分类科目名称 S100S_PAY_ITEM预算项目编码S100S_PAY_PRJ_NM预算项目名称S100S_INFO_TYPE_KIND预算类型编码S42S_PRDT_NM预算类型名称S60S_ZIP_ID类编码S42S_CLASS_NM类名称S60S_COMMI_ZIP_ID款编码S42S_NOTICE_NM款名称S60S_PAYEE_INFO_ID项编码S42S_INDUSTRY_NM项名称S60S_TRAN_SORT_FG经济分类编码S42S_COMMI_INST_NM经济分类名称S60S_SPT_ITEM_CD目级科目S18S_AT_PURPOSE_CD用途S100S_HOLD_APP_ID指标编号S50S_BRGON_ID指标文号S200S_WORK_ZIP_ID一级预算单位编码S42S_OUT_DEP_CORP_NM一级预算单位名称S60S_SUP_AREA_CD区域编码S42S_DEMAND_FIX_TERM_ID单位国标码S20S_RB_PRI_ACC_ID结算号S18S_SUMMARY摘要名称S200S_PAY_SUMM_CD摘要编码S42S_ALLOT_CD支付管理类型编码S42S_DEBT_TYPE_CD支付管理类型名称S60S_VARY_TYPE_CD支付类型S10直接支付1授权支付S_ACC_TYPE_CD资金性质编码S50S_PARA_CD资金性质名称S50S_DERATE_WAY_CD支出类型S30S_ECHO_WAY_CD结算方式名称S60S_REMIT_STAT_CD结算方式编码S42S_YEAR_DT年度S4S_VCHR_DT凭证日期S8S_AMOUNT_AT金额D12.2S_ORG_ITEM_ID原凭证编号S50S_TRAN_STAT凭证状态S10待处理1已支付2已退款3已作废8提交9审核S_PAY_DT支付日期S8S_MONTH_DT计划月份S2S_DEAL_STAT核心对账状态 S3S_TUS_ID清算户代码S32S_OUS_ID清算户名称S60S_INSERT_TM支付时间S6S_RESUME_DT退款日期S8S_TFS_DT退款时间S6S_HOLD_DT作废日期S8S_TRAN_INST_TM作废时间S6S_DIFF_CERT_TYPE_CD支付凭证种类 S10无纸质凭证1有纸质凭证S_BOOK_FG整理期标识 S10本年度 1上年度S_ORG_BATCH_ID清算批次S8S_MAN_MODIFY_STAT_CD清算状态S10未清算S_ORGER_PSNL_NM付款人全称S100S_RMT_ACC_ID付款人账号S60TL_PAYEEBANKNO付款人开户银行S100S_RECV_PSNL_NM收款人全称S100S_PEER_ACC_ID收款人账号S60TL_PAYEEOPBKCODE收款人开户行号S100TL_PAYEENAME收款人开户行名称S100S_SUS_ID清算行号S30S_TDS_ID清算行名称S100TL_MSGID支付凭证主键S60支出明细系统码S_ATM_RTF_CD是否基建S1Y是N否S_DATA_ORG_CD指标来源S18S_ACC_CERT_TYPE_CD指标类型S18S_OPERATE_TYPE_CD授权支付类型S1S_ORG_SYS_ID原始编号S42S_PI_KIND_CD清算银行类别S3S_COMM_BANK_ID备用金银行名称S100S_BANK_TYPE_CD备用金银行类别S3S_ACCOUNT01备用金账户账号S40S_IN_ACC_NM备用金账户名称S100S_CONTENT01业务处室名称S100S_CONTENT02业务处室编码S30S_INST_NATURE_CD支出功能科目性质S3S_FUND_USE资金用途S500S_TRANSFER_TYPE操作类型S2S_ACC_ITEM_SCP_CD会计期间S2S_FCO_ID支出专项代码S30S_SUP_ITEM_NM支出专项名称S100S_STRING31预留字段1S128S_STRING32预留字段2S256S_STRING33预留字段3S5123.2.2.3 接口通讯报文3.2.2.4 P平台_界面设计3.2.2.4.1 查询条件界面授权支付业务明细查询业务代码:,M委托单位代码:,M授权支付业务明细查询起始日期:,D8 截止日期:,D8预算单位编码 O,A42 零余额账号:O,A32 支付状态:O,M 交易流水号:O,N8 清算状态:O,M 【查询】 【重置】3.2.2.4.2 查询结果界面预算单位名称、支付凭证编号、功能分类科目名称、支付金额、清算状态、状态、付款人名称、收款人名称、收款人账号、收款人开户银行、用途、支付日期XXXXXX XXXXX XXXXX XXXXX XXXXX XXXXXXXXXXX XXXXX XXXXX XXXXX XXXXX XXXXX3.2.2.4.3 打印页面无3.2.2.4.4 流程说明1. 输入授权支付业务明细查询条件,点击F4,调用后台查询交易。2. 接收后台返回的查询结果,并将授权支付业务明细查询结果显示在页面上3.2.2.5 E平台_界面设计(E平台人员,没有则删除章节)3.2.2.5.1 输入界面授权支付业务明细查询业务代码:,M委托单位:,M起始日期:,D8 截止日期:,D8预算单位编码 O,A42 零余额账号:O,A3