铁通银行代收代办系统V3[1]5接口规范.doc

铁通话费银行代收系统接口规范说明书编写单位：华泰贝通计费事业部定稿时间：2003年7月16日【版权声明】本文档版权归北京华泰贝通公司所有，任何人不得以任何方式将本文档传递给其他与本项目无关的个人或机构，我公司对违反此声明者保留依法追究法律责任的权利。版本历史版 本作者/修改者日 期备 注1.0高佩忠2002-4-25一稿1.1高佩忠2002-8-19修改了一些表达不准确的地方2.0何武军2002-10-24增加发票打印及发票补打交易2.1高佩忠2002-11-13加目录；备注移到文件尾3.0高佩忠2003-4-16将批扣和托收部分单独形成一个文档3.1高佩忠2003-4-16修改第8页关于交易包填充的说明3.2高佩忠2003-4-16将与批量代扣相关的FTP说明移至铁通话费银行批量代扣规范3.3武豪2003-5-28细化了关于时间的说明3.4高佩忠2003-7-16增加辽宁各地市金融机构代码定义3.5李洪涛2005-3-1取消“缴费申请”、“缴费确认”两种交易目 录1接口规范说明51.1参数定义51.2关于对帐61.3实现方式61.4关于银行柜台缴费61.5关于其它缴费模式61.6响应码定义61.7关于安全问题61.8通讯方式72铁通话费银行现金代缴规范82.1通信报文格式82.1.1话费查询（银行铁通）82.1.2话费缴纳（银行铁通）92.1.3发票打印（银行铁通）112.1.4发票补打（银行铁通）122.1.5用户退费（银行铁通）142.1.6缴费冲正（银行铁通）142.1.7退费冲正（银行铁通）152.1.8总额对帐（银行铁通）162.1.9明细对帐（银行铁通）172.2交易返回码定义（铁通银行、银行铁通）183银行-铁通FTP文件传输规范193.1登录用户及密码193.1.1用户名193.1.2密码193.2路径说明203.2.1银行上传明细对帐文件路径203.3其它说明203.3.1FTP用户浏览权限203.3.2关于上传、下载路径204备注211 接口规范说明1.1 参数定义1) 代理金融机构代码：3位，用于识别代金融机构110 建行、210 交行、310 农行、410 中行、510 工行、610 招行、710 邮储、810 城市商业银行、910 广发行、A10 福建兴业银行、B10 华夏银行、C10 中信实业银行、D10 光大银行、E10 农联社F10Z10其它银行依次定义。【辽宁金融机构代码定义】仍用三位表示：ABC “A”代表金融机构，其余两位“BC”代表地市；“A”的定义为：0银联、1 建行、2 交行、3 农行、4中行、5 工行、6 招行、7 邮储、8 城市商业银行、9 广发行；“BC”的定义为：沈阳 24铁岭 10大连 11鞍山 12抚顺 13本溪 14丹东 15锦州 16营口 17阜新 18辽阳 19朝阳 21盘锦 27葫芦岛 29通辽 75赤峰 762) 电信运营商代码：铁通0110。3) 应用种类定义：代缴话费：0101/0001；代扣话费：0102；代办业务：0103，如需增加业务种类，双方协商决定。1.2 关于对帐1) 对帐标准：通过银行代收代缴发生的帐务，以银行端交易记录为准。2) 异常处理：经核对，双方不一致的交易，进行人工干预处理。3) 对帐时间：由银行系统发起对帐交易请求，时间可以考虑在每天营业结束后进行，具体时间由双方协商确定。1.3 实现方式目前不仅考虑实时联网的现金或支票缴费方式，也包括批量代扣方式等缴费方式。1.4 关于银行柜台缴费1) 目前允许的缴费方式：可支持用户现金缴费，同时系统也要支持个人或单位的支票缴费方式，以方便用户，具体的支票缴费流程需要由银行完成。2) 业务流程：向铁通计费系统查询话费用户身份核对用户缴费打印发票完毕。1.5 关于其它缴费模式电话银行缴费、网上银行支付、银行查询终端缴费等交易处理模式可参照银行柜台交易的模式进行处理，计费系统只负责按照统一的格式传送交易包请求回复资料，具体的处理流程由银行完成。1.6 响应码定义采用自定义响应码，见后。 1.7 关于安全问题交易传输过程中涉及的资料加密问题，由银行方提供相应标准及接口函数。1.8 通讯方式双方前置机通讯采用TCP/IP socket编程方式，连接方式为短连接，即每有交易时由客户端（银行端）发起通讯请求，建立TCP/IP连接，交易结束后双方断开连接。2 铁通话费银行现金代缴规范2.1 通信报文格式2.1.1 话费查询（银行铁通）请求响应属性备注MMChar(4)包长度，传递ASC码字符（长度不足左补零）01000110MMChar(4)单位编号（铁通4位、0110）MChar(10)银行应收金额（取整后），以分为单位，（长度不足左补零）；MChar(10)用户实际费用金额，以分为单位，（长度不足左补零） MMChar(14)交易流水号（响应时的交易流水号与请求相同）MChar(14)交易时间（YYYYMMDDHHMMSS）MMChar(4)应用种类（代缴话费：0101）MMChar(30)银行柜台代码（响应时与请求时代码一致）MMChar(3)银行代码MChar(14)应答流水号（YYYYMMDDnnnnnn）MChar(2)交易返回码MChar(40)说明信息MMChar(7)区号MMChar(16)电话号码MChar(30)用户名称MChar(20)营业合同号（企业用户在营业合同号末位加#号）MChar(8)费用起始时间（YYYYMMDD）MChar(8)费用终止时间（YYYYMMDD）MChar(2)话费明细个数（长度不足左补零）MLLVAR话费明细，不定长字符。先是费用项名称20个字符，后跟10位以分为单位的费用，费用名称不足20位右补空格，费用不足10位左补0。注：1) 本报文用于银行方查询用户费用情况。2) “M”的意义为：该域在请求或应答交易包中必须存在；无“M”标志的域在交易包中可做填充，也可不填充；若在交易包中填充，则必须以空格填充，但最好不填充。此规则适用于所有交易包。3) “交易返回码”：参见“交易返回码定义”。此规则适用于所有交易包。4) “说明信息”域是对“交易返回码”的辅助说明。5) “话费明细”域第一项为上期余额，其它为话费明细，没有合计项；话费明细有些项目有可能为负值。例如：上期余额*0000000000月租费用*0000005000长话费用*0000050000市话费用*0000080000时段优惠*-000002000 ，*表示空格。6) 交易包各域的填充规则：用于数值运算的域，长度不足左补零，如果为负值，负号在首位；其它域右补空格。此规则适用于所有交易包。7) 交易包总长度包括“包长度”域的四个字节。此规则适用于所有交易包。8) 关于“银行应收金额”和“用户实际费用金额”银行应收金额 = 取整（用户实际费用金额 上期余额）；取整规则由双方协议；如果用户实际费用金额小于上期余额，银行应收金额不进行取整，为精确到分的一个负值；用户实际费用金额 = 话费明细中除去上期余额项之外的所有项之和。2.1.2 话费缴纳（银行铁通）请求响应属性备注MMChar(4)包长度，传递ASC码字符。02000210MMChar(4)单位编号（铁通4位、0110）MChar(10)实交金额，以分为单位（长度不足左补零）MMChar(10)用户实际费用金额，以分为单位（长度不足左补零）MMChar(14)交易流水号（响应时的交易流水号与请求相同）MChar(14)交易时间（YYYYMMDDHHMMSS）MMChar(4)应用种类（代缴话费：0101 / 0001）MMChar(30)银行柜台代码MMChar(3)银行代码MChar(14)应答流水号（YYYYMMDDnnnnnn）MChar(2)交易返回码MChar(40)说明信息MMChar(7)区号MMChar(16)电话号码 注：1) 该报文用于银行代缴话费。2) 用户缴费前必须做话费查询交易。3) “实交金额”即银行实际收取的金额4) “用户实际费用金额”域必须与话费查询交易中返回的“用户实际费用金额”完全一致，否则缴费会失败。5) 发票信息可以从话费查询交易中获取，也可以通过发票打印交易获取。6) 如果从话费查询交易中获取，无法分帐期打印发票，同时在缴费请求包中应将应用种类置为0101，银行方应将“实交金额”“用户实际费用金额” “上期余额”打印在用户发票的“本期余额”项目中（该项目不包含在查询应答包的名细项目中，要由银行端程序产生）。通过此方式打印发票后，铁通将该张发票置为已打印，银行不能再通过发票打印或发票补打交易打印该张发票。7) 如果银行不利用话费查询交易信息打印发票，在缴费请求包中应将应用种类置为0001，铁通将该次缴费的发票置为未打印，银行能通过发票打印或发票补打交易打印该次缴费的发票。2.1.3 发票打印（银行铁通）请求响应属性备注MMChar(4)包长度，传递ASC码字符。17001710MMChar(4)单位编号（铁通4位、0110）MMChar(14)交易流水号（响应时的交易流水号与请求相同）MMChar(14)交易时间（YYYYMMDDHHMMSS）MMChar(30)银行柜台代码MMChar(3)银行代码MMChar(14)对应的话费缴纳交易流水号MMChar(7)区号MMChar(16)电话号码 MChar(1)上张发票打印结果（0：打印成功，1：打印失败，2： 申请第一张发票）MChar(1)发票申请标志。0：继续申请上张发票（上张发票打印失败），1：申请下一张发票，2：停止申请（不想继续申请或发票已经申请完）。如果申请第一张发票该字段置1。MChar(2)剩余未打印发票张数（包括当前张）MChar(2)交易返回码MChar(40)说明信息MChar(8)发票起日期MChar(8)发票止日期MChar(30)用户名称MChar(20)营业合同号（企业用户在营业合同号末位加#号）MChar(10)上期余额（长度不足左补零）MChar(10)本次存入金额（长度不足左补零）MChar(10)支付话费（该帐期内用户实际费用金额，长度不足左补零）MChar(10)当前余额（长度不足左补零）MChar(2)话费明细个数（长度不足左补零）MLLVAR话费明细，不定长字符。先是费用项名称20个字符，后跟10位以分为单位的费用，费用名称不足20位右补空格，费用不足10位左补0。注：1) 该报文用于用户缴纳话费之后，分帐期打印发票。2) 该交易只返回本次缴费的发票信息，如果该次缴费跨几帐期，发票将会有多张，每次只返回某一帐期的发票信息，该次缴费由“对应的话费缴纳交易流水号”域唯一决定。3) 如果银行申请的为第一张发票，应将“上张发票打印结果”域置为2（表示申请第一张发票），其它情况按照上张发票的实际打印结果置该域为相应的值。4) 如果银行申请的为第一张发票，将“发票申请标志”域置为1。5) 银行在打印发票过程中，可以选择继续申请上一张发票（在上一张发票打印失败的情况下），或者申请下一张未打印发票，或者停止申请；如果银行停止申请，铁通将不返回信息给银行。6) 正常情况下，如果有n张发票需要打印，银行需要发n+1次请求，其中最后一次请求为第n张发票的打印确认信息。7) 银行在申请每一张发票时，都需要重新连接，即通讯采用短连接方式。2.1.4 发票补打（银行铁通）请求响应属性备注MMChar(4)包长度，传递ASC码字符。18001810MMChar(4)单位编号（铁通4位、0110）MMChar(14)交易流水号（响应时的交易流水号与请求相同）MMChar(14)交易时间（YYYYMMDDHHMMSS）MMChar(30)银行柜台代码MMChar(3)银行代码MMChar(7)区号MMChar(16)电话号码 MChar(1)上张发票打印结果（0：打印成功，1：打印失败，2： 申请第一张发票）MChar(1)发票申请标志。0：继续申请上张发票（上张发票打印失败），1：申请下一张发票，2：停止申请（不想继续申请或发票已经申请完）MChar(2)剩余未打印发票张数（包括当前张）MChar(2)交易返回码MChar(40)说明信息MChar(8)发票起日期MChar(8)发票止日期MChar(30)用户名称MChar(20)营业合同号（企业用户在营业合同号末位加#号）MChar(10)上期余额（长度不足左补零）MChar(10)本次存入金额（长度不足左补零）MChar(10)支付话费（长度不足左补零）MChar(10)当前余额（长度不足左补零）MChar(2)话费明细个数（长度不足左补零）MLLVAR话费明细，不定长字符。先是费用项名称20个字符，后跟10位以分为单位的费用，费用名称不足20位右补空格，费用不足10位左补0。注：1) 该报文用于用户所有未打印发票的打印（例如：电话银行缴费、网上银行缴费等）。2) 每次只返回一张发票的信息，如果有多张发票，需要发多次申请。3) 如果银行申请的为第一张发票，应将“上张发票打印结果”域置为2（表示申请第一张发票），其它情况按照上张发票的实际打印结果置该域为相应的值。4) 如果银行申请的为第一张发票，将“发票申请标志”域置为1。5) 银行在打印发票过程中，可以选择继续申请上一张发票（在上一张发票打印失败的情况下），或者申请下一张未打印发票，或者停止申请，如果银行停止申请，铁通将不返回信息给银行。6) 正常情况下，如果有n张发票需要打印，银行需要发n+1次请求，其中最后一次请求为第n张发票的打印确认信息。7) 银行在申请每一张发票时，都需要重新连接，即通讯采用短连接方式。2.1.5 用户退费（银行铁通）请求响应属性备注MMChar(4)包长度，传递ASC码字符。03000310MMChar(4)单位编码（铁通4位、0110）MMChar(10)退费金额MMChar(14)交易流水号（请求时与响应时相同）MChar(14)交易时间（YYYYMMDDHHMMSS）MChar(4)应用种类（代缴话费：0101）MMChar(30)银行柜台代码MMChar(3)银行代码MMChar(14)银行原缴费交易流水号/应答流水号MChar(2)返回码MChar(40)说明信息MMChar(7)区号MMChar(16)电话号码 注：1) 该交易主要是用于对某笔成功的缴费交易进行退费处理。2) 该交易只能做当日缴费交易的退费。2.1.6 缴费冲正（银行铁通）请求响应属性备注MMChar(4)包长度，传递ASC码字符。04000410MMChar(4)单位编号（铁通4位、0110）MMChar(10)冲正金额（长度不足左补零）MMChar(14)交易流水号（响应流水号与请求流水号一致）MChar(14)交易时间（YYYYMMDDHHMMSS）MChar(4)应用种类（代缴话费：0101）MMChar(30)银行柜台代码MMChar(3)银行代码MMChar(14)银行原缴费交易流水号MChar(2)返回码MChar(40)说明信息MMChar(7)区号MMChar(16)电话号码 注：1) 主要用于由于网络或其它原因引起的银行发出的缴费请求没有收到响应的处理，也可用于因操作员误操作所引起错误的处理。2) 该交易只能做当日缴费交易的冲正。2.1.7 退费冲正（银行铁通）请求响应属性备注MMChar(4)包长度，传递ASC码字符。13001310MMChar(4)单位编号（铁通4位、0110）MMChar(10)冲正金额（长度不足左补零）MMChar(14)交易流水号（响应流水号与请求流水号一致）MChar(14)交易时间（YYYYMMDDHHMMSS）MChar(4)应用种类（代缴话费：0101）MMChar(30)银行柜台代码MMChar(3)银行代码MMChar(14)银行原退费交易流水号MChar(2)返回码MChar(40)说明信息MMChar(7)区号MMChar(16)电话号码 注：1) 该交易主要用于由于网络或其它原因引起的银行发出的退费请求没有收到响应的处理，也可用于因操作员误操作所引起错误的处理。2) 该交易只能做当日退费交易的冲正。2.1.8 总额对帐（银行铁通）请求响应属性备注MMChar(4)包长度，传递ASC码字符。05000510MMChar(4)单位编号(铁通)MMChar(14)交易流水号（请求与响应一致）MChar(14)交易时间（YYYYMMDDHHMMSS）MChar(4)应用种类（代缴话费：0101）MMChar(3)银行代码MChar(2)返回码MChar(40)说明信息MMChar(6)代收总笔数（长度不足左补零）MMChar(14)代收总金额（长度不足左补零）MMChar(14)对帐起始时间（YYYYMMDDHHMMSS）MMChar(14)对帐终止时间（YYYYMMDDHHMMSS）注：1) “代收总笔数”： 请求包为银行在对帐时间内发生的所有成功的缴费与退费交易的总笔数，不包括已冲正的记录数；响应包为铁通在对帐时间内发生的所有成功的缴费与退费交易的总笔数，不包括已冲正的记录数。2) “代收总金额”： 请求包为银行在对帐时间内发生的所有成功的缴费与退费交易的总金额，不包括已冲正的记录；响应包为铁通在对帐时间内发生的所有成功的缴费与退费交易的总金额，不包括已冲正的记录。3) 对于对帐业务，由银行发出对帐请求，具体处理情况可参照前面所述。不论总额对帐是否正确，都要进行明细对帐。2.1.9 明细对帐（银行铁通）请求响应属性备注MMChar(4)包长度，传递ASC码字符。06000610MChar(14)交易时间（YYYYMMDDHHMMSS）MChar(4)应用种类（代缴话费：0101）MMChar(3)银行代码MMChar(14)交易流水号（请求与响应一致）MMChar(80)对帐明细文件名，不足位右补空格。MMChar(10)对帐明细文件长度（长度不足左补零）MMChar(14)对帐起始时间（YYYYMMDDHHMMSS）MMChar(14)对帐终止时间（YYYYMMDDHHMMSS）MChar(2)返回码MChar(40)说明信息注：1) 银行方先将文件传送到铁通前置机再发对帐请求。2) 对帐文件所对应的存放目录，见银行 - 铁通FTP文件传输规范。3) 因以银行方帐务为准，故不向银行方传递对帐差错文件。4) 对帐明细文件长度以文件系统给出的文件大小为准。（王旭）明细对帐文件格式（文件取名为B+银行代码_CRC_LIST_YYYYMMDD.TXT）类别属性备注区号Char(7)区号（不足右补空）电话号码Char(16)电话号码（不足右补空）交易金额Char(10)交易金额，以分为单位（09，不足左补0）银行交易流水号Char(14)银行交易时所产生的流水号铁通交易流水号Char(14)铁通交易时所产生的流水号注：1) 明细对帐文件包括该银行对帐时间范围内所有成功的缴费与退费交易记录，不包括已冲正的记录。2) 如果为退费交易记录，金额为负值，负号位于最左边。2.2 交易返回码定义（铁通银行、银行铁通）交易返回码说明00交易成功01此电话号码或帐户不存在02此电话号码或帐户无费用03此用户不可以在银行窗口交费04数据库中无此用户数10交易码非法11访问数据库失败12修改数据库失败13系统或网络故障14打开文件错20冲正日期非当天21已经冲正，不可再冲正22冲正和交款机构不一致23冲正系统错24此冲正记录不存在25已过退费时间26已经退费30对帐文件长度不符31对帐笔数不符32对帐总额不符33银行方无此笔交易记录34铁通方无此笔交易记录35双方交易记录内容不一致36电话号码错误或不存在37用户帐号错误38帐户金额不足39扣款成功40已经是代扣用户,不