DB53/T 1027-2021 重点用能单位能耗在线监测平台数据接口规范

ICS35.020

L73

云南省地方标准

DB53/T1027—2021

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

数据接口规范

2021-04-08发布2021-07-08实施

云南省市场监督管理局发布

DB53/T1027—2021

前言

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

起草。

本标准由云南省计量测试技术研究院、云南省节能监察中心提出。

本文件由云南省节能标准化技术委员会（YNTC11）归口。

本文件由云南省计量测试技术研究院、云南省节能监察中心、昆明理工大学起草。

本文件主要起草人：杨波、朱道飞、普麟、徐万成、周晓春、吴佩林、陈雪雷、吴玉鲲、陈丹晖、

李志娟、尹建川、孙晓明。

I

DB53/T1027—2021

重点用能单位能耗在线监测平台数据接口规范

1范围

本文件确立了重点用能单位与省级平台数据交换相关术语与定义、数据接口授权、数据接口规范都

能内容。

本文件适用于重点用能单位与省级平台数据交换，数据交换内容包括重点用能单位基本信息、能源

计量器具信息、计量数据、能耗统计数据、能效指标数据等。

2规范性引用文件

本文件没有规范性引用文件。

3术语和定义

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

3.1

重点用能单位

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

政府管理节能工作的部门指定的年综合能源消费总量五千吨标准煤以上（含五千吨）、不满一万吨标准

煤的用能单位。

3.2

省级平台

省级平台（重点用能单位能耗在线监测平台）是部署在省级节能相关部门，接收、存储、汇总、分

析本地内重点用能单位能耗在线监测数据，为本地相关政府部门、重点用能单位提供服务的系统。

3.3

端系统

对重点用能单位能源转换、输配、利用和回收实施动态监测和管理的信息系统，实现数据采集、分

析、汇总、上传等功能。

3.4

JSON

JSON(JavaScriptObjectNotation)是一种轻量级的数据交换格式。它基于ECMAScript(欧洲计算机协

会制定的js规范)的一个子集，采用完全独立于编程语言的文本格式来存储和表示数据。

3.5

XML

XML(ExtensibleMarkupLanguage)，可扩展标记语言，标准通用标记语言的子集，是一种用于标

记电子文件使其具有结构性的标记语言。它可以用来标记数据、定义数据类型，是一种允许用户对自己

的标记语言进行定义的源语言。它被设计用于存储和传输数据。

1

DB53/T1027—2021

3.6

AK

AK(AccessKey)是省级平台生成的一串字符串，用作端系统进行请求的一个令牌，当端系统申请AK

后，省级平台生成一个AK(Token),并将此AK返回给端系统，端系统只需带上这个AK来请求接口，而无需

带上用户名和密码。

3.7

SM4算法

SMS4分组加密算法是中国无线标准中使用的分组加密算法，在2012年已经被国家商用密码管理局确

定为国家密码行业标准，标准编号GM/T0002-2012并且改名为SM4算法，与SM2椭圆曲线公钥密码算法，

SM3密码杂凑算法共同作为国家密码的行业标准，在我国密码行业中有着极其重要的位置。

SMS4算法的分组长度为128bit，密钥长度也是128bit。加解密算法均采用32轮非平衡Feistel迭代

结构，该结构最先出现在分组密码LOKI的密钥扩展算法中。SMS4通过32轮非线性迭代后加上一个反序变

换，这样只需要解密密钥是加密密钥的逆序，就能使得解密算法与加密算法保持一致。SMS4加解密算法

的结构完全相同，只是在使用轮密钥时解密密钥是加密密钥的逆序。

3.8

PIN

PIN（PersonalIdentificationNumber），端系统使用该个人鉴别码访问省级平台。

3.9

PINBLOCK

对PIN进行加密时，由于PIN长度一般不符合加密算法的固定分组长度要求，对PIN进行填充,使之达

到一个分组的长度，填充后的PIN的分组数据块,称之为PINBLOCK。

3.10

IV

