营业收费系统socket接口报文标准

1、精选优质文档-倾情为你奉上精选优质文档-倾情为你奉上专心-专注-专业专心-专注-专业精选优质文档-倾情为你奉上专心-专注-专业 用户名称：XXXX燃气阜新新纪元计算机网络有限责任公司 密级：保密XXXX收费系统接口规范二一六年十月文档信息文档名称XXXXXX接口规范文件状态正式发布 编 写 人陈侃日 期2016-10-25校 对 人陈侃日 期2016年 10 月 23 日审 核 人李海山日 期2016年 10 月 25 日目 录 TOC o 1-4 h z u 任务概述目标利用现代化通讯技术，建立燃气收费系统与电信之间的信息传输通道；遵循行业规范，提供通用的中间业务平台；采用先进的数据库操作技

2、术实现信息安全可靠的存取；达到电信收取、查询燃气费的目的。为燃气运营商拓展营销活动空间、开发服务用户市场、加强行业竞争优势、挖掘新的经济增长点提供多种先进可行的手段。系统概述电信接口提供了燃气收费系统和电信系统之间的数据通讯，并提供双方进行数据交互的相关的数据包格式、业务数据检查等功能。电信接口提供对于外部系统的业务封装，对于外部系统只明确业务的功能及数据，不需要关心业务的具体处理。接口通过调用燃气收费系统封装的业务服务完成对于接口的请求处理。设计规范系统设计原则数据实时共享电信端不驻留任何数据，而由电信端发出请求，燃气公司和电信实时交换数据安全性必须保证用气系统数据服务的安全，避免任何可疑的

3、直接访问用气数据服务的操作，原则上不允许用营业收费系统的数据服务器与外网有直接的物理连接。必须设有防火墙机制过滤任何恶意攻击必须对接受的数据包进行有效性的验证，杜绝非法请求。稳定性数据请求采用专用传输通道。必须满足全天不间断的业务处理要求，系统运行稳定必须设有备用的通道、前置机。系统有良好的扩充性能够满足各种规模的要求，必要时能够通过增加业务处理机提高系统的容纳量，满足大量的用户交费需求。流程自动化能够自动完成如查询、交费、对帐、冲帐等功能提高自动化程度和工作效率。采用专用的传输通道尽量采用传输速度高、安全性好的光纤通道，避免网络阻塞和数据包丢失。系统设计方案2.2.1统一接口物理环境数据服务

4、器防火墙路由器、交换机电信前置通讯机路由器、交换机电信收费终端光纤、DDN、X25、帧中继TCP/IP协议前置通讯机应用服务器（可选）说明：燃气公司和电信方各自增加一台主机，称作前置机或代理服务器（Agent Server）。前置机之间通过网络设备和网络线路相连。在燃气方，前置机以http方式联接营销应用服务器，是燃气公司与电信进行信息交换的枢纽（Hinge）。主要网络设备： 路由器（Router） 防火墙（FireWall）目的：防止外部攻击。 指标：包过滤 基于IP包的源地址和目的地址的过滤 网络地址转换（NAT） 基于网络端口的访问控制 IP地址和MAC地址的对应系统功能从提供电信的业务

5、划分，主要为欠费查询、缴费、冲账、对帐。接口设计外部接口通讯模式和数据加密方式燃气、电信前置机之间的通讯采用TCP/IP协议，使用TCP socket短连接,交易端口可配置。数据包帧格式和超时时间1. 每个交易数据包由消息头和消息体两部分组成，消息头定长，消息体由多个定长字段组成。 2. 金额均以元为单位，精确到分；3. 除金额右对齐外，其他均左对齐；4数据包接收时，先接收5位的消息长度，然后按照此长度来接收剩下的包内容。5所有字段长度不足时，都以空格填充。6. 所有的业务，当返回消息头中的结果代码(RE_CODE)不为”0000”时，则消息只有包头，没有包体。 超时时间：约定系统超时时间为3

6、0秒，即任何一笔交易都会在30秒之内把应答返回给电信。消息头格式定义电信实时接口采用统一，定长的消息头格式，格式定义如下字段代码字段长度字段名称字段描述BUF_LENGTHCHAR(5)消息长度左对齐，右补空格，消息头长度(54)+包体长度TRAN_CODECHAR(5)交易码2开头为电信业务RE_CODECHAR(4)结果代码电信发起为 0000，燃气为0001RE_MSGCHAR(40)结果描述电信发起填空.交易代码表交易代码代码含义20011欠费查询20021电信缴费20031电信冲账20041对帐请求业务模块有以下几个业务模块:序号模块名称备注1欠费查询查询历史欠费2缴费交易缴纳欠费3

