DB42∕T 2527-2026 充电基础设施公共信息接入与应用规程_第1页
DB42∕T 2527-2026 充电基础设施公共信息接入与应用规程_第2页
DB42∕T 2527-2026 充电基础设施公共信息接入与应用规程_第3页
DB42∕T 2527-2026 充电基础设施公共信息接入与应用规程_第4页
DB42∕T 2527-2026 充电基础设施公共信息接入与应用规程_第5页
已阅读5页,还剩42页未读 继续免费阅读

下载本文档

版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领

文档简介

ICS35.240.01

CCSL67

DB42

湖北省地方标准

DB42/T2527—2026

充电基础设施公共信息接入与应用规程

Technicalspecificationforpublicinformationaccessandapplication

ofelectricvehiclecharginginfrastructure

2026-02-13发布2026-04-13实施

湖北省市场监督管理局  发布

DB42/T2527—2026

目次

前言III

1范围1

2规范性引用文件1

3术语和定义1

4接入内容1

5接入信息要求1

5.1接入字段要求1

5.2数据质量要求2

6接入与应用要求2

6.1总体架构2

6.2接入流程参考2

7接口要求3

7.1查询运营商信息3

7.2查询充换电站信息4

7.3推送充换电站信息5

7.4查询电池箱信息5

7.5推送电池箱信息6

7.6推送电池箱状态信息7

7.7查询充换电站状态信息7

7.8推送充电设备接口状态信息8

7.9推送充电状态信息8

7.10推送充电订单信息9

7.11推送历史充电订单信息10

7.12推送换电订单信息11

7.13推送充换电站用能统计信息11

7.14推送充换电站实时功率12

7.15查询充电事故信息13

7.16查询补贴发放信息14

7.17推送有序放电订单信息14

8接入安全要求15

8.1数据传输体系15

8.2平台认证要求17

8.3密钥的管理和使用19

9标准实施与评价20

9.1实施方法20

9.2实施范围20

I

DB42/T2527—2026

9.3条件要求20

9.4实施落实情况20

9.5实施评价分析21

9.6意见反馈21

附录A(资料性)公共信息对象22

附录B(资料性)湖北省地方标准实施信息及意见反馈表42

参考文献43

II

DB42/T2527—2026

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分:标准化文件的结构和起草规则》的规定

起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由湖北华中电力科技开发有限责任公司提出。

本文件由国网湖北省电力有限公司归口。

本文件起草单位:湖北华中电力科技开发有限责任公司、国网电动汽车服务湖北有限公司、武汉市

充换电技术有限公司、湖北省标准化与质量研究院、湖北交投新能源投资有限公司、武汉电动汽车技术

开发有限公司、武汉烽火富华电气有限责任公司、武汉腾云慧城科技有限公司。

本文件主要起草人:朱银军、陈敬佳、马强、佟翾、李劲松、李晓鹏、何艳、房亮、陶元、徐文渊、

姜楠、李婳婧、李航、张帅、罗肖、陈卓、马梓熔、易飞、王黎、朱优明、莫炜罡、季健康、高源、万

小莉、刘进、董启旺、谢宇阳、陈磊。

本文件实施应用中的疑问或修改意见建议请反馈至国网湖北省电力有限公司,联系电话:

系电话邮箱:417860905@。或者湖北省市场监督管理局,联系电话

邮箱:hbbzhc@163.com。

III

DB42/T2527—2026

充电基础设施公共信息接入与应用规程

1范围

本文件规定了湖北省内充电基础设施公共信息的接入内容、接入信息要求、接入流程、接口要求、

接入安全要求、应用和标准实施与评价等。

本文件适用于湖北省充电基础设施公共信息接入与应用。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,

仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本

文件。

GB/T9387.1信息技术开放系统互连基本参考模型第1部分:基本模型

GB/T20271信息安全技术信息系统安全通用技术要求

GB/T22239信息安全技术信息系统安全等级保护基本要求

GB/T25070信息安全技术信息系统等级保护安全设计技术要求

3术语和定义

下列术语和定义适用于本文件。

3.1

公共信息publicinformation

充电基础设施基础信息及运行信息,例如充换电站档案、充电设备档案、充电设备接口档案、充电

订单信息、充电状态信息等。

