Reserve Now

Source: OCPP 2.0.1 Part 2 — Specification (Edition 2, 2022-12-15) — Section 1.47 (Messages); Use Case H01 — Reservation (Functional Block H. Reservation)

Overview

The CSMS sends ReserveNowRequest to ask the Charging Station to reserve an EVSE (or any EVSE matching connectorType) for a specific idToken until expiryDateTime.

Compared to OCPP 1.6: a reservation may now target a connectorType (any EVSE matching that connector type) instead of a specific EVSE id, and groupIdToken is supported.

When the reservation is later used by a transaction, the CS reports it via the reservationId field on TransactionEventRequest(Started). When it expires or is removed without being used, the CS sends ReservationStatusUpdate.

Sequence Diagram

CSMS  ──── ReserveNowRequest ────▶  Charging Station
            (id, expiryDateTime, idToken, connectorType?, evseId?, groupIdToken?)
CSMS  ◀─── ReserveNowResponse ────  Charging Station
            (status, statusInfo?)

Initiator

CSMS → Charging Station

Fields

Field Name	Field Type	Card.	Description
id	integer	1..1	Required. Id of the reservation.
expiryDateTime	dateTime	1..1	Required. When the reservation expires.
connectorType	ConnectorEnumType	0..1	Optional. Specifies the connector type.
evseId	integer	0..1	Optional. EVSE id to reserve. When omitted, any EVSE matching `connectorType` may be reserved.
idToken	IdTokenType	1..1	Required. Identifier for which the reservation is made.
groupIdToken	IdTokenType	0..1	Optional. Group identifier for the reservation.

ReserveNowStatusEnumType values

Accepted, Faulted, Occupied, Rejected, Unavailable.

ConnectorEnumType values (selection)

cCCS1, cCCS2, cG105, cTesla, cType1, cType2, s309-1P-16A, s309-1P-32A, s309-3P-16A, s309-3P-32A, sBS1361, sCEE-7-7, sType2, sType3, Other1PhMax16A, Other1PhOver16A, Other3Ph, Pan, wInductive, wResonant, Undetermined, Unknown.

Examples

{
  "id": 42,
  "expiryDateTime": "2026-04-27T15:00:00Z",
  "evseId": 1,
  "idToken": { "idToken": "044943121F1A80", "type": "ISO14443" }
}

{
  "status": "Accepted"
}

Schema

Source: schemas/ReserveNowRequest.json, schemas/ReserveNowResponse.json (OCPP 2.0.1 FINAL)

Request schema (JSON Schema)

Response schema (JSON Schema)

Field Name	Field Type	Card.	Description
status	ReserveNowStatusEnumType	1..1	Required. Success or failure of the reservation.
statusInfo	StatusInfoType	0..1	Optional. Detailed status information.