DB21-T 3792-2023 重點(diǎn)用能單位能耗在線監(jiān)測大數(shù)據(jù)分析平臺數(shù)據(jù)接口規(guī)范

ICS29.240.01CCSF2121IDB21/T3792—2023前言 2規(guī)范性引用文件 3術(shù)語和定義 4縮略語 5通信框架 5.1總體結(jié)構(gòu) 5.2通信模式 5.3通信協(xié)議 6省級平臺與能耗在線監(jiān)測端設(shè)備的數(shù)據(jù)傳輸接口 6.1總述 6.2功能要求 6.3信息描述 7省級平臺與其他應(yīng)用平臺的數(shù)據(jù)傳輸接口 7.1總述 7.2功能要求 7.3信息描述 附錄A（資料性）省級平臺與能耗在線監(jiān)測端設(shè)備的數(shù)據(jù)傳輸接口示例 11附錄B（規(guī)范性）能耗在線監(jiān)測系統(tǒng)基礎(chǔ)信息與格式規(guī)范 23附錄C（資料性）省級平臺與其他應(yīng)用平臺的數(shù)據(jù)傳輸接口 28DB21/T3792—2023前言本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識別這些專利的責(zé)任本文件由遼寧省發(fā)展和改革委員會提出并歸口。本文件起草單位：遼寧省大數(shù)據(jù)管理中心（遼寧省信息中心）、青島高校信息產(chǎn)業(yè)股份有限公司、沈陽工業(yè)大學(xué)、遼寧省節(jié)能監(jiān)察服務(wù)中心、遼寧省市場監(jiān)管事務(wù)服務(wù)中心、大連市市場監(jiān)管綜合行政執(zhí)法隊能源大隊、大連理工大學(xué)能源與動力學(xué)院、大連輝創(chuàng)信息技術(shù)有限公司、遼寧碳科能信科技有限公司。本文件主要起草人：蘇乃鋒、張麗霞、李洪濤、蒲云鵬、李國良、叢明、蘭瑩、米欣、李宏巖、趙亮、王長亮、袁泉、王林娜、侯越、年曉非、任成剛、孫醒坤、于永勝、楊田、馬瑩瑩、李鐸、郭偉、朱琳卓、韓旭、邵思豪、吉新華、李享、汪東輝、宋小磊、高緒騰。本文件發(fā)布實(shí)施后，任何單位和個人如有問題和意見建議，均可以通過來電或來函等方式進(jìn)行反饋，我們將及時答復(fù)并認(rèn)真處理，根據(jù)實(shí)際情況依法進(jìn)行評估及復(fù)審。歸口管理單位：遼寧省發(fā)展和改革委員會，通訊地址：沈陽市皇姑區(qū)北陵大街45-2樓623室，聯(lián)系電話起草單位：遼寧省大數(shù)據(jù)管理中心（遼寧省信息中心通訊地址：遼寧省沈陽市和平區(qū)市府大路187號328室，聯(lián)系電話1DB21/T3792—2023重點(diǎn)用能單位能耗在線監(jiān)測大數(shù)據(jù)分析平臺數(shù)據(jù)接口規(guī)范本文件規(guī)定了重點(diǎn)用能單位能耗在線監(jiān)測大數(shù)據(jù)分析平臺數(shù)據(jù)傳輸過程的應(yīng)用層通信協(xié)議與數(shù)據(jù)接口規(guī)范，本文件不限制系統(tǒng)擴(kuò)展其他的信息內(nèi)容，在擴(kuò)展內(nèi)容時不得與本規(guī)范中所使用或保留的控制命令相沖突。本文件適用于重點(diǎn)用能單位能耗在線監(jiān)測大數(shù)據(jù)分析平臺和端設(shè)備、省政務(wù)信息共享交換平臺等其他應(yīng)用平臺之間的數(shù)據(jù)交換傳輸。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T2260中華人民共和國行政區(qū)劃代碼GB/T4754國民經(jīng)濟(jì)行業(yè)分類GB/T25070信息安全技術(shù)網(wǎng)絡(luò)安全等級保護(hù)安全設(shè)計技術(shù)要求GB32100法人和其他組織統(tǒng)一社會信用代碼編碼規(guī)則GB/T37947.1信息技術(shù)用能單位能耗在線監(jiān)測系統(tǒng)第1部分：端設(shè)備數(shù)據(jù)傳輸接口GB/T38692用能單位能耗在線監(jiān)測技術(shù)要求GB/T39786信息安全技術(shù)信息系統(tǒng)密碼應(yīng)用基本要求3術(shù)語和定義下列術(shù)語和定義適用于本文件。3.1重點(diǎn)用能單位keyenergyusers重點(diǎn)用能單位指年綜合能源消費(fèi)總量一萬噸標(biāo)準(zhǔn)煤以上（含一萬噸）的用能單位或國務(wù)院有關(guān)部門、省、自治區(qū)、直轄市人民政府管理節(jié)能工作的部門指定的年綜合能源消費(fèi)總量五千噸標(biāo)準(zhǔn)煤以上（含五千噸）、不滿一萬噸標(biāo)準(zhǔn)煤的用能單位。3.2省級平臺provincialplatform省級平臺是指遼寧省重點(diǎn)用能單位能耗在線監(jiān)測大數(shù)據(jù)分析平臺。負(fù)責(zé)接收、存儲、匯總、分析本地區(qū)內(nèi)重點(diǎn)用能單位能耗在線監(jiān)測數(shù)據(jù)，為各級節(jié)能主管部門、重點(diǎn)用能單位提供應(yīng)用服務(wù)。3.3端設(shè)備device部署在重點(diǎn)用能單位，用于采集、分析、匯總重點(diǎn)用能單位能耗數(shù)據(jù)并將數(shù)據(jù)上傳到省級平臺的設(shè)2DB21/T3792—20233.4其他應(yīng)用平臺otherapplicationplatforms與省級平臺進(jìn)行數(shù)據(jù)交換共享的其他獨(dú)立運(yùn)行的應(yīng)用系統(tǒng)，簡稱“其他應(yīng)用平臺”。3.5通信協(xié)議communicationprotocol指實(shí)現(xiàn)通信的雙方實(shí)體完成通信或服務(wù)所必須遵循的規(guī)則和約定。協(xié)議定義了數(shù)據(jù)單元使用的格式，信息單元應(yīng)該包含的信息與含義，連接方式，信息發(fā)送和接收的時序，從而確保網(wǎng)絡(luò)中數(shù)據(jù)從發(fā)送方順利地傳送到接收方，并被正確識別。本文件主要定義應(yīng)用層協(xié)議。3.6在線直接采集onlinedirectcollection通過對接智能儀表、工業(yè)控制系統(tǒng)、生產(chǎn)監(jiān)控管理系統(tǒng)、管理信息系統(tǒng)等，將重點(diǎn)用能單位的能耗數(shù)據(jù)采集到端設(shè)備，數(shù)據(jù)匯總處理后自動傳輸?shù)绞〖壠脚_。3.7數(shù)據(jù)傳輸接口datatransmissioninterface省級平臺和端設(shè)備、省政務(wù)信息共享交換平臺及其他應(yīng)用平臺實(shí)現(xiàn)數(shù)據(jù)傳輸所規(guī)定的一組約定。4縮略語下列縮略語適用于本文件。HTTPS：安全超文本傳輸協(xié)議（HyperTextTransferProtocolSecure）JSON:對象表示法(JavaScriptObjectNotation)CA:證書授權(quán)中心（CertificateAuthority)XML：可擴(kuò)展標(biāo)記語言（ExtensibleMarkupLanguage）TCP/IP：傳輸控制協(xié)議/因特網(wǎng)互聯(lián)協(xié)議（TransmissionControlProtocol/InternetProtocol）5通信框架5.1總體結(jié)構(gòu)通過端設(shè)備，省級平臺接收企業(yè)上傳的能耗數(shù)據(jù)，對接收的數(shù)據(jù)進(jìn)行匯總處理，按照統(tǒng)一約定與端設(shè)備及其他應(yīng)用平臺進(jìn)行數(shù)據(jù)傳輸共享。通信總體框架示意圖如圖1所示。圖1通信總體框架示意圖3DB21/T3792—20235.2通信模式省級平臺與端設(shè)備以及省級平臺與其他應(yīng)用平臺之間采用請求應(yīng)答通信模式。由能耗在線監(jiān)測端設(shè)備或是其他應(yīng)用平臺發(fā)起，省級平臺應(yīng)答組成。5.3通信協(xié)議傳輸層基于TCP/IP協(xié)議。應(yīng)用層基于HTTPS協(xié)議,在應(yīng)用層傳輸?shù)臉I(yè)務(wù)數(shù)據(jù)采用JSON交換格式,數(shù)據(jù)交換采用的格式見第6章、第7章。6省級平臺與能耗在線監(jiān)測端設(shè)備的數(shù)據(jù)傳輸接口6.1總述能耗在線監(jiān)測端設(shè)備需采用統(tǒng)一要求的CA數(shù)字證書進(jìn)行身份驗(yàn)證，通過身份驗(yàn)證后才能接入省級平臺。能耗在線監(jiān)測端設(shè)備將重點(diǎn)用能單位數(shù)據(jù)經(jīng)互聯(lián)網(wǎng)上傳至省級平臺時，需同時采用VPN通道及HTTPS協(xié)議進(jìn)行安全加密傳輸。數(shù)據(jù)傳輸接口構(gòu)成如圖2所示。圖3省級平臺與其他應(yīng)用平臺的數(shù)據(jù)傳輸接口構(gòu)成6.2功能要求6.2.1端設(shè)備注冊接口能耗在線監(jiān)測端設(shè)備完成物理部署、接入網(wǎng)絡(luò)并運(yùn)行后，進(jìn)行端設(shè)備注冊。省級平臺負(fù)責(zé)提供URL地址，并返回數(shù)據(jù)上傳時間點(diǎn)要求（平臺按照企業(yè)端注冊順序逐個返回上傳時間端設(shè)備需要按照此時間點(diǎn)上傳數(shù)據(jù)。4DB21/T3792—2023接口示例參見附錄A的A.1。6.2.2基礎(chǔ)數(shù)據(jù)下載接口能耗在線監(jiān)測端設(shè)備注冊成功后，對能耗在線監(jiān)測端設(shè)備系統(tǒng)進(jìn)行初始化配置，包括用能單位基礎(chǔ)信息、數(shù)據(jù)接入配置信息和相應(yīng)的數(shù)據(jù)編碼等。接口示例參見附錄A的A.2。6.2.3平臺版本校驗(yàn)接口本信息，重新注冊或下載基礎(chǔ)數(shù)據(jù)。接口示例參見附錄A的A.3。6.2.4用能單位基礎(chǔ)信息上傳接口能耗在線監(jiān)測端設(shè)備完成設(shè)備初始化配置后，上傳用能單位的基礎(chǔ)信息至省級平臺。接口示例參見附錄A的A.4。6.2.5用能單位采集數(shù)據(jù)上傳接口用能單位采集上傳的數(shù)據(jù)指標(biāo)分為每日采集上傳到省級平臺的數(shù)據(jù)指標(biāo)和每月采集上傳到省級平臺的數(shù)據(jù)指標(biāo)。每日采集上傳的數(shù)據(jù)指標(biāo)包括每日指標(biāo)和實(shí)時指標(biāo)兩類。每日指標(biāo)為結(jié)算日00:00-24:00企業(yè)的能源總量指標(biāo)；對于在線采集的數(shù)據(jù)，上傳實(shí)時指標(biāo)。實(shí)時指標(biāo)為每間隔15分鐘采集一次的能源消耗實(shí)時數(shù)據(jù)（為消耗數(shù)據(jù)，非累計值。如對于電表，采集保存數(shù)據(jù)=電表顯示累計電量n-電表顯示累計電量n-1）并保存在本地，在指定的數(shù)據(jù)上傳時間與每日上報數(shù)據(jù)一同上傳到省級平臺。企業(yè)每月采集上傳的數(shù)據(jù)指標(biāo)包括企業(yè)每月能源總量指標(biāo)（企業(yè)各能源品種的購進(jìn)量、外供量、期初庫存、期末庫存、綜合能源消費(fèi)量）、重點(diǎn)工段每月能源消費(fèi)量指標(biāo)、企業(yè)經(jīng)濟(jì)指標(biāo)。用能單位將數(shù)據(jù)進(jìn)行匯總打包后，每日在指定的數(shù)據(jù)上傳時間將本批次數(shù)據(jù)上傳至省級平臺。省級平臺成功接收本批次數(shù)據(jù)后，返回一個成功反饋消息，如果超時還未收到反饋或反饋為失敗，則端設(shè)備重發(fā)，若重發(fā)3次還未成功，則端設(shè)備將本批次數(shù)據(jù)保存在隊列中，下次上傳數(shù)據(jù)時再次重發(fā)，直至成功。接口示例參見附錄A的A.5。6.3信息描述6.3.1端設(shè)備注冊接口發(fā)送信息端設(shè)備注冊應(yīng)提供如下信息：a)用能單位統(tǒng)一社會信用代碼按照GB32100執(zhí)行，統(tǒng)一社會信用代碼為18位；b)用能單位所在行政區(qū)域的行政區(qū)劃代碼按照GB/T2260執(zhí)行，行政區(qū)劃代碼為6位；c)用能單位名稱（全稱）；d)用能單位所在行政區(qū)域的行政區(qū)劃名稱按照GB/T2260執(zhí)行。返回信息5DB21/T3792—2023省級平臺返回如下信息：a)返回碼：返回碼說明見表1；b)狀態(tài)提示：對返回碼的說明，狀態(tài)提示說明見表1；c)設(shè)備序列號“GUID”：GUID為端設(shè)備統(tǒng)一編碼，為32位，由省級平臺統(tǒng)一生成并下發(fā)；d)基礎(chǔ)數(shù)據(jù)下載地址：用于端設(shè)備基礎(chǔ)數(shù)據(jù)下載，如IP:port/downloadBaseData；e)省級平臺版本校驗(yàn)地址：用于平臺版本校驗(yàn)，如IP:port/versionCheck；f)用能單位基礎(chǔ)信息配置上傳地址：用于用能單位基礎(chǔ)信息上傳至省級平臺，如IP:port/uploadConfigData；g)用能單位采集數(shù)據(jù)上傳地址：用于用能單位采集數(shù)據(jù)上傳至省級平臺，如IP:port/uploadEnergyData；h)用能單位基礎(chǔ)信息配置下載地址：用于從省級平臺下載用能單位基礎(chǔ)信息，如IP:port/downloadConfigData；i)用能單位采集數(shù)據(jù)下載地址：用于從省級平臺下載用能單位采集數(shù)據(jù)，如IP:port/downloadEnergyData；j)上報時間點(diǎn)：用于規(guī)定用能單位上傳數(shù)據(jù)至省級平臺的時間，格式為：HH:MM:SS。表1返回碼說明06.3.2基礎(chǔ)數(shù)據(jù)下載接口發(fā)送信息a)能耗在線監(jiān)測端設(shè)備發(fā)起基礎(chǔ)數(shù)據(jù)下載應(yīng)提供設(shè)備序列號“GUID”：GUID為端設(shè)備統(tǒng)一編碼，為32位，由省級平臺統(tǒng)一生成并下發(fā);b)選擇基礎(chǔ)數(shù)據(jù)類型：基礎(chǔ)數(shù)據(jù)類型包含全部類型、行政區(qū)劃、行業(yè)、單位類別編碼、采集系統(tǒng)分類、生產(chǎn)工序、采集數(shù)據(jù)項(xiàng)、采集數(shù)據(jù)項(xiàng)數(shù)據(jù)用途、能源類型等選項(xiàng)，參加附錄A的A.6。返回信息省級平臺返回如下信息：a)返回碼：請求狀態(tài)說明代碼，返回碼說明見表1；b)狀態(tài)提示：對返回碼的說明，狀態(tài)提示說明見表1；c)行政區(qū)劃代碼：參見附錄B的B.1;d)行業(yè)代碼：參見附錄B的B.1;e)單位類別編碼：企業(yè)登記注冊類別與代碼說明，參見附錄A的A.7;f)采集數(shù)據(jù)項(xiàng)編碼：采集數(shù)據(jù)類型、能源品種、新能源指標(biāo)及碳指標(biāo)等編碼規(guī)則參見附錄B;6DB21/T3792—2023g)采集數(shù)據(jù)項(xiàng)數(shù)據(jù)用途：采集數(shù)據(jù)項(xiàng)見附錄B;h)產(chǎn)品指標(biāo)：單位產(chǎn)品能耗指標(biāo)項(xiàng)的信息見附錄B。6.3.3平臺版本校驗(yàn)接口發(fā)送信息能耗在線監(jiān)測端設(shè)備發(fā)起省級平臺版本校驗(yàn)應(yīng)提供：設(shè)備序列號“GUID”，GUID為端設(shè)備統(tǒng)一編碼，為32位，由省級平臺統(tǒng)一生成并下發(fā)。返回信息省級平臺返回值包含如下信息：a)返回碼：請求狀態(tài)說明代碼，返回碼說明見表1；b)狀態(tài)提示：對返回碼的說明，狀態(tài)提示說明見表1；c)省級平臺注冊服務(wù)版本信息：為省級平臺注冊服務(wù)的版本編號，如125；d)省級平臺基礎(chǔ)數(shù)據(jù)版本信息：為省級平臺基礎(chǔ)數(shù)據(jù)的版本編號，如125；e)能耗在線監(jiān)測端設(shè)備定期檢查本地基礎(chǔ)信息是否已更新，檢查周期至少每天一次。6.3.4用能單位基礎(chǔ)信息上傳接口發(fā)送信息用能單位基礎(chǔ)信息上傳應(yīng)提供如下信息：a)設(shè)備序列號“GUID”：GUID為端設(shè)備統(tǒng)一編碼，為32位，由省級平臺統(tǒng)一生成并下發(fā)。b)用能單位統(tǒng)一社會信用代碼：統(tǒng)一社會信用代碼為18位，按照GB32100執(zhí)行。c)采集數(shù)據(jù)項(xiàng)配置信息：能耗在線監(jiān)測端設(shè)備所需上傳的所有采集數(shù)據(jù)配置信息，包括采集數(shù)據(jù)項(xiàng)指標(biāo)名稱、生產(chǎn)工序編碼、工序單元編碼、采集對象類型編碼、能源分類和分項(xiàng)編碼、用途編碼、數(shù)據(jù)采集來源編碼、采集數(shù)據(jù)最大值、采集數(shù)據(jù)最小值、采集頻率編碼、采集系統(tǒng)名稱、備注、采集數(shù)據(jù)范圍編碼等，按照GB/T37947.1執(zhí)行。d)用能單位基本信息：能耗在線監(jiān)測端設(shè)備所在重點(diǎn)用能單位的基本信息，按照GB/T37947.1執(zhí)行。返回信息省級平臺返回如下信息：a)返回碼：請求狀態(tài)說明代碼，返回碼說明見表1；b)狀態(tài)提示：對返回碼的說明，狀態(tài)提示說明見表1。6.3.5用能單位采集數(shù)據(jù)上傳接口發(fā)送信息用能單位采集數(shù)據(jù)上傳應(yīng)提供如下信息：a)設(shè)備序列號“GUID”：GUID為端設(shè)備統(tǒng)一編碼，為32位，由省級平臺統(tǒng)一生成并下發(fā)；b)用能單位統(tǒng)一社會信用代碼：統(tǒng)一社會信用代碼為18位，按照GB32100執(zhí)行；c)采集數(shù)據(jù)的具體信息：包括上傳數(shù)據(jù)項(xiàng)編碼、數(shù)據(jù)項(xiàng)的值、數(shù)據(jù)有效性、數(shù)據(jù)范圍、數(shù)據(jù)采集類型、數(shù)據(jù)采集頻率、數(shù)據(jù)統(tǒng)計時間、數(shù)據(jù)上傳時間等。返回信息DB21/T3792—2023省級平臺返回如下信息：a)返回碼：請求狀態(tài)說明代碼，返回碼說明見表1；b)狀態(tài)提示：對返回碼的說明，狀態(tài)提示說明見表1。7省級平臺與其他應(yīng)用平臺的數(shù)據(jù)傳輸接口7.1總述省級平臺與其他應(yīng)用平臺數(shù)據(jù)交換或共享應(yīng)使用接口調(diào)用方式進(jìn)行。調(diào)用時應(yīng)使用安全加密傳輸請求服務(wù)，通過用戶名和密碼進(jìn)行認(rèn)證并在數(shù)據(jù)輸入輸出時進(jìn)行加密解密操作。數(shù)據(jù)傳輸接口構(gòu)成如圖3所示。圖3省級平臺與其他應(yīng)用平臺的數(shù)據(jù)傳輸接口構(gòu)成7.2功能要求7.2.1地區(qū)能耗統(tǒng)計數(shù)據(jù)接口獲取特定地區(qū)的能耗統(tǒng)計數(shù)據(jù)。接口示例參見附錄C的C.1。7.2.2行業(yè)能耗統(tǒng)計數(shù)據(jù)接口獲取特定行業(yè)的能耗統(tǒng)計數(shù)據(jù)。接口示例參見附錄C的C.2。7.2.3地區(qū)重點(diǎn)項(xiàng)目信息數(shù)據(jù)接口獲取特定地區(qū)下的所有重點(diǎn)項(xiàng)目信息。接口示例參見附錄C的C.3。7.2.4行業(yè)重點(diǎn)項(xiàng)目信息數(shù)據(jù)接口8DB21/T3792—2023獲取特定行業(yè)下的所有重點(diǎn)項(xiàng)目信息。接口示例參見附錄C的C.4。7.2.5地區(qū)企業(yè)基礎(chǔ)信息接口獲取特定地區(qū)的企業(yè)基礎(chǔ)信息。接口示例參見附錄C的C.5。7.2.6行業(yè)企業(yè)基礎(chǔ)信息接口獲取特定行業(yè)的企業(yè)基礎(chǔ)信息。接口示例參見附錄C的C.6。7.3信息描述7.3.1地區(qū)能耗統(tǒng)計數(shù)據(jù)接口發(fā)送信息地區(qū)能耗統(tǒng)計數(shù)據(jù)接口應(yīng)提供如下信息：a)用戶名：請求接口調(diào)用的用戶名;b)密碼：請求接口調(diào)用的密碼;c)數(shù)據(jù)周期：請求的數(shù)據(jù)周期，分為day、month、year三種;d)數(shù)據(jù)開始時間，請求的數(shù)據(jù)開始時間戳，精確到毫秒;e)數(shù)據(jù)結(jié)束時間，請求的數(shù)據(jù)結(jié)束時間戳，精確到毫秒;f)數(shù)據(jù)來源：請求的數(shù)據(jù)來源，分為online（在線數(shù)據(jù)）、report（填報數(shù)據(jù)）兩種;g)行政區(qū)劃代碼：請求的數(shù)據(jù)所屬行政區(qū)劃代碼，詳見《中華人民共和國行政區(qū)劃代碼》GB/T2260。返回信息地區(qū)能耗統(tǒng)計數(shù)據(jù)接口返回值包含如下信息：a)返回碼：詳見表1;b)狀態(tài)提示：對返回碼的說明，狀態(tài)提示說明見表1;c)能耗統(tǒng)計數(shù)據(jù)原始量：保留兩位小數(shù);d)能耗統(tǒng)計數(shù)據(jù)折標(biāo)量：保留兩位小數(shù);e)計量單位：能耗統(tǒng)計數(shù)據(jù)計量單位。7.3.2行業(yè)能耗統(tǒng)計數(shù)據(jù)接口發(fā)送信息行業(yè)能耗統(tǒng)計數(shù)據(jù)接口應(yīng)提供如下信息：a)用戶名：請求接口調(diào)用的用戶名;b)密碼：請求接口調(diào)用的密碼;c)數(shù)據(jù)周期：請求的數(shù)據(jù)周期，分為day、month、year三種;d)數(shù)據(jù)開始時間，請求的數(shù)據(jù)開始時間戳，精確到毫秒;e)數(shù)據(jù)結(jié)束時間，請求的數(shù)據(jù)結(jié)束時間戳，精確到毫秒;f)數(shù)據(jù)來源：請求的數(shù)據(jù)來源，分為online（在線數(shù)據(jù)）、report（填報數(shù)據(jù)）兩種;g)行業(yè)編碼：請求的數(shù)據(jù)所屬行業(yè)編碼，參見附錄B的B.1。返回信息DB21/T3792—2023行業(yè)能耗統(tǒng)計數(shù)據(jù)接口返回值包含如下信息：a)返回碼：詳見表1;b)狀態(tài)提示：對返回碼的說明，狀態(tài)提示說明見表1;c)能耗統(tǒng)計數(shù)據(jù)原始量：保留兩位小數(shù);d)能耗統(tǒng)計數(shù)據(jù)折標(biāo)量：保留兩位小數(shù);e)計量單位：能耗統(tǒng)計數(shù)據(jù)計量單位。7.3.3地區(qū)重點(diǎn)項(xiàng)目信息數(shù)據(jù)接口發(fā)送信息地區(qū)重點(diǎn)項(xiàng)目信息數(shù)據(jù)接口應(yīng)提供如下信息：a)用戶名：請求接口調(diào)用的用戶名;b)密碼：請求接口調(diào)用的密碼;c)行政區(qū)劃代碼：請求的數(shù)據(jù)所屬行政區(qū)劃代碼參見附錄B的B.1。返回信息地區(qū)重點(diǎn)項(xiàng)目信息數(shù)據(jù)接口返回值包含如下信息：a)返回碼：詳見表1;b)狀態(tài)提示：對返回碼的說明，狀態(tài)提示說明見表1；c)項(xiàng)目名稱：重點(diǎn)項(xiàng)目名稱;d)項(xiàng)目代碼：重點(diǎn)項(xiàng)目代碼;e)項(xiàng)目類型：重點(diǎn)項(xiàng)目類型;f)所屬地區(qū)：重點(diǎn)項(xiàng)目所屬地區(qū)名稱;g)所屬行業(yè)：重點(diǎn)項(xiàng)目所屬行業(yè)名稱;h)分類處置：重點(diǎn)項(xiàng)目分類處置類型名稱;i)建設(shè)內(nèi)容：重點(diǎn)項(xiàng)目詳細(xì)建設(shè)內(nèi)容;j)建設(shè)地點(diǎn)：重點(diǎn)項(xiàng)目詳細(xì)建設(shè)地點(diǎn)，至少精確到區(qū)縣;k)設(shè)計年綜合能源消費(fèi)量：重點(diǎn)項(xiàng)目批復(fù)的年綜合能源消費(fèi)量，計量單位噸標(biāo)準(zhǔn)煤。7.3.4行業(yè)重點(diǎn)項(xiàng)目信息數(shù)據(jù)接口發(fā)送信息行業(yè)重點(diǎn)項(xiàng)目信息數(shù)據(jù)接口應(yīng)提供如下信息：a)用戶名：請求接口調(diào)用的用戶名;b)密碼：請求接口調(diào)用的密碼;c)行業(yè)編碼：請求的數(shù)據(jù)所屬行業(yè)編碼參見附錄B的B.1。返回信息行業(yè)重點(diǎn)項(xiàng)目信息數(shù)據(jù)接口返回值包含如下信息：a)返回碼：詳見表1;b)狀態(tài)提示：對返回碼的說明，狀態(tài)提示說明見表1；c)項(xiàng)目名稱：重點(diǎn)項(xiàng)目名稱;d)項(xiàng)目代碼：重點(diǎn)項(xiàng)目代碼;DB21/T3792—2023e)項(xiàng)目類型：重點(diǎn)項(xiàng)目類型;f)所屬地區(qū)：重點(diǎn)項(xiàng)目所屬地區(qū)名稱;g)所屬行業(yè)：重點(diǎn)項(xiàng)目所屬行業(yè)名稱;h)分類處置：重點(diǎn)項(xiàng)目分類處置類型名稱;i)建設(shè)內(nèi)容：重點(diǎn)項(xiàng)目詳細(xì)建設(shè)內(nèi)容;j)建設(shè)地點(diǎn)：重點(diǎn)項(xiàng)目詳細(xì)建設(shè)地點(diǎn)，至少精確到區(qū)縣;k)設(shè)計年綜合能源消費(fèi)量：重點(diǎn)項(xiàng)目批復(fù)的年綜合能源消費(fèi)量，計量單位噸標(biāo)準(zhǔn)煤。7.3.5地區(qū)企業(yè)基礎(chǔ)信息接口發(fā)送信息地區(qū)企業(yè)基礎(chǔ)信息接口應(yīng)提供如下信息：a)用戶名：請求接口調(diào)用的用戶名;b)密碼：請求接口調(diào)用的密碼;c)行政區(qū)劃代碼：請求的數(shù)據(jù)所屬行政區(qū)劃代碼參見附錄B的B.1。返回信息地區(qū)企業(yè)基礎(chǔ)信息接口返回值包含如下信息：a)返回碼：詳見表1;b)狀態(tài)提示：對返回碼的說明，狀態(tài)提示說明見表1；c)企業(yè)基本信息：詳見地區(qū)企業(yè)基礎(chǔ)信息接口協(xié)議代碼示例“RESPONSE”部分。7.3.6行業(yè)企業(yè)基礎(chǔ)信息接口發(fā)送信息行業(yè)企業(yè)基礎(chǔ)信息接口應(yīng)提供如下信息：a)用戶名：請求接口調(diào)用的用戶名;b)密碼：請求接口調(diào)用的密碼;c)行業(yè)編碼：請求的數(shù)據(jù)所屬行業(yè)編碼參見附錄B的B.1。返回信息行業(yè)企業(yè)基礎(chǔ)信息接口返回值包含如下信息：a)返回碼：詳見表1;b)狀態(tài)提示：對返回碼的說明，狀態(tài)提示說明見表1；c)企業(yè)基本信息：詳見行業(yè)企業(yè)基礎(chǔ)信息接口協(xié)議代碼示例“RESPONSE”部分。DB21/T3792—2023附錄A（資料性）省級平臺與能耗在線監(jiān)測端設(shè)備的數(shù)據(jù)傳輸接口示例A.1端設(shè)備注冊接口示例能耗在線監(jiān)測端設(shè)備注冊接口示例見表A.1。表A.1端設(shè)備注冊接口示例{"enterpriseCode":"91210001234567"enterpriseName":"xxxx}{"loadConfigURL":"IP:port/downloadBaseData",//基礎(chǔ)數(shù)據(jù)下載“l(fā)oadDicVersionURL”:“IP:port/versionCheck”,//平臺版本下載地址"centerInfoURL":IP:port/uploadConfigData",//用能單位基礎(chǔ)信息配置上傳地址"centerDataURL":"IP:port/uploadEnergyData",//采集數(shù)據(jù)上傳地址"centerInfoDownloadURL":"IP:port/downloadConfigData",//用能單位基礎(chǔ)信息配置"centerDataDownloadURL":"IP:port/downloadEnergyData",//采集數(shù)據(jù)下載地址}DB21/T3792—2023A.2基礎(chǔ)數(shù)據(jù)下載接口示例能耗在線監(jiān)測端設(shè)備基礎(chǔ)數(shù)據(jù)下載接口示例見表A.2。表A.2基礎(chǔ)數(shù)據(jù)下載接口示例https://[/downloadBaseData]，//省級平臺基礎(chǔ){}{{{{DB21/T3792—2023表A.2（續(xù)）{{{{}{}{DB21/T3792—2023表A.2（續(xù)）{"industryCode":"C31"http://所屬行業(yè)，如“煉鋼”}{{{"pclass":"01",//采集數(shù)據(jù)類型，如“01一次能源”{DB21/T3792—2023表A.2（續(xù)）"pclass":"08",//采集數(shù)據(jù)類型，如“08能效指標(biāo)”}{}{}{DB21/T3792—2023}A.3平臺版本校驗(yàn)接口示例能耗在線監(jiān)測端設(shè)備省級平臺版本校驗(yàn)接口示例見表A.3。表A.3省級平臺版本校驗(yàn)接口示例https://[/versionCheck]，//省級平臺版本信息校驗(yàn){"deviceId":"0ef6ece}{"responseMessage":"RECEIV}A.4用能單位基礎(chǔ)信息上傳接口示例能耗在線監(jiān)測端設(shè)備用能單位基礎(chǔ)信息上傳接口示例見表A.4。表A.4用能單位基礎(chǔ)信息上傳接口示例DB21/T3792—2023https://[/uploadConfigData]，//省級平臺用能單位基礎(chǔ)信息上傳地址{"deviceId":"0ef6ecea08bf84c7b639c3e9"enterpriseCode":"91330{DB21/T3792—2023表A.4（續(xù)）類型說明"dataValueMax":300000,"dataValueMin":0,//數(shù)據(jù)"corporationCode":"912100005"latitude":33.283433,//"registerPrincipal":100"energyOffice":"機(jī)電能源部",//能管機(jī)構(gòu)名稱DB21/T3792—2023表A.4(續(xù))類型說明"energyPass":false,/"productionLine":"電弧爐生產(chǎn)寬厚板短流程生產(chǎn)線",//企業(yè)主要生產(chǎn)線名稱{{{}DB21/T3792—2023A.5用能單位采集數(shù)據(jù)上傳接口示例能耗在線監(jiān)測端設(shè)備采集數(shù)據(jù)上傳接口示例見表A.5。表A.5采集數(shù)據(jù)上傳接口示例https://[/uploadEnergyData]//省級平臺采集數(shù)據(jù)上傳地{"deviceId":"0ef6ecea08bf84c7b639c3{{}}{}DB21/T3792—2023A.6基礎(chǔ)數(shù)據(jù)類型編碼能耗在線監(jiān)測端設(shè)備采集的基礎(chǔ)數(shù)據(jù)類型編碼見表A.6。表A.6基礎(chǔ)數(shù)據(jù)類型編碼表DB21/T3792—2023A.7單位類別編碼單位類別編碼見表A.7。表A.7單位類別編碼表 - - DB21/T3792—2023（規(guī)范性）能耗在線監(jiān)測系統(tǒng)基礎(chǔ)信息與格式規(guī)范B.1基礎(chǔ)信息編碼B.1.1行政區(qū)劃代碼省級平臺中采用的行政區(qū)劃代碼參照《中華人民共和國行政區(qū)劃代碼》GB/T2260執(zhí)行。B.1.2行業(yè)編碼省級平臺中采用的行業(yè)編碼參照《國民經(jīng)濟(jì)行業(yè)分類》GB/T4754執(zhí)行。B.1.3重點(diǎn)用能單位編碼重點(diǎn)用能單位編碼采用該單位的統(tǒng)一社會信用代碼。統(tǒng)一社會信用代碼按照《法人和其他組織統(tǒng)一社會信用代碼編碼規(guī)則》GB32100執(zhí)行。B.1.4生產(chǎn)工序編碼生產(chǎn)工序是工業(yè)生產(chǎn)過程制造。生產(chǎn)某種產(chǎn)品或達(dá)到某一特定結(jié)果的特定步驟。其生產(chǎn)工序編碼按照行業(yè)分別編碼，編碼規(guī)則由2位阿拉伯?dāng)?shù)字組成。B.1.5工序單元編碼工序單元是重點(diǎn)用能單位的某一生產(chǎn)工序的具體實(shí)體單位。工序單元編碼由2位阿拉伯?dāng)?shù)字組成。B.1.6用能設(shè)備編碼用能設(shè)備是重點(diǎn)用能單位在生產(chǎn)、經(jīng)營活動中所使用的消耗能源的設(shè)備實(shí)體。用能設(shè)備的編碼由4位阿拉伯?dāng)?shù)字組成，第1位和第2位代表設(shè)備類型，第3位和第4位代表設(shè)備編號。B.2數(shù)據(jù)采集來源編碼數(shù)據(jù)采集來源是指能耗在線監(jiān)測系統(tǒng)中收集、識別和選取數(shù)據(jù)的數(shù)據(jù)源，一般包括管理信息系統(tǒng)、生產(chǎn)監(jiān)控系統(tǒng)、生產(chǎn)過程控制系統(tǒng)等業(yè)務(wù)信息化系統(tǒng)和現(xiàn)場儀表、手工填報等方式。數(shù)據(jù)來源由1位阿拉伯?dāng)?shù)字組成，數(shù)據(jù)采集來源類型編碼見表B.1。DB21/T3792—2023表B.1數(shù)據(jù)采集來源類型編碼1234567B.3采集數(shù)據(jù)編碼B.3.1采集數(shù)據(jù)類型編碼為了數(shù)據(jù)清洗可用，應(yīng)對采集數(shù)據(jù)進(jìn)行類型分類，本部分中采集數(shù)據(jù)類型可劃分為一次能源、二次能源、耗能工質(zhì)、非能源產(chǎn)品、一次能源折標(biāo)系數(shù)、二次能源折標(biāo)系數(shù)、耗能工質(zhì)折標(biāo)系數(shù)、能效指標(biāo)、經(jīng)濟(jì)指標(biāo)、其他、新能源指標(biāo)、碳指標(biāo)等12類。采集數(shù)據(jù)類型由2位阿拉伯?dāng)?shù)字組成，采集數(shù)據(jù)類型編碼見表B.2。表B.2采集數(shù)據(jù)類型編碼B.3.2能源品種編碼能源品種是能為人類活動提供某種形式能量的物質(zhì)資源，是對能源物質(zhì)的分類。能源品種用4位阿拉伯?dāng)?shù)字進(jìn)行編碼。能源品種編碼、計量單位、折標(biāo)系數(shù)參照GB/T37947.1執(zhí)行。DB21/T3792—2023B.3.3新能源指標(biāo)編碼新能源指標(biāo)編碼見表B.3。表B.3新能源指標(biāo)編碼B.3.4碳指標(biāo)編碼碳指標(biāo)編碼見表B.4。表B.4碳指標(biāo)編碼噸噸噸噸B.3.5非能源類產(chǎn)品非能源類產(chǎn)品是工業(yè)企業(yè)主要生產(chǎn)工序生產(chǎn)出的不屬于能源類的一種產(chǎn)品。非能源類產(chǎn)品用4位阿拉伯?dāng)?shù)字進(jìn)行非能源類產(chǎn)品編碼，參照GB/T37947.1執(zhí)行。B.3.6能效指標(biāo)編碼能效指標(biāo)編碼由4位阿拉伯?dāng)?shù)字構(gòu)成，參照GB/T37947.1執(zhí)行。B.4能源用途編碼能源用途是指能耗在線監(jiān)測系統(tǒng)中重點(diǎn)用能單位對采集數(shù)據(jù)的統(tǒng)計用途，例如購進(jìn)、消費(fèi)、產(chǎn)出、回收利用、庫存、外供等。用途業(yè)務(wù)編碼規(guī)則由2位阿拉伯?dāng)?shù)字組成，第1位數(shù)編碼為分類編碼，用DB21/T3792—20231位阿拉伯?dāng)?shù)字表示。第2位數(shù)編碼為分項(xiàng)編碼，用1位阿拉伯?dāng)?shù)字表示。能源用途編碼見表B.5。表B.5能源用途編碼101220123301240512607128019012345678B.5能耗指標(biāo)編碼能耗指標(biāo)編碼見表B.6。DB21/T3792—2023表B.6能耗指標(biāo)編碼DB21/T3792—2023（資料性）省級平臺與其他應(yīng)用平臺的數(shù)據(jù)傳輸接口C.1地區(qū)能耗統(tǒng)計數(shù)據(jù)接口示例地區(qū)能耗統(tǒng)計數(shù)據(jù)接口示例見表C.1。表C.1地區(qū)能耗統(tǒng)計數(shù)據(jù)接口示例/energyreport/common/getRegionData//互http://25:9001/energyreport/common/getRegionData//電子政務(wù){(diào)"beginTime":1619798400000,"endTime":1627747200000,"onlinORreport":"repo"regionCode":"210000"http://}}{"responseMessage":"RECEIVES"OriginValue":4602715"OriginValue":4602715}DB21/T3792—2023C.2行業(yè)能耗統(tǒng)計數(shù)據(jù)接口示例行業(yè)能耗統(tǒng)計數(shù)據(jù)接口示例見表C.2。表C.2行業(yè)能耗統(tǒng)計數(shù)據(jù)接口示例/energyreport/common/getIndustryData//互http://25:9001/energyreport/common/getIndustryData//電子政務(wù){(diào)"beginTime":161979840000"endTime":162774720000"onlinORreport":"repo"industryCode":"C25}{"responseMessage":"RECEIVES"OriginValue":46027"OriginValue":46027}}DB21/T3792—2023C.3地區(qū)重點(diǎn)項(xiàng)目信息數(shù)據(jù)接口示例地區(qū)重點(diǎn)項(xiàng)目信息數(shù)據(jù)接口示例表C.3。表C.3地區(qū)重點(diǎn)項(xiàng)目信息數(shù)據(jù)接口示例/energyreport/common/getProjectDataByRegion//互聯(lián)http://25:9001/energyreport/common/getProjectDataByRegion//電子{"regionCode":"210000"http://}}{"responseMessage":"RECEIVES{"classified_disposal":"前"construction_content":""construction_site":"沈陽市和平區(qū)xxxx"design_energy_consumption":"120}DB21/T3792—2023C.4行業(yè)重點(diǎn)項(xiàng)目信息數(shù)據(jù)接口示例行業(yè)重點(diǎn)項(xiàng)目信息數(shù)據(jù)接口協(xié)議代碼示例見表C.4。表C.4行業(yè)重點(diǎn)項(xiàng)目信息數(shù)據(jù)接口協(xié)議代碼示例/energyreport/common/getProjectDataByIndustry//互聯(lián)http://25:9001/energyreport/common/g