Q/SY
中国石油天然气集团有限公司企业标准
Q/SY 10009.6—2020
天然气零售系统建设与运维规范第6部分：燃气自助服务终端接口
Specifications for gas retail system implementation,operation & maintenance Part 6:Interface of gas self-service terminal
2020-07—30发布
2020－10－12实施
发布
中国石油天然气集团有限公司 Q/SY 10009.6—2020
目 次
前言范围 2 规范性引用文件 3 术语和定义设计要求
1
4
4.1 设计原则 4.2 功能设计 4.3 硬件设备接口要求
5
5.1 接人方式 5.2 接口规范调用处理流程 6.1基表缴费业务调用处理流程 6.2IC卡表充值业务调用处理流程附录A（规范性附录） 基表缴费功能接口规范附录B（规范性附录） IC卡表缴费功能接口规范附录C（规范性附录） 第三方支付接口规范附录D（规范性附录） 调用处理流程
b
2
"17 Q/SY 10009.6—2020
前言
Q/SY10009《天然气零售系统建设与运维规范》分为6个部分：
第1部分：运维管理：第2部分：燃气表IC卡接口：第3部分：银行代收系统接口：第4部分：远传表数据采集：第5部分：燃气表信息安全：第6部分：燃气自助服务终端接口。
本部分为Q/SY10009的第6部分。 本部分按照GB/T1.1一2009《标准化工作导则第1部分：标准的结构和编写》给出的规则起草，本部分由信息管理部提出。 本部分由中国石油天然气集团有限公司标准化委员会信息技术专业标准化技术委员会归口。 本部分起草单位：规划总院，天然气销售分公司（昆仑能源）。勘探开发研究院。 本部分主要起草人：杨金珠、高峰、刘世章。刘晨。张志强、宋倩、柳东、刘辉。
1I Q/SY 10009.6—2020
天然气零售系统建设与运维规范第6部分：燃气自助服务终端接口
1范围
Q/SY10009的本部分规定了天然气零售系统（以下简称“零售系统"）燃气自助服务终端设计要求、接口要求。调用处理流程。
本部分适用于接人零售系统的燃气自助服务终端的设计，开发。联调和应用的需要。
规范性引用文件
2
下列文件对于本文件的应用是必不可少的。凡是注日期的弓用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。
GB/T23647自助服务终端通用规范 GB4943.1信息技术设备安全第1部分：通用要求 ISO7816 5国际智能卡（Identification cards）
术语和定义
3
下列术语和定义适用于本文件。
3.1
燃气自助服务终端 gas self-service terminal 实现燃气缴费自助服务的设备或装置。
3.2
IC卡表 IC card gas meter 以膜式燃气表为计量基表，以IC卡为媒体。加装电子控制器所组成的一种具有预付费功能的燃
气表计量装置。 3.3
基表 basic gas meter 具有基础计量功能的膜式燃气表。
4设计要求 4.1设计原则
燃气自助服务终端硬件设计应满足GB/T23647—2009中4.1.1的要求，软件设计应满足GB/T 23647—2009中4.1.2的要求。 Q/SY 10009.6—2020
4.2功能设计
4.2.1功能概述
燃气自助服务终端功能应分为服务功能和管理功能两类。服务功能应包括IC卡表缴费。基表缴费。打印小票，查询、信息宣传。操作指南。管理功能应包括参数配置。身份识别、应用系统自检设备注册。 4.2.2 IC卡表缴费
应实现IC卡表客户在自助服务终端上自助完成充值缴费。 4.2.3基表缴费
应实现基表客户在自助服务终端上查询欠费和自助缴费。 4.2.4 4打印小票
应实现客户在充值后，在自助服务终端上打印充值凭证。 4.2.5 查询
应实现通过客户账号查询待缴费信息功能。
4.2.6 信息宣传
应实现燃气公司关于安全用气、营业网点等信息宣传。 4.2.7操作指南
应提供客户在自助服务终端上进行自助操作的流程指导。 4.2.8参数配置
应提供用于自助服务终端燃气公司代码等参数配置的功能。 4.2.9 身份识别
应实现通过验证自助服务终端机器码，识别该设备是否合法的功能。 4.2.10应用系统自检
系统开机后应具备自动检测扫码器，IC卡读写器。小票打印机等硬件和接口服务软件状态的功能。 4.2.11 设备注册
应实现通过机器码授权文件在零售系统注册的功能。 4.3 硬件设备 4.3.1 1整机结构
应满足以下技术要求：
2 Q/SY10009.6—2020
接人方式。企业内网的自助服务终端应通过内网访问核心区接口服务器进行对接：外网自助服务终端应通过互联网，经过防火墙访问DMZ区域的接口服务器进行对接。两种接人方式如图1所示。
天然气零售系统
DMZ区
. 接口应用服务器
0
-
外网自助服务终端
接口服务器
数据库
. 接口服务器
企业内网自助服务终端
图1接入方式
5.2接口规范 5.2.1概述 5.2.1.1 1接口协议
燃气自助服务终端对接天然气零售系统时，接口的请求方式应统一采用POST方式，HTTP协议提交表单参数。 5.2.1.2授权方式
燃气自助服务终端应安装终端授权程序进行注册，应通过请求http：//localhost：9966/ GetMachinecodeSecret获取机器码。 5.2.1.3安全机制
自助服务终端应用与服务器数据交互通过添加签名验证，防止拦截算改，并对传输数据做AES 加密，使用SSL证书，通过etDebtNet接口或getInfo接口获取用户信息与token值，其HTTP请求头Authorization中应包含此token值来验证请求合法性。 5.2.1.4接口分类
接口的分类和说明见表1。 5.2.2基表缴费 5.2.2.1 查询基表客户信息
自助服务终端根据客户号调用getDebtNet接口应查询到客户的基本信息，账单信息。 查询基表客户信息传人参数和传出参数应符合A.1的要求。
4