DL
中华人民共和国电力行业标准
DL/T 2978.42025
Power blockchain green electricity trading-Part 4: Interface requirements
国家能源局 发布
目次
前言.. II1范围 12规范性引用文件4缩略语 3术语和定义. .1 15接口技术要求6接口调用流程..7接口规约. 7.1接口分类 37.2数据封装基本要求. .3 37.3数据类型 47.4电力区块链平台接收数据的接口规约. .47.4.1接口请求.7.5电力区块链平台提供数据的接口规约 7.4.2接口返回... .4 .57.5.1接口请求. 57.5.2接口返回8接口信息内容 68.2电力区块链平台接收信息内容 8.1数据交互要求 9* .68.2.1经营主体信息. 98.2.2 合同信息.. 78.2.4结算信息. 8.2.3 合同映射关系. .88.2.5 绿证划转信息. 6 .98.3电力区块链平台提供信息内容. ..98.3.1链上经营主体信息. .98.3.2链上合同信息 .108.3.3链上结算信息.. 8.3.4链上绿证划转信息 .11 .128.3.5绿电消费证明. 12
前言
本文件按照GB/T1.1-2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草.
本文件是DL/T2978《电力区块链绿电交易》的第4部分.DL/T2978已经发布了以下部分：
一一第1部分：通用要求： 一-第2部分：流程要求；一第3部分：功能要求：一一第4部分：接口要求.
请注意本文件的某些内容可能涉及专利.本文件的发布机构不承担识别专利的责任.
本文件由中国电力企业联合会提出并归口.
本文件起草单位：国网数字科技控股有限公司、北京电力交易中心有限公司、国网雄安金融科技集团有限公司、国网区块链科技（北京）有限公司、四川中电启明星信息技术有限公司、北京科东电力控制系统有限责任公司、中国电力科学研究院有限公司、山西电力交易中心有限公司、国网能源研究院有限公司、甘肃电力交易中心有限公司、山东电力交易中心有限公司、宁夏电力交易中心有限公司、中国徽省电力有限公司铜陵供电公司、首都电力交易中心有限公司、浙江电力交易中心有限公司、华北电力 华电集团有限公司、国家电力投资集团有限公司、中国华能集团清洁能源技术研究院有限公司、国网安大学、上海交通大学、西安交通大学、西安电子科技大学、国家电网有限公司大数据中心、国网江苏省电力有限公司无锡供电分公司、数盾信息科技股份有限公司.
本文件主要起草人：王栋、张显、蒋炜、谢开、常青、张楠、庞博、李竹、刘硕、温婷婷、李达、曹瑛辉、谢文、常新、刘俊、高春成、傅、刘永辉、郭庆雷、宋坤、王彩霞、郑亚先、王琪、张圣楠、稀士杰、于松泰、弓建华、石竹玉、李鑫、纪鹏、董晓亮、股智、张学森、吴敏、王秀丽、周明、王一哲、袁明珠、金一丁、张哲、朱皇儒、王立、王海英、杨光宇、加鹤萍、李国栋、司良奇、梁赫霄、马子明、李培军、孙庆生、户平、吕经纬、张翼、王峰、雷雪姣、史昕、武昭原、王兴存、方硕、邢通、李强、庄晓丹、金骆松、袁浩、孙鸿雁、王帆、冯恒、杨文亮、薛颖、孔宪琳、裴庆祺、张辰达、雷明阳、陈思捷、师玮、马小小、吴冰洲、计策、刘芹、凡航、於慧敏、费彬.
本文件为首次发布.
本文件在执行过程中的意见或建议至中国电力企业联合会标准化管理中心（北京市白广路二条一号，100761）.
引言
为实现碳达峰、碳中和目标，建立有利于促进绿色能源生产消费的市场体系和长效机制，2021年9月，国家发展改革委、国家能源局正式启动绿色电力交易试点，目前，已建成体系化、规模化的绿色电力市场.为进一步落实国家发展改革委、国家能源局印发的《电力中长期交易基本规则一绿色电力交易制定《电力区块链绿电交易》系列标准.
技术方案进行梳理，总结提出基于区块链的绿色电力交易共性要求，为构建更加安全、高效、便捷的绿 DL/T2978《电力区块链绿电交易》系列标准通过对绿色电力交易业务中电力区块链应用的架构和色电力交易应用提供参考和指导，为实现“碳达峰、碳中和”目标提供有力支撑.本系列标准包括4部分，分别作出通用要求、流程要求、功能要求、接口要求.
一第1部分：通用要求.规定了应用于绿电交易的电力区块链平台的参考架构和技术要求，旨在为能源行业开展电力区块链绿电交易业务设定基本遵循.
第2部分：流程要求.规定了区块链技术支撑绿电交易应用的业务流程和具体要求，旨在指导电力交易机构采用区块链技术开展绿电交易业务.
第3部分：功能要求.规定了绿电交易电力区块链平台的总体功能要求和具体要求，旨在指导开展绿电交易业务时绿电交易电力区块链平台的功能设计.
程，规定了数据接口的技术要求、接口规约和信息内容，旨在指导绿电交易业务中电力区块链平台数据 一第4部分：接口要求.描述了电力区块链平台向绿电交易平台提供信息交互数据接口的调用流接口的设计、开发与实施.
电力区块链绿电交易第4部分：接口要求
1范围
术要求、调用流程、接口规约及接口信息内容. 本文件规定了电力区块链平台向绿电交易平台提供信息交互的数据接口（以下简称“接口”）的技
本文件适用于绿电交易业务中电力区块链平台数据接口的设计、开发与实施.
2规范性引用文件
下列文件中的内容通过文件中的规范性引用而构成本文件必不可少的条款.其中，注日期的引用文件，仅该日期对应的版本适用于本文件：不注日期的引用文件，其最新版本（包括的修改单）适用于本文件.
DL/T2978.1-2025电力区块链绿电交易第1部分：通用要求
3术语和定义
DL/T2978.1-2025界定的以及下列术语和定义适用于本文件.
3. 1
绿电交易信息网关服务greenelectricity transaction information gateway service
网关服务
部署在电力区块链平台上，用于接收绿电交易平台的绿电交易信息和绿证划转信息的上链、查询请求，绿电消费证明获取请求，拦截非法请求和错误请求的接入服务.
4缩略语
API：应用程序接口（application programming interface） 下列缩略语适用于本文件.HTTPS：超文本传输安全协议（hyper text transfer protocol over securesocket layer）ID：身份标识号（identification）JSON：JavaScript 对象表示法（JavaScript object notation）XML：可扩展标记语言（extensible markup language） UTF-8：8位统-码转换格式（8-bit unicode transformation format）
5接口技术要求
接口应满足以下技术要求：
a）接口设计以绿电交易业务需求为导向，根据智能合约编译、部署和执行规则设计，当业务需求或智能合约发生改变时，更新或新建接口：b）数据传输采用HTTPS协议，接口服务调用采用提交（POST）请求方法：