IV（InitializationVector），初始化向量或译初向量，又称初始变量（StartingVariable，缩写为

SV），是一个固定长度的输入值。一般的使用上会要求它是随机数或拟随机数（pseudorandom）。

4数据接口授权

为保证数据在网络传输过程中的安全,接口采用省级平台交互身份认证的令牌AK进行接口授权。

5数据接口规范

5.1数据交换流程

端系统数据交换流程如图1所示，具体分为以下几步：

a)端系统接入申请：向省级平台提交数据接入申请，在省级平台注册端系统，获得后续与省级平

台连接和交换数据的AK；

b)平台版本校验：端系统与省级平台进行当前版本一致性校验。校验不通过时，端系统应先从省

级平台下载基础数据并更新本地数据，确保端系统与省级平台当前版本一致，才能进行后续数

据交换；

c)平台基础配置地址更新：省级平台的平台服务信息更改后，端系统应支持重新获取平台基础配

置信息并更新相关配置；

d)平台基础数据下载：平台基础数据变更后，端系统应支持重新下载平台基础数据；

2

DB53/T1027—2021

e)重点用能单位数据上传：实现重点用能单位基础数据、采集配置数据和采集数据的上传。

端系统

安装部署

端系统注册申请

申请失败返回码验证

申请成功

端系统注册基础数据下载

端系统注册申请

端系统接入申请

申请失败返回码验证

申请成功

端系统获取AK

返回码验证获取失败

获取成功

平台版本校验平台版本校验版本变更

版本无变更

配置地址变更是

用能单位基础数据上传平台基础配置地址更新

更新配置地址

上传失败返回码验证否

上传成功

下载基础数据

用能单位采集配置数据上传

重点用能单位数据上传下载失败

返回码验证平台基础配置数据下载

上传失败返回码验证

下载完成

上传成功

本地保存处理

用能单位采集数据上传

返回码验证上传失败

上传成功

完成

图1端系统数据交换流程图

5.2接口调用规范

所有接口以http方式，通过post请求提供调用服务，调用方式如下：

http://[server]/[service]?[params]

参数含义：

server：提供接口的服务器信息(地址和端口)；

3

DB53/T1027—2021

service：调用接口所提供的服务名称；

params:调用接口服务所需要的参数,通过post请求传送。

调用示例:

http请求post方式：

http://localhost:81/ng-dc-s/termReg

服务器(端口和地址)：localhost:81

服务名称：ng-dc-s/termReg

所需参数：

{

"enterpriseCode":"913300005739XXXX3F",//统一社会信用代码

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

}

5.3数据交换格式

重点用能单位端系统与省级平台数据交换格式采用JSON。省级平台返回响应码见附表A.1所示。

6数据交换接口

6.1数据交换接口字段要求

下述数据交换接口中，使用“*”标注的字段均为必填字段。

6.2端系统接入管理

6.2.1端系统申请工作密钥

端系统向省级平台进行端系统工作密钥申请，省级平台返回工作密钥，用于后续接口交换安全。

报文接口示例，见附表B.1端系统申请工作密钥报文接口示例表。

报文字段规则，见表1。

表1报文字段规则表

序号字段名称长度备注

1enterpriseCode统一社会信用代码18*

2secretKey工作密钥32首次申请工作密钥为空

6.2.2端系统注册基础数据下载

端系统申请并成功获得工作密钥后，在进行端系统注册申请前，应选择从省级平台下载行政区划代

码、行业编码及重点用能单位类型编码等基础数据。

报文接口示例，见附表B.2端系统注册基础数据下载报文接口示例表。

报文字段规则，见表2。

4

DB53/T1027—2021

表2报文字段规则表

序号字段名称长度备注

1enterpriseCode统一社会信用代码18*

2itemIndex基础数据表编码*，1：行政区划代码

2：行业编码

16：重点用能单位类型编码

3data平台基础数据省级平台返回的数据

6.2.3端系统注册申请

端系统下载注册基础数据后，端系统项省级平台申请注册，审核通过后，重点用能单位端系统可接

