Onboarding and setup

DownloadFullscreen

By default, smart charging is DISABLED. In this state, the vehicle charges continuously when plugged in, unless the user configures other interventions via the vehicle, charger, or other apps.

To enable smart charging, we need two simple inputs:

1. A smart charging policy, including a user-defined deadline
2. One or more user-defined charging locations

A valid smart charging policy is necessary to transition from the DISABLED state to the CONSIDERING state. However, a charging location is required to generate a smart charging plan (transitioning into PLAN:*), so we consider this a core part of smart charging onboarding.

In addition to collecting these two inputs, presenting some key information early in the user journey ensures a better understanding and experience:

• What smart charging is and how it works
• Protective charging
• Interference by third parties

This guide will walk you through the required inputs and key information.

Copy linkWhat it is and how it works

DownloadFullscreen

Copy linkProtective charging

Protective charging is controlled by the vehicle's SmartChargingPolicyAPI minimumChargeLimit, which defaults to zero.

If the vehicle's charge level is below minimumChargeLimit when plugged in, it will charge continuously until it reaches minimumChargeLimit, regardless of energy prices.

Copy linkInterference by third parties

DownloadFullscreen

If the user has enabled schedules or other smart charging functionality via their charger, vehicle, or other apps, these will cause problems for smart charging plans.

Copy linkAdding a charging location

DownloadFullscreen

The vehicle must be plugged in at a known charging location for smart charging to be considered, as indicated by the atChargingLocation consideration. Post a name and location data (longitude, latitude) to the /charging-locations endpoint to add a charging location. Charging locations are also used for mapping price data to tariffsAPI or Nordpool price areas.

You can learn more about the charging location endpoints in our API referenceAPI.

Example

{
  "name": "Home",
  "longitude": 10.757933,
  "latitude": 59.911491
}

Copy linkSetting a deadline

DownloadFullscreen

Enabling smart charging for a vehicle involves calling the /vehicles/{vehicleId}/smart-charging-policy endpoint with the required information. Learn more in the previous guide and our docsAPI.

Copy linkConfirmation

DownloadFullscreen

At this point, the user is ready. The next time they plug in their vehicle at a charging location, smart charging will be considered.