3.2

时区timezone

为避免不同时区带来的差异,本规程中所提及的时间均采用北京时间(UTC+8)。

4接入内容

接入对象包括应接入对象、宜接入对象、可拓展对象,其中应接入对象为运营商信息、充换电站信

息、充电设备信息、充电设备接口信息、充换电站状态信息、充电设备接口状态信息、充电状态信息、

充电订单信息、充电明细信息;宜接入对象为换电设备信息、电池箱信息、电池箱状态信息、换电订单

信息、充换电站用能统计信息、充电设备运行统计信息、充电设备接口运行统计信息、充换电站功率信

息、充电设备功率信息、充电设备接口功率信息;可拓展对象为补贴发放信息、充电事故信息、有序放

电订单信息。具体接入字段可参考附录A。

5接入信息要求

5.1接入字段要求

1

DB42/T2527—2026

接入信息内各字段根据实际业务情况分为应接入信息、宜接入信息、可拓展信息,针对各字段存在

不同格式要求及业务含义要求,详细定义见附录A。

5.2数据质量要求

为确保充电基础设施公共信息可正常应用,公共信息数据质量应满足应接入信息无遗漏、宜接入信

息与可拓展信息自愿补全、接入信息格式无异常等基础要求,各数据需求方宜通过数据的完整性、有效

性、准确性、唯一性、合理性、及时性六个方面自行制定数据质量要求。

6接入与应用要求

6.1总体架构

总体架构见图1,充电运营服务企业基于本规程,通过社会充电运营服务平台对各级新能源汽车充

电基础设施公共平台开展信息上报,各级新能源汽车充电基础设施公共平台依托本规程开展信息互联互

通,由湖北省新能源汽车充电基础设施公共平台开展对平台间信息共享应用。通过本规程的实施,以规

范省内充电基础设施公共信息的共享,加快省内充电基础设施行业快速发展。

图1总体架构图

6.2接入流程参考

充电基础设施公共信息接入的流程如图2所示,步骤说明如下:

a)数据对接方对数据需求方提出数据对接通知;

b)数据需求方针对该数据对接方创建技术沟通渠道;

c)数据对接方根据数据需求方要求,提供相关资料至数据需求方;

d)数据对接方与数据需求方开展测试环境联调、正式环境联调;

e)正式环境联调通过后,数据对接方需根据数据需求方要求,开放对应数据权限,开展数据推

送,推送完毕后双方需对接入总量进行核对,确保无数据漏传丢失情况;

f)数据需求方根据平台内数据治理规则,对接入数据进行治理,若发现异常数据则反馈至数据

对接方,并详细告知整改方案;

2

DB42/T2527—2026

g)数据对接方根据数据需求方反馈的异常数据,开展数据治理,整改后推送至数据需求方;

h)数据需求方再次对数据进行治理,若无问题,则完成数据接入流程。

图2接入流程图

7接口要求

7.1查询运营商信息

7.1.1概述

此接口用于查询运营商的信息。

7.1.2接口定义

接口名称:supervise_query_operator_info

接口使用方法:由数据提供方实现此接口,数据需求方调用。

调用频率:每天至少一次,数据需求方依托实际业务情况,宜选取每日业务低谷时段调用,例如

02:00~04:00区间调用。

7.1.3输入参数

3

DB42/T2527—2026

查询运营商信息接口输入参数见表1。

表1查询运营商信息输入参数

名称定义描述必填类型

查询页码PageNo不填写默认为1是整型

每页数量PageSize不填写默认为50是整型

7.1.4返回值

查询运营商信息接口返回值见表2。

表2查询运营商信息返回值

名称字段描述必填类型

当前页数PageNo如果查询页面大于页码总数,返回查询页码数是整型

页码总数PageCount总页数是整型

总记录条数ItemSize符合条件的总数是整型

运营商信息列表OperatorInfos参考公共对象:运营商信息是SupOperatorInfo数组

7.2查询充换电站信息

7.2.1概述

此接口用于主动查询充换电站信息、充电设备信息、充电设备接口信息。

7.2.2接口定义

接口名称:supervise_query_stations_info

接口使用方法:由数据提供方实现此接口,数据需求方调用。

调用频率:每天至少一次,数据需求方依托实际业务情况,宜选取每日业务低谷时段调用,例如

