Skip to content

max1weber/ha-addon-vattenfall-tijdprijs-trend

BranchesTags

Repository files navigation

Vattenfall Tijdprijs

hacs_badge GitHub Release License codecov Tests

Home Assistant integratie voor Vattenfall TijdPrijs dynamische energieprijzen.

English version below

🇳🇱 Nederlandse Versie

Functies

Deze integratie biedt geavanceerde energieprijsberekening voor Vattenfall TijdPrijs met ondersteuning voor:

  • Tijdsgebonden Tarieven - Verschillende tarieven voor zomer/winter en normale/dal perioden
  • Dynamische Prijzen - Real-time prijsberekening op basis van huidige tijd en daluurperiode
  • 48-uurs Voorspelling - Uurlijkse prijzen voor de komende 48 uur met kleurcodering voor dashboardvisualisaties
  • ApexCharts Integratie - Klaar-voor-gebruik dataformaat voor ApexCharts met kleurcodering (groen voor lage, rood voor hoge tarieven)
  • Vaste Kosten - Dagelijkse vaste leveringskosten, systeembeheerkosten en belastingvermindering
  • Teruglever Tarieven - Vergoeding en kosten voor teruggeleverde stroom
  • Unieke Entity ID's - Alle entiteiten hebben unieke ID's voor juiste Home Assistant entity tracking

Prijsberekening

De integratie berekent energieprijzen op basis van:

  • Zomer/winter seizoen (april-september = zomer, oktober-maart = winter)
  • Dagtijden (normaal, dal doordeweeks, dal weekend)
  • Energiebelasting + leveringstarieven (beide inclusief 21% BTW)
  • Real-time berekening: de huidige prijs wordt dynamisch berekend op basis van de actuele tijd

Standaardwaarden

Alle configuratievelden hebben redelijke standaardwaarden vooraf ingesteld:

  • Zomer: 0,115 €/kWh (normaal), 0,018 €/kWh (dal), 0,000 €/kWh (weekend dal)
  • Winter: 0,141 €/kWh (normaal), 0,087 €/kWh (dal dag), 0,071 €/kWh (dal nacht)
  • Vaste kosten: 0,296 €/dag (levering), -1,723 €/dag (belastingvermindering), 1,304 €/dag (systeembeheer)

Installatie

Via HACS (Aanbevolen)

  1. Open HACS in Home Assistant
  2. Ga naar "Integrations"
  3. Klik op de drie stippen rechtsboven (â‹®)
  4. Kies "Custom repositories"
  5. Voeg deze URL toe: https://github.com/max1weber/ha-addon-vattenfall-tijdprijs-trend
  6. Selecteer "Integration" als categorie
  7. Klik op "Add"
  8. Zoek naar "Vattenfall Tijdprijs" en klik op "Download"
  9. Herstart Home Assistant

Handmatige Installatie

  1. Kopieer de map custom_components/vattenfall_tijdprijs naar je Home Assistant config/custom_components/ map
  2. Herstart Home Assistant

Configuratie

De configuratiewizard begeleidt je door de volgende stappen:

  1. Vaste Kosten - Configureer dagelijkse vaste kosten (standaardwaarden zijn vooraf ingevuld)
  2. Leveringstarieven (optioneel) - Pas de leveringstarieven aan voor elke periode of gebruik standaardwaarden
  3. Teruglever Tarieven - Stel de vergoeding en kosten voor teruggeleverde stroom in

Alle velden hebben standaardwaarden, dus je kunt de configuratie direct voltooien of afzonderlijke velden aanpassen.

Geëxporteerde Sensoren

Na configuratie zijn de volgende entiteiten beschikbaar in Home Assistant:

Dynamic Price Sensors

  • sensor.vattenfall_tijdprijs_huidige_importprijs - Current import price based on time-of-use (€/kWh)
  • sensor.vattenfall_tijdprijs_importprijs_per_uur - 48-hour price forecast with hourly values and ApexCharts data

Note: Entity IDs can be customized in Home Assistant (Settings → Devices & Services → Entities) if you prefer shorter names like sensor.importprijs_per_uur

Teruglever Sensoren

  • sensor.vattenfall_tijdprijs_terugleververgoeding - Teruglever vergoeding (€/kWh)
  • sensor.vattenfall_tijdprijs_terugleverkosten - Teruglever kosten (€/kWh)

Vaste Kosten Sensoren

  • sensor.vattenfall_tijdprijs_vaste_leveringskosten - Dagelijkse vaste leveringskosten (€/dag)
  • sensor.vattenfall_tijdprijs_vaste_netbeheerkosten - Dagelijkse systeembeheerkosten (€/dag)
  • sensor.vattenfall_tijdprijs_vaste_belastingvermindering - Dagelijkse belastingvermindering (€/dag)