7、冲正交易撤销缴费欠费查询业务流程描述1）首先根据客户的户号，向电信前置机发请求；电信前置机根据请求发数据包到阜新港华燃气公司前置机，前置机调用应用服务器的服务获得用户明细信息，并发送给电信前置机；3) 网点根据反馈信息得到用户应交纳的金额。输入包体定义消息头格式见输入：字段名称最大长度备注USER_NO CHAR(20) 用户号完整的输入报文示例：查询欠费： 输出包体定义输出：字段名称最大长度描述备注USER_NOCHAR(20)户号USER_NAMECHAR(64)客户名USER_ADDRCHAR(64)地址USER_ROOMCHAR(4)房间OWN_TOTALCHAR(14)欠费金额/预存

8、金额以分为单位如果没有欠费（欠费为负数），也可返回预存金额（预存为正数）RECORD_NUMCHAR(20)备用完整的输出报文示例： 返回气费信息。网银缴费业务流程描述用户提交更新收费信息到电信前置机，电信前置机发数据到燃气公司前置机，燃气公司前置机请求燃气公司服务器更新数据；燃气服务器通过同样的途径反馈更新结果返回。电信端根据反馈信息判断是否成功操作；输入包体定义消息头格式见。输入：字段名称最大长度描述备注USER_NOCHAR(20)户号FLOW_NOCHAR(20)流水号YYYYMMDD+交易代码（20021）+网银流水PAY_DATETIMECHAR(20)交费日期时间YYYY/MM/

9、DD HH:MM:SSMONEYCHAR(13)实收金额单位为分,应该大于或等于欠费金额完整的输入报文示例：缴纳欠费： 输出包体定义输出只有消息头。完整的输出报文示例： 业务逻辑电信端应该判断用户所缴纳的实收金额是否大于等于用户总的欠费金额，如果不满足，则提示金额不足错误。用户可以多缴气费，多缴部分自动转预存。缴费失败并且错误代码是网络错误或者系统错误，电信自动循环发起3次缴费请求，缴费流水同第一次的缴费流水，如果燃气返回流水号重复错误或者返回缴费成功信息，则认为该笔缴费成功，否则，放弃该笔缴费，重新进行欠费查询，再次发起缴费。电信冲正业务流程描述首先由电信根据客户的户号、收费日期、原流水号（

10、对应收费流水），向电信前置机发请求；电信前置机接到请求即发数据包到燃气公司前置机，燃气公司前置机调用服务从燃气公司服务器冲帐，并发送成功信息给电信前置机；电信前置机根据燃气公司传送信息进行冲帐处理；输入包体定义消息头格式见。输入：字段名称最大长度描述备注FLOW_NOCHAR(20)流水号USER_NOCHAR(20)号码户号PAY_DATECHAR(20)交费日期时间YYYY/MM/DD HH:MM:SSOLD_FLOW_NOCHAR(20)流水号对应原缴费流水完整的输入报文示例：输出包体定义输出只有消息头。完整的输出报文示例： 。电信对帐.1业务流程燃气每天定时生成对帐文件并推送至电信方指

11、定目录，电信读取文件，电信端检查对帐文件是否符合。符合，返回银行成功，否则，返回失败。.2输入包体定义消息头格式见。字段名称最大长度描述备注FILENAMECHAR(20)对帐文件名FILECOUNTCHAR(8)文件行数文件的总的行数，包括空行(不包含汇总行信息) ，即文件行数=对帐文件总行数-1完整的输入报文示例： .3输出包体定义输出只有消息头。完整的输出报文示例： .3通讯协议燃气每天定时生成对帐文件并FPT推送至电信方指定目录，电信读取文件，对帐结束。电信端检查对帐文件是否符合。符合，返回银行成功，否则，返回失败。.2文件名电信)+YYYYMMDD.txt例如： go.txt.3文件内容:=交易日期|电信合计总笔数|电信合计总金额明细:交易日期|流水号|户号|金