02:00~04:00区间调用。

7.2.3输入参数

查询充换电站信息接口输入参数见表3。

表3查询充换电站信息输入参数

名称字段描述必填类型

运营商IDOperatorID运营商服务平台ID否字符串

充换电站ID列表StationIDs要查询的充电站ID列表,不填写,默认全部充电站否字符串数组

查询页码PageNo默认为1是整型

每页场站数量PageSize默认为50是整型

格式“yyyy-MM-ddHH:mm:ss”查询增量数据,更新时间大于

最近查询时间LastQueryTime否字符串

等于此字段的数据

7.2.4返回值

查询充换电站信息接口返回值见表4。

4

DB42/T2527—2026

表4查询充换电站信息返回值

名称字段描述必填类型

当前页数PageNo如果查询页码大于页码总数,返回查询页码数是整型

页码总数PageCount总页数是整型

总记录条数ItemSize符合条件的电站总数是整型

充换电站信息列表StationInfos参照公共对象:充换电站信息是SupStationInfo数组

7.3推送充换电站信息

7.3.1概述

此接口用于充换电站及充换电设备信息发生变化时,推送至数据需求方平台,推送失败时,5分钟

内重试推送,若仍失败,则按小时级频率重试推送,直至推送成功。

7.3.2接口定义

接口名称:supervise_notification_station_info

接口使用方法:数据需求方实现此接口,数据提供方调用。

调用频率:变化调用

7.3.3输入参数

推送充换电站信息接口输入参数见表5。

表5推送充换电站信息输入参数

名称字段描述必填类型

充换电站信息SupStationInfo对象中的字段参照公共对象:充换电站信息是SupStationInfo

7.3.4返回值

推送充换电站信息接口返回值见表6。

表6推送充换电站信息返回值

名称字段描述必填类型

0:成功

状态Status是整型

1:失败,不需要重试

7.4查询电池箱信息

7.4.1概述

此接口用于主动查询电池箱信息,若平台内无换电业务可不对接此接口。

7.4.2接口定义

接口名称:supervise_query_battery_pack_info

接口使用方法:由数据提供方实现此接口,数据需求方调用。

调用频率:每天至少一次,宜选取每日业务低谷时段调用,例如02:00~04:00区间调用。

5

DB42/T2527—2026

7.4.3输入参数

查询电池箱信息接口输入参数见表7。

表7查询换电电池箱信息输入参数

名称字段描述必填类型

运营商IDOperatorIDs运营商服务平台ID列表,不填写,默认全部否字符串数组

查询页码PageNo默认为1否整型

每页电池箱数量PageSize默认为50否整型

7.4.4返回值

查询电池箱信息接口返回值见表8。

表8查询电池箱信息返回值

名称字段描述必填类型

查询页码PageNo默认为1是整型

每页场站数量PageSize默认为50是整型

总记录条数ItemSize符合条件的电池箱总数是整型

电池箱信息列表BatteryPackInfo参照公共对象:电池箱信息是SupBatteryPackInfo数组

7.5推送电池箱信息

7.5.1概述

此接口用于充换电站电池箱信息发生变化时,推送至数据需求方平台,推送失败时,5分钟内重试

推送,若仍失败,则按小时级频率重试推送,直至推送成功。若平台内无换电业务可不对接此接口。

7.5.2接口定义

接口名称:supervise_notification_battery_pack_info

接口使用方法:数据需求方实现此接口,数据提供方调用。

调用频率:变化调用。

7.5.3输入参数

推送电池箱信息接口输入参数见表9。

表9推送电池箱信息输入参数

名称字段描述必填类型

电池箱信息SupBatteryPackInfo对象中的字段参照公共对象:电池箱信息是SupBatteryPackInfo

7.5.4返回值

推送电池箱信息接口返回值见表10。

表10推送电池箱信息返回值

6

DB42/T2527—2026

名称字段描述必填类型

0:成功

状态Status是整型

1:失败,不需要重试

7.6推送电池箱状态信息

7.6.1概述

此接口用于电池箱状态信息发生变化时,推送最新的状态信息到数据需求方,推送失败时,5分钟

内重试推送,若仍失败,则按小时级频率重试推送,直至推送成功。若平台内无换电业务可不对接此接

