ICS35.020

L73

云南省地方標準

DB53/T1027—2021

重點用能單位能耗在線監(jiān)測平臺

數據接口規(guī)范

2021-04-08發(fā)布2021-07-08實施

云南省市場監(jiān)督管理局發(fā)布

DB53/T1027—2021

前言

本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結構和起草規(guī)則》的規(guī)定

起草。

本標準由云南省計量測試技術研究院、云南省節(jié)能監(jiān)察中心提出。

本文件由云南省節(jié)能標準化技術委員會（YNTC11）歸口。

本文件由云南省計量測試技術研究院、云南省節(jié)能監(jiān)察中心、昆明理工大學起草。

本文件主要起草人：楊波、朱道飛、普麟、徐萬成、周曉春、吳佩林、陳雪雷、吳玉鯤、陳丹暉、

李志娟、尹建川、孫曉明。

I

DB53/T1027—2021

重點用能單位能耗在線監(jiān)測平臺數據接口規(guī)范

1范圍

本文件確立了重點用能單位與省級平臺數據交換相關術語與定義、數據接口授權、數據接口規(guī)范都

能內容。

本文件適用于重點用能單位與省級平臺數據交換，數據交換內容包括重點用能單位基本信息、能源

計量器具信息、計量數據、能耗統(tǒng)計數據、能效指標數據等。

2規(guī)范性引用文件

本文件沒有規(guī)范性引用文件。

3術語和定義

下列術語和定義適用于本文件。

3.1

重點用能單位

指年綜合能源消費總量一萬噸標準煤以上（含一萬噸）的用能單位或國務院有關部門、云南省人民

政府管理節(jié)能工作的部門指定的年綜合能源消費總量五千噸標準煤以上（含五千噸）、不滿一萬噸標準

煤的用能單位。

3.2

省級平臺

省級平臺（重點用能單位能耗在線監(jiān)測平臺）是部署在省級節(jié)能相關部門，接收、存儲、匯總、分

析本地內重點用能單位能耗在線監(jiān)測數據，為本地相關政府部門、重點用能單位提供服務的系統(tǒng)。

3.3

端系統(tǒng)

對重點用能單位能源轉換、輸配、利用和回收實施動態(tài)監(jiān)測和管理的信息系統(tǒng)，實現數據采集、分

析、匯總、上傳等功能。

3.4

JSON

JSON(JavaScriptObjectNotation)是一種輕量級的數據交換格式。它基于ECMAScript(歐洲計算機協(xié)

會制定的js規(guī)范)的一個子集，采用完全獨立于編程語言的文本格式來存儲和表示數據。

3.5

XML

XML(ExtensibleMarkupLanguage)，可擴展標記語言，標準通用標記語言的子集，是一種用于標

記電子文件使其具有結構性的標記語言。它可以用來標記數據、定義數據類型，是一種允許用戶對自己

的標記語言進行定義的源語言。它被設計用于存儲和傳輸數據。

1

DB53/T1027—2021

3.6

AK

AK(AccessKey)是省級平臺生成的一串字符串，用作端系統(tǒng)進行請求的一個令牌，當端系統(tǒng)申請AK

后，省級平臺生成一個AK(Token),并將此AK返回給端系統(tǒng)，端系統(tǒng)只需帶上這個AK來請求接口，而無需

帶上用戶名和密碼。

3.7

SM4算法

SMS4分組加密算法是中國無線標準中使用的分組加密算法，在2012年已經被國家商用密碼管理局確

定為國家密碼行業(yè)標準，標準編號GM/T0002-2012并且改名為SM4算法，與SM2橢圓曲線公鑰密碼算法，

SM3密碼雜湊算法共同作為國家密碼的行業(yè)標準，在我國密碼行業(yè)中有著極其重要的位置。

SMS4算法的分組長度為128bit，密鑰長度也是128bit。加解密算法均采用32輪非平衡Feistel迭代

結構，該結構最先出現在分組密碼LOKI的密鑰擴展算法中。SMS4通過32輪非線性迭代后加上一個反序變

換，這樣只需要解密密鑰是加密密鑰的逆序，就能使得解密算法與加密算法保持一致。SMS4加解密算法

的結構完全相同，只是在使用輪密鑰時解密密鑰是加密密鑰的逆序。

3.8

PIN

PIN（PersonalIdentificationNumber），端系統(tǒng)使用該個人鑒別碼訪問省級平臺。

3.9

PINBLOCK

