Guides

Temporary EVSE status

Support maintenance mode, commissioning, parking sensors, and reservation systems

Spirii's Temporary EVSE status functionality allows the charge point operator (CPO) to modify the charger status shared with the e-Mobility Service Providers (eMSPs).

This feature updates the displayed charger status in the eMSP apps without touching the actual charger status.

The CPO can utilize this functionality for multiple use cases:

  • Maintenance mode: Avoid having drivers turn up at the charger only to be disappointed, whilst keeping the charger available for the technician to work on it.
  • Commissioning: Create hype for new chargers being planned, installed, tested, and configured.
  • Parking sensors: Allow an external sensor system to update the status when the parking space in front of the charger becomes occupied.
  • Reservation system: Allow an external booking system to update the reservation status of the charger.

How it works

The CPO can create a temporary EVSE status by using the POST Temporary EVSE status endpoint.

Set the EVSE ID that should be updated, including the desired status and an optional from/to period.

The EVSE status presented in the eMSP apps will kick in based on the fromtimestamp and be cleared again automatically based on the to timestamp.

If the temporary status should be cleared before the to timestamp, then the CPO can send a DELETE temporary EVSE status call to clear the status. This will revert the presented status to the actual charger status (e.g., "available", "charging", etc.).

If none are defined, the temporary status is permanent until a DELETE temporary EVSE status call is sent.


How are the statuses presented in the eMSP apps

The apps, hubs, and protocols in the market each have standards for handling the use cases.

Below is an overview of how the statuses are translated from Spirii's platform:

Temporary EVSE status in SpiriiSpirii Go (& branded apps)Hubject (OICP) Roaming HubDirect Roaming partners (OCPI)
MaintenanceOut of ServiceOut of ServiceInoperative
CommissioningOut of ServiceOut of ServicePlanned
BlockedOccupiedOccupiedBlocked
ReservedOccupiedReservedReserved