Skip to content
Documentation Menu

Reservation Status Update

Source: OCPP 2.0.1 Part 2 — Specification (Edition 2, 2022-12-15) — Section 1.46 (Messages); Use Case H04 — Reservation Ended, not used (Functional Block H. Reservation)

Overview

The Charging Station sends ReservationStatusUpdateRequest to inform the CSMS that a previously-made reservation has ended without being used (either because it expired, or because it became unusable e.g. the EVSE went Faulted/Unavailable).

This is not sent when a reservation is consumed by a transaction — in that case the CS reports the reservation termination via the reservationId field on TransactionEventRequest(Started).

Sequence Diagram

Charging Station  ──── ReservationStatusUpdateRequest ────▶  CSMS
                       (reservationId, reservationUpdateStatus)
Charging Station  ◀─── ReservationStatusUpdateResponse ────  CSMS

Initiator

Charging Station → CSMS

Fields

Field NameField TypeCard.Description
reservationIdinteger1..1Required. The id of the reservation.
reservationUpdateStatusReservationUpdateStatusEnumType1..1Required. The updated reservation status.

ReservationUpdateStatusEnumType values

  • Expired — Reservation expired (its expiryDateTime was reached).
  • Removed — Reservation was removed (e.g. by CancelReservationRequest while not active, or because the EVSE became Faulted/Unavailable).

Examples

{
  "reservationId": 42,
  "reservationUpdateStatus": "Expired"
}

Schema

Source: schemas/ReservationStatusUpdateRequest.json, schemas/ReservationStatusUpdateResponse.json (OCPP 2.0.1 FINAL)

Request schema (JSON Schema)
Response schema (JSON Schema)