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

1、用户名称：XXXX燃气阜新新纪元计算机网络有限责任公司密级：保密XXXX收费系统接口规范二O六年十月文档信息文档名称XXXXXX接口规范文件状态正式发布编写人陈促日期2016-10-25校对人陈侃日期2016年10月23日审核人李海山日期2016年 10月25 日1任务概述3 目标3 系统概述32. 设计规范3 系统设计原则3系统设计方案4统一接口物理环境4系统功能53 接口设计6.外部接口 6通讯模式和数据加密方式6数据包帧格式和超时时间6消息头格式定义6A交易代码表7业务模块7欠费查询7电信缴费8电信冲正9电信对帐104 附录：11附录1:错误码定义111任务概述1.1. 目标利用现代化通

2、讯技术，建立燃气收费系统与电信之间的信息传输通道；遵循行业规范， 提供通用的中间业务平台；采用先进的数据库操作技术实现信息安全可靠的存取；达到电信 收取、查询燃气费的目的。为燃气运营商拓展营销活动空间、开发服务用户市场、加强行业 竞争优势、挖掘新的经济增长点提供多种先进可行的手段。1.2. 系统概述电信接口提供了燃气收费系统和电信系统之间的数据通讯，并提供双方进行数据交互的 相关的数据包格式、业务数据检查等功能。电信接口提供对于外部系统的业务封装，对于外部系统只明确业务的功能及数据，不需 要关心业务的具体处理。接口通过调用燃气收费系统封装的业务服务完成对于接口的请求处 理。2.设计规范2. 1

3、.系统设计原则1、数据实时共享电信端不驻留任何数据，而由电信端发出请求，燃气公司和电信实时交换数 据2、安全性必须保证用气系统数据服务的安全，避免任何可疑的直接访问用气数据 服务的操作，原则上不允许用营业收费系统的数据服务器与外网有直接的 物理连接。必须设有防火墙机制过滤任何恶意攻击必须对接受的数据包进行有效性的验证，杜绝非法请求。3、稳定性数据请求采用专用传输通道。必须满足全天不间断的业务处理要求，系统运行稳定必须设有备用的通 道、前置机。4、系统有良好的扩充性能够满足各种规模的要求，必要时能够通过增加业务处理机提高系统的 容纳量，满足大量的用户交费需求。5、流程自动化能够自动完成如查询、交

4、费、对帐、冲帐等功能提高自动化程度和工作效率。6、7. 采用专用的传输通道尽量采用传输速度高、安全性好的光纤通道，避免网络阻塞和数据包丢 失。22系统设计方案统一接口物理环境防火墙光奸、DDN、X25、桢中继TCP/IP协议路由器、交换机应用服务器（可选）前置通讯机电信收费终端说明：燃气公司和电信方各自増加一台主机，称作前置机或代理服务器（Agent Server）0前置机之间通过网络设备和网络线路相连。在燃气方，前置机以http方式 联接营销应用服务器，是燃气公司与电信进行信息交换的枢纽（Hinge）o主要网络设备：路由器（Router）防火墙（FireWall）目的：防止外部攻击。指标：包

5、过滤 基于IP包的源地址和目的地址的过滤网络地址转换（7AT） 基于网络端口的访问控制IP地址和MAC地址的对应2. 2. 2.心系统功能从提供电信的业务划分，主要为欠费查询、缴费、冲账、对帐。3接口设计3. 1.外部接口311通讯模式和数据加密方式爆气、电信前置机之间的通讯采用TCP/IP协议，使用TCP socket短连接，交易端口可配置。3. 1. 2.数据包帧格式和超时时间1. 每个交易数据包由消息头和消息体两部分组成，消息头定长，消息体由多个定长字段组 成。2. 金额均以元为单位，精确到分；3. 除金额右对齐外，其他均左对齐；4. 数据包接收时，先接收5位的消息长度，然后按照此长度来

