Notify EV Charging Needs
Source: OCPP 2.0.1 Part 2 — Specification (Edition 2, 2022-12-15) — Section 1.36 (Messages); Use Case K15 — Charging with load leveling based on High Level Communication (Functional Block K. SmartCharging)
Overview
When an EV connects via ISO 15118 and communicates its charging needs, the Charging Station forwards those needs to the CSMS using NotifyEVChargingNeedsRequest. This enables Central Smart Charging based on EV-supplied parameters (preferred energy, departure time, AC/DC parameters, etc.).
The CSMS responds with a status indicating whether it could process the message — but the response does not imply that the charging needs can actually be met given the current charging profile.
Sequence Diagram
Charging Station ──── NotifyEVChargingNeedsRequest ────▶ CSMS
(evseId, chargingNeeds, maxScheduleTuples?)
Charging Station ◀─── NotifyEVChargingNeedsResponse ──── CSMS
(status, statusInfo?)
Initiator
Charging Station → CSMS
Fields
| Field Name | Field Type | Card. | Description |
|---|---|---|---|
| maxScheduleTuples | integer | 0..1 | Optional. Maximum schedule tuples the car supports per schedule. |
| evseId | integer (> 0) | 1..1 | Required. EVSE/connector to which the EV is connected. May not be 0. |
| chargingNeeds | ChargingNeedsType | 1..1 | Required. The characteristics of the energy delivery required. |
| Field Name | Field Type | Card. | Description |
|---|---|---|---|
| status | NotifyEVChargingNeedsStatusEnumType | 1..1 | Required. Whether the CSMS could process the message. Does not imply that the needs can be met. |
| statusInfo | StatusInfoType | 0..1 | Optional. Detailed status information. |
ChargingNeedsType (selected fields)
| Field | Type | Card. | Description |
|---|---|---|---|
| requestedEnergyTransfer | EnergyTransferModeEnumType | 1..1 | AC_single_phase / AC_three_phase / DC / etc. |
| departureTime | dateTime | 0..1 | Estimated departure time of the EV. |
| acChargingParameters | ACChargingParametersType | 0..1 | AC charging parameters (energyAmount, voltage, current). |
| dcChargingParameters | DCChargingParametersType | 0..1 | DC charging parameters (max current/voltage/power, etc). |
NotifyEVChargingNeedsStatusEnumType values
Accepted, Rejected, Processing.
Examples
{
"evseId": 1,
"chargingNeeds": {
"requestedEnergyTransfer": "DC",
"departureTime": "2026-04-27T15:00:00Z",
"dcChargingParameters": {
"evMaxCurrent": 200,
"evMaxVoltage": 800,
"energyAmount": 60000,
"evMaxPower": 150000,
"stateOfCharge": 25,
"evEnergyCapacity": 90000,
"fullSoC": 100,
"bulkSoC": 80
}
}
}{
"status": "Accepted"
}Schema
Source:
schemas/NotifyEVChargingNeedsRequest.json,schemas/NotifyEVChargingNeedsResponse.json(OCPP 2.0.1 FINAL)