Set Personal Smart Charging Preferences

Owner Smart Charging preferences are split in 6 categories, depending on the type of smart charging methodology:

user_controlled_schedule
solar
octopus_agile
octopus_go
energi_elspot
nordpool

Each category has a different set of preferences. Following you'll find examples of each:

user_controlled_schedule

This is where you'll set up your personalised charging schedule, setting the periods (startTime - endTime), Target Charge (Min and Max values for the desired charge state at the end of the period) as well as Electricity Cost tracking (in case a dynamic electricity rate service is in use).

curl --location 'https://{{baseUrl}}/public-api/resources/charge-points/v2.0/6/personal-smart-charging-preferences' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{apiToken}}' \
--data '{
  "data": [
    {
      "type": "solar",
      "preferences": {
        "startTime": "22:00",
        "endTime": "06:00",
        "targetCharge": {
          "minTargetChargeKwh": 55,
          "maxTargetChargeKwh": 70
        },
        "trackElectricityCosts": {
          "priceOffPeak": 0.12,
          "pricePeak": 0.23
        }
      },
      "enabled": true
    }
  ]
}'

RESPONSE:

{
    "data": {
        "type": "user_controlled_schedule",
        "integrationId": null,
        "preferences": {
            "startTime": "23:00:00",
            "endTime": "05:00:00",
            "targetCharge": []
        },
        "enabled": true
    }
}

solar

Solar Charging enables your EV Charge Point to use Excess solar power to charge, instead of grid current. It's important to mention only certain chargers support the functionality.

curl --location 'https://{{baseUrl}}/public-api/resources/charge-points/v2.0/6/personal-smart-charging-preferences' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{apiToken}}' \
--data '{
  "data": [
    {
      "type": "solar",
      "preferences": {
        "maxCurrentFromGrid": 12,
        "solarStableTime": "300"},
      "enabled": true
    }
  ]
}'

RESPONSE Status: 201 Created

octopus_agile, octopus_go

Flexible Electricity Rates for the next 24 hours from Octopus Group can be used to optimise charging patterns.

curl --location 'https://{{baseUrl}}/public-api/resources/charge-points/v2.0/6/personal-smart-charging-preferences' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{apiToken}}' \
--data '{
  "data": [
    {
      "type": "octopus_agile",
      "integrationId": 1,
      "preferences": {
          "applicableTaxId": 205366174,
          "targetCharge":{
              "departureTime": "07:30",
              "minTargetKwh": 45,
              "maxTargetKwh": 60
          },
          "postCode": 1000,
          "priceThreshold": 0.25
      },
      "enabled": true
    }
  ]
}'

RESPONSE Status: 201 Created

energi_elspot, nordpool

Day-ahead pricing for Austria, Denmark, Sweden, Finland, Germany, Norway, some of the baltic countries and UK.

curl --location 'https://{{baseUrl}}/public-api/resources/charge-points/v2.0/6/personal-smart-charging-preferences' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{apiToken}}'' \
--data '{
  "data": [
    {
      "type": "energi_elspot",
      "preferences": {
          "location": "GB1",
          "targetCharge":{
              "departureTime": "07:30",
              "targetKwh": 45
                }
          },
      "enabled": true
    }
  ]
}'

RESPONSE Status: 201 Created