6、接收剩下的包内容。5. 所有字段长度不足时，都以空格填充。6所有的业务，当返回消息头中的结果代码(RE CODE)不为” 0000”时，则消息只有包头, 没有包体。超时时间：约定系统超时时间为30秒，即任何一笔交易都会在30秒之内把应答返回给电信。3. 1.3.消息头格式定义电信实时接口采用统一，定长的消息头格式，格式定义如下字段代码字段长度字段名称字段描述BUF_LENGTHCHAR(5)消息长度左对齐，右补空格，消息头长 度(54)+包体长度TRAN C()DECHAR(5)交易码2开头为电信业务RE_CODECHAR(4)结果代码电信发起为0000,燃气为 0001RE MSGCHAR

7、(40)结果描述电信发起填空.3. 1. 4.交易代码表交易代码代码含义20011欠费查询20021电信缴费20031电信冲账20041对帐请求3. 1.5.业务模块有以下几个业务模块：序号模块名称备注1欠费查询查询历史欠费2缴费交易缴纳欠费3冲正交易撤销缴费3.1.5. 1.欠费查询3.1.5. 1. 1.业务流程描述1）首先根据客户的户号，向电信前置机发请求；2）电信前置机根据请求发数据包到阜新港华燃气公司前置机，前置机调用应用服务器的服务获得用户明细信息，并发送给电信前置机；3）网点根据反馈信息得到用户应交纳的金额。3.1. 5. 1. 2.输入包体定义消息头格式见 输入：字段名称最大长

8、度备注USER_NOCHAR(20)用户号完整的输入报文示例: 查询欠费：3.1. 5. 1. 3.输出包体定义输出:字段名称最大长度描述备注USER一NOCHAR(20)户号USER_NAHECHAR(64)客户名USER_ADDRCHAR(64)地址USER_R()(ICHAR(4)房问金额以分为单位OWN.TOTALCHAR(14)欠费金额/预存如果没有欠费（欠费为负数人也可返回预 存金额（预存为正数）REC()RD_NUMCHAR(20)、用完整的输出报文示例:返回气费信息。3.1. 5.2.网银缴费3.1521 业务流程描述1) 用户提交更新收费信息到电信前置机，电信前置机发数据到燃

9、气公司前置机，燃气 公司前置机请求燃气公司服务器更新数据；2) 燃气服务器通过同样的途径反馈更新结果返回。电信端根据反馈信息判断是否成功 操作；3.1. 5. 2. 2. 输入包体定义消息头格式见消息头格式定义。输入：字段名称最大长度描述备注USER_NOCIIAR (20)户号FLOW_NOCHAR(20)流水号YYYYMMDD+交易代码(20021) *网银流水PAY_DATETIMECIIAR (20)交费日期时问YYYY/MM/DD HH：MM：SSMONEYCHAR(13)实收金额单位为分应该大于或等于欠费金额完整的输入报文示例:缴纳欠费：3.1. 5. 2. 3.输出包体定义输出只

10、有消息头。完整的输出报文示例：3.1. 5. 2. 4.业务逻辑电信端应该判断用户所缴纳的实收金额是否大于等于用户总的欠费金额，如果不满足,则提示金额不足错误。用户可以多缴气费，多缴部分自动转预存。缴费失败并且错误代码是网络错误或者系统错误，电信自动循环发起3次缴费请求，缴费流水同第一次的缴费流水，如果燃气返回流水号重复错误或者返回缴费成功信息，则认为该笔缴费成功，否则，放弃该笔缴费，重新进行欠费查询，再次发起缴费。3.1. 5. 3.电信冲正3.1. 5. 3. 1 业务流程描述1）首先由电信根据客户的户号、收费日期、原流水号（对应收费流水），向电信前置 机发请求；2）电信前置机接到请求即发

11、数据包到燃气公司前置机，燃气公司前置机调用服务从燃 气公司服务器冲帐，并发送成功信息给电信前置机；3）电信前置机根据燃气公司传送信息进行冲帐处理；3.1. 5. 3. 2.输入包体定义消息头格式见消息头格式定义。B输入：字段名称最大长度描述备注FLOW_NOCHAR(20)流水号USER一NOCHAR(20)号码户号PAY.DATECHAR(20)交费日期时问YYYY/MM/DD HH：MM：SS0LD_FL01Y_N0CHAR(20)流水号对应原缴费流水完整的输入报文示例:3.1. 5. 3. 3. I心仏 输出包体定义输出只有消息头。完整的输出报文示例：O电信对帐1业务流程燃气每天定时生成

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