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

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