OCPP 2.1 Schemas — Availability

Functional Block: G

Types Reference: Shared types referenced below are defined in OCPP-2.1-DataTypes.md.
Types used only within this block are documented inline below.

#Messages

ChangeAvailability (CSMS → CS)
StatusNotification (CS → CSMS)

#ChangeAvailability

Direction: CSMS → CS

#ChangeAvailabilityRequest

Field	Type	Required
`operationalStatus`	OperationalStatusEnumType	Yes
`evse`	EVSEType	No
`customData`	CustomDataType	No

Example ChangeAvailabilityRequest

{
  "operationalStatus": "Inoperative"
}

#ChangeAvailabilityResponse

Field	Type	Required
`status`	ChangeAvailabilityStatusEnumType	Yes
`statusInfo`	StatusInfoType	No
`customData`	CustomDataType	No

#StatusNotification

Direction: CS → CSMS

#StatusNotificationRequest

Field	Type	Required	Constraints	Description
`connectorId`	integer	Yes	min: 0.0	The id of the connector within the EVSE for which the status is reported.
`connectorStatus`	ConnectorStatusEnumType	Yes
`evseId`	integer	Yes	min: 0.0	The id of the EVSE to which the connector belongs for which the the status is reported.
`timestamp`	string (date-time)	Yes		The time for which the status is reported.
`customData`	CustomDataType	No

Example StatusNotificationRequest

{
  "connectorId": 0,
  "connectorStatus": "Available",
  "evseId": 0,
  "timestamp": "2024-01-15T10:30:00Z"
}

#StatusNotificationResponse

No required fields. An empty {} is a valid response.

#Local Types

Types used only within this block's messages.

#ChangeAvailabilityStatusEnumType

This indicates whether the Charging Station is able to perform the availability change.

Value
`Accepted`
`Rejected`
`Scheduled`

Used in: ChangeAvailability

#ConnectorStatusEnumType

This contains the current status of the Connector.

Value
`Available`
`Occupied`
`Reserved`
`Unavailable`
`Faulted`

Used in: StatusNotification

#OperationalStatusEnumType

This contains the type of availability change that the Charging Station should perform.

Value
`Inoperative`
`Operative`

Used in: ChangeAvailability