2022年营业收费系统socket接口报文标准 .pdf

《2022年营业收费系统socket接口报文标准 .pdf》由会员分享，可在线阅读，更多相关《2022年营业收费系统socket接口报文标准 .pdf（11页珍藏版）》请在得力文库 - 分享文档赚钱的网站上搜索。

1、阜新新纪元计算机网络有限责任公司 QQ:1166371 用户名称：XXXX燃气阜新新纪元计算机网络有限责任公司密级：保密XXXX 收费系统接口规范二一六年十月文档信息文档名称XXXXXX 接口规范文件状态正式发布编 写 人陈侃日期2016-10-25 校 对 人陈侃日期2016 年10 月23 日审 核 人李海山日期2016 年10 月 25 日目 录名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 1 页，共 11 页 - - - - - - - - - 阜新新纪元计算机网络有限责任

2、公司 QQ:1166372 1任务概述 . 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：错误码

3、定义. 11名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 2 页，共 11 页 - - - - - - - - - 阜新新纪元计算机网络有限责任公司 QQ:1166373 1 任务概述1.1. 目标利用现代化通讯技术，建立燃气收费系统与电信之间的信息传输通道；遵循行业规范，提供通用的中间业务平台；采用先进的数据库操作技术实现信息安全可靠的存取；达到电信收取、 查询燃气费的目的。为燃气运营商拓展营销活动空间、开发服务用户市场、加强行业竞争优势、挖掘新的经济增长点提供多种先进可行的手段

4、。1.2. 系统概述电信接口提供了燃气收费系统和电信系统之间的数据通讯，并提供双方进行数据交互的相关的数据包格式、业务数据检查等功能。电信接口提供对于外部系统的业务封装，对于外部系统只明确业务的功能及数据，不需要关心业务的具体处理。接口通过调用燃气收费系统封装的业务服务完成对于接口的请求处理。2. 设计规范2.1. 系统设计原则1、 数据实时共享电信端不驻留任何数据，而由电信端发出请求，燃气公司和电信实时交换数据2、 安全性必须保证用气系统数据服务的安全，避免任何可疑的直接访问用气数据服务的操作，原则上不允许用营业收费系统的数据服务器与外网有直接的物理连接。必须设有防火墙机制过滤任何恶意攻击必

5、须对接受的数据包进行有效性的验证，杜绝非法请求。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 3 页，共 11 页 - - - - - - - - - 阜新新纪元计算机网络有限责任公司 QQ:1166374 3、 稳定性数据请求采用专用传输通道。必须满足全天不间断的业务处理要求，系统运行稳定必须设有备用的通道、前置机。4、 系统有良好的扩充性能够满足各种规模的要求， 必要时能够通过增加业务处理机提高系统的容纳量，满足大量的用户交费需求。5、 流程自动化能够自动完成如查询、交费、对帐

6、、冲帐等功能提高自动化程度和工作效率。6、 采用专用的传输通道尽量采用传输速度高、 安全性好的光纤通道， 避免网络阻塞和数据包丢失。2.2 系统设计方案2.2.1 统一接口物理环境名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 4 页，共 11 页 - - - - - - - - - 阜新新纪元计算机网络有限责任公司 QQ:1166375 说明：燃气公司和电信方各自增加一台主机，称作前置机或代理服务器（Agent Server） 。前置机之间通过网络设备和网络线路相连。在燃气方，前置

7、机以http 方式联接营销应用服务器，是燃气公司与电信进行信息交换的枢纽（Hinge） 。主要网络设备：路由器（ Router）防火墙（ FireWall ）目的：防止外部攻击。指标：包过滤基于 IP 包的源地址和目的地址的过滤网络地址转换（NAT ）基于网络端口的访问控制IP 地址和 MAC 地址的对应2.2.2. 系统功能从提供电信的业务划分，主要为欠费查询、缴费、冲账、对帐。数据服务器防火墙路由器、交换机电信前置通讯机路由器、交换机电信收费终端光纤、DDN、X25、帧中继TCP/IP 协议前置通讯机应用服务器（可选）名师资料总结 - - -精品资料欢迎下载 - - - - - - - -