口。

7.6.2接口定义

接口名称:supervise_notification_battery_status

接口使用方法:由数据需求方实现此接口,数据提供方调用。

接口频率:变化推送。

7.6.3输入参数

推送电池箱状态信息接口输入参数见表11。

表11推送电池箱状态信息输入参数

名称字段描述必填类型

SupBatteryStatusInfo

电池箱状态参照公共对象:电池箱状态信息是SupBatteryStatusInfo

对象中的字段

7.6.4返回值

推送电池箱状态信息接口返回值见表12。

表12推送电池箱状态信息返回值

名称字段描述必填类型

0:成功

状态Status是整型

1:失败

7.7查询充换电站状态信息

7.7.1概述

此接口用于数据需求方批量查询数据提供方的充换电站状态信息。

7.7.2接口定义

接口名称:supervise_query_station_status

接口使用方法:由数据提供方实现此接口,数据需求方调用。

调用频率:每天至少一次,数据需求方依托实际业务情况,宜选取每日业务低谷时段调用,例如

02:00~04:00区间调用。

7.7.3输入参数

7

DB42/T2527—2026

查询充换电站状态信息接口输入参数见表13。

表13查询充换电站状态信息输入参数

名称字段描述必填类型

充换电站ID列表StationIDs数组长度不超过50是字符串数组

运营商IDOperatorID运营商服务平台ID,字符9位是字符串

7.7.4返回值

查询充换电站状态信息接口返回值见表14。

表14查询充换电站状态信息返回值

名称字段描述必填类型

充换电站状态信息StationStatusInfos参照公共对象:充换电状态信息是SupStationStatusInfo数组

7.8推送充电设备接口状态信息

7.8.1概述

此接口用于充电设备接口状态信息发生变化时,推送最新的状态信息给数据需求方;推送失败时,

5分钟内重试推送,若仍失败,则按小时级频率重试推送,直至推送成功,数据需求方需依托实际情况

制定频繁访问限制,避免设备故障频繁上报对系统造成影响。

7.8.2接口定义

接口名称:supervise_notification_station_status

接口使用方法:由数据需求方实现此接口,数据提供方调用。

调用频率:变化推送。

7.8.3输入参数

推送充电设备接口状态信息接口输入参数见表15。

表15推送充电设备接口状态信息输入参数

名称字段描述必填类型

充电设备接口SupConnectorStatusInfo对象SupConnectorS

参照公共对象:充电设备接口状态信息是

状态信息中的字段tatusInfo

7.8.4返回值

推送充电设备接口状态信息接口返回值见表16。

表16推送充电设备接口状态返回值

名称字段描述必填类型

0:接受

状态Status是整型

1:丢弃/忽略,不需要重试

7.9推送充电状态信息

8

DB42/T2527—2026

7.9.1概述

此接口用于数据提供方向数据需求方推送充电设备的充电状态;推送失败时,5分钟内重试推送,

若仍失败,则按小时级频率重试推送,直至推送成功。

7.9.2接口定义

接口名称:supervise_notification_equip_charge_status

接口使用方法:由数据需求方实现此接口,数据提供方调用。

调用频率:4-5分钟。

7.9.3输入参数

推送充电状态接口的主要输入参数为充电订单号、充电订单状态、充电设备接口编码、相关状态信

息和充电明细信息体列表,具体内容参见表17。

表17推送充电状态信息输入参数

名称字段描述必填类型

SupEquipChargeStatusSupEquipCha

充电状态信息参照公共对象:充电状态信息是

对象中的字段rgeStatus

7.9.4返回值

推送充电状态接口的主要返回值为充电订单号和操作结果,见表18。

表18推送充电状态信息返回值

名称字段描述必填类型

充电订单号OrderNo格式“运营商ID+唯一编号”,不超过64个字符是字符串

0:成功

操作结果SuccStat是整型

1:失败

失败原因FailReasonMsg失败原因的描述是字符串

0:成功

失败码FailReasonCode是整型

1:失败

7.10推送充电订单信息

7.10.1概述

此接口用于数据提供方向数据需求方推送充电订单信息;充电订单在充电结束时实时推送,同一订