Let op: De Huidige Importprijs sensor wordt dynamisch berekend op basis van de actuele tijd en het seizoen (zomer/winter) en daluren periode.

De Importprijs per uur sensor bevat in de attributen een lijst met 48 uurwaarden voor dashboardvisualisaties:

Uurlijkse Prijsdata:

hourly_prices:  # 48 uur gedetailleerde prijsdata
  - time: "2024-01-15T14:00:00"
    hour: 14
    price: 0.25184
    period: "normal"
    season: "winter"
  - time: "2024-01-15T15:00:00"
    hour: 15
    price: 0.25184
    period: "normal"
    season: "winter"
  # ... 46 meer uren

median_price: 0.23456  # Drempel voor kleurcodering

apexcharts_data:  # Vooraf geformatteerd voor ApexCharts
  - x: "2024-01-15T14:00:00"
    y: 0.25184
    fillColor: "#e74c3c"  # Rood voor hoog tarief (boven mediaan)
  - x: "2024-01-15T15:00:00"
    y: 0.20000
    fillColor: "#27ae60"  # Groen voor laag tarief (op of onder mediaan)
  # ... 46 meer uren

ApexCharts Card Example:

type: custom:apexcharts-card
header:
  title: Vattenfall Importprijs - Komende 48 uur
  show: true
apex_config:
  chart:
    height: 300
  xaxis:
    type: datetime
series:
  - entity: sensor.vattenfall_tijdprijs_importprijs_per_uur
    attribute: apexcharts_data
    name: Importprijs (€/kWh)
    type: column
    stroke_width: 0

