中间业务联通新接口

1、综合营帐代收接口方案 3.5最后更新日期 2002-8-8山东版本说明：该版本是对以前的接口方案 3.X和补充说明汇总，本版本中的接口形式无新的变化，但补充，各代收机构需严格执行。补充规定：1、明确包头中 A9 位置的定义，必须严格按照下述描述指收方的形式。基本的代收形式一般有实时柜台交费、自助交费、协议批量代扣、网上交费、ATM 自助交费等形式，它们的代码分别为MAN、BAT、WEB、ATM，代收机构每增加新的代收形式，都需要事先以形式通知方；2、打印时，通过接口方返回给代收机构的项目，代收方必须严格按照返回内容、完全打印到上，包括的缴费流水号、第几/几张、时间、部门等；对在上定义的接口中不

2、需返回的代收方的项目，也要严格打印，包括代收网点、网点流水号、操作员、操作部门等。3、在以前版本的交费交易（交易码 010102）的请求包的最后有是否生成的标志，现改为忽略该值，不论其值为多少，都生成，但该标志的位置仍保留。4、部分代收机构通过本接口实现的批量或自助等业务，由于该种业务具有客户不需亲自到现场的特点，在开通该类业务时系统必须能实现客户对票据的需求。为了使业务处理清晰简洁，代收机构应取回发票内容入库保留，以便在以后查询打印或采取其它通知和送达方式。在保留内容时要注意到能处理中项目的灵活、不固定的特点。5、其它改动或补充在下一版本中。山东自 96 年开业以来，、邮政代系统在对用户服务

3、方面发挥了巨大的作用。但随着用户数量的增长、业务的发展，老的代系统已经无法适应业务需要。首先，在 97 年初代系统启用初期，山东只存在后用户，即用户打完并在月结出帐后才需要交费，但是为了方便用户，不论是否欠费和欠费多少，用户都可以随意交任意金额的作法是在一开始就坚持的一条原则，因而在那时，用户的票据由两种情况，欠费但未交足和足额交清。后来，随着业务的发展，增加了预业务，因而又增加了一种在用户不欠费情况下交费产生的预格式；鉴于内容和格式有所区别，在上增加了备注内容，相应地在接口上也扩充了备注列，用于标注“本月话费未结清(收据)”、“预交款(收据)”等。从增加该备注列后新开通的或作过系统升级的部分

4、老，都是按照这种接口执行的。随着山东一期期工程的进展，至今已经是五期、六期工程了，但接口方面一直未有进一步的变化。的下一步系统规划中，为了塑造“世界关注的中国综合电信运营商”的形象，对运营支撑系统的要求也越来越高。为了实现的 GSM、CDMA 移动业务互联网业务、长途业务、IP 业务等综合业务的“一张单据”等新要求，以及改变原有接口已存在的与现有业务也不能很好适应的缺陷，特在老接口的基础上，根据山东的情况，结合的实现方法，提出新的综合代收接口。新接口的目标是，首先从技术上保证接口更加稳定可靠；其次，要在的接口上完成综合业务的代功能， 实现“一台清”和“一单清”；再次，新的接口要在适应当前业务需

5、求的基础上，适当考虑将来业务的扩展。新接口的特点、与老接口的明显变化：1、实现综合业务。在老接口中，是用在同一个位置上机号和帐号指定用户的；在新接口中，参照中国总部 H2 接口规范，凡需要指定用户的场合，都包含以下三项内容：业务类型（代表 GSM、CDMA、165、193等各种业务）、号码类型（代表在同一种业务中后面的值是号码还是帐号等）、号码具体值（该值的具体内容）。在和交费方式的处理上，该接口对所有综合业务的处理也是的。2、在接口中着重考虑易用性和易理解性，适当增加说明文字的位置，让受理员清楚、让顾客明白。该处的信息还可用作在出现错误时，直接返回提示信息。3、丰富查询内容，在用户查询应交话

6、费时，适当将与交费相关的一些用户属性返回。如：性质（是预还是后），用户的当前欠费额及建议交费额等。在用户欠多月的情况下，除了返回欠费总额外，还返回每个月的欠费情况。4、欠费额及建议交费额的含义及计算方法。用户的欠费额是用户截至到当前的欠费金额（后用户不包括当月实时话费），若小于零，则表明用户不欠费，其绝对值代表用户的预付款余额。建议交费额的计算方法：若为预用户，在欠费额的基础上（不论正负）增加 50，若该值0,则向上取成 5 的倍数；若该值0,则向上取 5 的倍数；若该值0，则为 0。说明60可以增加说明性文字返回月数2表明本次返回几个月的数据10 x0A分割符序号2代表欠费的第几个月份，排序