8、 - - - - - - - - - - 名师精心整理 - - - - - - - 第 5 页，共 11 页 - - - - - - - - - 阜新新纪元计算机网络有限责任公司 QQ:1166376 3 接口设计3.1. 外部接口3.1.1. 通讯模式和数据加密方式燃气、电信前置机之间的通讯采用TCP/IP 协议，使用TCP socket 短连接 ,交易端口可配置。3.1.2. 数据包帧格式和超时时间1. 每个交易数据包由消息头和消息体两部分组成，消息头定长，消息体由多个定长字段组成。2. 金额均以元为单位，精确到分；3. 除金额右对齐外，其他均左对齐；4数据包接收时，先接收5 位的消息长度

9、，然后按照此长度来接收剩下的包内容。5所有字段长度不足时，都以空格填充。6. 所有的业务，当返回消息头中的结果代码(RE_CODE) 不为 ” 0000” 时，则消息只有包头，没有包体。超时时间 ：约定系统超时时间为30 秒，即任何一笔交易都会在30 秒之内把应答返回给电信。3.1.3. 消息头格式定义电信实时接口采用统一，定长的消息头格式，格式定义如下字段代码字段长度字段名称字段描述BUF_LENGTH CHAR(5) 消息长度左对齐，右补空格，消息头长度(54)+包体长度TRAN_CODE CHAR(5) 交易码2 开头为电信业务RE_CODE CHAR(4) 结果代码电 信发 起为 00

10、00 ， 燃气 为0001RE_MSG CHAR(40) 结果描述电信发起填空 . 名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 6 页，共 11 页 - - - - - - - - - 阜新新纪元计算机网络有限责任公司 QQ:1166377 3.1.4. 交易代码表交易代码代码含义20011 欠费查询20021 电信缴费20031 电信冲账20041 对帐请求3.1.5. 业务模块有以下几个业务模块: 序号模块名称备注1 欠费查询查询历史欠费2 缴费交易缴纳欠费3 冲正交易撤销缴

11、费3.1.5.1. 欠费查询3.1.5.1.1. 业务流程描述1）首先根据客户的户号，向电信前置机发请求；2） 电信前置机根据请求发数据包到阜新港华燃气公司前置机，前置机调用应用服务器的服务获得用户明细信息，并发送给电信前置机；3) 网点根据反馈信息得到用户应交纳的金额。3.1.5.1.2. 输入包体定义消息头格式见输入：字段名称最大长度备注USER_NO CHAR(20) 用户号完整的输入报文示例：查询欠费：名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 7 页，共 11 页 -

12、- - - - - - - - 阜新新纪元计算机网络有限责任公司 QQ:1166378 3.1.5.1.3. 输出包体定义输出：字段名称最大长度描述备注USER_NO CHAR(20) 户号USER_NAME CHAR(64) 客户名USER_ADDR CHAR(64) 地址USER_ROOM CHAR(4) 房间OWN_TOTAL CHAR(14) 欠费金额 /预存金额以分为单位如果没有欠费 （欠费为负数） ，也可返回预存金额（预存为正数）RECORD_NUM CHAR(20) 备用完整的输出报文示例：返回气费信息。3.1.5.2. 网银缴费3.1.5.2.1. 业务流程描述1） 用户提交更

13、新收费信息到电信前置机，电信前置机发数据到燃气公司前置机，燃气公司前置机请求燃气公司服务器更新数据；2） 燃气服务器通过同样的途径反馈更新结果返回。电信端根据反馈信息判断是否成功操作；3.1.5.2.2. 输入包体定义消息头格式见 消息头格式定义 。输入：字段名称最大长度描述备注USER_NO CHAR(20) 户号FLOW_NO CHAR(20) 流水号YYYYMMDD+交易代码（ 20021）+网银流水PAY_DATETIME CHAR(20) 交费日期时间YYYY/MM/DD HH:MM:SS MONEY CHAR(13) 实收金额单位为分 , 应该大于或等于欠费金额名师资料总结 - -

