NotifyEVChargingNeeds

SmartCharging CS->CSMS OCPP 2.0.1

Sent by the Charging Station to report the charging requirements communicated by the EV via ISO 15118, including desired energy, departure time, and AC/DC charging parameters.

Quick Reference

Required Fields

evseId integer

EVSE where the EV is connected

chargingNeeds ChargingNeedsType

Object containing the EV's requested charging parameters

chargingNeeds.requestedEnergyTransfer EnergyTransferModeEnumType

Type of energy transfer: DC, AC_single_phase, AC_two_phase, AC_three_phase

Optional Fields

chargingNeeds.departureTime string (date-time)

EV's requested departure time

chargingNeeds.acChargingParameters ACChargingParametersType

AC charging parameters from the EV

chargingNeeds.dcChargingParameters DCChargingParametersType

DC charging parameters from the EV (target SoC, max current, etc.)

Example Payload

{
  "evseId": 1,
  "chargingNeeds": {
    "requestedEnergyTransfer": "AC_three_phase",
    "departureTime": "2024-01-15T18:00:00Z",
    "acChargingParameters": {
      "energyAmount": 30000,
      "evMinCurrent": 6,
      "evMaxCurrent": 32,
      "evMaxVoltage": 230
    }
  }
}

Example Full Frame

[
  2,
  "msg-001",
  "NotifyEVChargingNeeds",
  {
    "evseId": 1,
    "chargingNeeds": {
      "requestedEnergyTransfer": "AC_three_phase",
      "departureTime": "2024-01-15T18:00:00Z",
      "acChargingParameters": {
        "energyAmount": 30000,
        "evMinCurrent": 6,
        "evMaxCurrent": 32,
        "evMaxVoltage": 230
      }
    }
  }
]

Format: [MessageType, MessageId, Action, Payload]

Open in Builder Go to Validator

Overview

NotifyEVChargingNeeds forwards the EV’s charging requirements (received via ISO 15118) to the CSMS so it can create an optimal charging schedule. This enables advanced smart charging based on the EV’s state of charge and departure time.

When to Send

When an EV communicates its charging needs via ISO 15118 (Plug & Charge)
After the EV reports its SoC, target SoC, or departure time
When the EV updates its charging requirements during a session

Expected Response

status: Accepted, Rejected, or NotImplemented

Usage Notes

The CSMS should respond with a SetChargingProfile after receiving this message to implement the requested schedule
departureTime enables time-based optimization (charge by departure, use off-peak rates)
DC parameters include evTargetSoC, evMaximumCurrentLimit, and evMaximumPowerLimit

Testing Tips

Send with AC parameters and verify the CSMS creates a compatible charging profile
Send with a departure time and verify time-based optimization is applied

Common Errors

`TypeConstraintViolation`

Cause: requestedEnergyTransfer uses an unsupported value

Solution: Use one of: DC, AC_single_phase, AC_two_phase, AC_three_phase