DB21/T 3792-2023 重点用能单位能耗在线监测大数据分析平台数据接口规范

ICS29.240.01

CCSF21

21

辽宁省地方标准

DB21/T3792—2023

重点用能单位能耗在线监测大数据分析平

台数据接口规范

Datainterfacespecificationofbigdataanalysisplatformforonline

monitoringofenergyconsumptionofkeyenergyusers

2023-08-30发布2023-09-30实施

辽宁省市场监督管理局发布

DB21/T3792—2023

目次

前言..................................................................................II

1范围.................................................................................1

2规范性引用文件.......................................................................1

3术语和定义...........................................................................1

4缩略语...............................................................................2

5通信框架.............................................................................2

5.1总体结构.........................................................................2

5.2通信模式.........................................................................3

5.3通信协议.........................................................................3

6省级平台与能耗在线监测端设备的数据传输接口...........................................3

6.1总述.............................................................................3

6.2功能要求.........................................................................3

6.3信息描述.........................................................................4

7省级平台与其他应用平台的数据传输接口.................................................7

7.1总述.............................................................................7

7.2功能要求.........................................................................7

7.3信息描述.........................................................................8

附录A（资料性）省级平台与能耗在线监测端设备的数据传输接口示例......................11

附录B（规范性）能耗在线监测系统基础信息与格式规范..................................23

附录C（资料性）省级平台与其他应用平台的数据传输接口................................28

I

DB21/T3792—2023

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任

本文件由辽宁省发展和改革委员会提出并归口。

本文件起草单位：辽宁省大数据管理中心（辽宁省信息中心）、青岛高校信息产业股份有限公

司、沈阳工业大学、辽宁省节能监察服务中心、辽宁省市场监管事务服务中心、大连市市场监管综

合行政执法队能源大队、大连理工大学能源与动力学院、大连辉创信息技术有限公司、辽宁碳科能

信科技有限公司。

本文件主要起草人：苏乃锋、张丽霞、李洪涛、蒲云鹏、李国良、丛明、兰莹、米欣、李宏岩、赵

亮、王长亮、袁泉、王林娜、侯越、年晓非、任成刚、孙醒坤、于永胜、杨田、马莹莹、李铎、郭伟、

朱琳卓、韩旭、邵思豪、吉新华、李享、汪东辉、宋小磊、高绪腾。

本文件发布实施后，任何单位和个人如有问题和意见建议，均可以通过来电或来函等方式进行反馈，

我们将及时答复并认真处理，根据实际情况依法进行评估及复审。

归口管理单位：辽宁省发展和改革委员会，通讯地址：沈阳市皇姑区北陵大街45-2楼623室，联系

电话：024-86892950。

起草单位：辽宁省大数据管理中心（辽宁省信息中心），通讯地址：辽宁省沈阳市和平区市府大路

187号328室，联系电话：13889880931。

II

DB21/T3792—2023

重点用能单位能耗在线监测

大数据分析平台数据接口规范

1范围

本文件规定了重点用能单位能耗在线监测大数据分析平台数据传输过程的应用层通信协议与数据

接口规范，本文件不限制系统扩展其他的信息内容，在扩展内容时不得与本规范中所使用或保留的控制

命令相冲突。

本文件适用于重点用能单位能耗在线监测大数据分析平台和端设备、省政务信息共享交换平台等其

他应用平台之间的数据交换传输。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T2260中华人民共和国行政区划代码

GB/T4754国民经济行业分类

GB/T25070信息安全技术网络安全等级保护安全设计技术要求

GB32100法人和其他组织统一社会信用代码编码规则

GB/T37947.1信息技术用能单位能耗在线监测系统第1部分：端设备数据传输接口

GB/T38692用能单位能耗在线监测技术要求

GB/T39786信息安全技术信息系统密码应用基本要求

3术语和定义

下列术语和定义适用于本文件。

3.1

重点用能单位keyenergyusers

重点用能单位指年综合能源消费总量一万吨标准煤以上（含一万吨）的用能单位或国务院有关部门、

