Get Composite Schedule
Source: OCPP 2.0.1 Part 2 — Specification (Edition 2, 2022-12-15) — Section 1.20 (Messages); Use Case K08 — Get Composite Schedule (Functional Block K. SmartCharging)
Overview
The CSMS sends GetCompositeScheduleRequest to ask the Charging Station for the composite schedule that results from combining all currently active charging profiles, local limits, and (where applicable) ISO 15118 limits.
When evseId = 0, the CS reports the total expected energy flow at the grid connection.
The schedule is informational only — it can change as conditions change.
Sequence Diagram
CSMS ──── GetCompositeScheduleRequest ────▶ Charging Station
(duration, chargingRateUnit?, evseId)
CSMS ◀─── GetCompositeScheduleResponse ──── Charging Station
(status, schedule?, statusInfo?)
Initiator
CSMS → Charging Station
Fields
| Field Name | Field Type | Card. | Description |
|---|---|---|---|
| duration | integer | 1..1 | Required. Length of the requested schedule (seconds). |
| chargingRateUnit | ChargingRateUnitEnumType | 0..1 | Optional. Force a power or current profile. |
| evseId | integer (>= 0) | 1..1 | Required. The EVSE for which the schedule is requested. 0 for grid connection. |
| Field Name | Field Type | Card. | Description |
|---|---|---|---|
| status | GenericStatusEnumType | 1..1 | Required. Whether the CS could process the request. |
| schedule | CompositeScheduleType | 0..1 | Optional. The calculated composite schedule. May only be omitted when status is Rejected. |
| statusInfo | StatusInfoType | 0..1 | Optional. Detailed status information. |
ChargingRateUnitEnumType values
A, W.
GenericStatusEnumType values
Accepted, Rejected.
Examples
{
"duration": 3600,
"chargingRateUnit": "W",
"evseId": 1
}{
"status": "Accepted",
"schedule": {
"evseId": 1,
"duration": 3600,
"scheduleStart": "2026-04-27T13:00:00Z",
"chargingRateUnit": "W",
"chargingSchedulePeriod": [
{ "startPeriod": 0, "limit": 11000.0 },
{ "startPeriod": 1800, "limit": 7400.0 }
]
}
}Schema
Source:
schemas/GetCompositeScheduleRequest.json,schemas/GetCompositeScheduleResponse.json(OCPP 2.0.1 FINAL)