7、后字段字段长度说明预留20为请求方提供的字段，服务应答时原样返回。帐期6格式：YYYYMM。若 atol(该值)=0,则含义为查询欠费情况；否则，含义为查询指定月份的费用情况。（注：指定月份查询的功能尚未完善）0 x1A包结束标志2. 缴费（交易代码 010102）(包头 A7 为 01，A6 为号码)请求包格式：字段字段长度说明预留20合同号20缴费金额12(允许为零，此时代表交零打票)缴费日期14格式：YYYYMMDDHHMISS。为请求方时间，作为对帐依据是否生成1（Ver3.5 后忽略该标志，即不论该值如何，都认为是生成）帐期6可能存在多个帐期是否交清11（是）；0（否）。是否打印过1

8、1（是）；0（否）。上期余额10本月合计10本月用户产生的费用本月已缴10在本次交费前用户已交的本月费用本月欠费10本月到当前的欠费到当前的滞纳金10本月欠费到当前产生的滞纳金本月总应交10本月到当前总应交备注20可增加注释10 x0A分割符序号2帐期6可能存在多个帐期.备注2010 x1A包结束标志应答包格式：3. 打（交易代码 010103）(包头 A7 为 01，A6 为号码)请求包格式：应答包格式：字段字段长度说明预留20缴费流水号20服务方交易流水号。说明60210 x0A分割符序号2日期10格式：YYYY.MM.DD 为服务方日期时间8格式：HH:MI:SS 为服务方时间字段字段长

9、度说明预留20缴费流水号20服务方交易流水号。(若打印失败，同一个流水号可再次申请)序号2代表要打印该流水的第几张(0 或非法值代表取该笔流水的所有)10 x1A包结束标志字段字段长度说明预留20缴费流水号20服务方交易流水号。说明6010 x1A包结束标志10 x1A包结束标志合同号20用户名称60代表号20用字符方式处理，原样打印类型20为字符，标明的类型帐期6为字符项目总数最大值 2410 x0D单元分割符费用项目名 120字符费用金额 110字符(为了打印方便，已填空对齐)费用项目名 220字符费用金额 210字符(为了打印方便，已填空对齐).10 x0D单元分割符上次余额10字符(为

10、了打印方便，已填空对齐)本次实交10字符(为了打印方便，已填空对齐)本次余额10字符(为了打印方便，已填空对齐)金额大写40字符金额小写10字符(为了打印方便，已填空对齐)部门20字符，在代打时可以不同于部门备注敬告、通知等备注敬告、通知等备注敬告、通知等x0A分割符序号2下一张.4.退款（交易代码 010104）、冲正（交易代码 010105）(包头 A7 为 01，A6 为号码) (如果是退款包头 A7 为 02，A6 为帐号)请求包格式：应答包格式：5.交费情况查询（交易代码 010106）(包头 A7 为 01，A6 为号码)通过接口能够查询指定用户的当天的交费和退款情况。请求包格式：

11、应答包格式：字段字段长度说明预留20字段字段长度说明预留20日期8格式：YYYYMMDD10 x1A包结束标志字段字段长度说明预留20说明6010 x1A包结束标志字段字段长度说明预留20缴费请求流水号20冲正时忽略此值缴费金额12退款日期14格式：YYYYMMDDHHMISS。为请求方时间，作为对帐依据10 x1A包结束标志备注 3800 x1A 包结束符6. 查询月费用（交易码 010107）(包头 A7 为 01，A6 为号码)根据指定用户和指定月份，查询用户的明细项目和金额。请求包格式：应答包格式：字段字段长度说明预留20帐务月份6格式：YYYYMM10 x1A包结束标志说明60业务笔

12、数210 x0A分割符序号2流水号20服务方交易流水号。交费部门20交费机构业务种类12交费或退款等发生金额10业务状态10是否有效发生时间14格式：YYYYMMDDHHMISS。为请求方时间，作为对帐依据2若未打印则为零备注2010 x0A分割符序号2下一笔.备注2010 x1A包结束标志7. 取服务方文件(交易代码 010108)取服务方文件，文件名必须登记在服务方的配置文件内，配置文件内可以登记文件名的匹配规则。请求包格式：(无包体)字段字段长度说明字段字段长度说明预留20合同号20代表号20用户名60说明60210 x0A分割符序号2项目总数最大值 24费用项目名 120字符费用金额