单无异常情况仅可推送一次;推送失败时,5分钟内重试推送,若仍失败,则按小时级频率重试推送,

直至推送成功,7天内订单采用该接口进行推送。

7.10.2接口定义

接口名称:supervise_notification_charge_order_info

接口使用方法:由数据需求方实现此接口,数据提供方调用。

调用频率:实时。

7.10.3输入参数

9

DB42/T2527—2026

推送充电订单信息接口的主要输入参数为充电订单号、充电设备接口编码、订单的电量信息、订单

的费用信息、订单结束原因和充电明细信息体列表,见表19。

表19推送充电订单信息输入参数

名称字段描述必填类型

SupChargeOrderInfoSupCharge

充电订单信息参照公共对象:充电订单信息是

对象中的字段OrderInfo

7.10.4返回值

推送充电订单信息接口的主要返回值为充电订单号、充电设备接口编码和确认结果,见表20。

表20推送充电订单信息返回值

名称字段描述必填类型

充电订单号OrderNo格式“运营商ID+唯一编号”,不超过64个字符是字符串

充电设备接口编码ConnectorID充电设备接口编码,同一运营商内唯一是字符串

0:成功

确认结果ConfirmResult否整型

1:失败

7.11推送历史充电订单信息

7.11.1概述

此接口用于数据提供方向数据需求方推送历史充电订单信息。此接口与补推订单管理办法相结合使

用。数据提供方明确推送订单月份,明确推送订单数量。数据需求方根据推送数据规模进行相应的资源

调度,提供接口开放时间,数据提供方根据接口开放时间,完成历史充电订单信息数据推送,推送失败

时进行协商重试推送,直到推送成功,超出7天订单需数据需求方与数据提供方沟通后使用该接口传输,

历史订单推送范围需数据需求方与数据提供方自行沟通明确。

7.11.2接口定义

接口名称:supervise_notification_charge_order_info_history

接口使用方法:由数据需求方实现此接口,数据提供方调用。

调用频率:约定推送。

7.11.3输入参数

推送历史充电订单信息接口的主要输入参数为充电订单号、充电设备接口编码、订单的电量信息、

订单的费用信息、订单结束原因和充电明细信息体列表,见表21。

表21推送历史订单信息输入参数

名称字段描述必填类型

充电订单信息SupChargeOrderInfo对象中的字段参照公共对象:充电订单信息是SupChargeOrderInfo

7.11.4返回值

推送历史充电订单信息接口的主要返回值为充电订单号、充电设备接口编码和确认结果,见表22。

10

DB42/T2527—2026

表22推送历史订单信息返回值

名称字段描述必填类型

充电订单号OrderNo格式“运营商ID+唯一编号”,不超过64个字符是字符串

充电设备接口编码ConnectorID充电设备接口编码,同一运营商内唯一是字符串

0:成功

确认结果ConfirmResult否整型

1:失败

7.12推送换电订单信息

7.12.1概述

此接口用于推送换电站换电订单信息至数据需求方,同一订单无异常时不可重复推送,推送失败时,

5分钟内重试推送,若仍失败,则按小时级频率重试推送,直至推送成功。若平台内无换电业务可不对

接此接口。

7.12.2接口定义

接口名称:supervise_notification_swap_order_info

接口使用方法:由数据需求方实现此接口,数据提供方调用。

频率:变化推送。

7.12.3输入参数

推送换电订单信息接口输入参数见表23。

表23推送换电订单信息输入参数

名称字段描述必填类型

换电订单信息SupSwapOrderInfo对象中的字段参照公共对象:换电订单信息是SupSwapOrderInfo

7.12.4返回值

推送换电订单信息接口返回值见表24。

表24推送换电订单信息返回值

名称字段描述必填类型

0:成功

状态Status是整型

1:失败,不需要重试

7.13推送充换电站用能统计信息

7.13.1概述

此接口用于数据提供方向数据需求方推送充换电站用能统计信息,统计时间规则以订单结束时间为

基准(即订单结束时间在统计开始时间与统计结束时间区间内);数据不可重复推送,推送失败时,5

分钟内重试推送,若仍失败,则按小时级频率重试推送,直至推送成功,重复推送则对已接收数据进行

更新。

7.13.2接口定义

11

DB42/T2527—2026

