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)项目名称：重点项目名
26、称;d)项目代码：重点项目代码;e)项目类型：重点项目类型;f)所属地区：重点项目所属地区名称;g)所属行业：重点项目所属行业名称;h)分类处置：重点项目分类处置类型名称;i)建设内容：重点项目详细建设内容;j)建设地点：重点项目详细建设地点，至少精确到区县;k)设计年综合能源消费量：重点项目批复的年综合能源消费量，计量单位吨标准煤。7.3.4行业重点项目信息数据接口7.3.4.1发送信息行业重点项目信息数据接口应提供如下信息：a)用户名：请求接口调用的用户名;b)密码：请求接口调用的密码;c)行业编码：请求的数据所属行业编码参见附录B的B.1。7.3.4.2返回信息行业重点项目信息数据接口返
27、回值包含如下信息：a)返回码：详见表 1;b)状态提示：对返回码的说明，状态提示说明见表1；c)项目名称：重点项目名称;d)项目代码：重点项目代码;DB21/T 3792202310e)项目类型：重点项目类型;f)所属地区：重点项目所属地区名称;g)所属行业：重点项目所属行业名称;h)分类处置：重点项目分类处置类型名称;i)建设内容：重点项目详细建设内容;j)建设地点：重点项目详细建设地点，至少精确到区县;k)设计年综合能源消费量：重点项目批复的年综合能源消费量，计量单位吨标准煤。7.3.5地区企业基础信息接口7.3.5.1发送信息地区企业基础信息接口应提供如下信息：a)用户名：请求接口调用的
28、用户名;b)密码：请求接口调用的密码;c)行政区划代码：请求的数据所属行政区划代码参见附录B的B.1。7.3.5.2返回信息地区企业基础信息接口返回值包含如下信息：a)返回码：详见表 1;b)状态提示：对返回码的说明，状态提示说明见表1；c)企业基本信息：详见地区企业基础信息接口协议代码示例“RESPONSE”部分。7.3.6行业企业基础信息接口7.3.6.1发送信息行业企业基础信息接口应提供如下信息：a)用户名：请求接口调用的用户名;b)密码：请求接口调用的密码;c)行业编码：请求的数据所属行业编码参见附录 B 的 B.1。7.3.6.2返回信息行业企业基础信息接口返回值包含如下信息：a)返
29、回码：详见表 1;b)状态提示：对返回码的说明，状态提示说明见表1；c)企业基本信息：详见行业企业基础信息接口协议代码示例“RESPONSE”部分。DB21/T 3792202311AA附录 A（资料性）省级平台与能耗在线监测端设备的数据传输接口示例A.1 端设备注册接口示例能耗在线监测端设备注册接口示例见表A.1。表 A.1 端设备注册接口示例类型说明URLhttps:/IP:port，/固定的域名或 IP，能耗在线监测系统注册平台MethodPOSTRequestenterpriseCode:9121000123456789X,/统一社会信用代码enterpriseName:xxxx有限公
30、司,/用能单位名称region:210101,/行政区划代码，具体到县级regionName:市辖区/行政区划名称，具体到县级ResponseresponseCode:“0”,/返 回 码responseMessage:RECEIVE SUCCESS,/状态提示deviceId:0ef6ecea08bf84c7b639c3e9b84ed546,/设 备 序 列 号 GUIDloadConfigURL:IP:port/downloadBaseData,/基础数据下载地址“loadDicVersionURL”:“IP:port/versionCheck”,/平台版本下载地址centerInfoUR
31、L:IP:port/uploadConfigData,/用能单位基础信息配置上传地址centerDataURL:IP:port/uploadEnergyData,/采集数据上传地址centerInfoDownloadURL:IP:port/downloadConfigData,/用能单位基础信息配置下载地址centerDataDownloadURL:IP:port/downloadEnergyData,/采集数据下载地址uploadTime:01:05:00;/上报时间点DB21/T 3792202312A.2 基础数据下载接口示例能耗在线监测端设备基础数据下载接口示例见表A.2。表 A.2
32、基础数据下载接口示例类型说明URLhttps:/192.168.1.2/downloadBaseData，/省级平台基础数据下载地址MethodPOSTREQUESTdeviceId:GUID,/从服务地址发布平台获取(必填)type:all,/从服务地址发布平台获取(非必填，默认全部)RESPONSEresponseCode:“0”,/返 回 码responseMessage:RECEIVE SUCCESS,/状态提示data:region:/行政区划（参照 GB/T 2260）code:210000,fullName:辽宁省,name:辽宁省,pcode:000000,/上一级行政区划编码
33、，全国以000000表示。type:1/1：省级，2：市级，3：县级,code:210100,fullName:沈阳市,name:沈阳市,pcode:210000,type:2,code:210101,fullName:市辖区,name:市辖区,pcode:210100,type:3,DB21/T 3792202313表 A.2（续）类型说明RESPONSEindustry:/行业（参照 GB/T 4754）code:C,/行业编码fullName:制造业,/行业全名jgzh:false,/是否能源加工转换类行业name:制造业,/行业名称pcode:0/上一级行业编码,code:C31,fu
34、llName:黑色金属冶炼和延压加工业,jgzh:false,name:黑色金属冶炼和延压加工业,pcode:C,code:C312,fullName:炼钢,jgzh:false,name:炼钢,pcode:C31,code:C3120,fullName:炼钢,jgzh:false,name:炼钢,pcode:C312,entType:/单位类别编码(参照国统字1998200 号文件)code:100,name:内资企业,collectSystemType:/采集系统分类（详见“NECC-NHJC-02”）code:1,name:管理信息系统,DB21/T 3792202314表 A.2（续）
35、类型说明RESPONSEprocess:/生产工序（详见“NECC-NHJC-02”）code:01,name:焦化工序,industryCode:C31/所属行业，如“炼钢”,collectItem:/采集数据项（详见“NECC-NHJC-02”）code:01,name:一次能源,pcode:,/上一级指标编码type:1,/1 采集数据类型；2 分类编码；3 分类编码+分项编码pclass:,/采集数据类型industryCode:,unit:/采集项单位,code:01,name:原煤,pcode:,type:2,pclass:01,/采集数据类型industryCode:,unit:
36、吨/采集项单位,code:0100,name:其他原煤,pcode:01,/上一级指标编码type:3,pclass:01,/采集数据类型，如“01 一次能源”industryCode:,unit:吨/采集项单位,code:0001,name:吨钢综合能耗,pcode:00,type:3,/1 采集数据类型；2 分类编码；3 分类编码+分项编码DB21/T 3792202315表 A.2（续）类型说明RESPONSEpclass:08,/采集数据类型，如“08 能效指标”industryCode:C3120,/行业编码unit:千克标准煤/吨/采集项单位,collectItemUsage:/采
37、集数据项数据用途（详见“NECC-NHJC-02”）code:11,name:购进已消费,energyType:/能源类型，提供各类能源的计量单位和折标系数。同时提供非能源产品、经营指标的的计量单位code:0100,/能耗编码；name:其它原煤,/名称pcode:01,/父编码unit:吨,/单位classCode:01,/大类编码nhzbdw:吨标准煤/吨,/能耗折标单位type:2,/type=1 是分类；type=2 是分类+分项zbckz:0.7143,/折标量参考值dwzbxs:1/单位折标系数,productQuota:/产品指标，提供各类单产能耗指标项的标准值code:000
38、1,/指标编码name:吨钢综合能耗,/指标名regionCode:110101,/地区编码industryCode:C3120,/行业编码gbValue:,/国标dbValue:655,/地方标准elemUnit:吨标准煤,/分子单位denoUnit:吨,/分母单位quotaUnit:千克标准煤/吨,/指标单位zbxs:1000.0/单位换算系数DB21/T 3792202316A.3 平台版本校验接口示例能耗在线监测端设备省级平台版本校验接口示例见表 A.3。表 A.3 省级平台版本校验接口示例类型说明URLhttps:/192.168.1.3/versionCheck，/省级平台版本信息
39、校验地址MethodPOSTRequestdeviceId:0ef6ecea08bf84c7b639c3e9b84ed546,/设备序列号 GUID,ResponseresponseCode:“0”,/返 回 码，详 见 表 1responseMessage:RECEIVESUCCESS,/状态提示regVersion:125,/省级平台：注册服务版本信息dicVersion:125/省级平台：基础数据版本信息A.4 用能单位基础信息上传接口示例能耗在线监测端设备用能单位基础信息上传接口示例见表A.4。表 A.4 用能单位基础信息上传接口示例类型说明DB21/T 3792202317URLht
40、tps:/192.168.1.4/uploadConfigData，/省级平台用能单位基础信息上传地址MethodPOSTREQUESTdeviceId:0ef6ecea08bf84c7b639c3e9b84ed546,/从服务地址发布平台获取(必填)enterpriseCode:91330000573973053F,/统一社会信用代码(必填)collectItemConfig:/采集数据项配置(必填)name:全厂-二次能源-电力-购进已消费,/采集数据项指标名称processCode:00,/生产工序，参照行业采集指南，(必填)processUnitCode:00,/工序单元(必填)equ
41、ipmentCode:00,/重点耗能设备类型(必填)equipmentUnitCode:00,/重点耗能设备编号(必填)energyClassCode:02,/采集对象类型(必填)energyTypeCode:3300,/能源分类+分项(必填)dataUsageCode:11,/用途编码(必填)DB21/T 3792202318表 A.4（续）类型说明REQUESTinputType:1,/数据采集来源(必填)dataValueMax:300000,/数据最大值(非必填)dataValueMin:0,/数据最小值(非必填）statType”:”1”,/采集频率，0 实时;1 日;2 月;3
42、年collectSystemName:EXCENERGY 能源采集系统,/采集系统名称remark:,/备注scope:1/范围 1：全厂，2：生产工序，3：生产工序单元，4：重点耗能设备,enterprise:/用能单位(必填)code:91210000573973053F,/统一社会信用代码(必填)name:示例钢铁有限责任公司,/单位名称(必填)typeCode:159,/单位类型(必填)typeName:其他有限责任公司,/单位类型名industryCode:C3120,/行业编码(必填)regionCode:410481,/区域编码(必填 6 位到地区级别)regionName:示例
43、市,/地区名center:false,/是否央企(必填)corporationCode:91210000573973053F,/统一社会信用代码(必填)jgzh:false,/是否能源加工转换类企业(必填)energyConsumeLevel:4,/1:5000 吨以下,2:500010000 吨，3:1 万-10 万吨，4:10 万-50 万吨，5:50 万-300 万吨，6:300 万吨以上(必填)latitude:33.283433,/用能单位主要厂址中心纬度(必填)longitude:113.505883,/用能单位主要厂址中心经度(必填)phone:0375-8111111,/企业联
44、系电话（必填）fax:0375-8111111,/传真email:,/电子邮箱address:辽宁省示例市人民大道 1 号,/地址zipCode:462500/邮编url:,/用能单位网站地址 URLfieldCode:100,/领域编码，工业:100,交通运输、仓储和邮政业:200,住宿和餐饮业：300，批发和零售业：400，教育：500，其他：600fieldName:工业,/领域名称corporationName:赵钱孙,/法人代表registerDate:1998-10-10 00:00:00,/注册日期registerPrincipal:10000,/注册资金，万元energyOff
45、ice:机电能源部,/能管机构名称DB21/T 3792202319表 A.4(续)类型说明REQUESTenergyOfficial:李周,/主管节能领导姓名energyOfficialPosition:机电能源部主任,/主管节能领导职位energyOfficialPhone:18866669999,/主管节能领导联系电话energyPass:false,/是否通过能源管理体系认证energyRespName:吴郑,/能管负责人姓名energyRespPhone:18677778888,/能管负责人电话passDate:,/认证日期passOrg:,/认证机构productionLine:电
46、弧炉生产宽厚板短流程生产线,/企业主要生产线名称leadingProduct:钢板,/企业主导产品remark:企业信息化水平落后，除电力消费数据外，其他数据指标均采用人工填报方式上传,/备注,group:/集团（非必填）name:河北示例钢铁股份有限公司,/集团名称address:河北省示例市体育南大街 385 号,/集团地址remark:/备注,process:/生产工序(非必填)processCode:06,/生产工序编码processName:电炉工序,/生产工序名称remark:/备注,processUnit:/工序单元(非必填)code:01,/工序单元编码name:#1 电炉,/
47、工序单元名称processCode:06,/生产工序编码commDate:2010-10-10 00:00:00,/投产日期designedCapacity:年产钢水 50 万吨,/生产能力remark:/备注RESPONSEresponseCode:“0”,/返 回 码，详 见 表 1responseMessage:RECEIVE SUCCESS,/状态提示DB21/T 3792202320A.5 用能单位采集数据上传接口示例能耗在线监测端设备采集数据上传接口示例见表A.5。表 A.5 采集数据上传接口示例类型说明URLhttps:/192.168.1.5/uploadEnergyData/
48、省级平台采集数据上传地址,MethodPOSTREQUESTdeviceId:0ef6ecea08bf84c7b639c3e9b84ed546,/从服务地址发布平台获取(必填)enterpriseCode:91330000573973053F,/(必填)data:/(全部属性均必填)dataCode:04-01-0000-040200-30,dataValue:123.45,/数据项的值，数据单位按“NECC-NHJC-02”要求inputType:1,statType:1,/数据采集频率，0 实时、1 日、2 月、3 年statDate:2014-10-09 00:00:00,/数据统计周期
49、的起始时间uploadDate:2014-10-10 21:58:46,scope:1,valid:true,dataCode:04-02-0000-040200-30,dataValue:234.56,/数据项的值，数据单位按“NECC-NHJC-02”要求inputType:1,statType:1,/数据采集频率，0 实时、1 日、2 月、3 年statDate:2014-10-09 00:00:00,/数据统计周期的起始时间uploadDate:2014-10-10 21:58:46,scope:1,valid:true,RESPONSEresponseCode:“0”,/返 回 码，
50、详 见 表 1responseMessage:RECEIVE SUCCESS,/状态提示DB21/T 3792202321A.6 基础数据类型编码能耗在线监测端设备采集的基础数据类型编码见表 A.6。表 A.6 基础数据类型编码表基础数据类型编码基础数据类型说明all全部region行政区划industry行业entType单位类别编码collectSystemType采集系统分类process生产工序collectItem采集数据项collectItemUsage采集数据项数据用途energyType能源类型DB21/T 3792202322A.7 单位类别编码单位类别编码见表 A.7。表
