Octopus Energy Germany

← Vehicles

This page shows the nightly version. Switch to the release version.

Reads vehicle data (state of charge, target soc) via the Octopus Energy Germany Kraken API. The vehicle or charge point must be connected in the Octopus account (Intelligent Octopus).

Parameters

Name	Description	Value	Level
email	Email address Example: user@example.com		optional
password	Password Service account password		optional
title	Title Will be displayed in the user interface		optional
capacity [kWh]	Battery capacity Example: 50		optional
accountnumber	Account Number Account when several are linked (e.g. A-12345678). Example: A-12345678		optional
device	Vehicle Vehicle when the account has more than one.		optional
icon	Icon Will be displayed in the user interface Default: car	carbikebusmopedmotorcyclerocketscootertaxitractorrickshawshuttlevanairpurifierbatterybulbclimatecoffeemakercomputecookingcoolerdesktopdevicedishwasherdryerfloorlampgenericheaterheatexchangeheatpumpkettlelaundrylaundry2machinemetermicrowavepumpsmartconsumertoolwaterheater	advanced
phases	Maximum number of phases Used to determine the minimum solar surplus and plan duration.	123	advanced
mode	Default charging mode Applied when a vehicle is connected. Leave empty to keep the current mode.		advanced
minCurrent [A]	Minimum current The minimum current per connected phase that can be used Example: 6		advanced
maxCurrent [A]	Maximum current The maximum current per connected phase that can be used Example: 16		advanced
maxPower [W]	Maximum charging power hint Defines the maximum charging power of the vehicle. Helps improve charge plan accuracy when the vehicle typically uses less than the offered current or supports higher single-phase current compared to three-phase. The offered current of the loadpoint is not affected. Example: 10000		advanced
identifiers	RFID identification Used to assign the vehicle to a loadpoint via RFID card. The identifier is shown on the loadpoint. Copy the value from there. Learn more.		advanced
priority	Priority Priority of the loadpoint or vehicle in relation to other loadpoints or vehicles for allocating surplus energy (higher values, higher priority).		advanced
climaterdisabled	Disable climater detection Ignore the vehicle's climater state for charge control, so charging stops at the SoC or energy limit even when the vehicle signals an active climater request.		advanced
autodetectdisabled	Exclude from auto detection Ignore the vehicle for auto detection of connected vehicles		advanced
welcomecharge	Charge on connection Charger will enable charging for short time when vehicle is connected, irrespective of configured charge mode. This is useful for vehicles that require power supply when connecting.		advanced
cache	Cache Time interval for data refresh Default: 15m Example: 5m		advanced

Configuration example for evcc.yaml

If you don't want to configure via the UI, you can alternatively use this YAML block.

vehicles:
    - name: my_car
      type: template
      template: octopus-de
      email: user@example.com # Email address
      password: # Password, Service account password
      title: # Title, Will be displayed in the user interface (optional)
      capacity: 50 # Battery capacity (kWh), optional
      accountnumber: A-12345678 # Account Number, Account when several are linked (e.g. A-12345678). (optional)
      device: # Vehicle, Vehicle when the account has more than one. (optional)
      icon: car # Icon, Will be displayed in the user interface [car, bike, bus, moped, motorcycle, rocket, scooter, taxi, tractor, rickshaw, shuttle, van, airpurifier, battery, bulb, climate, coffeemaker, compute, cooking, cooler, desktop, device, dishwasher, dryer, floorlamp, generic, heater, heatexchange, heatpump, kettle, laundry, laundry2, machine, meter, microwave, pump, smartconsumer, tool, waterheater] (optional)
      phases: # Maximum number of phases, Used to determine the minimum solar surplus and plan duration. [1, 2, 3] (optional)
      mode: # Default charging mode, Applied when a vehicle is connected. Leave empty to keep the current mode. (optional)
      minCurrent: 6 # Minimum current (A), The minimum current per connected phase that can be used (optional)
      maxCurrent: 16 # Maximum current (A), The maximum current per connected phase that can be used (optional)
      maxPower: 10000 # Maximum charging power hint (W), Defines the maximum charging power of the vehicle. Helps improve charge plan accuracy when the vehicle typically uses less than the offered current or supports higher single-phase current compared to three-phase. _The offered current of the loadpoint is not affected._ (optional)
      identifiers: # RFID identification, Used to assign the vehicle to a loadpoint via RFID card. The identifier is shown on the loadpoint. Copy the value from there. [Learn more.](https://docs.evcc.io/en/docs/features/vehicle) (optional)
      priority: # Priority, Priority of the loadpoint or vehicle in relation to other loadpoints or vehicles for allocating surplus energy (higher values, higher priority). (optional)
      climaterdisabled: # Disable climater detection, Ignore the vehicle's climater state for charge control, so charging stops at the SoC or energy limit even when the vehicle signals an active climater request. (optional)
      autodetectdisabled: # Exclude from auto detection, Ignore the vehicle for auto detection of connected vehicles (optional)
      welcomecharge: # Charge on connection, Charger will enable charging for short time when vehicle is connected, irrespective of configured charge mode. This is useful for vehicles that require power supply when connecting. (optional)
      cache: 15m # Cache, Time interval for data refresh (optional)