Maak van Home Assistant een echt energiemanagementsysteem.

Wat doet ze

• Prijssensoren sensor.sef_afnameprijs en sensor.sef_injectieprijs: wat één kWh nu kost of opbrengt met uw huidige contract, all-in in EUR incl. btw, elk kwartier vernieuwd. De prijs per kwartier van vandaag en morgen staat in het attribuut kwartieren (bij een dynamisch contract morgen pas na 13 uur; nooit voorbij het einde van de maand), voor een automatisering die de vaatwasser of de wagen op het goedkoopste moment laat starten.
• Huidig contract sensor.sef_contract_elektriciteit (en met gas sensor.sef_contract_gas): leverancier en product waarmee uw dossier rekent, met in het attribuut tariefkaart_url de link naar de tariefkaart die die prijs bepaalt (leeg als die niet gekend is, bv. bij een prijs uit het VREG-werkboek).
• Waakhond: sensor.sef_besparing_elektriciteit zegt hoeveel het goedkoopste contract uit uw laatste vergelijking minder kost dan uw huidige contract, en sensor.sef_contract_elektriciteit_dagen_tot_einde hoeveel dagen uw contract uit Mijn contracten nog loopt. Met een automatisering krijgt u zo een melding op uw gsm als het goedkoper kan of uw contract afloopt. De besparing is zo recent als uw laatste vergelijking.
• Voorschot (vanaf 0.6.0): geef uw maandvoorschot in bij Mijn voorschot. sensor.sef_kost_deze_maand_elektriciteit zegt wat uw verbruik deze maand al kostte tegenover uw voorschot voor dezelfde dagen, sensor.sef_jaarschatting_elektriciteit wat de laatste 12 volle maanden kosten met uw huidige contract, en sensor.sef_voorschot_saldo_elektriciteit of u op de afrekening moet bijbetalen (positief) of terugkrijgt (negatief). Vanaf 0.9.0 zegt sensor.sef_kost_sinds_afrekening_elektriciteit wat uw verbruik kostte sinds de datum van uw laatste afrekening (ook in te geven bij Mijn voorschot); elektriciteit en gas samen maakt u met een template-sensor.
• P1-upload: twee minuten na elk kwartier leest ze de telwerken van uw P1-meter (bv. HomeWizard) uit de statistieken van Home Assistant en stuurt de kwartierwaarden naar uw dossier. Een gemist kwartier vult ze vanzelf aan, tot 10 dagen terug.
• Gas (optioneel): elk uur het gasverbruik in m³ naar uw dossier, dat omrekent naar kWh met de omrekening uit uw eigen Fluvius-gasexport, en sensor.sef_gasprijs: wat één m³ nu kost met uw huidige gascontract, rechtstreeks bruikbaar in het Energy-dashboard.
• Meldingen in Home Assistant: weigert uw dossier een upload, of heeft een telwerk geen statistiek, dan verschijnt een melding met de reden. Zie Problemen oplossen.

Sensoren

Alle bedragen zijn in EUR incl. btw, met het contract dat u in Mijn contracten als huidig aanduidt. Is Energieplatform Vlaanderen even niet bereikbaar, dan worden de sensoren onbeschikbaar; Home Assistant start gewoon verder.

• ¹ Enkel als u een gastelwerk instelt.
• ² Als u een gastelwerk instelt, of als uw dossier een gascontract of gasvergelijking heeft. Dat wordt bekeken bij het opstarten: herlaad de integratie nadat u een gascontract toevoegt.
• ³ Als u een gastelwerk instelt, of als uw dossier een gasaansluiting heeft (bekeken bij het opstarten). De jaarschatting vraagt 12 volle maanden meetdata zonder gaten; anders zegt reden waarom ze onbekend is.
• kwartieren is een lijst met per kwartier start en prijs, voor elk contract, van vandaag en morgen (bij een dynamisch contract morgen pas na 13 uur; nooit voorbij het einde van de maand). Ze wordt niet in de geschiedenis bewaard; een kwartier zonder gekende prijs heeft prijs: null.
• reden zegt waarom de besparing onbekend is, bv. nog geen vergelijking of geen doorgerekend huidig contract. De besparing is zo recent als uw laatste vergelijking: start er een op de website om ze te verversen.
• Dagen tot einde is onbekend bij een contract zonder einddatum.

Vooraf

Aangemeld ziet u deze lijst met vinkjes onder Mijn Energieplatform → Home Assistant, met bij elke stap die nog ontbreekt een link om ze in orde te brengen.

