DB21 T 3792-2023 重点用能单位能耗在线监测大数据分析平台数据接口规范.pdf
《DB21 T 3792-2023 重点用能单位能耗在线监测大数据分析平台数据接口规范.pdf》由会员分享,可在线阅读,更多相关《DB21 T 3792-2023 重点用能单位能耗在线监测大数据分析平台数据接口规范.pdf(41页珍藏版)》请在麦多课文档分享上搜索。
1、ICS29.240.01CCS F 2121辽宁省地方标准DB21/T 37922023重点用能单位能耗在线监测大数据分析平台数据接口规范Data interface specification of big data analysis platform for onlinemonitoring of energy consumption of key energy users2023-08-30 发布2023-09-30 实施辽宁省市场监督管理局 发 布DB21/T 37922023I目次前言.II1 范围.12 规范性引用文件.13 术语和定义.14 缩略语.25 通信框架.25.1 总体
2、结构.25.2 通信模式.35.3 通信协议.36 省级平台与能耗在线监测端设备的数据传输接口.36.1 总述.36.2 功能要求.36.3 信息描述.47 省级平台与其他应用平台的数据传输接口.77.1 总述.77.2 功能要求.77.3 信息描述.8附录 A(资料性)省级平台与能耗在线监测端设备的数据传输接口示例.11附录 B(规范性)能耗在线监测系统基础信息与格式规范.23附录 C(资料性)省级平台与其他应用平台的数据传输接口.28DB21/T 37922023II前言本文件按照GB/T 1.12020标准化工作导则第1部分:标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可
3、能涉及专利。本文件的发布机构不承担识别这些专利的责任本文件由辽宁省发展和改革委员会提出并归口。本文件起草单位:辽宁省大数据管理中心(辽宁省信息中心)、青岛高校信息产业股份有限公司、沈阳工业大学、辽宁省节能监察服务中心、辽宁省市场监管事务服务中心、大连市市场监管综合行政执法队能源大队、大连理工大学能源与动力学院、大连辉创信息技术有限公司、辽宁碳科能信科技有限公司。本文件主要起草人:苏乃锋、张丽霞、李洪涛、蒲云鹏、李国良、丛明、兰莹、米欣、李宏岩、赵亮、王长亮、袁泉、王林娜、侯越、年晓非、任成刚、孙醒坤、于永胜、杨田、马莹莹、李铎、郭伟、朱琳卓、韩旭、邵思豪、吉新华、李享、汪东辉、宋小磊、高绪腾。
4、本文件发布实施后,任何单位和个人如有问题和意见建议,均可以通过来电或来函等方式进行反馈,我们将及时答复并认真处理,根据实际情况依法进行评估及复审。归口管理单位:辽宁省发展和改革委员会,通讯地址:沈阳市皇姑区北陵大街45-2楼623室,联系电话:024-86892950。起草单位:辽宁省大数据管理中心(辽宁省信息中心),通讯地址:辽宁省沈阳市和平区市府大路187号328室,联系电话:13889880931。DB21/T 379220231重点用能单位能耗在线监测大数据分析平台数据接口规范1范围本文件规定了重点用能单位能耗在线监测大数据分析平台数据传输过程的应用层通信协议与数据接口规范,本文件不限
5、制系统扩展其他的信息内容,在扩展内容时不得与本规范中所使用或保留的控制命令相冲突。本文件适用于重点用能单位能耗在线监测大数据分析平台和端设备、省政务信息共享交换平台等其他应用平台之间的数据交换传输。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T 2260 中华人民共和国行政区划代码GB/T 4754 国民经济行业分类GB/T 25070 信息安全技术网络安全等级保护安全设计技术要求GB 32100 法人和其他组织统一社会信用代码编码规
6、则GB/T 37947.1 信息技术用能单位能耗在线监测系统第 1 部分:端设备数据传输接口GB/T 38692 用能单位能耗在线监测技术要求GB/T 39786 信息安全技术信息系统密码应用基本要求3术语和定义下列术语和定义适用于本文件。3.1重点用能单位 key energy users重点用能单位指年综合能源消费总量一万吨标准煤以上(含一万吨)的用能单位或国务院有关部门、省、自治区、直辖市人民政府管理节能工作的部门指定的年综合能源消费总量五千吨标准煤以上(含五千吨)、不满一万吨标准煤的用能单位。3.2省级平台 provincial platform省级平台是指辽宁省重点用能单位能耗在线监
7、测大数据分析平台。负责接收、存储、汇总、分析本地区内重点用能单位能耗在线监测数据,为各级节能主管部门、重点用能单位提供应用服务。3.3端设备 device部署在重点用能单位,用于采集、分析、汇总重点用能单位能耗数据并将数据上传到省级平台的设备。DB21/T 3792202323.4其他应用平台 other application platforms与省级平台进行数据交换共享的其他独立运行的应用系统,简称“其他应用平台”。3.5通信协议 communication protocol指实现通信的双方实体完成通信或服务所必须遵循的规则和约定。协议定义了数据单元使用的格式,信息单元应该包含的信息与含义
8、,连接方式,信息发送和接收的时序,从而确保网络中数据从发送方顺利地传送到接收方,并被正确识别。本文件主要定义应用层协议。3.6在线直接采集 online direct collection通过对接智能仪表、工业控制系统、生产监控管理系统、管理信息系统等,将重点用能单位的能耗数据采集到端设备,数据汇总处理后自动传输到省级平台。3.7数据传输接口 data transmission interface省级平台和端设备、省政务信息共享交换平台及其他应用平台实现数据传输所规定的一组约定。4缩略语下列缩略语适用于本文件。HTTPS:安全超文本传输协议(Hyper Text Transfer Protoc
9、ol Secure)JSON:对象表示法(JavaScript Object Notation)CA:证书授权中心(Certificate Authority)XML:可扩展标记语言(Extensible Markup Language)TCP/IP:传输控制协议/因特网互联协议(Transmission Control Protocol/Internet Protocol)5通信框架5.1总体结构通过端设备,省级平台接收企业上传的能耗数据,对接收的数据进行汇总处理,按照统一约定与端设备及其他应用平台进行数据传输共享。通信总体框架示意图如图1所示。图 1 通信总体框架示意图DB21/T 379
10、2202335.2通信模式省级平台与端设备以及省级平台与其他应用平台之间采用请求应答通信模式。由能耗在线监测端设备或是其他应用平台发起,省级平台应答组成。5.3通信协议传输层基于TCP/IP协议。应用层基于HTTPS协议,在应用层传输的业务数据采用JSON交换格式,数据交换采用的格式见第6章、第7章。6省级平台与能耗在线监测端设备的数据传输接口6.1总述能耗在线监测端设备需采用统一要求的CA数字证书进行身份验证,通过身份验证后才能接入省级平台。能耗在线监测端设备将重点用能单位数据经互联网上传至省级平台时,需同时采用VPN通道及HTTPS协议进行安全加密传输。数据传输接口构成如图2所示。图 3
11、省级平台与其他应用平台的数据传输接口构成6.2功能要求6.2.1端设备注册接口能耗在线监测端设备完成物理部署、接入网络并运行后,进行端设备注册。省级平台负责提供 URL地址,并返回数据上传时间点要求(平台按照企业端注册顺序逐个返回上传时间),端设备需要按照此时间点上传数据。DB21/T 379220234接口示例参见附录A的A.1。6.2.2基础数据下载接口能耗在线监测端设备注册成功后,对能耗在线监测端设备系统进行初始化配置,包括用能单位基础信息、数据接入配置信息和相应的数据编码等。接口示例参见附录A的A.2。6.2.3平台版本校验接口省级平台的注册服务信息或基础数据更改后,相应版本信息进行更
12、新。能耗在线监测端设备基于此版本信息,重新注册或下载基础数据。接口示例参见附录A的A.3。6.2.4用能单位基础信息上传接口能耗在线监测端设备完成设备初始化配置后,上传用能单位的基础信息至省级平台。接口示例参见附录A的A.4。6.2.5用能单位采集数据上传接口用能单位采集上传的数据指标分为每日采集上传到省级平台的数据指标和每月采集上传到省级平台的数据指标。每日采集上传的数据指标包括每日指标和实时指标两类。每日指标为结算日00:00-24:00企业的能源总量指标;对于在线采集的数据,上传实时指标。实时指标为每间隔15分钟采集一次的能源消耗实时数据(为消耗数据,非累计值。如对于电表,采集保存数据=
13、电表显示累计电量n-电表显示累计电量n-1)并保存在本地,在指定的数据上传时间与每日上报数据一同上传到省级平台。企业每月采集上传的数据指标包括企业每月能源总量指标(企业各能源品种的购进量、外供量、期初库存、期末库存、综合能源消费量)、重点工段每月能源消费量指标、企业经济指标。用能单位将数据进行汇总打包后,每日在指定的数据上传时间将本批次数据上传至省级平台。省级平台成功接收本批次数据后,返回一个成功反馈消息,如果超时还未收到反馈或反馈为失败,则端设备重发,若重发3次还未成功,则端设备将本批次数据保存在队列中,下次上传数据时再次重发,直至成功。接口示例参见附录A的A.5。6.3信息描述6.3.1端
14、设备注册接口6.3.1.1发送信息端设备注册应提供如下信息:a)用能单位统一社会信用代码按照 GB 32100 执行,统一社会信用代码为 18 位;b)用能单位所在行政区域的行政区划代码按照 GB/T 2260 执行,行政区划代码为 6 位;c)用能单位名称(全称);d)用能单位所在行政区域的行政区划名称按照 GB/T 2260 执行。6.3.1.2返回信息DB21/T 379220235省级平台返回如下信息:a)返回码:返回码说明见表 1;b)状态提示:对返回码的说明,状态提示说明见表 1;c)设备序列号“GUID”:GUID 为端设备统一编码,为 32 位,由省级平台统一生成并下发;d)基
15、础数据下载地址:用于端设备基础数据下载,如 IP:port/downloadBaseData;e)省级平台版本校验地址:用于平台版本校验,如 IP:port/versionCheck;f)用能单位基础信息配置上传地址:用于用能单位基础信息上传至省级平台,如IP:port/uploadConfigData;g)用能单位采集数据上传地址:用于用能单位采集数据上传至省级平台,如IP:port/uploadEnergyData;h)用能单位基础信息配置下载地址:用于从省级平台下载用能单位基础信息,如IP:port/downloadConfigData;i)用能单位采集数据下载地址:用于从省级平台下载用
16、能单位采集数据,如IP:port/downloadEnergyData;j)上报时间点:用于规定用能单位上传数据至省级平台的时间,格式为:HH:MM:SS。表 1返回码说明返回码状态提示说明备注0请求成功E1001平台服务异常请求失败E1002服务器数据库异常,联系省级平台管理员请求失败E2001请求参数异常,缺少必填项请求失败E2002请求参数异常,参数格式不合法请求失败6.3.2基础数据下载接口6.3.2.1发送信息a)能耗在线监测端设备发起基础数据下载应提供设备序列号“GUID”:GUID 为端设备统一编码,为 32 位,由省级平台统一生成并下发;b)选择基础数据类型:基础数据类型包含全
17、部类型、行政区划、行业、单位类别编码、采集系统分类、生产工序、采集数据项、采集数据项数据用途、能源类型等选项,参加附录 A 的 A.6。6.3.2.2返回信息省级平台返回如下信息:a)返回码:请求状态说明代码,返回码说明见表 1;b)状态提示:对返回码的说明,状态提示说明见表 1;c)行政区划代码:参见附录 B 的 B.1;d)行业代码:参见附录 B 的 B.1;e)单位类别编码:企业登记注册类别与代码说明,参见附录 A 的 A.7;f)采集数据项编码:采集数据类型、能源品种、新能源指标及碳指标等编码规则参见附录 B;DB21/T 379220236g)采集数据项数据用途:采集数据项见附录 B
18、;h)产品指标:单位产品能耗指标项的信息见附录 B。6.3.3平台版本校验接口6.3.3.1发送信息能耗在线监测端设备发起省级平台版本校验应提供:设备序列号“GUID”,GUID 为端设备统一编码,为 32 位,由省级平台统一生成并下发。6.3.3.2返回信息省级平台返回值包含如下信息:a)返回码:请求状态说明代码,返回码说明见表 1;b)状态提示:对返回码的说明,状态提示说明见表1;c)省级平台注册服务版本信息:为省级平台注册服务的版本编号,如 125;d)省级平台基础数据版本信息:为省级平台基础数据的版本编号,如 125;e)能耗在线监测端设备定期检查本地基础信息是否已更新,检查周期至少每
19、天一次。6.3.4用能单位基础信息上传接口6.3.4.1发送信息用能单位基础信息上传应提供如下信息:a)设备序列号“GUID”:GUID 为端设备统一编码,为32位,由省级平台统一生成并下发。b)用能单位统一社会信用代码:统一社会信用代码为18位,按照GB 32100执行。c)采集数据项配置信息:能耗在线监测端设备所需上传的所有采集数据配置信息,包括采集数据项指标名称、生产工序编码、工序单元编码、采集对象类型编码、能源分类和分项编码、用途编码、数据采集来源编码、采集数据最大值、采集数据最小值、采集频率编码、采集系统名称、备注、采集数据范围编码等,按照GB/T 37947.1执行。d)用能单位基
20、本信息:能耗在线监测端设备所在重点用能单位的基本信息,按照GB/T 37947.1执行。6.3.4.2返回信息省级平台返回如下信息:a)返回码:请求状态说明代码,返回码说明见表 1;b)状态提示:对返回码的说明,状态提示说明见表 1。6.3.5用能单位采集数据上传接口6.3.5.1发送信息用能单位采集数据上传应提供如下信息:a)设备序列号“GUID”:GUID 为端设备统一编码,为32位,由省级平台统一生成并下发;b)用能单位统一社会信用代码:统一社会信用代码为18位,按照GB 32100执行;c)采集数据的具体信息:包括上传数据项编码、数据项的值、数据有效性、数据范围、数据采集类型、数据采集
21、频率、数据统计时间、数据上传时间等。6.3.5.2返回信息DB21/T 379220237省级平台返回如下信息:a)返回码:请求状态说明代码,返回码说明见表 1;b)状态提示:对返回码的说明,状态提示说明见表1。7省级平台与其他应用平台的数据传输接口7.1总述省级平台与其他应用平台数据交换或共享应使用接口调用方式进行。调用时应使用安全加密传输请求服务,通过用户名和密码进行认证并在数据输入输出时进行加密解密操作。数据传输接口构成如图3所示。图 3 省级平台与其他应用平台的数据传输接口构成7.2功能要求7.2.1地区能耗统计数据接口获取特定地区的能耗统计数据。接口示例参见附录C的C.1。7.2.2
22、行业能耗统计数据接口获取特定行业的能耗统计数据。接口示例参见附录C的C.2。7.2.3地区重点项目信息数据接口获取特定地区下的所有重点项目信息。接口示例参见附录C的C.3。7.2.4行业重点项目信息数据接口DB21/T 379220238获取特定行业下的所有重点项目信息。接口示例参见附录C的C.4。7.2.5地区企业基础信息接口获取特定地区的企业基础信息。接口示例参见附录C的C.5。7.2.6行业企业基础信息接口获取特定行业的企业基础信息。接口示例参见附录C的C.6。7.3信息描述7.3.1地区能耗统计数据接口7.3.1.1发送信息地区能耗统计数据接口应提供如下信息:a)用户名:请求接口调用的
23、用户名;b)密码:请求接口调用的密码;c)数据周期:请求的数据周期,分为day、month、year三种;d)数据开始时间,请求的数据开始时间戳,精确到毫秒;e)数据结束时间,请求的数据结束时间戳,精确到毫秒;f)数据来源:请求的数据来源,分为online(在线数据)、report(填报数据)两种;g)行政区划代码:请求的数据所属行政区划代码,详见中华人民共和国行政区划代码GB/T 2260。7.3.1.2返回信息地区能耗统计数据接口返回值包含如下信息:a)返回码:详见表 1;b)状态提示:对返回码的说明,状态提示说明见表 1;c)能耗统计数据原始量:保留两位小数;d)能耗统计数据折标量:保留
24、两位小数;e)计量单位:能耗统计数据计量单位。7.3.2行业能耗统计数据接口7.3.2.1发送信息行业能耗统计数据接口应提供如下信息:a)用户名:请求接口调用的用户名;b)密码:请求接口调用的密码;c)数据周期:请求的数据周期,分为 day、month、year 三种;d)数据开始时间,请求的数据开始时间戳,精确到毫秒;e)数据结束时间,请求的数据结束时间戳,精确到毫秒;f)数据来源:请求的数据来源,分为 online(在线数据)、report(填报数据)两种;g)行业编码:请求的数据所属行业编码,参见附录 B 的 B.1。7.3.2.2返回信息DB21/T 379220239行业能耗统计数据
25、接口返回值包含如下信息:a)返回码:详见表 1;b)状态提示:对返回码的说明,状态提示说明见表 1;c)能耗统计数据原始量:保留两位小数;d)能耗统计数据折标量:保留两位小数;e)计量单位:能耗统计数据计量单位。7.3.3地区重点项目信息数据接口7.3.3.1发送信息地区重点项目信息数据接口应提供如下信息:a)用户名:请求接口调用的用户名;b)密码:请求接口调用的密码;c)行政区划代码:请求的数据所属行政区划代码参见附录B的B.1。7.3.3.2返回信息地区重点项目信息数据接口返回值包含如下信息:a)返回码:详见表 1;b)状态提示:对返回码的说明,状态提示说明见表1;c)项目名称:重点项目名
- 1.请仔细阅读文档,确保文档完整性,对于不预览、不比对内容而直接下载带来的问题本站不予受理。
- 2.下载的文档,不会出现我们的网址水印。
- 3、该文档所得收入(下载+内容+预览)归上传者、原创作者;如果您是本文档原作者,请点此认领!既往收益都归您。
下载文档到电脑,查找使用更方便
5000 积分 0人已下载
下载 | 加入VIP,交流精品资源 |
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB21 3792-2023 重点用能单位能耗在线监测大数据分析平台数据接口规范 3792 2023 重点 单位 能耗 在线 监测 数据 分析 平台 接口 规范