對PIN進行加密時，由于PIN長度一般不符合加密算法的固定分組長度要求，對PIN進行填充,使之達

到一個分組的長度，填充后的PIN的分組數據塊,稱之為PINBLOCK。

3.10

IV

IV（InitializationVector），初始化向量或譯初向量，又稱初始變量（StartingVariable，縮寫為

SV），是一個固定長度的輸入值。一般的使用上會要求它是隨機數或擬隨機數（pseudorandom）。

4數據接口授權

為保證數據在網絡傳輸過程中的安全,接口采用省級平臺交互身份認證的令牌AK進行接口授權。

5數據接口規(guī)范

5.1數據交換流程

端系統(tǒng)數據交換流程如圖1所示，具體分為以下幾步：

a)端系統(tǒng)接入申請：向省級平臺提交數據接入申請，在省級平臺注冊端系統(tǒng)，獲得后續(xù)與省級平

臺連接和交換數據的AK；

b)平臺版本校驗：端系統(tǒng)與省級平臺進行當前版本一致性校驗。校驗不通過時，端系統(tǒng)應先從省

級平臺下載基礎數據并更新本地數據，確保端系統(tǒng)與省級平臺當前版本一致，才能進行后續(xù)數

據交換；

c)平臺基礎配置地址更新：省級平臺的平臺服務信息更改后，端系統(tǒng)應支持重新獲取平臺基礎配

置信息并更新相關配置；

d)平臺基礎數據下載：平臺基礎數據變更后，端系統(tǒng)應支持重新下載平臺基礎數據；

2

DB53/T1027—2021

e)重點用能單位數據上傳：實現重點用能單位基礎數據、采集配置數據和采集數據的上傳。

端系統(tǒng)

安裝部署

端系統(tǒng)注冊申請

申請失敗返回碼驗證

申請成功

端系統(tǒng)注冊基礎數據下載

端系統(tǒng)注冊申請

端系統(tǒng)接入申請

申請失敗返回碼驗證

申請成功

端系統(tǒng)獲取AK

返回碼驗證獲取失敗

獲取成功

平臺版本校驗平臺版本校驗版本變更

版本無變更

配置地址變更是

用能單位基礎數據上傳平臺基礎配置地址更新

更新配置地址

上傳失敗返回碼驗證否

上傳成功

下載基礎數據

用能單位采集配置數據上傳

重點用能單位數據上傳下載失敗

返回碼驗證平臺基礎配置數據下載

上傳失敗返回碼驗證

下載完成

上傳成功

本地保存處理

用能單位采集數據上傳

返回碼驗證上傳失敗

上傳成功

完成

圖1端系統(tǒng)數據交換流程圖

5.2接口調用規(guī)范

所有接口以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",//統(tǒng)一社會信用代碼

"region":"530000"http://行政區(qū)劃代碼，具體到縣級

}

5.3數據交換格式

重點用能單位端系統(tǒng)與省級平臺數據交換格式采用JSON。省級平臺返回響應碼見附表A.1所示。

6數據交換接口

6.1數據交換接口字段要求

下述數據交換接口中，使用“*”標注的字段均為必填字段。

6.2端系統(tǒng)接入管理

6.2.1端系統(tǒng)申請工作密鑰

端系統(tǒng)向省級平臺進行端系統(tǒng)工作密鑰申請，省級平臺返回工作密鑰，用于后續(xù)接口交換安全。

報文接口示例，見附表B.1端系統(tǒng)申請工作密鑰報文接口示例表。

報文字段規(guī)則，見表1。

表1報文字段規(guī)則表

序號字段名稱長度備注

1enterpriseCode統(tǒng)一社會信用代碼18*

2secretKey工作密鑰32首次申請工作密鑰為空

6.2.2端系統(tǒng)注冊基礎數據下載

端系統(tǒng)申請并成功獲得工作密鑰后，在進行端系統(tǒng)注冊申請前，應選擇從省級平臺下載行政區(qū)劃代

碼、行業(yè)編碼及重點用能單位類型編碼等基礎數據。

報文接口示例，見附表B.2端系統(tǒng)注冊基礎數據下載報文接口示例表。

報文字段規(guī)則，見表2。

4

DB53/T1027—2021

表2報文字段規(guī)則表

序號字段名稱長度備注

1enterpriseCode統(tǒng)一社會信用代碼18*

2itemIndex基礎數據表編碼*，1：行政區(qū)劃代碼

2：行業(yè)編碼

16：重點用能單位類型編碼

3data平臺基礎數據省級平臺返回的數據