接口名称:supervise_notification_operation_stats_info

接口使用方法:由数据需求方实现此接口,数据提供方调用。

调用频率:于次日凌晨1:00至2:00期间,推送前一日运行统计信息。或每日凌晨2:00前,推送前一

日运行统计信息。

7.13.3输入参数

推送充换电站用能统计信息接口输入参数见表25。

表25推送充换电站用能统计信息

名称字段描述必填类型

充换电站运行SupStationSta

StationStatsInfos参照公共对象:充换电站用能统计信息是

统计信息列表tsInfo[]

7.13.4返回值

推送充换电站用能统计信息接口返回值见表26。

表26推送充换电站用能统计信息返回值

名称字段描述必填类型

0:成功

状态Status是整型

1:失败

7.14推送充换电站实时功率

7.14.1概述

此接口用于数据提供方推送充换电站实时功率信息。每日0点开始,每间隔15分钟计算一次功率,

全天共计算96个时间点功率数据;数据不可重复推送,推送失败时,5分钟内重试推送,若仍失败,则

按小时级频率重试推送,直至推送成功,重复推送则对已接收数据进行更新。

7.14.2接口定义

接口名称:supervise_notification_realtime_power_info

接口使用方法:由数据需求方实现此接口,数据提供方调用。

调用频率:15分钟推送一次,15分钟内最新的功率信息。

7.14.3输入参数

推送充换电站实时功率接口输入参数见表27。

12

DB42/T2527—2026

表27推送充换电站实时功率输入参数

名称字段描述必填类型

充换电站功率

SupStationPowerInfos参照公共对象:充换电站功率信息是SupStationPowerInfo[]

统计信息列表

7.14.4返回值

推送充换电站实时功率接口返回值见表28。

表28推送充换电站实时功率返回值

名称字段描述必填类型

0:成功

状态Status是整型

1:失败

7.15查询充电事故信息

7.15.1概述

此接口用于数据需求方查询数据提供方的充电事故信息。

7.15.2接口定义

接口名称:supervise_query_accident_info

接口使用方法:由数据需求方实现此接口,数据提供方调用。

调用频率:每天至少一次。

7.15.3输入参数

查询充电事故信息接口输入参数见表29。

表29查询充电事故信息输入参数

名称字段描述必填类型

查询页码PageNo默认为1是整型

每页数量PageSize默认为10是整型

上次查询时间lastQueryTimeyyyy-MM-ddHH:mm:ss是字符串

7.15.4返回值

查询充电事故信息接口返回值见表30。

表30查询充电事故信息返回值

名称字段描述必填类型

当前页数PageNo如果查询页码大于页码总数,返回查询页码数是整型

页码总数PageCount总页数是整型

总记录条数ItemSize符合条件的总条数是整型

SupEquipmentAcci

充电事故事故信息列表EquipmentAccidentInfos参照公共对象:充电事故信息是

dentInfo[]

13

DB42/T2527—2026

7.16查询补贴发放信息

7.16.1概述

此接口用于数据需求方查询数据提供方的补贴发放信息。

7.16.2接口定义

接口名称:supervise_query_subsidy_grant_info

接口使用方法:由数据需求方实现此接口,数据提供方调用,宜选取每日业务低谷时段调用,例如

02:00~04:00区间调用。

调用频率:每天至少一次。

7.16.3输入参数

查询补贴发放信息接口输入参数见表31。

表31查询补贴发放信息输入参数

名称字段描述必填类型

查询页码PageNo默认为1是整型

每页数量PageSize默认为10是整型

上次查询时间lastQueryTimeyyyy-MM-ddHH:mm:ss是字符串

7.16.4返回值

查询补贴发放信息接口返回值见表32。

表32查询补贴发放信息返回值

名称字段描述必填类型

当前页数PageNo如果查询页码大于页码总数,返回查询页码数是整型

页码总数PageCount总页数是整型

总记录条数ItemSize符合条件的总条数是整型

补贴发放信息列表SubsidyGrantInfo参照公共对象:补贴发放信息是SubsidyGrantInfo[]

7.17推送有序放电订单信息

7.17.1概述

此接口用于数据提供方向数据需求方推送有序放电订单信息;有序放电订单在放电结束时实时推送,

