GetCompositeSchedule

SmartCharging CSMS->CS OCPP 2.0.1

Sent by the CSMS to request the effective charging schedule for an EVSE over a specified duration, combining all applicable charging profiles.

Quick Reference

Required Fields

duration integer

Duration in seconds for which to calculate the composite schedule

evseId integer

EVSE for which to calculate the schedule

Optional Fields

chargingRateUnit ChargingRateUnitEnumType

Unit for the schedule output: W or A (Watts or Amperes)

Example Payload

{
  "duration": 86400,
  "evseId": 1,
  "chargingRateUnit": "W"
}

Example Full Frame

[
  2,
  "msg-001",
  "GetCompositeSchedule",
  {
    "duration": 86400,
    "evseId": 1,
    "chargingRateUnit": "W"
  }
]

Format: [MessageType, MessageId, Action, Payload]

Open in Builder Go to Validator

Overview

GetCompositeSchedule asks the Charging Station to calculate and return the resulting power schedule for an EVSE over a future period, taking into account all installed charging profiles and their stack levels.

Expected Response

status: Accepted or Rejected
schedule (if Accepted): The composite schedule with periods and power limits

Usage Notes

The Charging Station combines all applicable profiles according to stack level rules
A duration of 86400 (24 hours) gives a full-day view
Use W for power-based schedules (most common) or A for current-based schedules

Testing Tips

Set two overlapping profiles and verify the composite schedule reflects the higher stack level
Request for an EVSE with no profiles and verify a default unlimited schedule is returned

Common Errors

`TypeConstraintViolation`

Cause: chargingRateUnit uses kW or kWh instead of W or A

Solution: OCPP 2.0.1 accepts W (Watts) or A (Amperes) as rate units