1. Een account met een opgeladen Fluvius-export van precies één elektriciteitsaansluiting (en voor gas precies één gasaansluiting). De P1-upload sluit aan op de laatste meting in uw dossier en kan hoogstens 10 dagen aanvullen.
2. Uw huidige contract aangeduid in Mijn contracten, voor de prijssensoren.
3. Een Home Assistant-sleutel: maak hem op API-sleutels. Hij leest uw prijzen en mag P1-metingen opladen (dossier:lezen dossier:schrijven), los van een eventuele MCP/API-sleutel.
4. De P1-stroom toegestaan: Mijn Energieplatform → Instellingen → P1-meter, per aansluiting (voor gas dus apart). Zonder dat vinkje weigert het platform elke upload, ook met een geldige sleutel. Voor enkel de prijs- en waakhondsensoren is het niet nodig.
5. Een P1-meter in Home Assistant met kWh-telwerken (state_class: total_increasing), bv. de HomeWizard-integratie.
6. Voor gas: uw recentste Fluvius-gasexport (opnieuw) opgeladen. Daaruit haalt uw dossier de omrekening van m³ naar kWh; zonder die omrekening blijft sensor.sef_gasprijs onbekend en wordt de gasupload geweigerd.
7. Home Assistant moet https://energieplatform-vlaanderen.be bereiken. Controle in de Terminal-add-on: curl -s -o /dev/null -w '%{http_code}' https://energieplatform-vlaanderen.be/api/v1/status geeft 401 (geen sleutel meegegeven), geen time-out.

Installatie

1. Met HACS: HACS → ⋮ (drie puntjes rechtsboven) → Aangepaste repositories, plak https://github.com/Gert1986/energieplatform-vlaanderen-ha, kies type Integratie en voeg toe. Zoek daarna Energieplatform Vlaanderen in HACS, download en herstart Home Assistant. Een nieuwe versie verschijnt dan vanzelf als update in HACS.
   Zonder HACS: pak de zip uit in /config/ van Home Assistant, zodat er /config/custom_components/sef/ staat (bv. met de add-on Samba share of Studio Code Server), en herstart Home Assistant. Kwam u eerder met de zip? HACS mag dezelfde map gewoon overnemen.
2. Instellingen → Apparaten en diensten → Integratie toevoegen → Energieplatform Vlaanderen. Vul uw Home Assistant-sleutel in; die wordt meteen nagekeken.
3. Daarna optioneel uw P1-meter. Laat alles leeg voor enkel de prijs- en waakhondsensoren.
   • De telwerken: zoek in de lijst op energy_import_tariff en energy_export_tariff (kWh), en voor gas op gas_meter (m³; bij HomeWizard op het aparte apparaat Gas meter, bv. sensor.gas_meter_gas, niet het oude sensor.p1_meter_total_gas). Elk telwerk moet onder Ontwikkelhulpmiddelen → Statistieken staan; zonder statistiek kan er niets doorgestuurd worden en toont Home Assistant een melding.
   • Het meter-ID: het serienummer van uw P1-meter (bij HomeWizard: Instellingen → Apparaten → HomeWizard → apparaatinfo), enkel letters en cijfers. Uw dossier koppelt de eerste upload aan dit ID; een ander ID daarna wordt geweigerd.

Later iets wijzigen (een telwerk, gas toevoegen): er is nog geen optiescherm. Verwijder de integratie en voeg ze opnieuw toe; de entiteiten krijgen dezelfde namen, dus uw Energy-dashboard en automatiseringen blijven werken. Geef daarbij altijd hetzelfde meter-ID in: uw dossier weigert een ander.

Liever in YAML, zoals tot versie 0.3.0? Dat kan nog: Home Assistant leest het blok bij het opstarten in de integratie in, met dezelfde sensoren. Let op: zolang er een sef:-blok in uw YAML staat, vervangt het bij elke herstart wat u in de gebruikersinterface ingaf. Een regel die u uit de YAML schrapt, verdwijnt ook uit de integratie.

# secrets.yaml
sef_sleutel: sef_...

# configuration.yaml
sef:
  sleutel: !secret sef_sleutel
  meter: 5c2fafabcdef            # serienummer van de P1-meter
  afname_1: sensor.p1_meter_energy_import_tariff_1
  afname_2: sensor.p1_meter_energy_import_tariff_2
  injectie_1: sensor.p1_meter_energy_export_tariff_1
  injectie_2: sensor.p1_meter_energy_export_tariff_2
  tarief_1: dag                  # 1.8.1/2.8.1 = dag (Belgische afspraak); omgekeerd? zet nacht
  # enkelvoudig: true            # enkel bij een enkelvoudige meter
  gas: sensor.gas_meter_gas     # optioneel: gastelwerk in m³ (elk uur naar uw dossier + gasprijs)