De kleurcodering toont automatisch:

  • 🟢 Groen (#27ae60) voor lage/gunstige tarieven (≤ mediaan prijs)
  • 🔴 Rood (#e74c3c) voor hoge/dure tarieven (> mediaan prijs)

Gebruik in Automatiseringen

Voorbeeld om apparaten te schakelen op basis van de stroomprijs:

automation:
  - alias: "Boiler aan bij lage prijs"
    trigger:
      - platform: numeric_state
        entity_id: sensor.vattenfall_tijdprijs_importprijs
        below: 0.20
    action:
      - service: switch.turn_on
        target:
          entity_id: switch.boiler

  - alias: "Wasmachine uitstellen bij hoge prijs"
    trigger:
      - platform: numeric_state
        entity_id: sensor.vattenfall_tijdprijs_importprijs
        above: 0.40
    action:
      - service: switch.turn_off
        target:
          entity_id: switch.wasmachine

Energy Dashboard Integratie

Deze sensoren kunnen gebruikt worden in het Home Assistant Energy Dashboard om je energiekosten bij te houden.

Support

Voor vragen en problemen, gebruik de GitHub issue tracker.

Licentie

Dit project is gelicenseerd onder GNU AGPL v3. Eventuele aanpassingen moeten openbaar worden gemaakt.

🇬🇧 English Version

Home Assistant integration for Vattenfall TijdPrijs dynamic energy pricing with time-of-use rates and consumption-based pricing tiers.

Features

This integration provides advanced energy price calculations with:

  • Time-of-Use Pricing - Different rates for summer/winter and normal/off-peak periods
  • Dynamic Pricing - Real-time price calculation based on current time and off-peak periods
  • 48-Hour Forecast - Hourly prices for the next 48 hours with color-coded tariffs for dashboard visualizations
  • ApexCharts Integration - Ready-to-use data format for ApexCharts with color coding (green for low, red for high tariffs)
  • Fixed Costs - Daily fixed delivery costs, grid management costs, and tax reductions
  • Export Pricing - Compensation and costs for exported electricity
  • Unique Entity IDs - All entities have unique IDs for proper Home Assistant entity tracking

Price Calculation

The integration calculates energy prices based on:

  • Season (summer: April-September, winter: October-March)
  • Time of day (normal, off-peak weekday, off-peak weekend)
  • Energy tax + delivery rates (both including 21% VAT)
  • Real-time calculation: current price is dynamically calculated based on the actual time

Default Values

All configuration fields come with reasonable default values pre-filled:

  • Summer: 0.115 €/kWh (normal), 0.018 €/kWh (off-peak), 0.000 €/kWh (weekend off-peak)
  • Winter: 0.141 €/kWh (normal), 0.087 €/kWh (off-peak day), 0.071 €/kWh (off-peak night)
  • Fixed costs: 0.296 €/day (delivery), -1.723 €/day (tax reduction), 1.304 €/day (grid management)

Installation

Via HACS (Recommended)

  1. Open HACS in Home Assistant
  2. Go to "Integrations"
  3. Click the three dots in the top right (â‹®)
  4. Select "Custom repositories"
  5. Add this URL: https://github.com/max1weber/ha-addon-vattenfall-tijdprijs-trend
  6. Select "Integration" as category
  7. Click "Add"
  8. Search for "Vattenfall Tijdprijs" and click "Download"
  9. Restart Home Assistant

Manual Installation

  1. Copy the custom_components/vattenfall_tijdprijs folder to your Home Assistant config/custom_components/ directory
  2. Restart Home Assistant

Configuration

The configuration wizard guides you through the following steps:

  1. Fixed Costs - Configure daily fixed costs (default values are pre-filled)
  2. Delivery Rates (optional) - Customize delivery rates for each period or use standard rates
  3. Export Rates - Set compensation and costs for exported electricity

All fields have default values, so you can complete the configuration immediately or adjust individual fields as needed.

Use in Automations

Example to control devices based on electricity price:

automation:
  - alias: "Turn on water heater at low price"
    trigger:
      - platform: numeric_state
        entity_id: sensor.vattenfall_tijdprijs_importprijs
        below: 0.20
    action:
      - service: switch.turn_on
        target:
          entity_id: switch.water_heater

  - alias: "Postpone washing machine at high price"
    trigger:
      - platform: numeric_state
        entity_id: sensor.vattenfall_tijdprijs_importprijs
        above: 0.40
    action:
      - service: switch.turn_off
        target:
          entity_id: switch.washing_machine

Exported Sensors

After configuration, the following entities are available in Home Assistant:

Dynamic Price Sensors

  • sensor.vattenfall_tijdprijs_huidige_importprijs - Current import price based on time-of-use (€/kWh)
  • sensor.vattenfall_tijdprijs_importprijs_per_uur - 48-hour price forecast with hourly values and ApexCharts data

Note: Entity IDs can be customized in Home Assistant (Settings → Devices & Services → Entities) if you prefer shorter names like sensor.importprijs_per_uur

Export Sensors

  • sensor.vattenfall_tijdprijs_terugleververgoeding - Export compensation (€/kWh)
  • sensor.vattenfall_tijdprijs_terugleverkosten - Export costs (€/kWh)

Fixed Cost Sensors

  • sensor.vattenfall_tijdprijs_vaste_leveringskosten - Daily fixed delivery costs (€/day)
  • sensor.vattenfall_tijdprijs_vaste_netbeheerkosten - Daily grid management costs (€/day)
  • sensor.vattenfall_tijdprijs_vaste_belastingvermindering - Daily tax reduction (€/day)

Note: The Huidige Importprijs sensor is dynamically calculated based on the current time, season (summer/winter), and time-of-use period.

The Importprijs per uur sensor provides 48-hour price data in its attributes for dashboard visualizations:

Hourly Prices Data:

hourly_prices:  # 48 hours of detailed price data
  - time: "2024-01-15T14:00:00"
    hour: 14
    price: 0.25184
    period: "normal"
    season: "winter"
  - time: "2024-01-15T15:00:00"
    hour: 15
    price: 0.25184
    period: "normal"
    season: "winter"
  # ... 46 more hours

median_price: 0.23456  # Threshold for color coding

apexcharts_data:  # Pre-formatted for ApexCharts
  - x: "2024-01-15T14:00:00"
    y: 0.25184
    fillColor: "#e74c3c"  # Red for high tariff (above median)
  - x: "2024-01-15T15:00:00"
    y: 0.20000
    fillColor: "#27ae60"  # Green for low tariff (at or below median)
  # ... 46 more hours

ApexCharts Card Example:

type: custom:apexcharts-card
header:
  title: Vattenfall Importprijs - Komende 48 uur
  show: true
apex_config:
  chart:
    height: 300
  xaxis:
    type: datetime
series:
  - entity: sensor.vattenfall_tijdprijs_importprijs_per_uur
    attribute: apexcharts_data
    name: Importprijs (€/kWh)
    type: column
    stroke_width: 0

The color coding automatically shows:

  • 🟢 Green (#27ae60) for low/favorable tariffs (≤ median price)
  • 🔴 Red (#e74c3c) for high/expensive tariffs (> median price)

Energy Dashboard Integration

These sensors can be used in the Home Assistant Energy Dashboard to track your energy costs.

Support

For questions and issues, use the GitHub issue tracker.

License

This project is licensed under GNU AGPL v3. Any deployed modifications must publish their source code.

About

Home Assistant integration for Vattenfall TijdPrijs Trend 'dynamic energy' pricing

Topics

energy homeassistant hacs vattenfall homeassistant-integration energyprices tijdprijs tijdprijstrend

Resources

Readme

License

View license

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

1 tags

Packages

 
 
 

Contributors

Languages