入平台，并使用数据接口。

报文接口示例，见附表B.3端系统注册申请报文接口示例表。

报文字段规则，见表3。

表3报文字段规则表

序号字段名称长度备注

1enterpriseCode统一社会信用代码18*

2isorg是否是公共机构1*，0：不是；1：是

3password省级平台访问密码64*

4cmpName单位名称30*

5address地址50*

6zipCode邮编6

7corporationName法人代表30*

8regionCode行政区划代码*，具体到县级

9license营业执照400k*，使用Base64编码

10organization组织结构图400k使用Base64编码

11registerAddress注册地址50*

12registerDate注册日期*，yyyy-MM-dd

13registerPrincipa注册资金10*，单位为万元

l

14typeCode单位类型50*，参考用能单位类型编码表

15industryCode行业编码10*，参考行业编码表

16fieldCode领域编码3*，100：工业；200：交通运输、仓储

和邮政业；300：住宿和餐饮业；400：

批发和零售业；500：教育；600：其他

5

DB53/T1027—2021

表3（续）

序号字段名称长度备注

17energyConsumeLev重点用能单位耗能级1*，1：5000吨以下

el别2：5000~10000吨

3：1万-10万吨

4：10万-50万吨

5；50万-300万吨

6：300万吨以上

18center是否央企1*，0：不是；1：是

19jgzh是否能源加工转换类1*，0：不是；1：是

重点用能单位

20latitude厂址中心纬度25*

21longitude厂址中心经度25*

22phone联系电话(法人)13*

23fax传真13

24email电子邮箱（法人）30

25url用能单位网站地址30

26productionLine主要生产线名称255*

27leadingProduct主导产品100*

28groupName集团名称50央企需要填写

29groupAddress集团地址50央企需要填写

30orgType机构类型3*，01：国家机关

02：事业单位

021：教育事业

022：科技事业

023：文化事业

024：卫生事业

025：体育事业

026：其它

03：团体组织

31orgCode组织机构代码9

remark备注255

6.2.4端系统修改平台访问密码

端系统向省平台申请注册，并通过审核后，省级平台允许端系统根据业务要求，对端系统访问省级

平台的访问进行修改。

报文接口示例，见附表B.4端系统修改平台访问密码报文接口示例表。

报文字段规则，见表4。

6

DB53/T1027—2021

表4报文字段规则表

序号字段名称长度备注

1dataIndex企业注册记录索引号64*

2enterpriseCode统一社会信用代码18*

3currentPassword省级平台原访问密码64*

4newPassword省级平台新访问密码64*

6.2.5端系统获取AK

端系统注册申请通过审核，可获取到访问省级平台的AK及重点用能单位数据交换时间。

报文接口示例，见附表B.5端系统获取AK报文接口示例表。

报文字段规则，见表5。

表5报文字段规则表

序号字段名称长度备注

1enterpriseCode统一社会信用代码18*

2password省级平台访问密码64*

3akExpiresIn到期时间yyyy-MM-ddHH:mm:ssSSS

4akValidAt启用时间yyyy-MM-ddHH:mm:ssSSS

5enterpriseUploadTime数据交换时间段HH:mm:ss

6platformURL平台版本校验地址100

7token访问省级平台AK230

6.3平台版本校验

省级平台的平台服务信息或基础数据更改后，版本信息会进行更新。端系统可基于此接口确认省级

平台最新版本信息，确认端系统本地基础信息是否需要进行更新。

报文接口示例，见附表B.6平台版本校验报文接口示例表。

报文字段规则，见表6。

表6报文字段规则

序号字段名称长度备注

1AK访问省级平台AK230*

2enterpriseCode统一社会信用代码18*

3dicVersion平台基础数据版本10

4regVersion平台基础配置版本10

5loadPlatformDataURL平台基础配置查询地址100

6modifyDescription版本变更简述255

6.4平台基础配置地址更新

省级平台的平台服务信息或基础数据更改后，端系统基于版本信息，可重新获取平台基础配置信息。

平台基础配置信息包含，但不限于以下信息：

