邮政储蓄银行代理地方财政国库集中支付系统应用系统设计说明书(草稿)中国邮政储蓄银行代理财政业务项目组2012年1月31日文档标识:AFS-DES-当前版本:0.1当前状态:草稿发布日期:2010-09-21发布修改历史日期版本作者修改内容评审号变更控制号2010-09-211.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请求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...