13、110字符(为了显示方便，已填空对齐)费用项目名 220字符费用金额 210字符(为了显示方便，已填空对齐).10 x0A分割符序号2下一张.10 x1A包结束标志应答包格式：8.对帐文件传输（交易代码 010109）（注：没有包结束符。对帐文件格式说明见后）送对帐文件（或其它文件），用于将代收方的文件传送到方。请求包格式：应答包格式：五 对帐文件规范：1.文件命名方式：LT+A8 营业点(最大 6 位，6 位取实际位数) 序号（2 位，00）日期（8 位）2.时间:约定一天对一次。每天晚上 24:00 之前；每月最后一天 19:00 前3.传送过程中若失败，sleep 若干秒后重试,重试 5

14、 次仍不成功则失败退出。4.文件格式字段行数说明字段字段长度说明文件名40文件大小10写到磁盘上的文件的尺寸10 x1A包结束标志字段字段长度说明文件名40文件内容4k整个包的总长度4K字段字段长度说明文件大小10磁盘文件尺寸文件内容4K整个包的总长度4K文件名4010 x1A包结束标志统计时 间段1 行YYYYMMDDHHMMSS:YYYYMMDDHHMMSS-YYYYMMDDHHMMSS统计数据生成时间:统计起始点-统计结束点总数1 行总金额|总笔数明细业 务N 行缴费请求包头流水号|缴费返回包体流水号|缴费请求合同号|缴费请求金额|预留文件尾1(在无后续文字时也要存在)区任意的文字六 几

15、个典型业务的数据包结构图：1、 查询请求包(简单格式)TE包 头包 体应答包ATTAE包 头用户信息月份帐务信息2、 缴费请求包：简单格式应答包：简单格式3、打印请求包TE应答包ATTTTADDE包头总情况头体尾4、 退款、冲正请求包：简单格式应答包：简单格式七打印规范：下面是空白的示意图在系统中打印票据时共有三种情况，分别是已出帐月的完整、已出帐月的交票据、尚未出帐月的预交款票据，情况分别如下：1、正常2、未交清中国山东发票联网点流水号：1234567890地税 No.交费流水号：123456789012第 1/2 张时间：2002.01.28 12:34:56操作员: JNCZY操作部门:

16、 JNYYT1网点:部门: JNYYT1敬 1.2.告 3.客户帐号1234567890客户名称码类型1出 帐 月2001.12项目金额项目金额项目金额月租费市话费长途费特服费漫游费其它费1.002.003.004.005.006.00 7.00 上次余额1.00本次实交15.00本次余额2.00合计金额大写壹拾肆元整合计金额14.00中国山东发票联网点流水号：地税 No.交费流水号：第 / 张时间：客户帐号客户名称码类型出 帐 月项目金额项目金额项目金额上次余额本次实交本次余额合计金额大写合计金额操作员:操作部门:网点:部门:敬 1.2.告 3.3、 预交款中国山东发票联网点流水号：1234

17、567890地税 No.交费流水号：123456789012第 1/1 张时间：2002.01.28 12:34:56操作员: ABCD操作部门: JNZSYH网点: 955551234部门: JNZSYH敬 1.2.告 3.客户帐号1234567890客户名称码类型2出 帐 月2002.01项目金额项目金额项目金额预交款本月实时话费预交款累计(收据) 16.0050.00上次余额20.00本次实交30.00本次余额34.00合计金额大写合计金额30.00中国山东发票联网点流水号：1234567890地税 No.交费流水号：123456789012第 1/1 张时间：2002.01.28 12

18、:34:56操作员: ABC操作部门: JNNH网点: 370001234部门: JNNH敬 1.2.告 3.客户帐号1234567890客户名称码类型2出 帐 月2001.10项目金额项目金额项目金额本月话费未结清本月话费合计本次交滞纳金(收据) 14.001.00上次余额-1.00本次实交10.00本次余额-6.00合计金额大写合计金额10.004、 说明：5、上面分三个区，从上往下分别为 H 区、D 区和 F 区；6、H 区和 F 区项目内容较固定；网点流水号、操作员、操作部门、网点等信息由代收方自己提供，接口中不再传输；包括部门在内的其余项目内容全部从接口中获得；7、D 区按照接口中的内容和顺序依次打印；8、原则上在接口中用来在上打印的数据都是用字符格式，代收方不必转化；若某些值为空，则打印空格或不必打印；八 附注：1. 应答结果代码约定如下：（详细代码另行定义，或以文件形式通过接口取得）服务类型返回码说明任何00000操作成功查询