a)基础数据下载地址：用于接入端系统基础数据下载；

7

DB53/T1027—2021

b)重点用能单位基础信息配置上传地址：用于重点用能单位基础信息上传至省级平台；

c)采集数据上传地址：用于重点用能单位采集数据上传至省级平台；

d)重点用能单位基础信息配置下载地址：用于从省级平台下载重点用能单位基础信息；

e)采集数据下载地址：用于从省级平台下载重点用能单位采集数据。

能源资源数据交换地址：用于重点用能单位采集数据上传至省级平台：

a)报文接口示例，见附表B.7平台基础配置地址更新报文接口示例表；

b)报文字段规则，见表7。

表7报文字段规则表

序号字段名称长度备注

1enterpriseCode统一社会信用代码18*

2enterpriseDataDownloadURL耗数据下载地址100

3enterpriseDataURL能耗数据交换地址100

4enterpriseInfoDownloadURL基础信息配置下载地址100

5enterpriseInfoURL基础信息配置交换地址100

6loadBaseDataURL基础数据下载地址100

6.5平台基础数据下载

省级平台的基础数据更改后，端系统比较本地的基础数据版本信息与省级平台不一致，应重新下载

基础数据。

报文接口示例，见附表B.8平台基础数据下载报文接口示例表。

报文字段规则，见表8。

表8报文字段规则表

序号字段名称长度备注

1enterpriseCode统一社会信用代码18*

2itemIndex基础数据表编码*，1：行政区划代码

2：行业编码

3：生产工序编码

4：工序单元编码

5：用能设备编码

6：数据采集来源类型编码

7：采集数据类型编码

8：能源品种编码计量单位及精度

9：耗能工质编码计量单位及精度

10：非能源类产品及计量单位(包含平

台预定义编码及重点用能单位自定义

编码)

11：能效指标编码及计量单位

12：经营指标编码及计量单位

13：其它数据编码

8

DB53/T1027—2021

表8（续）

序号字段名称长度备注

14：能源用途编码

15：计量器具编码

16：重点用能单位类型编码

17：重点用能设备分类编码

3data平台基础数据省级平台返回的数据

6.6重点用能单位能耗数据交换

6.6.1重点用能单位基础数据上传

重点用能单位联系人信息

端系统根据省平台要求上传重点用能单位联系人姓名、电话、所在部门、职位、传真、邮箱等信息：

报文接口示例，见附表B.9新增重点用能单位联系人报文接口示例表；

报文字段规则，见表9。

表9报文字段规则表

序号字段名称长度备注

1regVersion平台服务版本10*

2dicVersion基础数据版本10*

3enterpriseCode统一社会信用代码18*

4contacterName姓名15*

5phone电话13*

6dept所在部门20*

7job职位、或者岗位15

8fax传真13

9email邮件30

10remark备注255

11dataIndex记录索引号64由端系统保存

重点用能单位能源管理体系信息

端系统根据省级平台要求上传重点用能单位名称、主管节能领导姓名、主管节能领导职位、是否通

过能源管理体系认证，能管负责人姓名、能管负责人电话、认证日期、认证机构等信息。

报文接口示例，见附表B.10新增重点用能单位能源管理体系报文接口示例表。

报文字段规则，见表10。

表10报文字段规则表

序号字段名称长度备注

1regVersion平台服务版本10*

2dicVersion基础数据版本10*

9

DB53/T1027—2021

表10（续）

序号字段名称长度备注

3dataIndex记录索引号64由端系统保存

4remark备注255

5enterpriseCode统一社会信用代码18*

6energyOffice能源管理机构50*

7energyOfficial主管节能领导姓名20*

8energyOfficialPosition主管节能领导职位20*

9phone电话13*

10fax传真13

重点用能单位能源管理人员信息

端系统根据省平台要求上传重点用能单位名称、管理人员名称、管理人员电话、所在部门、职位、

培训或取证情况，备注等信息。

报文接口示例，见附表B.11新增重点用能单位能源管理人员报文接口示例表。