A session is a core asset that encapsulates the attempts of the user (driver or admin) to affect a charging transaction. All metrics in a session are based on data reported by the chargestation sensors and meters.

Timeline

Session Creation:
When a new session is created (via a POST API request or via the dashboard), eDRV sends a remote start request to the chargestation (status = created)

Charging Start:
If the chargestation starts charging the status changes to (status = started).

Charging Stop:
When the chargestation sends a successful stop charging message, (status = ended)

Session Cancelled:
If the chargestation does not report that charging has start within 120 seconds of a session start attempt the session is cancelled (status = cancelled). E.g. when the driver did not insert his charging cable in time. In this scenario please create a new session to attempt a new charging session.

{
    "_id": "60e7116e15f9305d44e9d4d5",
    "user": "60e7116e15f9305d44e9d4d5",
    "chargestation": "60e7116e15f9305d44e9d4d5",
    "connector": "60e7116e15f9305d44e9d4d5",
    "status": "created",
    "rate": "603763d392204c0c840578be",
    "cost": {
      "amount": 17.5,
      "currency": "eur"
    },
    "metrics": {
      "chargingStart": "2021-07-08T14:56:47.528Z",
      "chargingStop": "2021-07-08T14:55:55.000Z",
      "energyPeriod": 2476,
      "energyConsumed": 4406
    },
    "energy_report": {
      "timestamp": "2021-07-08T14:55:33Z",
      "current": {
        "value": 31.16,
        "unit": "A"
      },
      "power": {
        "value": 7.018,
        "unit": "kW"
      },
      "energy_meter": {
        "value": 15.83,
        "unit": "kWh"
      }
    },
    "meta_data": {
      "session_source": "Android_App"
    },
    "reservation": "5f72f55431a6770a131db279",
    "planned_cutoff_energy": 2700,
    "planned_cutoff_time": 14400,
    "planned_cutoff_cost": 20,
    "createdAt": "2021-07-21T12:50:36.660Z",
    "updatedAt": "2021-07-21T12:50:36.660Z"
}

Attributes

_id string

The Id of this transaction

user string

The Id of the user

chargestation string

The Id of the chargestation where this charging transaction took place

connector string

The Id of the connector where this charging transaction took place

status string

The live current transaction status
Expected values are [created, started,ended, cancelled]

rate string

The rate Id applied for this charging session

cost object The running estimate or final cost for this session

amount: float
currency: string Three digit currency code based on the Rate for this session

metrics object As reported directly by the chargestation. Final when session.status = ended

energyConsumed: float As reported by the chargestation meter in kWh
energyPeriod: integer Energy consumption time period in Seconds
chargingStart: datetime Energy consumption start timestamp
chargingStop: datetime Charging session end timestamp

energy_report object Instantaneous session energy information

timestamp: datetime report timestamp in UTC

current: object Instantaneous current flow to the EV

  • current.value: float
  • current.unit: string Expected values are [A] for Amperes

power: object Instantaneous active power imported by the EV.

  • power.value: float
  • power.unit: string Expected values are [W,kW]

energy_meter: object Chargestation's Meter register. Reports total lifetime energy imported from the grid supply by this chargestation.

  • energy_meter.value: float
  • energy_meter.unit: string Expected values are [Wh,kWh]

meta_data object

Any session specific data the developer would like to include

createdAt datetime

Creation time of this Session record

updatedAt datetime

Last update time of this Session record

Coming Soon

reservation string

Reservation Id, if this session fulfills a reservation.

planned_cutoff_energy integer

The ceiling for the amount of energy that this session can consume in Watt-hours. eDRV will attempt a stop session automatically just before this ceiling is reached.

planned_cutoff_time integer

The ceiling for the amount of time this session is allowed to run in seconds. eDRV will attempt a stop session automatically just before this ceiling is reached.

planned_cutoff_cost float

The ceiling for the max cost for this session. Cost is Monitored via the session.cost property. eDRV will attempt a stop session automatically just before this ceiling is reached.