Charge Assist Session states
Using the Session Start starts a charging session.
Below are the different states and an overview of the Flow.
Charge Assist Session Flow
Below is an Overview of the transition between diferent states. See State definition further below.
We advise that after a POST Start has been made to immediately start polling for GET Session at a frequent interval until the state 'Charging' is returned (e.g. once every 3-5 seconds).
Once the session is in 'Charging', the payload will include a 'nextStatusCall' recommendation to set the polling schedule.

Charge Assist Session States
Session Status | Description |
---|---|
REQUESTED | Session is created with REQUESTED status as initial state |
REJECTED | Error state. when command cannot be accepted, such as invalid token or blocked connector. |
STARTING | When the charging station accepts the start command and prepares to start the charging process, the status is changed into STARTING. |
CHARGING | When the charging session is started (car is now actually charging) status is changed to CHARGING. |
PARKING | When the car is fully charged and no substantial power is used the status is changed into PARKING. See also Parking detection |
STOPPING | When a Stop Session is initiated by the User or the EV is disconnected, the status is changed to STOPPING. This is a short-lived in-progress state until it moves to COMPLETED. |
COMPLETED | When session is completed and car can be detached status is changed to COMPLETED. The total costs will also be shown at this stage. If no total costs are shown, there was a calculation or setup error. |
CDR_AVAILABLE | When cost calculation is available status is changed into CDR_AVAILABLE. This should happen very quickly following COMPLETED state. A CDR as in OCPI specifications is not available in Charge Assist. However, all relevant components to create a receipt are available at this stage. |
TIMEOUT | When there has a been a timeout from the Charge station side. Typically 30 seconds. This is mainly due to no connector inserted. |
ERROR | General error |
Error Codes
Error Code | Description |
---|---|
INVALID_TOKEN | |
EVSE_NOT_AVILABLE | |
COMMAND_TIMED_OUT |
Example of a Timed out Command
{
"locationId": "nl-gfx-460a0012-ac8f-4c0d-b025-210583913047",
"evseUid": "NL-GFX-EThomastestCharger1-2",
"connectorId": "4",
"status": "TIMEOUT",
"canRateSession": false,
"error": "COMMAND_TIMED_OUT",
"endTime": null,
"nextStatusCall": "2021-08-11T08:56:28.0471901+00:00",
"smartChargingEnabled": false,
"prioritySessionStatus": "NOT_APPLICABLE",
"vidStatus": "VID_NOT_AVAILABLE",
"paymentMethodId": "a4711d43-f342-4fb3-8f48-b9da1db86edf",
"chargingNotAllowed": false
}
Updated almost 2 years ago