业务管理地方代理财政业务系统应用系统设计说明书额度管理.docx
《业务管理地方代理财政业务系统应用系统设计说明书额度管理.docx》由会员分享,可在线阅读,更多相关《业务管理地方代理财政业务系统应用系统设计说明书额度管理.docx(74页珍藏版)》请在冰点文库上搜索。
业务管理地方代理财政业务系统应用系统设计说明书额度管理
(业务管理)地方代理财政业务系统应用系统设计说明书额度管理
邮政储蓄银行代理财政业务系统
应用系统设计说明书
(草稿)
中国邮政储蓄银行代理财政业务项目组
2012年1月31日
文档标识:
AFS-DES-
当前版本:
0.1
当前状态:
草稿
发布日期:
2010-09-21
发布
ü
修改历史
日期
版本
作者
修改内容
评审号
变更控制号
2010-09-21
1.0
胡美鑫
新建
1概述
1.1通讯报文协议约定
前台系统向中间业务后台系统发起交易时,交易报文采用TUXEDOFML的格式,即所有的通讯报文都由一系列的FML域构成。
中间业务系统后台主机对于FML域的说明及使用规则如下:
Ø所有在报文中出现的FML域,都必须存在于后台主机的报文域列表(数据字典)中cpa.fml。
ØFML数据域不存在进行对齐和补足长度的问题。
ØFML域名:
指TUXEDOFML域的标识,全部以大写形式表示。
Ø类型长度约定:
为了查找方便,将所有数据域进行归类表示,类别说明如下:
Ø数据域类型的表示方法说明:
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
请求MAC
14.
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
响应MAC
10.
Ø返回网点或管理终端的交易应答参与mac计算的FML域:
S_TRAN_DT+S_MIDD_TRAN_SQ+S_RSP_CD
1.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
本金(实收金额)
Double
S_FEE
手续费
Double
S_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/APS
1.调用APFchkMerchForOwe()函数完成欠费查询时的相关检查。
2.特殊处理配置点;
APSpayPubProc()
$HOME/src/BUSI/PAY/APS
1.调用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.
下载公司系统额度下达结果
770302
3.
额度批量下达汇总信息查询
770303
是
是
是
4.
额度批量下达结果查询
770304
是
是
是
5.
额度批量下达成功明细查询
770305
是
是
是
6.
额度批量下达失败明细查询
770306
是
是
是
7.
额度批量下达冻结明细查询
770307
是
是
是
8.
额度批量下达解冻明细查询
770308
是
是
是
9.
额度反馈EXCEL文件导出
770309
是
是
是
10.
额度反馈文件导出
770310
是
是
是
11.
额度注销
770311
12.
额度冻结
770312
是
是
是
13.
额度解冻
770313
是
是
是
14.
额度结转
770314
15.
额度下达登记簿-汇总信息查询
770315
是
是
是
16.
额度下达登记簿-明细信息查询
770316
是
是
是
17.
额度变动登记簿
770317
是
是
是
18.
额度注销登记簿
770318
是
是
是
19.
额度冻结/解冻登记簿
770319
是
是
是
20.
额度结转登记簿
770320
是
是
是
21.
额度结转科目明细查询
770321
是
是
是
22.
额度到账通知单打印通知接收
770322
23.
额度注销通知单打印通知接收
770323
24.
额度到账通知单打印情况查询
770324
是
是
是
25.
额度到账通知单打印对账
770325
26.
额度注销通知单打印对账
770326
27.
额度冻结对账
770327
28.
额度解冻对账
770328
1.6参考文档
资料名称
作者
日期
《邮政金融代理财政业务系统技术方案》
中国邮政
2011年12月
《邮政金融代理财政业务系统业务需求》
中国邮政
2011年12月
《邮政金融中间业务平台技术方案》
中国邮政
2010年5月
《外部接入系统与邮政金融计算机网络系统(公司业务应用软件)接口技术规范》
中国邮政
2008年7月
《财政部与中央财政代理银行国库收付业务接口定义规范》
财政部国库司
2010年11月
《国库动态监控系统代理银行实时传输数据接口规范》
财政部国库司
2009年10月
《中央金库与代理银行联网方案
接口规范》
中国金融电子化公司
2009年8月
《邮政综合计算机网安全保密系统总体技术方案》
原国家邮政局
《信息安全等级保护管理办法》
公通字[2007]43号
《数据处理设备的安全规定》
GB4943-85
《邮政金融代理财政业务系统业务需求分析说明书》
中国邮政
《邮政金融代理财政业务系统业务总体设计》
中国邮政
2总体流程设计
2.1总体处理流程
2.1.1XXXX处理流程
2.1.2XXXX处理流程
3公共管理部分设计
3.1额度管理
3.1.1760206_额度导入生效[鲁国栋]
3.1.1.1功能描述[后台]
此交易将下载到银行端的额度信息导入代理财政业务系统,主要为查询和记录财政发送的额度文件,每次记录的额度信息累加使用,财政为了控制预算单位的额度,可以发送负值额度信息。
3.1.1.2前后台通讯报文[后台]
Ø请求报文
数据域标识
数据域名称
前端对应域ID(P)
前端对应域ID(E)
是否必输
域类型
说明
S_OPE_CD
业务代码
Y
S6
S_MERCH_ID
委托单位代码
Y
S12
S_CPA_BATCH_NO
额度汇总单号
Y
S50
重复域
S_YEAR_DT
年度
Y
重复域
S_QT
数量
Y
L
所选中的额度汇总单数量
Ø响应报文
数据域标识
数据域名称
前端对应ID(P)
前端对应域ID(E)
是否必输
域类型
说明
S_SUCC_QT
成功总笔数
Y
L10
S_ORGN_PB_AT
成功总金额
Y
D16,2
S_FAIL_QT
失败总笔数
Y
L10
S_ORGN_RB_AT
失败总金额
Y
D16,2
S_PB_QT
冻结笔数
Y
L10
S_FAIL_PB_QT
解冻笔数
Y
3.1.1.3接口通讯报文
3.1.1.4E平台_界面设计
3.1.1.4.1输入界面
前台勾选相应的额度汇总单号,点击导入按钮
3.1.1.4.2输出界面
成功总笔数N成功总金额N
失败总笔数N失败总金额N
额度冻结笔数N额度解冻笔数N
3.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.7APS流程配置
编号
APS名称
子APS/APF
使用说明
1.
APSTsaQuotaProc()
APSChkMerchOpe()
商家代码、业务代码检查
APFIntSpecRun()
配置点调用个性化函数
3.
APSTsaReleace()
APFIntSpecRun()
配置点调用个性化函数
4.
MerchAppInter()
APFIntSpecRun()
财政系统接口,发送消息通知
5.
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.2760213_额度结转[鲁国栋]
3.1.2.1功能描述[后台]
3.1.2.2前后台通讯报文[后台]
Ø请求报文
数据域标识
数据域名称
前端对应域ID(P)
前端对应域ID(E)
是否必输
域类型
说明
S_OPE_CD
业务代码
Y
S6
S_MERCH_ID
委托方代码
Y
S12
S_HOME_ZIP_ID
预算单位编码
Y
S50
S_OUT_ACC_CARD_ID
原零余额账号
Y
S32
S_ORGER_PSNL_NM
原零余额账户名称
Y
S100
S_IN_ACC_CARD_ID
新零余额账号
Y
S32
S_RECV_PSNL_NM
新零余额账户名称
Y
S100
S_EFFECT_DT
生效日期
Y
S8
默认当天
Ø响应报文
数据域标识
数据域名称
前端对应ID(P)
前端对应域ID(E)
是否必输
域类型
说明
S_SUCC_FG
交易结果
Y
S1
S_INST_ID
操作机构号
Y
S21
S_TLR_ID
操作柜员号
Y
S7
S_AUTH_SEQ_ID
授权柜员号
Y
S7
S_TRAN_SQ
交易流水号
Y
3.1.2.3接口通讯报文
3.1.2.4E平台_界面设计(E平台人员,没有则删除章节)
3.1.2.4.1输入界面
额度结转
业务代码[★,M]
委托方代码[★,M]
预算单位编码[★,A]
原零余额账号[★,A]
原零余额账户名称[★,A]
新零余额账号[★,A]
新零余额账户名称[★,A]
生效日期[★,D]
确认重置
3.1.2.4.2输出界面
交易结果A操作机构号A
操作柜员号A授权柜员号A
交易流水号A
3.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.3APS流程配置
编号
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_unit
3.1.2.5.5权限说明
交易属性:
实时联机交易
渠道类型:
管理终端
交易授权:
需要
3.1.2.5.6备注说明
无
3.1.3760214_额度结转生效[鲁国栋](修改为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.3APS流程配置
编号
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_unit
3.1.3.4.5权限说明
交易属性:
日终
渠道类型:
后台
交易授权:
不需要
3.1.3.4.6备注说明
无
3.2支付管理
3.2.1760302_授权支付凭证查询下载[鲁国栋]
3.2.1.1功能描述[后台]
本交易主要用于查询下载到代理财政业务系统本地的支付指令。
如在代理财政业务系统本地的支付指令当中查询不到,则系统发起交易去财政端查询并下载该支付指令。
3.2.1.2前后台通讯报文[后台]
Ø请求报文
数据域标识
数据域名称
前端对应域ID(P)
前端对应域ID(E)
是否必输
域类型
说明
S_OPE_CD
业务代码
Y
S6
S_MERCH_ID
委托单位代码
Y
S12
S_CERT_ID
支付凭证编码
Y
S50
Ø响应报文
数据域标识
数据域名称
前端对应ID(P)
前端对应域ID(E)
是否必输
域类型
说明
S_RECV_DT
下载日期
Y
S8
S_CERT_ID
支付凭证编码
Y
S50
S_AVAIL_CD
电子支付指令标志
Y
S1
0待处理1支付2退款3作废8提交9审核
S_HOME_ZIP_ID
基层单位编码
Y
S42
S_DEP_CORP_NM
基层单位名称
Y
S100
S_ITEM_TYPE_CD
科目编码
Y
S42
S_PAY_ITEM
项目编码
Y
S100
S_HOLD_APP_ID
指标编号
Y
S50
S_BRGON_ID
指标文号
Y
S200
S_NEED_START_FG
是否基建
Y
S1
S_YEAR_DT
原年度
Y
S4
S_RB_AT
金额
Y
D12,2
3.2.1.3接口通讯报文
3.2.1.4P平台_界面设计
3.2.1.4.1查询主界面
电子支付令查询
业务代码:
[★,M]
委托单位:
[★,M]
3.2.1.4.2查询条件界面
电子支付令查询
支付凭证编码:
[★,A10]
3.2.1.4.3查询结果界面
下载日期D8支付凭证编码A10
电子支付指令标志N1基层单位编码A42
基层单位名称A100
科目编码A42项目编码A100
指标编号A10
指标文号A200原年度D4
是否基建N1金额N12.2
3.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(),