省、自治区、直辖市人民政府管理节能工作的部门指定的年综合能源消费总量五千吨标准煤以上（含五

千吨）、不满一万吨标准煤的用能单位。

3.2

省级平台provincialplatform

省级平台是指辽宁省重点用能单位能耗在线监测大数据分析平台。负责接收、存储、汇总、分析本

地区内重点用能单位能耗在线监测数据，为各级节能主管部门、重点用能单位提供应用服务。

3.3

端设备device

部署在重点用能单位，用于采集、分析、汇总重点用能单位能耗数据并将数据上传到省级平台的设

备。

1

DB21/T3792—2023

3.4

其他应用平台otherapplicationplatforms

与省级平台进行数据交换共享的其他独立运行的应用系统，简称“其他应用平台”。

3.5

通信协议communicationprotocol

指实现通信的双方实体完成通信或服务所必须遵循的规则和约定。协议定义了数据单元使用的格式，

信息单元应该包含的信息与含义，连接方式，信息发送和接收的时序，从而确保网络中数据从发送方顺

利地传送到接收方，并被正确识别。

本文件主要定义应用层协议。

3.6

在线直接采集onlinedirectcollection

通过对接智能仪表、工业控制系统、生产监控管理系统、管理信息系统等，将重点用能单位的能耗

数据采集到端设备，数据汇总处理后自动传输到省级平台。

3.7

数据传输接口datatransmissioninterface

省级平台和端设备、省政务信息共享交换平台及其他应用平台实现数据传输所规定的一组约定。

4缩略语

下列缩略语适用于本文件。

HTTPS：安全超文本传输协议（HyperTextTransferProtocolSecure）

JSON:对象表示法(JavaScriptObjectNotation)

CA:证书授权中心（CertificateAuthority)

XML：可扩展标记语言（ExtensibleMarkupLanguage）

TCP/IP：传输控制协议/因特网互联协议（TransmissionControlProtocol/InternetProtocol）

5通信框架

5.1总体结构

通过端设备，省级平台接收企业上传的能耗数据，对接收的数据进行汇总处理，按照统一约定与端

设备及其他应用平台进行数据传输共享。通信总体框架示意图如图1所示。

图1通信总体框架示意图

2

DB21/T3792—2023

5.2通信模式

省级平台与端设备以及省级平台与其他应用平台之间采用请求应答通信模式。由能耗在线监测端设

备或是其他应用平台发起，省级平台应答组成。

5.3通信协议

传输层基于TCP/IP协议。

应用层基于HTTPS协议,在应用层传输的业务数据采用JSON交换格式,数据交换采用的格式见第6章、

第7章。

6省级平台与能耗在线监测端设备的数据传输接口

6.1总述

能耗在线监测端设备需采用统一要求的CA数字证书进行身份验证，通过身份验证后才能接入省级平

台。能耗在线监测端设备将重点用能单位数据经互联网上传至省级平台时，需同时采用VPN通道及HTTPS

协议进行安全加密传输。

数据传输接口构成如图2所示。

图3省级平台与其他应用平台的数据传输接口构成

6.2功能要求

6.2.1端设备注册接口

能耗在线监测端设备完成物理部署、接入网络并运行后，进行端设备注册。省级平台负责提供URL

地址，并返回数据上传时间点要求（平台按照企业端注册顺序逐个返回上传时间），端设备需要按照此

时间点上传数据。

3

DB21/T3792—2023

接口示例参见附录A的A.1。

6.2.2基础数据下载接口

能耗在线监测端设备注册成功后，对能耗在线监测端设备系统进行初始化配置，包括用能单位基础

信息、数据接入配置信息和相应的数据编码等。

接口示例参见附录A的A.2。

6.2.3平台版本校验接口

省级平台的注册服务信息或基础数据更改后，相应版本信息进行更新。能耗在线监测端设备基于此版

本信息，重新注册或下载基础数据。

接口示例参见附录A的A.3。

6.2.4用能单位基础信息上传接口

