铁通银行代收代办系统V315接口规范

1、.铁通话费银行代收系统接口规范阐明书：.；第 PAGE 21 页 共 NUMPAGES 21 页铁通话费银行代收系统接口规范阐明书编写单位：华泰贝通计费事业部定稿时间：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高佩忠2

2、003-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取消“缴费恳求、“缴费确认两种买卖目 录 TOC o 1-3 h z HYPERLINK l _Toc98821034 1接口规范阐明 PAGEREF _Toc98821034 h 5 HYPERLINK l _Toc98821035 1.1参数定义 PAGEREF _Toc98821035

3、h 5 HYPERLINK l _Toc98821036 1.2关于对帐 PAGEREF _Toc98821036 h 6 HYPERLINK l _Toc98821037 1.3实现方式 PAGEREF _Toc98821037 h 6 HYPERLINK l _Toc98821038 1.4关于银行柜台缴费 PAGEREF _Toc98821038 h 6 HYPERLINK l _Toc98821039 1.5关于其它缴费方式 PAGEREF _Toc98821039 h 6 HYPERLINK l _Toc98821040 1.6呼应码定义 PAGEREF _Toc98821040 h

4、 6 HYPERLINK l _Toc98821041 1.7关于平安问题 PAGEREF _Toc98821041 h 6 HYPERLINK l _Toc98821042 1.8通讯方式 PAGEREF _Toc98821042 h 7 HYPERLINK l _Toc98821043 2铁通话费银行现金代缴规范 PAGEREF _Toc98821043 h 8 HYPERLINK l _Toc98821044 2.1通讯报文格式 PAGEREF _Toc98821044 h 8 HYPERLINK l _Toc98821045 2.1.1话费查询银行铁通 PAGEREF _Toc9882

5、1045 h 8 HYPERLINK l _Toc98821046 2.1.2话费交纳银行铁通 PAGEREF _Toc98821046 h 9 HYPERLINK l _Toc98821047 2.1.3发票打印银行铁通 PAGEREF _Toc98821047 h 11 HYPERLINK l _Toc98821048 2.1.4发票补打银行铁通 PAGEREF _Toc98821048 h 12 HYPERLINK l _Toc98821049 2.1.5用户退费银行铁通 PAGEREF _Toc98821049 h 14 HYPERLINK l _Toc98821050 2.1.6缴费

6、冲正银行铁通 PAGEREF _Toc98821050 h 14 HYPERLINK l _Toc98821051 2.1.7退费冲正银行铁通 PAGEREF _Toc98821051 h 15 HYPERLINK l _Toc98821052 2.1.8总额对帐银行铁通 PAGEREF _Toc98821052 h 16 HYPERLINK l _Toc98821053 2.1.9明细对帐银行铁通 PAGEREF _Toc98821053 h 17 HYPERLINK l _Toc98821054 2.2买卖前往码定义铁通银行、银行铁通 PAGEREF _Toc98821054 h 18 H

7、YPERLINK l _Toc98821055 3银行-铁通FTP文件传输规范 PAGEREF _Toc98821055 h 19 HYPERLINK l _Toc98821056 3.1登录用户及密码 PAGEREF _Toc98821056 h 19 HYPERLINK l _Toc98821057 3.1.1用户名 PAGEREF _Toc98821057 h 19 HYPERLINK l _Toc98821058 3.1.2密码 PAGEREF _Toc98821058 h 19 HYPERLINK l _Toc98821059 3.2途径阐明 PAGEREF _Toc98821059

8、 h 20 HYPERLINK l _Toc98821060 3.2.1银行上传明细对帐文件途径 PAGEREF _Toc98821060 h 20 HYPERLINK l _Toc98821061 3.3其它阐明 PAGEREF _Toc98821061 h 20 HYPERLINK l _Toc98821062 3.3.1FTP用户阅读权限 PAGEREF _Toc98821062 h 20 HYPERLINK l _Toc98821063 3.3.2关于上传、下载途径 PAGEREF _Toc98821063 h 20 HYPERLINK l _Toc98821064 4备注 PAGER

9、EF _Toc98821064 h 21接口规范阐明参数定义代理金融机构代码：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、 10大连 11鞍山 12抚顺 13本溪 14丹东 15锦州 16营口 17阜新 18辽阳 19朝阳 21盘锦 27葫芦岛 29通辽 75赤峰 76电信运营商代码：铁通0110。运用种类定义：代缴话费：0101/0001；代扣话费：0102；代办业务：0103，如需添加业务种类，双方协商决议。关于对帐对帐规范：经过银行代收代缴发生的帐务，以银行端买卖记录为准。异常处置：经核对，双方不一致的买卖，进展人工干涉处置。对帐时间：由银行系统发起对帐买卖恳求，时间可以思索在每天营业终了后进展，详细时间由双方协商确定。实现方式目前不仅思索实时联网的现金或支票缴费方式，也包括批量代扣方式等缴费方式。关于银行

