用能单位能耗在线监测平台数据接口规范
合集下载
相关主题
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
9.1.2 用能单位信息综合查询
功能描述：获取地区所管辖区域、行业、用能单位在省级平台中注册的用能单位信息。 输入：地区、行业、统一社会信用代码。 输出：列出该地区、行业、统一社会信用代码的用能单位的信息，包含用能单位名称、统一社会信 用代码、法人代表、机构类型、行业名称、行政区划名称、联系电话、注册日期、注册资本、单位详细 地址、其他。
4. 令牌ak:如：f61ce23cee1d46b38ed021dd902e3425，该表示在每次请求服务的时候必须带上，用于 标识身份。
5. 基础数据下载地址：如192.168.1.2/downloadBaseData ，用于接入端系统基础数据下载。 6. 平台版本校验地址：如192.168.1.3/versionCheck ，用于平台版本校验。 7. 用能单位基础信息配置上传地址：如192.168.1.4/uploadConfigData ，用于用能单位基础信息上传 至省级平台。 8. 采集数据上传地址：如192.168.1.5/uploadEnergyData ，用于用能单位采集数据上传至省级平台。 9. 用能单位基础信息配置下载地址：如192.168.1.6/downloadConfigData ，用于从省级平台下载用能 单位基础信息。 10. 采集数据下载地址：如192.168.1.7/downloadEnergyData ，用于从省级平台下载用能单位采集数 据。 11.公共机构能源资源数据交换地址：如192.168.1.8/downloadEnergyData ，用于公共机构采集数据 上传至省级平台。 12.上报时间点：如01:05:00 ，用于规定用能单位上传数据至平台的时间。
"enterpriseCode":"91330000573973053F",//统一社会信用代码 "region":"110101"//行政区划代码，具体到县级 }
6 数据交换原理
用能单位和省级平台数据通讯中，用能单位从省级平台获取需要的能源信息，把能源数据通过网络 发送至省级平台。数据交换方式通过https协议接口传输方式进行数据交换。
返回码验证 上传成功
完成
8.1 用能单位能耗在线监测接入端系统管理
上传失败
8.1.1 用能单位能耗在线监测接入端系统注册申请
用能单位能耗在线监测接入端系统完成物理部署、接入网络并运行后，进行接入端系统注册申请。 省级平台的接入端系统注册平台根据用能单位注册申请信息负责线上、线下审核，确认信息的准确性和 有效性，并根据数据交换需求，设定用能单位能耗数据上送时间等信息，通过审核后，用能单位方可接 入使用平台接口。
d.采集数据项编码：参照NECC-NHJC-02。 e.采集数据项数据用途：参照NECC-NHJC-02。 f.产品指标：包含各类单产能耗指标项的指标名称、编码及单位等内容。 备注：其它基础信息详见接口实现章节。
8.4 数据上传
接入端系统定时将采集数据上传至省级平台。 用能单位采集上传的数据指标按照上传周期不同分为每日和每月数据指标上传到省级平台。其中， 每日上传的数据指标包括每日指标和实时指标两类，实时指标为每间隔15分钟采集一次（标准采集频率， 如企业实现困难，采集频率要求可放宽但不能低于1小时一次）的能源消耗实时数据，非人工填报数据 均需上传实时指标。 每一用能单位将数据进行汇总打包后，每日在指定的数据上传时间将本批次数据上传至省级平台。 省级平台成功接收本批次数据后，返回一个成功反馈消息，如果超时还未收到反馈或反馈为失败，则接 入端系统重发，直至收到成功反馈为止。 若重发3次还未成功，则接入端系统将本批次数据保存在队列中，下次上传数据时再次重发，直至 成功。 用能单位采集数据上传应提供如下信息： a.令牌ak：有效令牌 b.接入端系统注册号clientId：由省级平台统一下发管理。 c.用能单位统一社会信用代码enterpriseCode：统一社会信用代码为18位，参见GB 32100。 d.采集数据的具体信息data：包括上传数据项编码、数据项的值、数据有效性、数据范围、数据采 集类型、数据采集频率、数据统计时间、数据上传时间等，详见“9交换数据要求和10接口实现”。 备注：数据上传内容详见接口章节。
行政区划代码 行业编码 生产工序编码 工序单元编码 用能设备编码 数据采集来源编码 采集数据类型编码 能源品种编码 耗能工质编码 非能源类产品 能效指标编码 经营指标编码 其它数据编码 能源用途编码 计量器具编码 能源计量单位及精度 耗能工质计量单位及精度 非能源品种计量单位 能效指标计量单位 能源折标系数及计量单位 经营指标计量单位
用能单位能耗在线监测平台数据接口规范
1 范围
本标准适用于用能单位或主管部门与省级平台数据交换，数据交换内容包括用能单位基本信息、能 源计量器具信息、能源资源计量数据、能耗统计数据、能效指标数据等。
2 规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。
NHJC-02 重点用能单位能耗在线监测系统技术规范 GB 32100 法人和其他组织统一社会信用代码编码规则 GB 17167 用能单位能源计量器具配备与管理通则 GB/T 28749 企业能量平衡网络图绘制方法 GB/T 33656 企业能源计量网络图绘制方法 GB/T 4754 国民经济行业分类 GB/T 2260 中华人民共和国行政区划代码 JJF 1356 重点用能单位能源计量审查规范 JJF 1051 计量器具命名与分类编码 《关于划分企业登记注册类型的规定》（国统字〔2011〕86号）
5 接口调用规范
所有接口以http/https方式通过post请求提供调用服务，调用方式如下： http://[server]/[service]?[params]
参数含义： server ：提供接口的服务器信息(地址和端口)； service：调用接口所提供的服务名称； params:调用接口服务所需要的参数,通过get请求或post请求传送。如果请求数据量大，请用post请求。 调用示例: http请求post方式： http://localhost:81/ng-dc-s/termReg 服务器(端口和地址)：http://localhost:81/ng-dc-s/ 服务名称：termReg， 所需参数： {
接口系统
Https GET/POST Https GET/POST Https GET/POST
用能单位通过网 络访问省级平台 接口系统相应的 数据接口实现数
据交换
网络传输
省级平台
智能仪表/ 传感器
DCS/PLC/ MES/EMS
手工抄表
用能单位
用能单位可以通过网络以Https POST方式向省级平台发送相应的数据。
8.1.2 接入端系统注册状态查询
接入端系统根据平台要求提交注册申请后，可通过注册申请时提交的统一社会信用代码及密码等其 它必要信息，进行注册是否通过的查询，如注册通过，平台将返回以下信息：
1. 接入端系统序列号“clientId”：为接入端系统统一编码，为32位，由平台统一生成并下发。 2. 令牌生效期：akValidAt:2019-08-12 12:22:33 3. 令牌有效期：akExpiresIn：如720000，单位秒，如果当前时间超过令牌生效开始时间加有效期， 那么令牌失效，需要重新申请。
7 数据交换格式
7.1 交换格式 交换格式有两种：XML和JSON。
7.2 返回值 数据交换后，服务地址获取返回码定义为： 0：请求成功 E1001：平台服务异常 E1002：服务器数据库异常 E2001：请求参数异常，缺少必填项 E2002：请求参数异常，参数格式不合法
8 用能单位数据交换流程
接入 端系统 安装 部署
CA认证
通过
用能 单位接 入端系 统注册 申请
不通过
联系 相关单 位解决
申请失败
返回码验证 申请成功
版本变更
接入端系统注册状态查询 下载失败
基础 数据下 载
返回码验证 下载完成
用能 单位采 集配置 数据下 载 用能 单位采 集数据 下载
平台版本校验 版本无变更
用能 单位基 础数据 上传
上传失败
返回码验证
8.2 平台版本校验（在线升级）
省级平台的注册服务信息或基础数据更改后，相应版本信息进行更新。接入端系统基于此版本信息， 重新上传或下载基础数据。
版本校验应提供如下信息： a.接入端系统注册号clientId：由省级平台统一下发管理。 b.令牌ak：由省级平台维护，有效期请根据申请得到的令牌有效期自动维护，以防令牌失效影响提 供服务。 省级平台返回值包含如下信息： a.省级平台注册服务版本信息：如125，为省级平台注册服务的版本编号。 b.省级平台基础数据版本信息：如125，为省级平台基础数据的版本编号。
可扩展标记语言，标准通用标记语言的子集，是一种用于标记电子文件使其具有结构性的标记语言。 它可以用来标记数据、定义数据类型，是一种允许用户对自己的标记语言进行定义的源语言。它被设计 用于存储和传输数据。
3.4 数字证书 数字证书就是互联网通讯中标志通讯各方身份信息的一串数字，提供了一种在Internet上验证通信
9.1.3 用能单位计量器具信息综合查询
功能描述：获取不同地区、不同行业、用能单位的计量器具信息。 输入：地区、行业、统一社会信用代码。 输出：列出计量器具清单,包含用能单位名称、计量器具名称、规格型号、准确度等级、测量范围、 生产厂家、出厂编号、用能单位管理编号、安装使用地点、状态(合格/准用/停用)等。
9 数据交换要求
9.1 省级平台数据交换要求
业务描述：主管部门获取用能单位基础能源信息、能源计量器具信息、用能单位综合能耗及能耗指 标等，为主管部门Leabharlann Baidu源决策提供数据参考。
对于该接口未提供的数据，可以定制化。
9.1.1 能耗信息综合查询
功能描述：获取地区管辖地区、行业、用能单位或介质的能耗，综合能耗单位：万吨标准煤。 输入：行政区划代码、企业所属行业、用能单位、用能单位介质、统计时间（月）。 输出：列出某地区所管辖区域的能耗信息，包含行政区划名称、行业名、用能单位、介质综合能耗、 单位、统计时间。
8.3 基础数据下载
省级平台的基础数据更改后，相应版本信息进行更新。接入端系统比较本地的基础数据版本信息， 重新下载基础数据。
基础数据下载应提供如下信息： a.接入端系统注册号clientId：由省级平台统一下发管理。 b.令牌ak：由省级平台维护，有效期请根据申请得到的令牌有效期自动维护，以防令牌失效影响提 供服务。 省级平台返回值包含如下信息： a.行政区划代码：参照GB/T 2260。 b.行业代码：参照GB/T 4754。 c.单位类别编码：参照国统字〔2011〕86号。
上传成功
用能 单位采 集配置 数据上 传
上传失败
返回码验证
上传成功
用能 单位采 集数据 上传
企业联系人 能源管理体系信息 能源管理人员信息 能源计量人员配置信息 企业物料产品信息 企业产值、增加值、销售收入 企业产品结构信息 企业节能项目情况 企业水、电、燃气户号信息
基础 数据本 地保存 处理
生产工序 工序单元 重点用能设备信息 能源计量器具基本信息 能源计量器具更换记录 能源计量器具校准记录 采集数据项配置 用能单位折标系数
实体身份的方式，数字证书不是数字身份证，而是身份认证机构盖在数字身份证上的一个章或印（或者 说加在数字身份证上的一个签名）。它是由权威机构——CA机构，又称为证书授权（Certificate Authority） 中心发行的，人们可以在网上用它来识别对方的身份。
4 数据接口授权
为了保证能源资源数据在网络传输过程中的安全,接口采用省级平台交互身份认证的令牌token进 行接口授权。
3 术语和定义
下列术语和定义适用于本标准。 3.1 省级平台
省级平台（用能单位能耗在线监测平台）是部署在省级节能相关部门，接收、存储、汇总、分析本 地内重点用能单位能耗在线监测数据，为本地相关政府部门、用能单位提供应服务。 3.2 JSON
JSON(JavaScript Object Notation) 是一种轻量级的数据交换格式, 处理Javascript和web服务器端的 之间数据交换。 3.3 XML
功能描述：获取地区所管辖区域、行业、用能单位在省级平台中注册的用能单位信息。 输入：地区、行业、统一社会信用代码。 输出：列出该地区、行业、统一社会信用代码的用能单位的信息，包含用能单位名称、统一社会信 用代码、法人代表、机构类型、行业名称、行政区划名称、联系电话、注册日期、注册资本、单位详细 地址、其他。
4. 令牌ak:如：f61ce23cee1d46b38ed021dd902e3425，该表示在每次请求服务的时候必须带上，用于 标识身份。
5. 基础数据下载地址：如192.168.1.2/downloadBaseData ，用于接入端系统基础数据下载。 6. 平台版本校验地址：如192.168.1.3/versionCheck ，用于平台版本校验。 7. 用能单位基础信息配置上传地址：如192.168.1.4/uploadConfigData ，用于用能单位基础信息上传 至省级平台。 8. 采集数据上传地址：如192.168.1.5/uploadEnergyData ，用于用能单位采集数据上传至省级平台。 9. 用能单位基础信息配置下载地址：如192.168.1.6/downloadConfigData ，用于从省级平台下载用能 单位基础信息。 10. 采集数据下载地址：如192.168.1.7/downloadEnergyData ，用于从省级平台下载用能单位采集数 据。 11.公共机构能源资源数据交换地址：如192.168.1.8/downloadEnergyData ，用于公共机构采集数据 上传至省级平台。 12.上报时间点：如01:05:00 ，用于规定用能单位上传数据至平台的时间。
"enterpriseCode":"91330000573973053F",//统一社会信用代码 "region":"110101"//行政区划代码，具体到县级 }
6 数据交换原理
用能单位和省级平台数据通讯中，用能单位从省级平台获取需要的能源信息，把能源数据通过网络 发送至省级平台。数据交换方式通过https协议接口传输方式进行数据交换。
返回码验证 上传成功
完成
8.1 用能单位能耗在线监测接入端系统管理
上传失败
8.1.1 用能单位能耗在线监测接入端系统注册申请
用能单位能耗在线监测接入端系统完成物理部署、接入网络并运行后，进行接入端系统注册申请。 省级平台的接入端系统注册平台根据用能单位注册申请信息负责线上、线下审核，确认信息的准确性和 有效性，并根据数据交换需求，设定用能单位能耗数据上送时间等信息，通过审核后，用能单位方可接 入使用平台接口。
d.采集数据项编码：参照NECC-NHJC-02。 e.采集数据项数据用途：参照NECC-NHJC-02。 f.产品指标：包含各类单产能耗指标项的指标名称、编码及单位等内容。 备注：其它基础信息详见接口实现章节。
8.4 数据上传
接入端系统定时将采集数据上传至省级平台。 用能单位采集上传的数据指标按照上传周期不同分为每日和每月数据指标上传到省级平台。其中， 每日上传的数据指标包括每日指标和实时指标两类，实时指标为每间隔15分钟采集一次（标准采集频率， 如企业实现困难，采集频率要求可放宽但不能低于1小时一次）的能源消耗实时数据，非人工填报数据 均需上传实时指标。 每一用能单位将数据进行汇总打包后，每日在指定的数据上传时间将本批次数据上传至省级平台。 省级平台成功接收本批次数据后，返回一个成功反馈消息，如果超时还未收到反馈或反馈为失败，则接 入端系统重发，直至收到成功反馈为止。 若重发3次还未成功，则接入端系统将本批次数据保存在队列中，下次上传数据时再次重发，直至 成功。 用能单位采集数据上传应提供如下信息： a.令牌ak：有效令牌 b.接入端系统注册号clientId：由省级平台统一下发管理。 c.用能单位统一社会信用代码enterpriseCode：统一社会信用代码为18位，参见GB 32100。 d.采集数据的具体信息data：包括上传数据项编码、数据项的值、数据有效性、数据范围、数据采 集类型、数据采集频率、数据统计时间、数据上传时间等，详见“9交换数据要求和10接口实现”。 备注：数据上传内容详见接口章节。
行政区划代码 行业编码 生产工序编码 工序单元编码 用能设备编码 数据采集来源编码 采集数据类型编码 能源品种编码 耗能工质编码 非能源类产品 能效指标编码 经营指标编码 其它数据编码 能源用途编码 计量器具编码 能源计量单位及精度 耗能工质计量单位及精度 非能源品种计量单位 能效指标计量单位 能源折标系数及计量单位 经营指标计量单位
用能单位能耗在线监测平台数据接口规范
1 范围
本标准适用于用能单位或主管部门与省级平台数据交换，数据交换内容包括用能单位基本信息、能 源计量器具信息、能源资源计量数据、能耗统计数据、能效指标数据等。
2 规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文 件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。
NHJC-02 重点用能单位能耗在线监测系统技术规范 GB 32100 法人和其他组织统一社会信用代码编码规则 GB 17167 用能单位能源计量器具配备与管理通则 GB/T 28749 企业能量平衡网络图绘制方法 GB/T 33656 企业能源计量网络图绘制方法 GB/T 4754 国民经济行业分类 GB/T 2260 中华人民共和国行政区划代码 JJF 1356 重点用能单位能源计量审查规范 JJF 1051 计量器具命名与分类编码 《关于划分企业登记注册类型的规定》（国统字〔2011〕86号）
5 接口调用规范
所有接口以http/https方式通过post请求提供调用服务，调用方式如下： http://[server]/[service]?[params]
参数含义： server ：提供接口的服务器信息(地址和端口)； service：调用接口所提供的服务名称； params:调用接口服务所需要的参数,通过get请求或post请求传送。如果请求数据量大，请用post请求。 调用示例: http请求post方式： http://localhost:81/ng-dc-s/termReg 服务器(端口和地址)：http://localhost:81/ng-dc-s/ 服务名称：termReg， 所需参数： {
接口系统
Https GET/POST Https GET/POST Https GET/POST
用能单位通过网 络访问省级平台 接口系统相应的 数据接口实现数
据交换
网络传输
省级平台
智能仪表/ 传感器
DCS/PLC/ MES/EMS
手工抄表
用能单位
用能单位可以通过网络以Https POST方式向省级平台发送相应的数据。
8.1.2 接入端系统注册状态查询
接入端系统根据平台要求提交注册申请后，可通过注册申请时提交的统一社会信用代码及密码等其 它必要信息，进行注册是否通过的查询，如注册通过，平台将返回以下信息：
1. 接入端系统序列号“clientId”：为接入端系统统一编码，为32位，由平台统一生成并下发。 2. 令牌生效期：akValidAt:2019-08-12 12:22:33 3. 令牌有效期：akExpiresIn：如720000，单位秒，如果当前时间超过令牌生效开始时间加有效期， 那么令牌失效，需要重新申请。
7 数据交换格式
7.1 交换格式 交换格式有两种：XML和JSON。
7.2 返回值 数据交换后，服务地址获取返回码定义为： 0：请求成功 E1001：平台服务异常 E1002：服务器数据库异常 E2001：请求参数异常，缺少必填项 E2002：请求参数异常，参数格式不合法
8 用能单位数据交换流程
接入 端系统 安装 部署
CA认证
通过
用能 单位接 入端系 统注册 申请
不通过
联系 相关单 位解决
申请失败
返回码验证 申请成功
版本变更
接入端系统注册状态查询 下载失败
基础 数据下 载
返回码验证 下载完成
用能 单位采 集配置 数据下 载 用能 单位采 集数据 下载
平台版本校验 版本无变更
用能 单位基 础数据 上传
上传失败
返回码验证
8.2 平台版本校验（在线升级）
省级平台的注册服务信息或基础数据更改后，相应版本信息进行更新。接入端系统基于此版本信息， 重新上传或下载基础数据。
版本校验应提供如下信息： a.接入端系统注册号clientId：由省级平台统一下发管理。 b.令牌ak：由省级平台维护，有效期请根据申请得到的令牌有效期自动维护，以防令牌失效影响提 供服务。 省级平台返回值包含如下信息： a.省级平台注册服务版本信息：如125，为省级平台注册服务的版本编号。 b.省级平台基础数据版本信息：如125，为省级平台基础数据的版本编号。
可扩展标记语言，标准通用标记语言的子集，是一种用于标记电子文件使其具有结构性的标记语言。 它可以用来标记数据、定义数据类型，是一种允许用户对自己的标记语言进行定义的源语言。它被设计 用于存储和传输数据。
3.4 数字证书 数字证书就是互联网通讯中标志通讯各方身份信息的一串数字，提供了一种在Internet上验证通信
9.1.3 用能单位计量器具信息综合查询
功能描述：获取不同地区、不同行业、用能单位的计量器具信息。 输入：地区、行业、统一社会信用代码。 输出：列出计量器具清单,包含用能单位名称、计量器具名称、规格型号、准确度等级、测量范围、 生产厂家、出厂编号、用能单位管理编号、安装使用地点、状态(合格/准用/停用)等。
9 数据交换要求
9.1 省级平台数据交换要求
业务描述：主管部门获取用能单位基础能源信息、能源计量器具信息、用能单位综合能耗及能耗指 标等，为主管部门Leabharlann Baidu源决策提供数据参考。
对于该接口未提供的数据，可以定制化。
9.1.1 能耗信息综合查询
功能描述：获取地区管辖地区、行业、用能单位或介质的能耗，综合能耗单位：万吨标准煤。 输入：行政区划代码、企业所属行业、用能单位、用能单位介质、统计时间（月）。 输出：列出某地区所管辖区域的能耗信息，包含行政区划名称、行业名、用能单位、介质综合能耗、 单位、统计时间。
8.3 基础数据下载
省级平台的基础数据更改后，相应版本信息进行更新。接入端系统比较本地的基础数据版本信息， 重新下载基础数据。
基础数据下载应提供如下信息： a.接入端系统注册号clientId：由省级平台统一下发管理。 b.令牌ak：由省级平台维护，有效期请根据申请得到的令牌有效期自动维护，以防令牌失效影响提 供服务。 省级平台返回值包含如下信息： a.行政区划代码：参照GB/T 2260。 b.行业代码：参照GB/T 4754。 c.单位类别编码：参照国统字〔2011〕86号。
上传成功
用能 单位采 集配置 数据上 传
上传失败
返回码验证
上传成功
用能 单位采 集数据 上传
企业联系人 能源管理体系信息 能源管理人员信息 能源计量人员配置信息 企业物料产品信息 企业产值、增加值、销售收入 企业产品结构信息 企业节能项目情况 企业水、电、燃气户号信息
基础 数据本 地保存 处理
生产工序 工序单元 重点用能设备信息 能源计量器具基本信息 能源计量器具更换记录 能源计量器具校准记录 采集数据项配置 用能单位折标系数
实体身份的方式，数字证书不是数字身份证，而是身份认证机构盖在数字身份证上的一个章或印（或者 说加在数字身份证上的一个签名）。它是由权威机构——CA机构，又称为证书授权（Certificate Authority） 中心发行的，人们可以在网上用它来识别对方的身份。
4 数据接口授权
为了保证能源资源数据在网络传输过程中的安全,接口采用省级平台交互身份认证的令牌token进 行接口授权。
3 术语和定义
下列术语和定义适用于本标准。 3.1 省级平台
省级平台（用能单位能耗在线监测平台）是部署在省级节能相关部门，接收、存储、汇总、分析本 地内重点用能单位能耗在线监测数据，为本地相关政府部门、用能单位提供应服务。 3.2 JSON
JSON(JavaScript Object Notation) 是一种轻量级的数据交换格式, 处理Javascript和web服务器端的 之间数据交换。 3.3 XML