能耗在线监测端设备完成设备初始化配置后，上传用能单位的基础信息至省级平台。

接口示例参见附录A的A.4。

6.2.5用能单位采集数据上传接口

用能单位采集上传的数据指标分为每日采集上传到省级平台的数据指标和每月采集上传到省级平

台的数据指标。

每日采集上传的数据指标包括每日指标和实时指标两类。每日指标为结算日00:00-24:00企业的能

源总量指标；对于在线采集的数据，上传实时指标。实时指标为每间隔15分钟采集一次的能源消耗实时

数据（为消耗数据，非累计值。如对于电表，采集保存数据=电表显示累计电量n-电表显示累计电量n-1）

并保存在本地，在指定的数据上传时间与每日上报数据一同上传到省级平台。

企业每月采集上传的数据指标包括企业每月能源总量指标（企业各能源品种的购进量、外供量、期

初库存、期末库存、综合能源消费量）、重点工段每月能源消费量指标、企业经济指标。

用能单位将数据进行汇总打包后，每日在指定的数据上传时间将本批次数据上传至省级平台。省级

平台成功接收本批次数据后，返回一个成功反馈消息，如果超时还未收到反馈或反馈为失败，则端设备

重发，若重发3次还未成功，则端设备将本批次数据保存在队列中，下次上传数据时再次重发，直至成

功。

接口示例参见附录A的A.5。

6.3信息描述

6.3.1端设备注册接口

发送信息

端设备注册应提供如下信息：

a)用能单位统一社会信用代码按照GB32100执行，统一社会信用代码为18位；

b)用能单位所在行政区域的行政区划代码按照GB/T2260执行，行政区划代码为6位；

c)用能单位名称（全称）；

d)用能单位所在行政区域的行政区划名称按照GB/T2260执行。

返回信息

4

DB21/T3792—2023

省级平台返回如下信息：

a)返回码：返回码说明见表1；

b)状态提示：对返回码的说明，状态提示说明见表1；

c)设备序列号“GUID”：GUID为端设备统一编码，为32位，由省级平台统一生成并下发；

d)基础数据下载地址：用于端设备基础数据下载，如IP:port/downloadBaseData；

e)省级平台版本校验地址：用于平台版本校验，如IP:port/versionCheck；

f)用能单位基础信息配置上传地址：用于用能单位基础信息上传至省级平台，如

IP:port/uploadConfigData；

g)用能单位采集数据上传地址：用于用能单位采集数据上传至省级平台，如

IP:port/uploadEnergyData；

h)用能单位基础信息配置下载地址：用于从省级平台下载用能单位基础信息，如

IP:port/downloadConfigData；

i)用能单位采集数据下载地址：用于从省级平台下载用能单位采集数据，如

IP:port/downloadEnergyData；

j)上报时间点：用于规定用能单位上传数据至省级平台的时间，格式为：HH:MM:SS。

表1返回码说明

返回码状态提示说明备注

0请求成功

E1001平台服务异常请求失败

E1002服务器数据库异常，联系省级平台管理员请求失败

E2001请求参数异常，缺少必填项请求失败

E2002请求参数异常，参数格式不合法请求失败

6.3.2基础数据下载接口

发送信息

a)能耗在线监测端设备发起基础数据下载应提供设备序列号“GUID”：GUID为端设备统一编码，

为32位，由省级平台统一生成并下发;

b)选择基础数据类型：基础数据类型包含全部类型、行政区划、行业、单位类别编码、采集系

统分类、生产工序、采集数据项、采集数据项数据用途、能源类型等选项，参加附录A的A.6。

返回信息

省级平台返回如下信息：

a)返回码：请求状态说明代码，返回码说明见表1；

b)状态提示：对返回码的说明，状态提示说明见表1；

c)行政区划代码：参见附录B的B.1;

d)行业代码：参见附录B的B.1;

e)单位类别编码：企业登记注册类别与代码说明，参见附录A的A.7;