同一订单无异常时仅可推送一次;推送失败时,5分钟内重试推送,若仍失败,则按小时级频率重试推

送,直至推送成功。

7.17.2接口定义

接口名称:supervise_notification_discharge_charge_order_info

接口使用方法:由数据需求方实现此接口,数据提供方调用。

调用频率:实时。

7.17.3输入参数

14

DB42/T2527—2026

推送有序放电订单信息接口的主要输入参数为有序放电订单号、充电设备接口编码、订单的电量信

息、订单的费用信息、订单结束原因,见表33。

表33推送有序放电订单信息输入参数

名称字段描述必填类型

SupDischargeOrderInfoSupDischarge

有序放电订单信息参照公共对象:有序放电订单信息是

对象中的字段OrderInfo

7.17.4返回值

推送有序放电订单信息接口的主要返回值为有序放电订单号、充电设备接口编码和确认结果,见表

34。

表34推送有序放电订单信息返回值

名称字段描述必填类型

有序放电订单号DischargeOrderNo格式“运营商ID+唯一编号”,不超过64个字符是字符串

充电设备接口编

ConnectorID充电设备接口编码,同一运营商内唯一是字符串

0:成功,表示对此订单的对账确认

确认结果ConfirmResult否整型

1:失败

8接入安全要求

8.1数据传输体系

8.1.1数据传输一般流程

电动汽车充换电服务信息交换应符合GB/T9387.1中关于会话连接的要求,一般需要经过平台认证、

请求和应答3个步骤。

8.1.2数据传输接口

数据传输接口应采用HTTP(S)接口,接口URL应按如下格式定义:

http(s)://[域名]/evcs/v[版本号]/[接口名称]

a)域名:接口提供方平台域名;

b)版本号:代表接口版本号,不同的版本地址对应相应版本功能。系统升级期间,新旧版本应

同时存在,待所有接入方都切换到新版本接口,旧版本接口即可下线。

c)接口名称:所请求/调用接口的名称,具体接口名称见本规程中7接口要求

d)为保证各接口功能明确清晰,每个接口只允许对应一种功能。

8.1.3接口调用方式

接口调用应使用HTTP(S)/POST方式,采用APPLICATION/JSON数据提交方式,传输过程中应包含消息

头和消息主体两部分。数据应采用UTF-8编码,JSON格式。

8.1.4消息头要求

15

DB42/T2527—2026

消息头包含内容类型(Content-Type)和授权信息(Authorization)。内容类型字段用于标识请

求中的消息主体编码方式,本标准中所定义的信息交换内容均应采用JSON格式,参数信息采用UTF-8编

码,消息头中的内容类型配置为application/json;charset=UTF-8。授权信息字段用于证明客户端有权

查看某个资源,本标准中所定义的授权信息采用令牌(Token)方式,消息头中的授权信息配置为Bearer

Token。

8.1.5消息主体要求

服务申请

运营商标识(OperatorID)、参数内容(Data)、时间戳(TimeStamp)、自增序列(Seq)和数字

签名(Sig)组成,具体要求参见表35。

表35消息主体内容表

参数名说明备注

OperatorID数据请求方的标识-

"Data":{

"Total":1,"StationStatusInfos":{

"StationID":"111111111111111",

"ConnectorStatusInfos":[{"ConnectorID":"1",

"Status":4,

"CurrentA":0,

"CurrentB":0,

Data各接口具体参数信息"CurrentC":0,

"VoltageA":0,

"VoltageB":0,

"VoltageC":0,

"SOC":10,

}]

}

}

TimeStamp时间戳接口请求时的时间戳信息,参照GB/T7408,格式为yyyyMMddHHmmss

Seq自增序列4位自增序列取自时间戳,保证唯一性

Sig参数签名-

参数返回

数据传输接口的返回参数应由返回值(Ret)、返回信息(Msg)、参数内容(Data)和数字签名(Sig)

组成,见表36。

a)Ret:必填字段,返回参数编码应符合表36的规定;

b)Msg:必填字段,有错误表示具体错误信息,无错误返回成功信息;

c)Data:参数内容,返回参数应符合本规程中的规定。

16

温馨提示

  • 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
  • 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
  • 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
  • 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
  • 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
  • 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
  • 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。

评论

0/150

提交评论