Gas. Met gas stuurt Home Assistant elk uur uw gasverbruik in m³; uw dossier rekent om naar kWh met de omrekening uit uw eigen Fluvius-gasexport. Laad daarvoor uw recentste gasexport (opnieuw) op en zet de P1-stroom ook voor uw gasaansluiting aan.

Zonder meter of telwerken komen enkel de prijs- en waakhondsensoren. Weigert uw dossier een upload, dan verschijnt een melding in Home Assistant (SEF weigerde de P1-upload …) met de reden.

Controleren. Na de herstart kijkt u onder Mijn Energieplatform → Home Assistant: daar staat binnen het kwartier Verbonden, met sinds wanneer, wat er van uw P1-meter binnenkomt en welke prijzen er naar Home Assistant gaan.

Energy-dashboard

Instellingen → Dashboards → Energie → Elektriciteitsnet: kies bij elk afnametelwerk "Gebruik een entiteit met de huidige prijs" → sensor.sef_afnameprijs, en bij elk injectietelwerk sensor.sef_injectieprijs. De vaste kosten (vaste vergoeding, capaciteitstarief) zitten bewust niet in die prijs.

Gasverbruik: kies bij uw gastelwerk "Gebruik een entiteit met de huidige prijs" → sensor.sef_gasprijs (EUR/m³ incl. btw met uw huidige gascontract, ook zonder vaste kosten).

Automatiseringen

Drie voorbeelden om in automations.yaml te plakken (of in de YAML-weergave van een nieuwe automatisering). Pas de drempels en de dienst notify.notify aan naar uw eigen toestel, bv. notify.mobile_app_uw_gsm.

- alias: Energieplatform - goedkoper contract
  trigger:
    - platform: numeric_state
      entity_id: sensor.sef_besparing_elektriciteit
      above: 50
  action:
    - service: notify.notify
      data:
        message: >
          {{ state_attr('sensor.sef_besparing_elektriciteit', 'beste_contract') }} kost
          {{ states('sensor.sef_besparing_elektriciteit') }} EUR minder dan uw huidige contract.

- alias: Energieplatform - contract loopt af
  trigger:
    - platform: numeric_state
      entity_id: sensor.sef_contract_elektriciteit_dagen_tot_einde
      below: 31
  action:
    - service: notify.notify
      data:
        message: Uw elektriciteitscontract loopt over {{ states('sensor.sef_contract_elektriciteit_dagen_tot_einde') }} dagen af.

- alias: Energieplatform - goedkope stroom
  trigger:
    - platform: numeric_state
      entity_id: sensor.sef_afnameprijs
      below: 0.15
  action:
    - service: switch.turn_on
      target:
        entity_id: switch.vaatwasser

De besparing geldt voor de periode van uw laatste vergelijking. Bij een dynamisch contract kunt u met het attribuut kwartieren van sensor.sef_afnameprijs ook vooruit plannen, bv. het goedkoopste kwartier van vandaag zoeken.

Goed om te weten

• Fluvius gaat voor. Na een herstart of storing zet Home Assistant het verbruik van de periode zonder statistiek in het eerste blok erna: het totaal klopt, het tijdstip niet. Een latere Fluvius-export vervangt die kwartieren.
• Eén register per kwartier: het telwerk dat bewoog. Wisselt het tarief binnen het kwartier, dan gaat alles naar het grootste.
• Gas in m³, omgerekend met de vorige maand. De werkelijke omrekening van Fluvius wijkt doorgaans minder dan 1 % af; een latere Fluvius-export zet de uren recht.
• Wanneer: elektriciteit om :02, :17, :32 en :47, gas om :07 na elk uur; de eerste upload loopt een minuut na het opstarten.
• Limiet: 12 uploads per uur per sleutel; normaal zijn het er 4 (met gas 5).

Problemen oplossen

Begin altijd bij Mijn Energieplatform → Home Assistant: daar staat wat nog ontbreekt, met een link per stap. Meldingen in Home Assistant hebben de vorm SEF weigerde de P1-upload (CODE): uitleg; meer detail in Instellingen → Systeem → Logboeken.

De algemene foutcodes van de API staan in de API-documentatie.