f)采集数据项编码：采集数据类型、能源品种、新能源指标及碳指标等编码规则参见附录B;

5

DB21/T3792—2023

g)采集数据项数据用途：采集数据项见附录B;

h)产品指标：单位产品能耗指标项的信息见附录B。

6.3.3平台版本校验接口

发送信息

能耗在线监测端设备发起省级平台版本校验应提供：设备序列号“GUID”，GUID为端设备统一编码，

为32位，由省级平台统一生成并下发。

返回信息

省级平台返回值包含如下信息：

a)返回码：请求状态说明代码，返回码说明见表1；

b)状态提示：对返回码的说明，状态提示说明见表1；

c)省级平台注册服务版本信息：为省级平台注册服务的版本编号，如125；

d)省级平台基础数据版本信息：为省级平台基础数据的版本编号，如125；

e)能耗在线监测端设备定期检查本地基础信息是否已更新，检查周期至少每天一次。

6.3.4用能单位基础信息上传接口

发送信息

用能单位基础信息上传应提供如下信息：

a)设备序列号“GUID”：GUID为端设备统一编码，为32位，由省级平台统一生成并下发。

b)用能单位统一社会信用代码：统一社会信用代码为18位，按照GB32100执行。

c)采集数据项配置信息：能耗在线监测端设备所需上传的所有采集数据配置信息，包括采集数据

项指标名称、生产工序编码、工序单元编码、采集对象类型编码、能源分类和分项编码、用途

编码、数据采集来源编码、采集数据最大值、采集数据最小值、采集频率编码、采集系统名称、

备注、采集数据范围编码等，按照GB/T37947.1执行。

d)用能单位基本信息：能耗在线监测端设备所在重点用能单位的基本信息，按照GB/T37947.1

执行。

返回信息

省级平台返回如下信息：

a)返回码：请求状态说明代码，返回码说明见表1；

b)状态提示：对返回码的说明，状态提示说明见表1。

6.3.5用能单位采集数据上传接口

发送信息

用能单位采集数据上传应提供如下信息：

a)设备序列号“GUID”：GUID为端设备统一编码，为32位，由省级平台统一生成并下发；

b)用能单位统一社会信用代码：统一社会信用代码为18位，按照GB32100执行；

c)采集数据的具体信息：包括上传数据项编码、数据项的值、数据有效性、数据范围、数据采集

类型、数据采集频率、数据统计时间、数据上传时间等。

返回信息

6

DB21/T3792—2023

省级平台返回如下信息：

a)返回码：请求状态说明代码，返回码说明见表1；

b)状态提示：对返回码的说明，状态提示说明见表1。

7省级平台与其他应用平台的数据传输接口

7.1总述

省级平台与其他应用平台数据交换或共享应使用接口调用方式进行。调用时应使用安全加密传输请

求服务，通过用户名和密码进行认证并在数据输入输出时进行加密解密操作。

数据传输接口构成如图3所示。

图3省级平台与其他应用平台的数据传输接口构成

7.2功能要求

7.2.1地区能耗统计数据接口

获取特定地区的能耗统计数据。接口示例参见附录C的C.1。

7.2.2行业能耗统计数据接口

获取特定行业的能耗统计数据。接口示例参见附录C的C.2。

7.2.3地区重点项目信息数据接口

获取特定地区下的所有重点项目信息。接口示例参见附录C的C.3。

7.2.4行业重点项目信息数据接口

7

DB21/T3792—2023

获取特定行业下的所有重点项目信息。接口示例参见附录C的C.4。

7.2.5地区企业基础信息接口

获取特定地区的企业基础信息。接口示例参见附录C的C.5。

7.2.6行业企业基础信息接口

获取特定行业的企业基础信息。接口示例参见附录C的C.6。

7.3信息描述

7.3.1地区能耗统计数据接口

发送信息

地区能耗统计数据接口应提供如下信息：

a)用户名：请求接口调用的用户名;

b)密码：请求接口调用的密码;

c)数据周期：请求的数据周期，分为day、month、year三种;