6.2.3端系統(tǒng)注冊申請

端系統(tǒng)下載注冊基礎數據后，端系統(tǒng)項省級平臺申請注冊，審核通過后，重點用能單位端系統(tǒng)可接

入平臺，并使用數據接口。

報文接口示例，見附表B.3端系統(tǒng)注冊申請報文接口示例表。

報文字段規(guī)則，見表3。

表3報文字段規(guī)則表

序號字段名稱長度備注

1enterpriseCode統(tǒng)一社會信用代碼18*

2isorg是否是公共機構1*，0：不是；1：是

3password省級平臺訪問密碼64*

4cmpName單位名稱30*

5address地址50*

6zipCode郵編6

7corporationName法人代表30*

8regionCode行政區(qū)劃代碼*，具體到縣級

9license營業(yè)執(zhí)照400k*，使用Base64編碼

10organization組織結構圖400k使用Base64編碼

11registerAddress注冊地址50*

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

13registerPrincipa注冊資金10*，單位為萬元

l

14typeCode單位類型50*，參考用能單位類型編碼表

15industryCode行業(yè)編碼10*，參考行業(yè)編碼表

16fieldCode領域編碼3*，100：工業(yè)；200：交通運輸、倉儲

和郵政業(yè)；300：住宿和餐飲業(yè)；400：

批發(fā)和零售業(yè)；500：教育；600：其他

5

DB53/T1027—2021

表3（續(xù)）

序號字段名稱長度備注

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聯(lián)系電話(法人)13*

23fax傳真13

24email電子郵箱（法人）30

25url用能單位網站地址30

26productionLine主要生產線名稱255*

27leadingProduct主導產品100*

28groupName集團名稱50央企需要填寫

29groupAddress集團地址50央企需要填寫

30orgType機構類型3*，01：國家機關

02：事業(yè)單位

021：教育事業(yè)

022：科技事業(yè)

023：文化事業(yè)

024：衛(wèi)生事業(yè)

025：體育事業(yè)

026：其它

03：團體組織

31orgCode組織機構代碼9

remark備注255

6.2.4端系統(tǒng)修改平臺訪問密碼

端系統(tǒng)向省平臺申請注冊，并通過審核后，省級平臺允許端系統(tǒng)根據業(yè)務要求，對端系統(tǒng)訪問省級

平臺的訪問進行修改。

報文接口示例，見附表B.4端系統(tǒng)修改平臺訪問密碼報文接口示例表。

報文字段規(guī)則，見表4。

6

DB53/T1027—2021

表4報文字段規(guī)則表

序號字段名稱長度備注

1dataIndex企業(yè)注冊記錄索引號64*

2enterpriseCode統(tǒng)一社會信用代碼18*

3currentPassword省級平臺原訪問密碼64*

4newPassword省級平臺新訪問密碼64*

6.2.5端系統(tǒng)獲取AK

端系統(tǒng)注冊申請通過審核，可獲取到訪問省級平臺的AK及重點用能單位數據交換時間。

報文接口示例，見附表B.5端系統(tǒng)獲取AK報文接口示例表。

報文字段規(guī)則，見表5。

表5報文字段規(guī)則表

序號字段名稱長度備注

1enterpriseCode統(tǒng)一社會信用代碼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平臺版本校驗

省級平臺的平臺服務信息或基礎數據更改后，版本信息會進行更新。端系統(tǒng)可基于此接口確認省級

平臺最新版本信息，確認端系統(tǒng)本地基礎信息是否需要進行更新。

報文接口示例，見附表B.6平臺版本校驗報文接口示例表。

報文字段規(guī)則，見表6。

表6報文字段規(guī)則

序號字段名稱長度備注

1AK訪問省級平臺AK230*

2enterpriseCode統(tǒng)一社會信用代碼18*

3dicVersion平臺基礎數據版本10

4regVersion平臺基礎配置版本10

5loadPlatformDataURL平臺基礎配置查詢地址100

6modifyDescription版本變更簡述255

6.4平臺基礎配置地址更新

省級平臺的平臺服務信息或基礎數據更改后，端系統(tǒng)基于版本信息，可重新獲取平臺基礎配置信息。

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

a)基礎數據下載地址：用于接入端系統(tǒng)基礎數據下載；

7

DB53/T1027—2021

b)重點用能單位基礎信息配置上傳地址：用于重點用能單位基礎信息上傳至省級平臺；

c)采集數據上傳地址：用于重點用能單位采集數據上傳至省級平臺；

