DB35_T 2000-2021 碳排放数据公共平台数据传输协议.docx

ICS 35.020CCS L 7035福建省地方标准DB35/T 20002021碳排放数据公共平台数据传输协议Protocol for data communication of carbon emission data public platform2021 - 08 - 17 发布2021 - 11 - 17 实施福建省市场监督管理局发 布DB35/T 20002021目次前言 . II1  范围 . 12  规范性引用文件 . 13  术语和定义 . 14  缩略语 . 25  平台架构 . 26  通讯协议 . 37  通讯架构 . 48  通讯接口 . 69  监测数据项编码 . 9附录 A（规范性）  参数信息 . 10附录 B（资料性）  数据传输代码示例 . 20附录 C（规范性）  编码信息 . 33参考文献 . 53IDB35/T 20002021前言本文件按照GB/T 1.12020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由福建省计量科学研究院提出。本文件由福建省信息化标准化技术委员会（SAFJ/TC 11）归口。本文件起草单位：福建省计量科学研究院、厦门奥普拓自控科技有限公司。本文件主要起草人：方仁桂、吴孟辉、褚丹雷、姚进辉、陆青、王智苑、陈为晶、林荣捷。IIDB35/T 20002021碳排放数据公共平台数据传输协议1  范围本文件规定了碳排放数据公共平台数据传输的平台架构、通讯协议、通讯架构、通讯接口和监测数据项编码。本文件适用于排放单位的在线监测端设备与碳排放数据中心之间的数据交换传输。2  规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 2260中华人民共和国行政区划代码GB/T 4754国民经济行业分类GB 18030信息技术中文编码字符集GB 32100法人和其他组织统一社会信用代码编码规则GB/T 32150工业企业温室气体排放核算和报告通则GB/T 32151（所有部分）温室气体排放核算与报告要求JJF 1051计量器具命名与分类编码3  术语和定义GB/T 2260、GB/T 4754、GB 18030、GB 32100、GB/T 32150、GB/T 32151（所有部分）和JJF 1051界定的以及下列术语和定义适用于本文件。3.1温室气体greenhouse gas大气层中自然存在的和由于人类活动产生的能够吸收和散发由地球表面、大气层和云层所产生的、波长在红外光谱内的辐射的气态成分。来源：GB/T 321502015，3.13.2排放单位organization of greenhouse gas emission具有温室气体排放行为的法人企业或视同法人的独立核算单位。来源：GB/T 321502015，3.2，有修改3.3排放源emission source向大气中排放温室气体排放的物理单元或过程。来源：GB/T 321502015，3.5，有修改1DB35/T 200020213.4全球变暖潜势global warming potential将单位质量的某种温室气体在给定时间段内辐射强度影响与等量二氧化碳辐射强度影响相关联的系数。来源：GB/T 321502015，3.15，有修改3.5碳排放数据carbon emission data与二氧化碳当量计算相关的温室气体排放数据。3.6碳排放数据中心carbon emission data center接收、存储、处理和分析在线监测端设备上传的数据，并将碳排放数据核算为二氧化碳当量的软件系统和硬件系统的总称。3.7在线监测端设备online monitoring terminal equipment安装在排放单位，用于采集、存储、处理碳排放数据，并可通过通讯网络与碳排放数据中心进行数据传输的设备。3.8碳排放数据公共平台public platform of carbon emission data由碳排放数据中心与排放单位在线监测端设备组成，应用于碳排放数据的在线采集、实时监测和数据分析等公共服务。4  缩略语下列缩略语适用于本文件。HTTPS：安全超文本传输协议（Hyper Text Transfer Protocol Over Secure Socket Layer）JSON：一种轻量级的数据交换格式（JavaScript Object Notation）TCP/IP：传输控制协议/网际协议（Transmission Control Protocol/Internet Protocol）URL：统一资源定位符（Uniform Resource Locator）5  平台架构平台架构由碳排放数据中心、通讯网络和排放单位的在线监测端设备组成。平台架构如图1所示。2DB35/T 20002021图1  碳排放数据公共平台架构6  通讯协议碳排放数据中心与在线监测端设备之间的传输层基于TCP/IP协议通讯，应用层基于HTTPS协议通讯，协议关系如图2所示。在应用层传输的报文采用JSON交换格式，字符/汉字采用GB 18030编码。图2  通讯协议层次图3序号发送方属性名称说明1在线监测端设备URL请求地址在线监测端设备发起不同请求的碳排放数据中心通讯地址，具体地址定义见表 2。2Method请求方法在线监测端设备请求上传资源。3Header请求头在线监测端设备注册前，内容为空；在线监测端设备注册后，内容为在线监测端设备的 appId 和 token。4Request请求参数当在线监测端设备请求获取资源时，内容为空；当在线监测端设备请求上传资源时，内容为需要上传的资源。5碳排放数据中心Response请求响应当在线监测端设备请求获取资源时，内容为碳排放数据中心回复相应的资源；当在线监测端设备请求上传资源时，内容为碳排放数据中心返回接收的情况。注：appId和token定义按照附录A的表A.1的规定。DB35/T 200020217  通讯架构7.1  通讯模式碳排放数据公共平台通讯模式为“客户端请求/服务端应答”模式，通讯模式如图3所示。其中，在线监测端设备是发起通讯请求的客户端，碳排放数据中心是应答通讯请求的服务端。图3  通讯模式图7.2  通讯报文结构通讯报文结构见表1。表1  通讯报文结构表4序号返回码说明1C0000成功。2C0001成功，请上传最新的排放单位信息。3C0002成功，请上传最新的计量器具信息。4C0003成功，请上传最新的监测数据项信息。5C0004成功，请上传相关仪表表头数据。6C0005成功，请补传相关监测数据项历史数据。7C0101成功，请注意系统通知。8C1001系统服务异常。9C1002数据库异常。10C1003非正常发起请求时间段。11C2001上传参数无法识别。12C2002上传参数的内容缺失。13C2003上传参数的格式错误。14C2101上传数据的时间错误。15C2102上传数据的内容错误。16C2103上传数据的数值大小异常。17C3001appKey 无效。序号请求地址说明1https:/apis/token用于在线监测端设备获取 token。2https:/apis/version用于在线监测端设备获取基础数据版本号。3https:/apis/downloadBaseData用于在线监测端设备下载基础数据。4https:/apis/uploadBaseInfo用于在线监测端设备上传排放单位基本信息。5https:/apis/uploadMeterInfo用于在线监测端设备上传排放单位计量器具信息。6https:/apis/uploadCollectItemInfo用于在线监测端设备上传排放单位监测数据项信息。7https:/apis/uploadCollectData用于在线监测端设备上传排放参数采集数据信息。8https:/apis/uploadCumulativeData用于在线监测端设备上传仪表表头累积数据信息。注：apis为碳排放数据中心服务器的域名或IP。DB35/T 200020217.3  请求地址在线监测端设备根据不同的需求发送不同的请求报文，请求报文的请求地址见表2。表2  请求地址表7.4  返回码碳排放数据中心成功接收并解析请求报文后，返回应答报文，在应答报文中包含返回码。返回码定义见表3。表3  返回码表5序号返回码说明18C3002token 无效。19C9001其他未知错误。注：appKey定义按照附录A的表A.1的规定。DB35/T 20002021表3返回码表（续）8  通讯接口8.1  接口类型通讯接口包括在线监测端设备注册、平台基础数据版本校验、排放单位信息及数据上传等3种类型。8.2  在线监测端设备注册接口8.2.1  在线监测端设备向碳排放数据中心发起初始连接请求时，应提交注册申请，流程包括报备申请、token 申请和平台基础数据下载等三个环节。具体流程如图 4 所示。流程开始排放单位申请在线监测端设备报备报备申请是否成功是在线监测端设备发送token申请请求token申请是否成功是在线监测端设备发送基础数据下载请求基础数据否否否下载是否成功是流程结束图4  在线监测端设备注册流程6序号环节参数信息代码示例1token申请请求按照附录A的表A.2的规定见附录B的表B.12基础数据下载请求按照附录A的表A.3的规定见附录B的表B.2DB35/T 200020218.2.2  排放单位向碳排放数据中心提交在线监测端设备报备申请，碳排放数据中心审核通过后，将碳排放数据中心服务器的域名或 IP、在线监测端设备的 appId 和 appKey 等信息，通过第三方网络发送至排放单位。8.2.3  token 申请和平台基础数据下载等通讯过程的相关参数信息和代码示例索引见表 4。表4  在线监测端设备注册流程信息索引表8.3  平台基础数据版本校验接口8.3.1  在线监测端设备向碳排放数据中心发送平台基础数据版本校验请求，同步碳排放数据中心的最新版本基础数据。具体流程如图 5 所示。流程开始在线监测端设备发送基础数据版本校验请求token是否失效否是在线监测端设备发送token申请请求token申请是否成功是否基础数据版本是否更新否是在线监测端设备发送基础数据下载请求基础数据下载是否成功是否流程结束图5  平台基础数据版本校验流程7序号环节参数信息代码示例1排放单位基本信息上传按照附录 A 的表 A.6 的规定见附录 B 的表 B.42排放单位计量器具信息上传按照附录 A 的表 A.7 的规定见附录 B 的表 B.53排放单位监测数据项信息上传按照附录 A 的表 A.8 的规定见附录 B 的表 B.6序号环节参数信息代码示例1基础数据版本校验请求按照附录 A 的表 A.5 的规定见附录 B 的表 B.32token 申请请求按照附录 A 的表 A.2 的规定见附录 B 的表 B.13基础数据下载请求按照附录 A 的表 A.3 的规定见附录 B 的表 B.28DB35/T 200020218.3.2  各环节通讯过程的相关参数信息和代码示例索引见表 5。表5  平台基础数据版本校验流程信息索引表8.4  排放单位信息及数据上传接口8.4.1  排放单位信息包括基本信息、计量器具信息和监测数据项信息，排放单位数据包括排放参数采集数据和仪表表头累积数据。具体流程如图 6 所示。流程开始在线监测端设备发送排放单位信息/数据上传情况否token是否失效否排放单位信息/数据是否上传成功是是     在线监测端设备发送token申请请求token申请是否成功是否流程结束图6  排放单位信息/数据上传流程8.4.2  在线监测端设备在碳排放中心完成注册或更新排放单位信息后，应向碳排放数据中心上传最新的排放单位信息。8.4.3  各环节通讯过程的相关参数信息和代码示例索引见表 6。表6  排放单位信息/数据上传流程信息索引表序号环节参数信息代码示例4排放参数采集数据上传按照附录 A 的表 A.9 的规定见附录 B 的表 B.75仪表表头累积数据上传按照附录 A 的表 A.10 的规定见附录 B 的表 B.8DB35/T 20002021表6排放单位信息/数据上传流程信息索引表（续）9  监测数据项编码在线监测端设备上传排放单位数据时，应上传每个监测数据项的编码。监测数据项编码由15位阿拉伯数字组成，包括排放行业、排放活动、排放源、排放参数和监测点序号等代码信息，编码结构如图7所示。X XX XX X  X X    X X  X X   X X X3位监测序号代码2位二级排放参数代码2位一级排放参数代码2位排放源分项代码2位排放源分类代码2位排放活动代码2位排放行业代码图7  编码结构各段编码要求如下：a)  排放行业、排放活动、排放源与排放参数的层级关系，根据各行业核算指南的核算方法定义，编码信息按照附录 C 的规定；b)  监测点序号由 3 位阿拉伯数字组成，在 001999 范围内按序编码。示例：某排放单位的某监测数据项编码是 100207200202003，该编码意为：化工生产企业工业生产过程排放原料消耗（碳产品）甲醇碳产品碳产品含碳量第 3 个监测点。9序号发送方参数名称数据长度byte描述1在线监测端设备appId32见表 A.1。2appKey32见表 A.1。3碳排放数据中心token32见表 A.1。4expiredDate19token 过期时间，格式如“yyyy-MM-dd HH:mm:ss”。5responseCode5请求状态返回码，定义见表 3。6responseMsg255返回状态信息。序号参数名称数据长度byte描述1appId32碳排放数据中心分配给在线监测端设备的设备唯一标识码。2appKey32碳排放数据中心分配给在线监测端设备的密钥。3token32碳排放数据中心分配给在线监测端设备的验证码。注1：碳排放数据中心按照管理要求不定期更新密钥。注2：token具有使用有效期，其失效后在线监测端设备应向碳排放数据中心重新提出申请。DB35/T 20002021A                   A附录A（规范性）参数信息表A.1A.10分别为设备、token申请请求、平台基础数据下载请求、平台基础数据下载请求的字典、基础数据版本校验请求、排放单位基本信息上传请求、排放单位计量器具信息上传请求、排放单位监测数据项信息上传请求、排放参数采集数据上传请求、仪表表头累积数据上传请求等参数信息，表A.1A.10的通讯接口中的参数类型均为字符型。表A.1  设备参数信息表A.2  token 申请请求的参数信息10项目名称子项目子项目名称数据长度byte备注iRegion行政区划code区划编码6按照 GB/T 2260 的规定编写。name区划名称128pCode区划父编码6type区划类型1字符1省级，字符2设区市级，字符3县（区、市）级。iEnterpriseType排放单位类型code单位类型编码3参照关于划分企业登记注册类型的规定调整的通知附件中的“企业登记注册类型与代码”编写。name单位类型名称128iEconomicIndustry经济行业code行业编码5按照 GB/T 4754 的规定编写。name行业名称255pCode行业父编码4序号发送方参数名称数据长度 byte描述1在线监测端设备appId32见表 A.1。2token32见表 A.1。3碳排放数据中心字典参数见表 A.4。4uploadTime8每日上传数据时间点，格式如“HH:mm:ss”。5responseCode5请求状态返回码，定义见表 3。6responseMsg255返回状态信息。DB35/T 20002021表A.3  平台基础数据下载请求的参数信息表A.4 平台基础数据下载请求的字典参数信息11项目名称子项目子项目名称数据长度byte备注iEmissionIndustry排放行业code行业编码2按照附录 C 的表 C.1 的规定编写。name行业名称128iEmissionActivity排放活动code排放活动编码2按照附录 C 的表 C.2 的规定编写。name排放活动名称128iEmissionSource排放源code排放源编码2按照附录 C 的表 C.2 和表 C.3 的规定编写。name排放源名称128type排放源等级1字符1分类，字符2分项。pCode排放源父编码2排放源等级为分类级时，此项为空；排放源等级为分项级时，此项为分类编码。emiActCode排放活动编码2iEmissionParameter排放参数code排放参数编码2按照附录 C 的表 C.2 的规定编写。name排放参数名称128type排放参数等级1字符1一级，字符2二级pCode排放参数父编码2排放参数等级为一级时，此项为空；排放参数等级为二级时，此项为一级编码。emiSouTypeCode排放源分类编码2emiSouItemCode排放源分项编码2emiActCode排放活动编码2DB35/T 20002021表 A.4  平台基础数据下载请求的字典参数信息（续）12项目名称子项目子项目名称数据长度byte备注iDataCollectType数据获取方式code获取方式编码2按照附录C的表C.4的规定编写。name获取方式名称32type获取方式等级1字符1分类。字符2分项。pCode获取方式父编码1获取方式等级为分类级时，此项为空；获取方式等级为分项级时，此项为分类编码。iDataSource数据来源code来源编码1按照附录C的表C.5的规定编写。name来源名称32iGasType温室气体类型code气体类型编码3按照附录 C 的表 C.6 的规定编写。name气体类型名称32symbol气体符号12type气体类型1字符1分类，字符2分项。pCode气体类型父编码3类型为分类级时，此项为空；类型为分项级时，此项为分类编码。iMonitorFreq监测频率code频率编码2按照附录C的表C.7的规定编写。name频率名称32iBorderInOut进出边界code进出编码1按照附录C的表C.8的规定编写。name进出名称4DB35/T 20002021表 A.4  平台基础数据下载请求的字典参数信息（续）13序号发送方名称数据长度byte描述1在线监测端设备appId32见表 A.1。2token32见表 A.1。3name256排放单位名称（必填）。4enterpriseCode18统一社会信用代码（必填）。5regionCode6行政区划代码（必填）。6enterpriseTypeCode3单位类型代码（必填）。7economicIndustryCode5经济行业代码（必填）。8emissionIndustryCode2排放行业代码（必填）。9address256排放单位地址（必填）。10longitude18排放单位所在地经度（必填），格式如“xxx.xxxxxx”。11latitude18排放单位所在地纬度（必填），格式如“xxx.xxxxxx”。12legalRepresentative30法定代表人。序号发送方名称数据长度byte描述1在线监测端设备appId32见表 A.1。2token32见表 A.1。3碳排放数据中心regVersion16平台基础数据版本，用于判断平台基础数据是否需要重新下载。4responseCode5请求状态返回码，具体定义见表 3。5responseMsg255返回状态信息。DB35/T 20002021表A.5  基础数据版本校验请求的参数信息表A.6  排放单位基本信息上传请求的参数信息14序号发送方名称数据长度byte描述13在线监测端设备carbonOffice20碳排放监测负责部门。14phone13联系电话（必填）。15fax13传真。16email32电子邮箱。17monitorRespName30监测负责人姓名（必填）。18monitorRespPhone13监测负责人联系电话（必填）。19produceLine255主要生产线。20leadingProduct255主导产品（必填）。21remark255备注。22碳排放数据中心responseCode5请求状态返回码，具体定义见表 3。23responseMsg255返回状态信息。序号发送方名称数据长度byte描述1在线监测端设备appId32见表 A.1。2token32见表 A.1。3enterpriseCode18统一社会信用代码（必填）。4meteringName32计量器具名称（必填）。5manageCode16管理编号（必填）。6meterType8器具类型（必填），按照 JJF 1051 的规定编码。DB35/T 20002021表A.6 排放单位基本信息上传请求的参数信息（续）表A.7  排放单位计量器具信息上传请求的参数信息15序号发送方名称数据长度byte描述7在线监测端设备manuFacturer50生产厂家。8typeSpecification32型号规格（必填）。9accuracyLevel10准确度等级（必填）。10measureRange32测量范围。11collectItemCode15相关的监测数据项编码（必填）。12meterLevel1器具等级（必填），字符1进出用能计量器具，字符2主要次级用能计量器具，字符3主要用能设备计量器具，字符4其他计量器具。13measureState1器具状态（必填），字符1在用，字符2停用，字符3备用。14calibrationCycle16检定/校准周期（必填），格式如“x 年”或“x 月”。15latelyCalibration19最近一次检定/校准时间（必填）。16installationSite50安装地点。17usrSystem32接入系统。18碳排放数据中心responseCode5请求状态返回码，具体定义见表 3。19responseMsg255返回状态信息。DB35/T 20002021表A.7 排放单位计量器具信息上传请求的参数信息（续）16序号发送方名称数据长度byte描述1在线监测端设备appId32见表 A.1。2token32见表 A.1。3enterpriseCode18统一社会信用代码（必填）。4collectItemName128监测数据项名称（必填），按照附录 C 的表 C.1表 C.3 的规定编码。5emissionIndustryCode2排放行业类型编码（必填），按照附录 C 的表 C.1 的规定编码。6emissionActivityCode2排放活动类型编码（必填），按照附录 C 的表 C.1 和表 C.2 的规定编码。7emissionSourceTypeCode2排放源分类编码（必填），按照附录 C 的表 C.1 和表 C.2 的规定编码。8emissionSourceItemCode2排放源分项编码（必填），按照附录 C 的表 C.1表 C.3 的规定编码。9firstLevelCode2一级计算参数编码（必填），按照附录 C 的表 C.1 和表 C.2 的规定编码。10secondLevelCode2二级计算参数编码（必填），按照附录 C 的表 C.1 和表 C.2 的规定编码。11statNumberCode3监测序号编码（必填）。12dataCollectType2采集数据的获取方式（必填），按照附录 C 的表 C.4 的规定编码。13dataSource1采集数据的来源（必填），按照附录 C 的表 C.5 的规定编码。14gasType3温室气体类型编码（必填），按照附录 C 的表 C.6 的规定编码。15monitorFreq2采集数据监测频率（必填），按照附录 C 的表 C.7 的规定编码。16borderInOut1进出排放单位法人边界（必填），按照附录 C 的表 C.8 的规定编码。17dataValueMax15采集数据的最大值，格式如“xxxxxxxx.xx