11、柜台缴费目前允许的缴费方式：可支持用户现金缴费，同时系统也要支持个人或单位的支票缴费方式，以方便用户，详细的支票缴费流程需求由银行完成。业务流程：向铁通计费系统查询话费用户身份核对用户缴费打印发票终了。关于其它缴费方式银行缴费、网上银行支付、银行查询终端缴费等买卖处置方式可参照银行柜台买卖的方式进展处置，计费系统只担任按照一致的格式传送买卖包恳求回复资料，详细的处置流程由银行完成。呼应码定义采用自定义呼应码，见后。 关于平安问题买卖传输过程中涉及的资料加密问题，由银行方提供相应规范及接口函数。通讯方式双方前置机通讯采用TCP/IP socket编程方式，衔接方式为短衔接，即每有买卖时由客户端银

12、行端发起通讯恳求，建立TCP/IP衔接，买卖终了后双方断开衔接。铁通话费银行现金代缴规范通讯报文格式话费查询银行铁通恳求呼应属性备注MMChar(4)包长度，传送ASC码字符长度缺乏左补零01000110MMChar(4)单位编号铁通4位、0110MChar(10)银行应收金额取整后，以分为单位，长度缺乏左补零；MChar(10)用户实践费用金额，以分为单位，长度缺乏左补零 MMChar(14)买卖流水号呼应时的买卖流水号与恳求一样MChar(14)买卖时间YYYYMMDDHHMMSSMMChar(4)运用种类代缴话费：0101MMChar(30)银行柜台代码呼应时与恳求时代码一致MMChar

13、(3)银行代码MChar(14)应对流水号YYYYMMDDnnnnnnMChar(2)买卖前往码MChar(40)阐明信息MMChar(7)区号MMChar(16)号码MChar(30)用户称号MChar(20)营业合同号企业用户在营业合同号末位加#号MChar(8)费用起始时间YYYYMMDDMChar(8)费用终止时间YYYYMMDDMChar(2)话费明细个数长度缺乏左补零MLLVAR话费明细，不定长字符。先是费用项称号20个字符，后跟10位以分为单位的费用，费用称号缺乏20位右补空格，费用缺乏10位左补0。注：本报文用于银行方查询用户费用情况。“M的意义为：该域在恳求或应对买卖包中必需

14、存在；无“M标志的域在买卖包中可做填充，也可不填充；假设在买卖包中填充，那么必需以空格填充，但最好不填充。此规那么适用于一切买卖包。“买卖前往码：参见“买卖前往码定义。此规那么适用于一切买卖包。“阐明信息域是对“买卖前往码的辅助阐明。“话费明细域第一项为上期余额，其它为话费明细，没有合计项；话费明细有些工程有能够为负值。例如：上期余额*0000000000月租费用*0000005000长话费用*0000050000市话费用*0000080000时段优惠*-000002000 ，*表示空格。买卖包各域的填充规那么：用于数值运算的域，长度缺乏左补零，假设为负值，负号在首位；其它域右补空格。此规那么

15、适用于一切买卖包。买卖包总长度包括“包长度域的四个字节。此规那么适用于一切买卖包。关于“银行应收金额和“用户实践费用金额银行应收金额 = 取整用户实践费用金额 上期余额；取整规那么由双方协议；假设用户实践费用金额小于上期余额，银行应收金额不进展取整，为准确到分的一个负值；用户实践费用金额 = 话费明细中除去上期余额项之外的一切项之和。话费交纳银行铁通恳求呼应属性备注MMChar(4)包长度，传送ASC码字符。02000210MMChar(4)单位编号铁通4位、0110MChar(10)实交金额，以分为单位长度缺乏左补零MMChar(10)用户实践费用金额，以分为单位长度缺乏左补零MMChar(

16、14)买卖流水号呼应时的买卖流水号与恳求一样MChar(14)买卖时间YYYYMMDDHHMMSSMMChar(4)运用种类代缴话费：0101 / 0001MMChar(30)银行柜台代码MMChar(3)银行代码MChar(14)应对流水号YYYYMMDDnnnnnnMChar(2)买卖前往码MChar(40)阐明信息MMChar(7)区号MMChar(16)号码 注：该报文用于银行代缴话费。用户缴费前必需做话费查询买卖。“实交金额即银行实践收取的金额“用户实践费用金额域必需与话费查询买卖中前往的“用户实践费用金额完全一致，否那么缴费会失败。发票信息可以从话费查询买卖中获取，也可以经过发票打

