Skip to main content

EV/EVSE

Steps to onboard an Electric Vehicle (EV) or Electric Vehicle Supply Equipment (EVSE)

📣 Note: The step order is dynamic, so when fetching the current step the query must be ready to accept any step type. An example of how this could look is as follows (note: this example does not include all possible step types)

Start onboarding wizard​

Select device type​

Select vehicle make​

This step is returned if the user needs to select the make (company/brand) of the electric vehicle to be onboarded.

Select vehicle variant​

This step is returned if the user needs to select the model/variant of the electric vehicle to be onboarded.

Select charge point make step​

This step is returned if the user needs to select the charge point make.

Select charge point variant​

This step is returned if the user needs to select the electric vehicle charge point model/variant.

Authentication​

This step is returned if the user needs to complete an authentication flow.

Setup virtual key​

This step is returned if the user needs to setup a virtual key for their device. The provided URI navigates the user to where they can set up the virtual key.

📣 Note: The step is currently only needed for Tesla's that require it.

Select user vehicle​

This step is returned if the user has multiple vehicles connected to their OEM's account. They must select a single vehicle to onboard with.

User action required​

This step is returned if device cannot be onboarded without some action from the user. An example of this is if the user needs to update their device's software.

Test charge​

For EV registration we will need to complete a test charge. To do this, we use startTestChargeForSmartFlexOnboarding.

Demo​

Here is a demo of how we can put these together to create a dynamic wizard which will load the appropriate options from the result of the previous step. This shows the UI up to the point where you would be redirected to the OAuth process of the vehicle manufacturer. The mocks are hard-coded for values for a Tesla vehicle and charger. Choosing the third option for the charger model shows a loader to indicate a redirect to OAuth would be performed.