d)数据开始时间，请求的数据开始时间戳，精确到毫秒;

e)数据结束时间，请求的数据结束时间戳，精确到毫秒;

f)数据来源：请求的数据来源，分为online（在线数据）、report（填报数据）两种;

g)行政区划代码：请求的数据所属行政区划代码，详见《中华人民共和国行政区划代码

》GB/T2260。

返回信息

地区能耗统计数据接口返回值包含如下信息：

a)返回码：详见表1;

b)状态提示：对返回码的说明，状态提示说明见表1;

c)能耗统计数据原始量：保留两位小数;

d)能耗统计数据折标量：保留两位小数;

e)计量单位：能耗统计数据计量单位。

7.3.2行业能耗统计数据接口

发送信息

行业能耗统计数据接口应提供如下信息：

a)用户名：请求接口调用的用户名;

b)密码：请求接口调用的密码;

c)数据周期：请求的数据周期，分为day、month、year三种;

d)数据开始时间，请求的数据开始时间戳，精确到毫秒;

e)数据结束时间，请求的数据结束时间戳，精确到毫秒;

f)数据来源：请求的数据来源，分为online（在线数据）、report（填报数据）两种;

g)行业编码：请求的数据所属行业编码，参见附录B的B.1。

返回信息

8

DB21/T3792—2023

行业能耗统计数据接口返回值包含如下信息：

a)返回码：详见表1;

b)状态提示：对返回码的说明，状态提示说明见表1;

c)能耗统计数据原始量：保留两位小数;

d)能耗统计数据折标量：保留两位小数;

e)计量单位：能耗统计数据计量单位。

7.3.3地区重点项目信息数据接口

发送信息

地区重点项目信息数据接口应提供如下信息：

a)用户名：请求接口调用的用户名;

b)密码：请求接口调用的密码;

c)行政区划代码：请求的数据所属行政区划代码参见附录B的B.1。

返回信息

地区重点项目信息数据接口返回值包含如下信息：

a)返回码：详见表1;

b)状态提示：对返回码的说明，状态提示说明见表1；

c)项目名称：重点项目名称;

d)项目代码：重点项目代码;

e)项目类型：重点项目类型;

f)所属地区：重点项目所属地区名称;

g)所属行业：重点项目所属行业名称;

h)分类处置：重点项目分类处置类型名称;

i)建设内容：重点项目详细建设内容;

j)建设地点：重点项目详细建设地点，至少精确到区县;

k)设计年综合能源消费量：重点项目批复的年综合能源消费量，计量单位吨标准煤。

7.3.4行业重点项目信息数据接口

发送信息

行业重点项目信息数据接口应提供如下信息：

a)用户名：请求接口调用的用户名;

b)密码：请求接口调用的密码;

c)行业编码：请求的数据所属行业编码参见附录B的B.1。

返回信息

行业重点项目信息数据接口返回值包含如下信息：

a)返回码：详见表1;

b)状态提示：对返回码的说明，状态提示说明见表1；

c)项目名称：重点项目名称;

d)项目代码：重点项目代码;

9

DB21/T3792—2023

e)项目类型：重点项目类型;

f)所属地区：重点项目所属地区名称;

g)所属行业：重点项目所属行业名称;

h)分类处置：重点项目分类处置类型名称;

i)建设内容：重点项目详细建设内容;

j)建设地点：重点项目详细建设地点，至少精确到区县;

k)设计年综合能源消费量：重点项目批复的年综合能源消费量，计量单位吨标准煤。

7.3.5地区企业基础信息接口

发送信息

地区企业基础信息接口应提供如下信息：

a)用户名：请求接口调用的用户名;

b)密码：请求接口调用的密码;

c)行政区划代码：请求的数据所属行政区划代码参见附录B的B.1。

返回信息

地区企业基础信息接口返回值包含如下信息：

a)返回码：详见表1;

b)状态提示：对返回码的说明，状态提示说明见表1；

c)企业基本信息：详见地区企业基础信息接口协议代码示例“RESPONSE”部分。

