Using POI API, you can start a charging session, check its progress, and stop it remotely.

First, make sure that:

Start charging

To start a charging session, send a request to POST https://api.everon.io/poi/v1/charging-sessions.  Specify the action as START, and specify the station's identity code in the locationId field, the connector's identity code in the evseId field, and the RFID in the token field.

{
    "action": "START",
    "locationId": "EVB-12345678",
    "evseId": "1",
    "token": "2WI8T6WEXPI3DDYW74BA"
}
CODE
curl --location --request POST 'https://api.everon.io/poi/v1/charging-sessions' \
--header 'Content-Type: application/json; charset=utf-8' \
--header 'Authorization: Bearer <token>' \
--data-raw '{
    "action": "START",
    "locationId": "EVB-12345678",
    "evseId": "1",
    "token": "2WI8T6WEXPI3DDYW74BA"
}'
CODE

A 202 response informs you that the station was sent a request to start charging.

Check session progress

After starting the charging session, you can get live session information from the station. This also gives you the transactionId needed to stop the session later on.

To check your session's progress, send a request to GET https://api.everon.io/poi/v1/charging-sessions?token=2WI8T6WEXPI3DDYW74BA, specifying the RFID you used to start the session as your token.

The response provides you with:

  • The current time and starting time, which you can use to calculate the duration of the session.
  • The meter values, which you can use to calculate the kWh consumed during the session.
  • A transactionId which you need to stop the session.
  • cdrId which is the transaction's unique identifier in Billing API. You can use it to retrieve transaction details for invoicing or receipts.

Sample response

{
    "eventType": "Updated",
    "timestamp": "2021-04-29T16:57:09",
    "createdAt": "2021-04-29T16:54:04Z",
    "evseId": 1,
    "connectorId": null,
    "tokenId": "2WI8T6WEXPI3DDYW74BA",
    "locationId": "EVB-12345678",
    "locationUid": "59a97ebf-e27d-47d3-bdf0-deb25254b8ea",
    "transactionData": {
        "transactionId": "22",
        "cdrId": "1843204b-2b5a-45f9-b5e6-d55929f11682",
        "meterStart": 12379,
        "meterEnd": 12380
    }
}
CODE

Stop charging

To stop the charging session, you need the same parameters used when starting the session as well as the transactionId you retrieved when checking the session's progress. This time, specify the action as STOP.

Send a request to POST https://api.everon.io/poi/v1/charging-sessions:

{
    "action": "STOP",
    "evseId": "1",
    "locationId": "EVB-12345678",
    "token": "2WI8T6WEXPI3DDYW74BA",
    "transactionId": "22"
}
CODE
curl --location --request POST 'https://api.everon.io/poi/v1/charging-sessions' \
--header 'Content-Type: application/json; charset=utf-8' \
--header 'Authorization: Bearer <token>' \
--data-raw '{
    "action": "STOP",
    "evseId": "1",
    "locationId": "EVB-12345678",
    "token": "2WI8T6WEXPI3DDYW74BA",
    "transactionId": "22"
}'
CODE

A 202 response informs you that the station was sent a request to stop charging.

You can now get the charging session's details using Billing API.