d)重點用能單位基礎信息配置下載地址：用于從省級平臺下載重點用能單位基礎信息；

e)采集數據下載地址：用于從省級平臺下載重點用能單位采集數據。

能源資源數據交換地址：用于重點用能單位采集數據上傳至省級平臺：

a)報文接口示例，見附表B.7平臺基礎配置地址更新報文接口示例表；

b)報文字段規(guī)則，見表7。

表7報文字段規(guī)則表

序號字段名稱長度備注

1enterpriseCode統(tǒng)一社會信用代碼18*

2enterpriseDataDownloadURL耗數據下載地址100

3enterpriseDataURL能耗數據交換地址100

4enterpriseInfoDownloadURL基礎信息配置下載地址100

5enterpriseInfoURL基礎信息配置交換地址100

6loadBaseDataURL基礎數據下載地址100

6.5平臺基礎數據下載

省級平臺的基礎數據更改后，端系統(tǒng)比較本地的基礎數據版本信息與省級平臺不一致，應重新下載

基礎數據。

報文接口示例，見附表B.8平臺基礎數據下載報文接口示例表。

報文字段規(guī)則，見表8。

表8報文字段規(guī)則表

序號字段名稱長度備注

1enterpriseCode統(tǒng)一社會信用代碼18*

2itemIndex基礎數據表編碼*，1：行政區(qū)劃代碼

2：行業(yè)編碼

3：生產工序編碼

4：工序單元編碼

5：用能設備編碼

6：數據采集來源類型編碼

7：采集數據類型編碼

8：能源品種編碼計量單位及精度

9：耗能工質編碼計量單位及精度

10：非能源類產品及計量單位(包含平

臺預定義編碼及重點用能單位自定義

編碼)

11：能效指標編碼及計量單位

12：經營指標編碼及計量單位

13：其它數據編碼

8

DB53/T1027—2021

表8（續(xù)）

序號字段名稱長度備注

14：能源用途編碼

15：計量器具編碼

16：重點用能單位類型編碼

17：重點用能設備分類編碼

3data平臺基礎數據省級平臺返回的數據

6.6重點用能單位能耗數據交換

6.6.1重點用能單位基礎數據上傳

重點用能單位聯(lián)系人信息

端系統(tǒng)根據省平臺要求上傳重點用能單位聯(lián)系人姓名、電話、所在部門、職位、傳真、郵箱等信息：

報文接口示例，見附表B.9新增重點用能單位聯(lián)系人報文接口示例表；

報文字段規(guī)則，見表9。

表9報文字段規(guī)則表

序號字段名稱長度備注

1regVersion平臺服務版本10*

2dicVersion基礎數據版本10*

3enterpriseCode統(tǒng)一社會信用代碼18*

4contacterName姓名15*

5phone電話13*

6dept所在部門20*

7job職位、或者崗位15

8fax傳真13

9email郵件30

10remark備注255

11dataIndex記錄索引號64由端系統(tǒng)保存

重點用能單位能源管理體系信息

端系統(tǒng)根據省級平臺要求上傳重點用能單位名稱、主管節(jié)能領導姓名、主管節(jié)能領導職位、是否通

過能源管理體系認證，能管負責人姓名、能管負責人電話、認證日期、認證機構等信息。

報文接口示例，見附表B.10新增重點用能單位能源管理體系報文接口示例表。

報文字段規(guī)則，見表10。

表10報文字段規(guī)則表

序號字段名稱長度備注

1regVersion平臺服務版本10*

2dicVersion基礎數據版本10*

9

DB53/T1027—2021

表10（續(xù)）

序號字段名稱長度備注

3dataIndex記錄索引號64由端系統(tǒng)保存

4remark備注255

5enterpriseCode統(tǒng)一社會信用代碼18*

6energyOffice能源管理機構50*

7energyOfficial主管節(jié)能領導姓名20*

8energyOfficialPosition主管節(jié)能領導職位20*

9phone電話13*

10fax傳真13

重點用能單位能源管理人員信息

端系統(tǒng)根據省平臺要求上傳重點用能單位名稱、管理人員名稱、管理人員電話、所在部門、職位、

培訓或取證情況，備注等信息。

報文接口示例，見附表B.11新增重點用能單位能源管理人員報文接口示例表。

報文字段規(guī)則，見表11。

表11報文字段規(guī)則表

序號字段名稱長度備注

1regVersion平臺服務版本10*

2dicVersion基礎數據版本10*

3dataIndex記錄索引號64由端系統(tǒng)保存

