Overview

A session represents the entire process from the moment a charge is requested until the station either declines it or starts and completes charging.

There are two methods of creating a session. In the first method, a session is created by "requesting" for it to be acknowledged and started by the station via the central system. In the second method, a session is created by "recording" it after it has already been started by the station.

Types of Session

1. Requested Session: A requested session is a remotely initiated session via API call to the central system with an autoStart value of false. This type of session is typically used by mobile applications or other remote systems, giving the user more control over the charging process. This type of session must be acknowledged and started by the station before it can begin charging.

2. Recorded Session: A recorded session is a session that is “recorded” and not started remotely. Generally, these sessions occur for stations where charging is initiated via a payment terminal, RFID, or some form of local authorization. This can be particularly useful at public charging stations or for fleet vehicles where charging may start without requiring additional user interaction. These sessions are recorded via API call to the central system with an autoStart value of true. As such, the central system assumes the recorded session to have already been started by the station.

NOTE: When initiating a charging session at a station through the API, users are advised to create a Requested type Session. Please note that sessions with autoStart: true are created directly by the stations themselves.

Cost Components of a Session

The cost of a charging session is calculated using the following four categories:

1. ENERGY: This pertains to the volume of energy (measured in kilowatt-hours, kWh) used during the charging session. This is typically the primary factor in determining the cost of a session and depends on the charging rate of the EV and the price per kWh.

2. FLAT: This category includes flat or connection fees that some charging stations or service providers may charge for the use of their charging infrastructure. These fees are a set amount that must be paid irrespective of the energy consumed or time spent charging.

3. PARKING_TIME: Certain charging stations or service providers may impose an extra fee for when a vehicle stays connected to a charger after reaching a full charge or remaining inactive for an extended period of time. This additional charge, referred to as an idle fee, is intended to motivate users to vacate charging stations promptly, allowing access for other users.

4. TIME: This category refers to the length of the charging session from the moment it first becomes active until it is stopped. Cost for this category is calculated based on the recorded session times and a price per hour rate set by the charging station or service provider.