17、印买卖获取。假设从话费查询买卖中获取，无法分帐期打印发票，同时在缴费恳求包中应将运用种类置为0101，银行方应将“实交金额“用户实践费用金额 “上期余额打印在用户发票的“本期余额工程中该工程不包含在查询应对包的名细工程中，要由银行端程序产生。经过此方式打印发票后，铁通将该张发票置为已打印，银行不能再经过发票打印或发票补打买卖打印该张发票。假设银行不利用话费查询买卖信息打印发票，在缴费恳求包中应将运用种类置为0001，铁通将该次缴费的发票置为未打印，银行能经过发票打印或发票补打买卖打印该次缴费的发票。发票打印银行铁通恳求呼应属性备注MMChar(4)包长度，传送ASC码字符。17001710MM

18、Char(4)单位编号铁通4位、0110MMChar(14)买卖流水号呼应时的买卖流水号与恳求一样MMChar(14)买卖时间YYYYMMDDHHMMSSMMChar(30)银行柜台代码MMChar(3)银行代码MMChar(14)对应的话费交纳买卖流水号MMChar(7)区号MMChar(16)号码 MChar(1)上张发票打印结果0：打印胜利，1：打印失败，2： 恳求第一张发票MChar(1)发票恳求标志。0：继续恳求上张发票上张发票打印失败，1：恳求下一张发票，2：停顿恳求不想继续恳求或发票曾经恳求完。假设恳求第一张发票该字段置1。MChar(2)剩余未打印发票张数包括当前张MChar(

19、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。注：该报文用于用户交纳话费之后，分帐期打印发票。该买卖

20、只前往本次缴费的发票信息，假设该次缴费跨几帐期，发票将会有多张，每次只前往某一帐期的发票信息，该次缴费由“对应的话费交纳买卖流水号域独一决议。假设银行恳求的为第一张发票，应将“上张发票打印结果域置为2表示恳求第一张发票，其它情况按照上张发票的实践打印结果置该域为相应的值。假设银行恳求的为第一张发票，将“发票恳求标志域置为1。银行在打印发票过程中，可以选择继续恳求上一张发票在上一张发票打印失败的情况下，或者恳求下一张未打印发票，或者停顿恳求；假设银行停顿恳求，铁通将不前往信息给银行。正常情况下，假设有n张发票需求打印，银行需求发n+1次恳求，其中最后一次恳求为第n张发票的打印确认信息。银行在恳求

21、每一张发票时，都需求重新衔接，即通讯采用短衔接方式。发票补打银行铁通恳求呼应属性备注MMChar(4)包长度，传送ASC码字符。18001810MMChar(4)单位编号铁通4位、0110MMChar(14)买卖流水号呼应时的买卖流水号与恳求一样MMChar(14)买卖时间YYYYMMDDHHMMSSMMChar(30)银行柜台代码MMChar(3)银行代码MMChar(7)区号MMChar(16)号码 MChar(1)上张发票打印结果0：打印胜利，1：打印失败，2： 恳求第一张发票MChar(1)发票恳求标志。0：继续恳求上张发票上张发票打印失败，1：恳求下一张发票，2：停顿恳求不想继续恳求

22、或发票曾经恳求完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。注：该报

23、文用于用户一切未打印发票的打印例如：银行缴费、网上银行缴费等。每次只前往一张发票的信息，假设有多张发票，需求发多次恳求。假设银行恳求的为第一张发票，应将“上张发票打印结果域置为2表示恳求第一张发票，其它情况按照上张发票的实践打印结果置该域为相应的值。假设银行恳求的为第一张发票，将“发票恳求标志域置为1。银行在打印发票过程中，可以选择继续恳求上一张发票在上一张发票打印失败的情况下，或者恳求下一张未打印发票，或者停顿恳求，假设银行停顿恳求，铁通将不前往信息给银行。正常情况下，假设有n张发票需求打印，银行需求发n+1次恳求，其中最后一次恳求为第n张发票的打印确认信息。银行在恳求每一张发票时，都需求重

24、新衔接，即通讯采用短衔接方式。用户退费银行铁通恳求呼应属性备注MMChar(4)包长度，传送ASC码字符。03000310MMChar(4)单位编码铁通4位、0110MMChar(10)退费金额MMChar(14)买卖流水号恳求时与呼应时一样MChar(14)买卖时间YYYYMMDDHHMMSSMChar(4)运用种类代缴话费：0101MMChar(30)银行柜台代码MMChar(3)银行代码MMChar(14)银行原缴费买卖流水号/应对流水号MChar(2)前往码MChar(40)阐明信息MMChar(7)区号MMChar(16)号码 注：该买卖主要是用于对某笔胜利的缴费买卖进展退费处置。该

25、买卖只能做当日缴费买卖的退费。缴费冲正银行铁通恳求呼应属性备注MMChar(4)包长度，传送ASC码字符。04000410MMChar(4)单位编号铁通4位、0110MMChar(10)冲正金额长度缺乏左补零MMChar(14)买卖流水号呼应流水号与恳求流水号一致MChar(14)买卖时间YYYYMMDDHHMMSSMChar(4)运用种类代缴话费：0101MMChar(30)银行柜台代码MMChar(3)银行代码MMChar(14)银行原缴费买卖流水号MChar(2)前往码MChar(40)阐明信息MMChar(7)区号MMChar(16)号码 注：主要用于由于网络或其它缘由引起的银行发出的

26、缴费恳求没有收到呼应的处置，也可用于因操作员误操作所引起错误的处置。该买卖只能做当日缴费买卖的冲正。退费冲正银行铁通恳求呼应属性备注MMChar(4)包长度，传送ASC码字符。13001310MMChar(4)单位编号铁通4位、0110MMChar(10)冲正金额长度缺乏左补零MMChar(14)买卖流水号呼应流水号与恳求流水号一致MChar(14)买卖时间YYYYMMDDHHMMSSMChar(4)运用种类代缴话费：0101MMChar(30)银行柜台代码MMChar(3)银行代码MMChar(14)银行原退费买卖流水号MChar(2)前往码MChar(40)阐明信息MMChar(7)区号M

27、MChar(16)号码 注：该买卖主要用于由于网络或其它缘由引起的银行发出的退费恳求没有收到呼应的处置，也可用于因操作员误操作所引起错误的处置。该买卖只能做当日退费买卖的冲正。总额对帐银行铁通恳求呼应属性备注MMChar(4)包长度，传送ASC码字符。05000510MMChar(4)单位编号(铁通)MMChar(14)买卖流水号恳求与呼应一致MChar(14)买卖时间YYYYMMDDHHMMSSMChar(4)运用种类代缴话费：0101MMChar(3)银行代码MChar(2)前往码MChar(40)阐明信息MMChar(6)代收总笔数长度缺乏左补零MMChar(14)代收总金额长度缺乏左补

28、零MMChar(14)对帐起始时间YYYYMMDDHHMMSSMMChar(14)对帐终止时间YYYYMMDDHHMMSS注：“代收总笔数： 恳求包为银行在对帐时间内发生的一切胜利的缴费与退费买卖的总笔数，不包括已冲正的记录数；呼应包为铁通在对帐时间内发生的一切胜利的缴费与退费买卖的总笔数，不包括已冲正的记录数。“代收总金额： 恳求包为银行在对帐时间内发生的一切胜利的缴费与退费买卖的总金额，不包括已冲正的记录；呼应包为铁通在对帐时间内发生的一切胜利的缴费与退费买卖的总金额，不包括已冲正的记录。对于对帐业务，由银行发出对帐恳求，详细处置情况可参照前面所述。不论总额对帐能否正确，都要进展明细对帐。

29、明细对帐银行铁通恳求呼应属性备注MMChar(4)包长度，传送ASC码字符。06000610MChar(14)买卖时间YYYYMMDDHHMMSSMChar(4)运用种类代缴话费：0101MMChar(3)银行代码MMChar(14)买卖流水号恳求与呼应一致MMChar(80)对帐明细文件名，缺乏位右补空格。MMChar(10)对帐明细文件长度长度缺乏左补零MMChar(14)对帐起始时间YYYYMMDDHHMMSSMMChar(14)对帐终止时间YYYYMMDDHHMMSSMChar(2)前往码MChar(40)阐明信息注：银行方先将文件传送到铁通前置机再发对帐恳求。对帐文件所对应的存放目录

30、，见。因以银行方帐务为准，故不向银行方传送对帐过失文件。对帐明细文件长度以文件系统给出的文件大小为准。王旭明细对帐文件格式文件取名为B+银行代码_CRC_LIST_YYYYMMDD.TXT类别属性备注区号Char(7)区号缺乏右补空号码Char(16)号码缺乏右补空买卖金额Char(10)买卖金额，以分为单位09，缺乏左补0银行买卖流水号Char(14)银行买卖时所产生的流水号铁通买卖流水号Char(14)铁通买卖时所产生的流水号注：明细对帐文件包括该银行对帐时间范围内一切胜利的缴费与退费买卖记录，不包括已冲正的记录。假设为退费买卖记录，金额为负值，负号位于最左边。买卖前往码定义铁通银行、银行铁通买卖前往码阐明00买卖胜利01此号码或帐户不存在02此号码或帐户无费用03此用户不可以在银行窗口交费04数据库中无此用户数10买卖码非法11访问数据库失败12