4remark備注255

5enterpriseCode統(tǒng)一社會信用代碼18*

6manager姓名15*

7phone電話13

8dept部門名稱20*

9job職位、或者崗位20

10trainInfo培訓或者取證情況描述255

重點用能單位能耗監(jiān)測項目負責人信息

端系統(tǒng)根據省級平臺要求上傳重點用能單位名稱、能耗監(jiān)測項目負責人名稱、電話、所在部門、職

位、備注等信息。

報文接口示例，見附表B.12新增重點用能單位能耗監(jiān)測項目負責人報文接口示例表；

報文字段規(guī)則，見表12。

表12報文字段規(guī)則表

序號字段長度備注

1regVersion平臺服務版本10*

2dicVersion基礎數據版本10*

3dataIndex記錄索引號64由端系統(tǒng)保存

10

DB53/T1027—2021

表12（續(xù)）

序號字段長度備注

4remark備注255

5enterpriseCode統(tǒng)一社會信用代碼18*

6monitor能耗監(jiān)測項目負責人姓名20*

7phone能耗監(jiān)測項目負責人電話13*

8dept能耗監(jiān)測項目負責人所屬部門20*

9job能耗監(jiān)測項目負責人職位20

重點用能單位能源計量人員配置信息

端系統(tǒng)根據省級平臺要求上傳重點用能單位名稱、計量人員姓名、電話、所在部門、職位、專業(yè)技

術職稱、專業(yè)技術證書、名稱、編號、備注等信息。

報文接口示例，見附表B.13新增重點用能單位能源計量人員報文接口示例表；

報文字段規(guī)則，見表13。

表13報文字段規(guī)則表

序號字段名稱長度備注

1regVersion平臺服務版本10*

2dicVersion基礎數據版本10*

3dataIndex記錄索引號64由端系統(tǒng)保存

4remark備注255

5enterpriseCode統(tǒng)一社會信用代碼18*

6calculaterName姓名20*

7phone電話20*

8dept工作部門50*

9job職位、或者崗位50*

10technicalPost專業(yè)技術職稱200

11certificate專業(yè)技術證書400k使用Base64編碼

12certificateName證書名稱30

13certificateNo證書編號30

重點用能單位企業(yè)認證信息

端系統(tǒng)根據省級平臺要求上傳重點用能單位名稱、是否通過能源管理體系認證、重點用能單位認證

負責人姓名、重點用能單位認證負責人電話、認證日期、認證機構等信息。

報文接口示例，見附表B.14新增重點用能單位企業(yè)認證信息報文接口示例表；

報文字段規(guī)則，見表14。

表14報文字段規(guī)則表

序號字段名稱長度備注

1regVersion平臺服務版本10*

2dicVersion基礎數據版本10*

11

DB53/T1027—2021

表14（續(xù)）

序號字段名稱長度備注

3dataIndex記錄索引號64由端系統(tǒng)保存

4remark備注255

5enterpriseCode統(tǒng)一社會信用代碼18*

6energyPass是否通過能源管理體系認證1*

1：通過

0：暫未通過

7director認證負責人姓名20

8phone認證負責人電話13

9passDate認證日期yyyy-MM-dd

10passOrg認證機構30*

重點用能單位產品結構信息

端系統(tǒng)根據省級平臺要求上傳重點用能單位名稱、產品名稱、產品編號、產品描述、從省級平臺獲

取的計量單位編號等信息。

報文接口示例，見附表B.15新增重點用能單位產品結構信息報文接口示例表；

報文字段規(guī)則，見表15。

表15報文字段規(guī)則表

序號字段名稱長度備注

1regVersion平臺服務版本10*

2dicVersion基礎數據版本10*

3dataIndex記錄索引號64由端系統(tǒng)保存

4remark備注255

5enterpriseCode統(tǒng)一社會信用代碼18*

6productName產品名稱20*

7productCode產品編號20*

8productType產品類型20*

9productUnit計量單位10*

重點用能單位產值、增加值、銷售收入信息

端系統(tǒng)根據省級平臺要求上傳重點用能單位名稱、重點用能單位產值、增加值、銷售收入等信息。

報文接口示例，見附表B.16新增重點用能單位產值、增加值、銷售收入信息報文接口示例表；

報文字段規(guī)則，見表16。

表16報文字段規(guī)則表

序號字段名稱長度備注

1regVersion平臺服務版本10*

2dicVersion基礎數據版本10*

12

DB53/T1027—2021

表16（續(xù)）

序號字段名稱