ReservationStatusUpdate

Reservation CS->CSMS OCPP 2.0.1

Sent by the Charging Station to inform the CSMS about a change in reservation status, such as when a reservation expires or is fulfilled.

Quick Reference

Required Fields

reservationId integer

ID of the reservation whose status has changed

reservationUpdateStatus ReservationUpdateStatusEnumType

New status: Expired or Removed

Example Payload

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

Example Full Frame

[
  2,
  "msg-001",
  "ReservationStatusUpdate",
  {
    "reservationId": 1,
    "reservationUpdateStatus": "Expired"
  }
]

Format: [MessageType, MessageId, Action, Payload]

Open in Builder Go to Validator

Overview

ReservationStatusUpdate is sent by the Charging Station when a reservation changes status — either it expires naturally or is removed by the CSMS (CancelReservation) or by a transaction fulfilling it.

When to Send

When a reservation expires (no one showed up before expiryDateTime)
When a reservation is cancelled via CancelReservation
When a transaction starts that fulfills the reservation

Expected Response

Empty response {}.

Testing Tips

Let a reservation expire and verify Expired is sent
Cancel a reservation and verify Removed is sent

Common Errors

`TypeConstraintViolation`

Cause: reservationUpdateStatus uses an unsupported value

Solution: Use one of: Expired or Removed