银行实时联网代收规范v5.11.doc

上海三高 需求分析报告 35-35 自来水营业收费管理系统银行实时联网代收规范 开发单位：上海三高计算机中心有限公司版本：5.11目录修改记录3业务流程（银行方为主动方）4水费查询&收费&打印发票4交易冲正5补打发票6对帐7应答通信帧格式8请求通信帧格式8应答通信帧格式8交易码与返回码定义9交易超时10交易报文数据结构描述11水费查询请求11水费查询应答11批扣查询请求13文件格式：13批扣查询应答14文件格式：14缴费请求15缴费应答15预付款充值请求19预付款充值应答19交易冲正请求20交易冲正应答21交易记录查询请求22交易查询应答22打印发票请求23打印发票应答23对帐请求27文件格式：28对帐应答29水司前置机31注意事项32修改记录日期版本描述编写人2007-04-105.00营业收费系统产品版况艺华2007-04-105.01调整对帐业务流程况艺华2007-04-165.02调整批扣应答处理流程况艺华2007-04-275.03调整对帐流程况艺华2007-07-165.041增加远程表交易业务 详见附件22统一各交易应答帧相关字段长度客户编号：16水费编号：9水量、抄码：9交易金额：12帐单零头：53 增加并统一交易结果代码00：成功11：失败（交易异常）12：交易关闭13：正在对帐、拒绝其它交易况艺华2007-09-105.05增加户名、地址查询交易况艺华2007-10-175.06增加电信查询交易况艺华2008-01-015.10调整查询报文，清除水费查询请求_电信和户名、地址查询10应答报文调整户名、地址位置20应答报文在每笔帐增加备注字段况艺华2008-05-085.11冲正应答增加银行端的请求流水号况艺华业务流程（银行方为主动方）水费查询&收费&打印发票水费查询请求水司方：水费查询应答Y继续？成功？NYN选择要收费的水费记录，发送缴费请求/发送充值请求水司方：接收收费请求，进行收费处理，返回收费应答结束成功？YN银行方：根据成功收费应答信息，记录收费信息到已方系统数据库；发送打印发票请求N银行方：发送冲正请求成功？Y结束根据缴费应答信息，打印发票内容交易冲正银行在进行交易冲正时，无需等待水司返回应答，即可认为冲正已成功。因为即使水司未处理，银行在对帐后，水司会依据对帐文本将此笔帐从系统中撤销掉。银行方：交易冲正请求水司方：水费冲正应答冲正处理结束补打发票银行方：交易查询请求水司方：交易查询应答Y继续？成功？NYN选择要打印的水费记录，发送打印发票请求水司方：根据打印发票请求，记录相应信息，返回打印发票应答成功？NY根据水费查询应答信息，打印发票内容结束对帐银行方：利用FTP协议发送对帐文本到水司指定位置发送对帐请求水司方：校验登帐文件是否有效水司方：发送文件无效应答返回对帐应答成功？YN水司方：发送文件有效应答断开连接水司方：内部进行对帐处理YN帐平？银行方：对帐结束存在银行多收NYNY水司方：对帐结束水司多收笔数未超过阙值水司方：多收帐冲正登帐记录对帐日志水司方：人工处理（同银行核对、手动对帐）水司方：记录对帐日志水司方：登帐应答通信帧格式请求通信帧格式字段名数据类型字段含义备注TRAN_CODEChar(2)交易码OPER_IDChar(8)操作员名称可填写银行员工工号FLOW_NOChar(8)银行交易流水号银行生成的交易流水号，务必保证当天交易中该流水号唯一，隔天可重复使用数据Char（x）详见“数据结构”应答通信帧格式含义数据类型备注帧长度char(6)不含“帧长度”本身的“数据”长度（以Char为单位）所有应答帧头部中包含该信息数据Char（x）详见“数据结构”注：请求帧长度最大不能超过8000字节。如果超过则返回错误码0C交易码与返回码定义交易码用来识别系统当前处于那一种交易功能:交易码内容10查询水费11批扣查询20水费缴费21预付款充值30水费冲正15交易记录查询请求16打印发票请求40对帐41水司手工对帐交易超时水司设定了两个超时参数：交易超时和对帐超时交易超时：水司自接收到交易指令到发送交易结果完（对帐处理除外）的最长时间为n秒, 水司可以根据银行方的实际运行情况设定n值，目前缺省为30秒。对帐超时：水司自接收到对帐指令到发送对帐结果的最长时间为n秒, 水司可以根据银行方的实际运行情况设定n值，目前缺省为300秒。交易报文数据结构描述描述各种请求和响应的数据内容，下面的数据包的定义考虑了各个地方的不同，采用有效数据加空格左对齐的方式添满尾部空格水费查询请求查询对应户号的所有未缴水费记录。字段名数据类型字段含义备注TRAN_CODEChar(2)交易码10OPER_IDChar(8)操作员名称FLOW_NOChar(8)流水号USER_NOChar(16)客户编号自来水公司为用水户分配的唯一标示编号水费查询应答返回对应户号的所有未缴水费记录。一个应答数据包的关键字段是：交易码操作员名称流水号客户编号第一层：查询用户的关键字段是：客户编号；一个应答数据包中可以包含同一户号的多笔应缴水费，用RowCount对读写进行控制；第二层：一笔应缴水费的关键字段是：水费记录号（FeeID）；字段字段类型字段含义对应字段备注RE_CODEChar(2)返回信息码根据结果返回00：成功11：失败（交易异常）12：交易关闭13：正在对帐、拒绝其它交易21：户号非法22：无欠费信息TRAN_CODEChar(2)交易码返回请求字段10OPER_IDChar(8)操作员名称返回请求字段FLOW_NOChar(8)流水号返回请求字段USER_NOChar(16)客户编号返回请求字段，USER_NAMEChar(64)户名用户当前户名USER_ADDRChar(64)地址用户当前地址CHARGE_TYPEChar(1)客户在水司登记的预定缴费方式0=代收1=托收2=代扣3=预付费9=远程充值A_BChar(12)预付款余额ZJEChar(12)应收总金额本次总金额应收总金额=(帐单金额+违约金) ROWCOUNTChar(2)水费明细行数不超过99查询到的一个用户应缴的多笔水费是数据包中以下所有字段重复次数FEEIDChar(9)水费记录号水司营收系统的主键在收费请求时要带入的重要字段MONChar(6)水费年月格式：YYYYMMYSLChar(9)用水量SCYEChar(5)上期结余上期帐单的零头结余金额CBJEChar(12)帐单金额收费时读取的金额BCyeChar(5)本期结余本期帐单的零头结余金额ZNJChar(12)违约金批扣查询请求字段名数据类型字段含义备注TRAN_CODEChar(2)交易码11OPER_IDChar(8)操作员名称FLOW_NOChar(8)流水号FileNameChar(64)批扣用户清单文本文件名文件名命名规则：Pk_bank.xxx(xxx银行代码)文件格式：注：文本文件明细均按以下字段顺序组织，字段间用空格分隔，行之间用换行符分隔)字段名数据类型字段含义备注USER_NOChar(16)客户编号AccountNoChar(32)银行批扣帐号批扣查询应答字段名数据类型字段含义备注RE_CODEChar(2)返回信息码00：成功11：失败（交易异常）12：交易关闭13：正在对帐、拒绝其它交易21：文件不存在22：文本错23：无欠费TRAN_CODEChar(2)交易码OPER_IDChar(8)操作员名称FLOW_NOChar(8)流水号FileNameChar(64)批扣用户欠费明细文本文件名注：银行在download欠费明细文件后，应及时将水司ftp服务器上的源文件删除文件名命名规则：Pk_water.xxx(xxx银行代码)批扣流程：第一步：水司收到请求文件后，在检查完文件有效性后立即返回应答信息。第二步：水司根据银行文件生成“代扣用户欠费明细文件”并放在水司端ftp环境第三步：银行定时到水司端ftp环境取“代扣用户欠费明细文件”第四步：银行根据代扣用户欠费明细文件用【缴费请求】逐步缴费文件格式：注：文本文件明细均按以下字段顺序组织，字段间用空格分隔，行之间用换行符分隔)字段名数据类型字段含义备注USER_NOChar(16)客户编号FeeIDChar(9)水费记录号ZDJEChar(12)帐单金额ZNJChar(12)违约金金额InvoicePrintedChar(1)是否已打印过发票（收据）否已打印缴费请求字段名数据类型字段含义备注TRAN_CODEChar(2)交易码20OPER_IDChar(8)操作员名称FLOW_NOChar(8)流水号TRAN_DATEChar(8)交易日期YYYYMMDDUSER_NOChar(16)客户编号PaySourceChar(1)实际付款方式0=现金2=银行转帐FEEIDChar(9)水费记录号在收费请求时要带入的重要字段PAYJEChar(12)缴费金额缴费金额=帐单金额+滞纳金ZDJEChar(12)帐单金额【查询应答包】中的返回数据ZNJChar(12)滞纳金【查询应答包】中的返回数据PrintInvoiceChar(1)申请打印发票0=不打印发票1=申请打印发票缴费应答字段名数据类型字段含义备注RE_CODEChar(2)返回信息码00：成功11：失败（交易异常）12：交易关闭13：正在对帐、拒绝其它交易14：交易流水号重复21：户号非法22：水费记录号非法23：帐单余额不足24：帐单已付25：帐单已冻结TRAN_CODEChar(2)交易码OPER_IDChar(8)操作员名称FLOW_NOChar(8)流水号USER_NOChar(16)客户编号PAYJEChar(12)实收金额银行方实际收取的金额FEEIDChar(9)水费记录号在收费请求时要带入的重要字段InvoicePrintedChar(1)是否已打印过发票0=未打印1=已打印过(银行应在凭证上打印”补”)USER_NAMEChar(64)户名USER_ADDRChar(64)地址MONChar(6)水费年月YyyymmCCChar(2)抄次0099CBRQChar(8)抄表日期YyyymmddCBZTChar(16)抄表状态SCCMChar(9)上次抄码BCCMChar(9)本次抄码SCYEChar(5)上期结余上期帐单的零头结余金额ZDJEChar(12)帐单金额00000.00BCyeChar(5)本期余额本期帐单的零头结余金额ZNJChar(12)违约金PriceCountChar(2)用水性质组成数混合用水，是数据包中以下X_字段重复次数，单一价格为 1 X_YsxzChar(32)用水性质X_YSBLChar(4)用水比率0.00X_fee0_level1_SLChar(9)用水费：基本阶梯水量X_fee0_level1_JEChar(12)用水费：基本阶梯水量金额X_fee0_level1_DJChar(6)用水费：基本阶梯的单价X_fee0_level2_SLChar(9)用水费：二级阶梯水量X_fee0_level2_JEChar(12)用水费：二级阶梯金额X_fee0_level2_DJChar(6)用水费：二级阶梯的单价X_fee0_level3_SLChar(9)用水费：三级阶梯水量X_fee0_level3_JEChar(12)用水费：三级阶梯金额X_fee0_level3_DJChar(6)用水费：三级阶梯的单价X_fee1_level1_SLChar(9)污水处理费：基本阶梯水量X_fee1_level1_JEChar(12)污水处理费：基本阶梯水量金额X_fee1_level1_DJChar(6)污水处理费：基本阶梯的单价X_fee1_level2_SLChar(9)污水处理费：二级阶梯水量X_fee1_level2_JEChar(12)污水处理费：二级阶梯金额X_fee1_level2_DJChar(6)污水处理费：二级阶梯的单价X_fee1_level3_SLChar(9)污水处理费：三级阶梯水量X_fee1_level3_JEChar(12)污水处理费：三级阶梯金额X_fee1_level3_DJChar(6)污水处理费：三级阶梯的单价X_fee2_level1_SLChar(9)城市附加费：基本阶梯水量X_fee2_level1_JEChar(12)城市附加费：基本阶梯水量金额X_fee2_level1_DJChar(6)城市附加费：基本阶梯的单价X_fee2_level2_SLChar(9)城市附加费：二级阶梯水量X_fee2_level2_JEChar(12)城市附加费：二级阶梯金额X_fee2_level2_DJChar(6)城市附加费：二级阶梯的单价X_fee2_level3_SLChar(9)城市附加费：三级阶梯水量X_fee2_level3_JEChar(12)城市附加费：三级阶梯金额X_fee2_level3_DJChar(6)城市附加费：三级阶梯的单价X_fee3_level1_SLChar(9)水资源费：基本阶梯水量X_fee3_level1_JEChar(12)水资源费：基本阶梯水量金额X_fee3_level1_DJChar(6)水资源费：基本阶梯的单价X_fee3_level2_SLChar(9)水资源费：二级阶梯水量X_fee3_level2_JEChar(12)水资源费：二级阶梯金额X_fee3_level2_DJChar(6)水资源费：二级阶梯的单价X_fee3_level3_SLChar(9)水资源费：三级阶梯水量X_fee3_level3_JEChar(12)水资源费：三级阶梯金额X_fee3_level3_DJChar(6)水资源费：三级阶梯的单价X_fee4_level1_SLChar(9)价调费：基本阶梯水量X_fee4_level1_JEChar(12)价调费：基本阶梯水量金额X_fee4_level1_DJChar(6)价调费：基本阶梯的单价X_fee4_level2_SLChar(9)价调费：二级阶梯水量X_fee4_level2_JEChar(12)价调费：二级阶梯金额X_fee4_level2_DJChar(6)价调费：二级阶梯的单价X_fee4_level3_SLChar(9)价调费：三级阶梯水量X_fee4_level3_JEChar(12)价调费：三级阶梯金额X_fee4_level3_DJChar(6)价调费：三级阶梯的单价备注Char(64)预付款充值请求字段名数据类型字段含义备注TRAN_CODEChar(2)交易码21OPER_IDChar(8)操作员名称FLOW_NOChar(8)流水号TRAN_DATEChar(8)交易日期YYYYMMDDUSER_NOChar(16)客户编号PAYJEChar(12)实收金额银行方实际收取的金额PaySourceChar(1)实际付款方式0=现金2=银行转帐PrintInvoiceChar(1)申请打印收据预付款充值收据0=不打印收据1=申请打印收据预付款充值应答字段名数据类型字段含义备注RE_CODEChar(2)返回信息码00：成功11：失败（交易异常）12：交易关闭13：正在对帐、拒绝其它交易14：交易流水号重复21：户号非法22：充值失败（未开通预付业务）TRAN_CODEChar(2)交易码21OPER_IDChar(8)操作员名称FLOW_NOChar(8)流水号USER_NOChar(16)客户编号FeeidChar(9)水司建立的充值交易流水号O_A_BChar(12)充值前的预付款款余额PAYJEChar(12)实收金额银行方实际收取的金额A_BChar(12)充值后的预收款余额USER_NAMEChar(64)户名USER_ADDRChar(64)地址交易冲正请求字段名数据类型字段含义备注TRAN_CODEChar(2)交易码30OPER_IDChar(8)操作员名称FLOW_NOChar(8)流水号TRAN_DATEChar(8)交易日期YYYYMMDDTRAN_TYPEChar(1)交易类型=缴费=预付款充值FeeidChar(9)要冲正的水费编号/水司建立的预付费交易流水号PAYJEChar(12)冲正金额银行方要冲正的金额交易冲正应答字段名数据类型字段含义备注RE_CODEChar(2)返回信息码00：成功11：失败（交易异常）12：交易关闭13：正在对帐、拒绝其它交易14：交易流水号重复21：冲正交易流水号无效22：已被冲正（重复）23：冲正金额不符TRAN_CODEChar(2)交易码OPER_IDChar(8)操作员名称TRAN_TYPEChar(1)交易类型=缴费=预付款充值FeeidChar(9)要冲正的水费编号/预付费交易流水号PAYJEChar(12)冲正金额银行方要冲正的金额FLOW_NOChar(8)流水号交易记录查询请求字段名数据类型字段含义备注TRAN_CODEChar(2)交易码15OPER_IDChar(8)操作员名称FLOW_NOChar(8)流水号USER_NOChar(16)客户编号PAY_DATEChar(8)交易开始日期YYYYMMDDPAY_DATEChar(8)交易结束日期YYYYMMDD交易查询应答字段名数据类型字段含义备注RE_CODEChar(2)返回信息码00：成功11：失败（交易异常）12：交易关闭13：正在对帐、拒绝其它交易21：客户编号非法22：无信息23：交易日期非法TRAN_CODEChar(2)交易码OPER_IDChar(8)操作员名称FLOW_NOChar(8)流水号USER_NOChar(16)客户编号ROWCOUNTChar(4)交易明细笔数是数据包中以下所有字段重复次数TRAN_DATEChar(8)交易日期YYYYMMDDBANK_FLOW_NOChar(8)交易报文中的银行FLOW_NOTRAN_TYPEChar(1)交易类型=缴费=预付款充值FEEIDChar(9)水费记录号/预付费交易流水号PAYJEChar(12)交易金额TRAN_TYPE =3：预付款充值金额TRAN_TYPE =0：帐单金额违约金InvoicePrintedChar(1)是否已打印过发票（收据）否已打印打印发票请求字段名数据类型字段含义备注TRAN_CODEChar(2)交易码16OPER_IDChar(8)操作员名称FLOW_NOChar(8)流水号TRAN_DATEChar(8)交易日期YYYYMMDDTRAN_TYPEChar(1)交易类型=缴费=预付款充值FEEIDChar(9)水费记录号/预付费交易流水号打印发票应答字段名数据类型字段含义备注RE_CODEChar(2)返回信息码00：成功11：失败（交易异常）12：交易关闭13：正在对帐、拒绝其它交易21：FEEID无效TRAN_CODEChar(2)交易码OPER_IDChar(8)操作员名称FLOW_NOChar(8)流水号PAY_DATEChar(8)交易日期YYYYMMDDTRAN_TYPEChar(1)交易类型=缴费=预付款充值FEEIDChar(9)水费记录号/预付费交易流水号InvoicePrintedChar(1)是否已打印过发票（收据）0=未打印1=已打印过(银行应在凭证上打印”补”)USER_NOChar(16)客户编号USER_NAMEChar(64)户名USER_ADDRChar(64)地址MON缴费业务返回“绿色部分”，预付款充值业务返回红色部分Char(6)水费年月YYYYMMCCChar(2)抄次0099CBRQChar(8)抄表日期YyyymmddCBZTChar(16)抄表状态SCCMChar(9)上次抄码BCCMChar(9)本次抄码SCYEChar(5)上期结余上期帐单的零头结余金额ZDJEChar(12)帐单金额00000.00BCyeChar(5)本月余额本期帐单的零头结余金额ZNJChar(12)违约金应收金额=抄表金额+滞纳金PriceCountChar(2)用水性质组成数混合用水，是数据包中以下X_字段重复次数，单一价格为 1 X_YsxzChar(32)用水性质X_YSBLChar(4)用水比率单一价格，为100 X_fee0_level1_SLChar(9)用水费：基本阶梯水量X_fee0_level1_JEChar(12)用水费：基本阶梯水量金额X_fee0_level1_DJChar(6)用水费：基本阶梯的单价X_fee0_level2_SLChar(9)用水费：二级阶梯水量X_fee0_level2_JEChar(12)用水费：二级阶梯金额X_fee0_level2_DJChar(6)用水费：二级阶梯的单价X_fee0_level3_SLChar(9)用水费：三级阶梯水量X_fee0_level3_JEChar(12)用水费：三级阶梯金额X_fee0_level3_DJChar(6)用水费：三级阶梯的单价X_fee1_level1_SLChar(9)污水处理费：基本阶梯水量X_fee1_level1_JEChar(12)污水处理费：基本阶梯水量金额X_fee1_level1_DJChar(6)污水处理费：基本阶梯的单价X_fee1_level2_SLChar(9)污水处理费：二级阶梯水量X_fee1_level2_JEChar(12)污水处理费：二级阶梯金额X_fee1_level2_DJChar(6)污水处理费：二级阶梯的单价X_fee1_level3_SLChar(9)污水处理费：三级阶梯水量X_fee1_level3_JEChar(12)污水处理费：三级阶梯金额X_fee1_level3_DJChar(6)污水处理费：三级阶梯的单价X_fee2_level1_SLChar(9)城市附加费：基本阶梯水量X_fee2_level1_JEChar(12)城市附加费：基本阶梯水量金额X_fee2_level1_DJChar(6)城市附加费：基本阶梯的单价X_fee2_level2_SLChar(9)城市附加费：二级阶梯水量X_fee2_level2_JEChar(12)城市附加费：二级阶梯金额X_fee2_level2_DJChar(6)城市附加费：二级阶梯的单价X_fee2_level3_SLChar(9)城市附加费：三级阶梯水量X_fee2_level3_JEChar(12)城市附加费：三级阶梯金额X_fee2_level3_DJChar(6)城市附加费：三级阶梯的单价X_fee3_level1_SLChar(9)水资源费：基本阶梯水量X_fee3_level1_JEChar(12)水资源费：基本阶梯水量金额X_fee3_level1_DJChar(6)水资源费：基本阶梯的单价X_fee3_level2_SLChar(9)水资源费：二级阶梯水量X_fee3_level2_JEChar(12)水资源费：二级阶梯金额X_fee3_level2_DJChar(6)水资源费：二级阶梯的单价X_fee3_level3_SLChar(9)水资源费：三级阶梯水量X_fee3_level3_JEChar(12)水资源费：三级阶梯金额X_fee3_level3_DJChar(6)水资源费：三级阶梯的单价X_fee4_level1_SLChar(9)价调费：基本阶梯水量X_fee4_level1_JEChar(12)价调费：基本阶梯水量金额X_fee4_level1_DJChar(6)价调费：基本阶梯的单价X_fee4_level2_SLChar(9)价调费：二级阶梯水量X_fee4_level2_JEChar(12)价调费：二级阶梯金额X_fee4_level2_DJChar(6)价调费：二级阶梯的单价X_fee4_level3_SLChar(9)价调费：三级阶梯水量X_fee4_level3_JEChar(12)价调费：三级阶梯金额X_fee4_level3_DJChar(6)价调费：三级阶梯的单价O_A_BChar(12)充值前的预付款款余额SSJEChar(12)实收金额银行方实际收取的金额A_BChar(12)充值后的预收款余额对帐请求字段名数据类型字段含义备注TRAN_CODEChar(2)交易码40OPER_IDChar(8)操作员名称FLOW_NOChar(8)流水号TRAN_DATEChar(8)收费日期 YYYYMMDD和对帐文本的文件名一致F_TOTALChar(12)实收总金额F_NUMChar(12)交易总笔数银行记录的有效缴费记录FileNameChar(64)对帐文本文件名注：银行先利用FTP协议将对帐文本文件发送到水司前置机FTP服务器上指定位置，发送成功后，发送该对帐请求，包含对帐文本文件的相关信息。对帐规则： 1. 一个对帐文本中的数据必须是同一天的收费数据；2. 同一天的收费数据必须存放在同一个文本中，进行一次对帐；文件名命名规则：YYYYMMDD.XXX YYYYMMDD：收费日期XXX：银行代号，位数是银行代号的实际位数(此代号由水司在系统上线前分配)如：20020628.001文件格式：注：文本文件交易明细均按以下字段顺序组织，字段间用空格分隔，行之间用换行符分隔)字段名数据类型字段含义备注OPER_IDChar(8)操