7.3.6行业企业基础信息接口

发送信息

行业企业基础信息接口应提供如下信息：

a)用户名：请求接口调用的用户名;

b)密码：请求接口调用的密码;

c)行业编码：请求的数据所属行业编码参见附录B的B.1。

返回信息

行业企业基础信息接口返回值包含如下信息：

a)返回码：详见表1;

b)状态提示：对返回码的说明，状态提示说明见表1；

c)企业基本信息：详见行业企业基础信息接口协议代码示例“RESPONSE”部分。

10

DB21/T3792—2023

A

A

附录A

（资料性）

省级平台与能耗在线监测端设备的数据传输接口示例

A.1端设备注册接口示例

能耗在线监测端设备注册接口示例见表A.1。

表A.1端设备注册接口示例

类型说明

URLhttps://[IP:port]，//固定的域名或IP，能耗在线监测系统注册平台

MethodPOST

{

"enterpriseCode":"9121000123456789X",//统一社会信用代码

"enterpriseName":"xxxx有限公司",//用能单位名称

Request"region":"210101",//行政区划代码，具体到县级

"regionName":"市辖区"//行政区划名称，具体到县级

}

{

"responseCode":“0”,//返回码

"responseMessage":"RECEIVESUCCESS",//状态提示

"deviceId":"0ef6ecea08bf84c7b639c3e9b84ed546",//设备序列号GUID

"loadConfigURL":"IP:port/downloadBaseData",//基础数据下载地址

“loadDicVersionURL”:“IP:port/versionCheck”,//平台版本下载地址

"centerInfoURL":IP:port/uploadConfigData",//用能单位基础信息配置上传地址

"centerDataURL":"IP:port/uploadEnergyData",//采集数据上传地址

"centerInfoDownloadURL":"IP:port/downloadConfigData",//用能单位基础信息配置下载地址

"centerDataDownloadURL":"IP:port/downloadEnergyData",//采集数据下载地址

"uploadTime":"01:05:00";//上报时间点

Response

}

11

DB21/T3792—2023

A.2基础数据下载接口示例

能耗在线监测端设备基础数据下载接口示例见表A.2。

表A.2基础数据下载接口示例

类型说明

URLhttps://[/downloadBaseData]，//省级平台基础数据下载地址

MethodPOST

{

"deviceId":"GUID",//从服务地址发布平台获取(必填)

REQUEST"type":"all",//从服务地址发布平台获取(非必填，默认全部)

}

{

"responseCode":“0”,//返回码

"responseMessage":"RECEIVESUCCESS",//状态提示

"data":{

"region":[//行政区划（参照GB/T2260）

{

"code":"210000",

"fullName":"辽宁省",

"name":"辽宁省",

"pcode":"000000",//上一级行政区划编码，全国以"000000"表示。

"type":1//1：省级，2：市级，3：县级

},

{

"code":"210100",

"fullName":"沈阳市",

RESPONSE

"name":"沈阳市",

"pcode":"210000",

"type":2

},

{

"code":"210101",

"fullName":"市辖区",

"name":"市辖区",

"pcode":"210100",

"type":3

}

],

12

DB21/T3792—2023

表A.2（续）

类型说明

"industry":[//行业（参照GB/T4754）

{

"code":"C",//行业编码

"fullName":"制造业",//行业全名

"jgzh":false,//是否能源加工转换类行业

"name":"制造业",//行业名称

"pcode":"0"//上一级行业编码

},

{

"code":"C31",

"fullName":"黑色金属冶炼和延压加工业",

"jgzh":false,

"name":"黑色金属冶炼和延压加工业","pcode":

"C"

},

{

"code":"C312",

"fullName":"炼钢",

"jgzh":false,"name":"

炼钢",

RESPONSE

"pcode":"C31"

},

{

"code":"C3120",

"fullName":"炼钢",

"jgzh":false,"name":"

炼钢",

"pcode":"C312"

}

],

"entType":[//单位类别编码(参照国统字〔1998〕200号文件)