14、 -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 8 页，共 11 页 - - - - - - - - - 阜新新纪元计算机网络有限责任公司 QQ:1166379 完整的输入报文示例：缴纳欠费：3.1.5.2.3. 输出包体定义输出只有消息头。完整的输出报文示例：3.1.5.2.4. 业务逻辑电信端应该判断用户所缴纳的实收金额是否大于等于用户总的欠费金额，如果不满足，则提示金额不足错误。用户可以多缴气费，多缴部分自动转预存。缴费失败并且错误代码是网络错误或者系统错误，电信自动循环发起3 次缴费请求， 缴费

15、流水同第一次的缴费流水，如果燃气返回流水号重复错误或者返回缴费成功信息，则认为该笔缴费成功，否则，放弃该笔缴费，重新进行欠费查询，再次发起缴费。3.1.5.3. 电信冲正3.1.5.3.1. 业务流程描述1） 首先由电信根据客户的户号、收费日期、原流水号（对应收费流水），向电信前置机发请求；2） 电信前置机接到请求即发数据包到燃气公司前置机，燃气公司前置机调用服务从燃气公司服务器冲帐，并发送成功信息给电信前置机；3） 电信前置机根据燃气公司传送信息进行冲帐处理；3.1.5.3.2. 输入包体定义消息头格式见 消息头格式定义 。输入：字段名称最大长度描述备注FLOW_NO CHAR(20) 流水

16、号名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 9 页，共 11 页 - - - - - - - - - 阜新新纪元计算机网络有限责任公司 QQ:11663710 USER_NO CHAR(20) 号码户号PAY_DATE CHAR(20) 交费日期时间YYYY/MM/DD HH:MM:SS OLD_FLOW_NO CHAR(20) 流水号对应原缴费流水完整的输入报文示例：3.1.5.3.3. 输出包体定义输出只有消息头。完整的输出报文示例：。3.1.5.4 电信对帐3.1.5.4

17、.1 业务流程燃气每天定时生成对帐文件并推送至电信方指定目录，电信读取文件， 电信端检查对帐文件是否符合。符合，返回银行成功，否则，返回失败。3.1.5.4.2输入包体定义消息头格式见 消息头格式定义 。字段名称最大长度描述备注FILENAME CHAR(20) 对帐文件名FILECOUNT CHAR(8) 文件行数文件的总的行数， 包括空行 ( 不包含汇总行信息 ) ，即文件行数 =对帐文件总行数 -1 完整的输入报文示例：3.1.5.4.3输出包体定义输出只有消息头。完整的输出报文示例：3.1.5.4.3通讯协议燃气每天定时生成对帐文件并FPT 推送至电信方指定目录，电信读取文件，对帐结束

18、。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 10 页，共 11 页 - - - - - - - - - 阜新新纪元计算机网络有限责任公司 QQ:11663711 电信端检查对帐文件是否符合。符合，返回银行成功，否则，返回失败。3.1.5.4.2文件名电信 )+YYYYMMDD.txt 例如：go20160117.txt 3.1.5.4.3文件内容 : =交易日期 |电信合计总笔数|电信合计总金额明细 : 交易日期 |流水号 |户号 |金额注：金额单位为分。例如，下面是一个电信对帐文件的部分内容：。4 附录 : 附录 1：错误码定义结果代码结果代码描述0000 成功1001数据库或网络断开交易超时1002 该用户不存在1003 电信端数据错误（户号、日期无效，流水号为空，金额无效）1004 被冲正的流水号不存在或已冲正.备注：燃气公司前置通讯机程序会每15秒发送定长字符串，用来判断客户端是否关闭名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 11 页，共 11 页 - - - - - - - - -