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

阜新新纪元计算机网络有限责任公司QQ:1166371用户名称：XXXX燃气阜新新纪元计算机网络有限责任公司密级：保密XXXX收费系统接口规范二〇一六年十月文档信息文档名称XXXXXX接口规范文件状态正式发布编写人陈侃日期2016-10-25校对人陈侃日期2016年10月23日审核人李海山日期2016年10月25日目录阜新新纪元计算机网络有限责任公司QQ:11663721任务概述..........................................................................................................................................31.1.目标...........................................................................................................................31.2.系统概述...................................................................................................................32.设计规范..........................................................................................................................................32.1.系统设计原则...........................................................................................................32.2系统设计方案...........................................................................................................42.2.1统一接口物理环境..................................................................................................42.2.2.系统功能..................................................................................................................53接口设计..........................................................................................................................................63.1.外部接口...................................................................................................................63.1.1.通讯模式和数据加密方式...............................................................................63.1.2.数据包帧格式和超时时间...............................................................................63.1.3.消息头格式定义...............................................................................................63.1.4.交易代码表.......................................................................................................73.1.5.业务模块...........................................................................................................73.1.5.1.欠费查询...................................................................................................73.1.5.2.电信缴费...................................................................................................83.1.5.3.电信冲正...................................................................................................93.1.5.4电信对帐..................................................................................................104附录:...............................................................................................................................................11附录1：错误码定义..............................................................................................................11阜新新纪元计算机网络有限责任公司QQ:11663731任务概述1.1.目标利用现代化通讯技术，建立燃气收费系统与电信之间的信息传输通道；遵循行业规范，提供通用的中间业务平台；采用先进的数据库操作技术实现信息安全可靠的存取；达到电信收取、查询燃气费的目的。为燃气运营商拓展营销活动空间、开发服务用户市场、加强行业竞争优势、挖掘新的经济增长点提供多种先进可行的手段。1.2.系统概述电信接口提供了燃气收费系统和电信系统之间的数据通讯，并提供双方进行数据交互的相关的数据包格式、业务数据检查等功能。电信接口提供对于外部系统的业务封装，对于外部系统只明确业务的功能及数据，不需要关心业务的具体处理。接口通过调用燃气收费系统封装的业务服务完成对于接口的请求处理。2.设计规范2.1.系统设计原则1、数据实时共享电信端不驻留任何数据，而由电信端发出请求，燃气公司和电信实时交换数据2、安全性必须保证用气系统数据服务的安全，避免任何可疑的直接访问用气数据服务的操作，原则上不允许用营业收费系统的数据服务器与外网有直接的物理连接。必须设有防火墙机制过滤任何恶意攻击必须对接受的数据包进行有效性的验证，杜绝非法请求。阜新新纪元计算机网络有限责任公司QQ:11663743、稳定性数据请求采用专用传输通道。必须满足全天不间断的业务处理要求，系统运行稳定必须设有备用的通道、前置机。4、系统有良好的扩充性能够满足各种规模的要求，必要时能够通过增加业务处理机提高系统的容纳量，满足大量的用户交费需求。5、流程自动化能够自动完成如查询、交费、对帐、冲帐等功能提高自动化程度和工作效率。6、采用专用的传输通道尽量采用传输速度高、安全性好的光纤通道，避免网络阻塞和数据包丢失。2.2系统设计方案2.2.1统一接口物理环境阜新新纪元计算机网络有限责任公司QQ:1166375说明：燃气公司和电信方各自增加一台主机，称作前置机或代理服务器（AgentServer）。前置机之间通过网络设备和网络线路相连。在燃气方，前置机以http方式联接营销应用服务器，是燃气公司与电信进行信息交换的枢纽（Hinge）。主要网络设备：路由器（Router）防火墙（FireWall）目的：防止外部攻击。指标：包过滤基于IP包的源地址和目的地址的过滤网络地址转换（NAT）基于网络端口的访问控制IP地址和MAC地址的对应2.2.2.系统功能从提供电信的业务划分，主要为欠费查询、缴费、冲账、对帐。数据服务器防火墙路由器、交换机电信前置通讯机路由器、交换机电信收费终端光纤、DDN、X25、帧中继TCP/IP协议前置通讯机应用服务器（可选）阜新新纪元计算机网络有限责任公司QQ:11663763接口设计3.1.外部接口3.1.1.通讯模式和数据加密方式燃气、电信前置机之间的通讯采用TCP/IP协议，使用TCPsocket短连接,交易端口可配置。3.1.2.数据包帧格式和超时时间1.每个交易数据包由消息头和消息体两部分组成，消息头定长，消息体由多个定长字段组成。2.金额均以元为单位，精确到分；3.除金额右对齐外，其他均左对齐；4．数据包接收时，先接收5位的消息长度，然后按照此长度来接收剩下的包内容。5．所有字段长度不足时，都以空格填充。6.所有的业务，当返回消息头中的结果代码(RE_CODE)不为”0000”时，则消息只有包头，没有包体。超时时间：约定系统超时时间为30秒，即任何一笔交易都会在30秒之内把应答返回给电信。3.1.3.消息头格式定义电信实时接口采用统一，定长的消息头格式，格式定义如下字段代码字段长度字段名称字段描述BUF_LENGTHCHAR(5)消息长度左对齐，右补空格，消息头长度(54)+包体长度TRAN_CODECHAR(5)交易码2开头为电信业务RE_CODECHAR(4)结果代码电信发起为‘0000’，燃气为‘0001’RE_MSGCHAR(40)结果描述电信发起填空.阜新新纪元计算机网络有限责任公司QQ:11663773.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.输入包体定义消息头格式见输入：字段名称最大长度备注USER_NOCHAR(20)用户号完整的输入报文示例：查询欠费：阜新新纪元计算机网络有限责任公司QQ:11663783.1.5.1.3.输出包体定义输出：字段名称最大长度描述备注USER_NOCHAR(20)户号USER_NAMECHAR(64)客户名USER_ADDRCHAR(64)地址USER_ROOMCHAR(4)房间OWN_TOTALCHAR(14)欠费金额/预存金额以分为单位如果没有欠费（欠费为负数），也可返回预存金额（预存为正数）RECORD_NUMCHAR(20)备用完整的输出报文示例：返回气费信息。3.1.5.2.网银缴费3.1.5.2.1.业务流程描述1）用户提交更新收费信息到电信前置机，电信前置机发数据到燃气公司前置机，燃气公司前置机请求燃气公司服务器更新数据