Aan de slag met de Energy Price Calculator
Inleiding
Bedankt voor je abonnement op Goedkopeuren.nl. In deze documentatie lees je hoe je de Energy Price Calculator installeert in Home Assistant en je apparaten op de goedkoopste uren laat draaien.
Wat zit er in je abonnement (€5 per maand)
- Goedkopeuren-tool: de Energy Price Calculator met alle prijssensoren en blueprints
- AI-gebaseerd onderhoud: wij bewaken je installatie op afstand; valt er iets uit, dan verhelpen wij het — vaak voordat je het doorhebt
- Automatische backups: je configuratie wordt dagelijks versleuteld opgeslagen, zodat je na een storing zo weer terug bent
- Dagelijkse KPI-rapportage: elke dag inzicht in wat je bespaart, je verbruik en je rendement — via de Home Assistant Companion-app of e-mail
Wat heb je nodig
- Home Assistant (versie 2024.6 of nieuwer) op eigen hardware, zoals een Raspberry Pi of mini-pc
- Je persoonlijke API-key uit de bestelmail van je abonnement
- Een dynamisch energiecontract
Stap 1: Installeren via HACS
- Open HACS in de zijbalk van Home Assistant.
- Ga naar Integraties en kies rechtsboven de drie puntjes en daarna Aangepaste repositories.
- Voeg toe:
https://github.com/MI-Services/energy-price-calculatormet categorie Integratie. - Installeer Energy Price Calculator en herstart Home Assistant.
Heb je nog geen HACS? Volg dan eerst de HACS-installatiehandleiding van Home Assistant, of installeer de integratie handmatig via de GitHub-repository.
Stap 2: Verbinden met de prijsserver
- Ga naar Instellingen → Apparaten en diensten → Integratie toevoegen.
- Zoek op Energy Price Calculator en start de configuratie.
- Vul in:
- Server-URL:
https://api.goedkopeuren.nl - API-key: de key uit je bestelmail
- Server-URL:
- Bevestig; de integratie haalt direct de actuele prijzen op.
Daarna haalt de integratie één keer per dag (rond middernacht) de prijzen op. Lukt dat niet, dan wordt het automatisch opnieuw geprobeerd. Sensoren blijven altijd zichtbaar; eventuele foutmeldingen vind je in de eigenschappen van de sensor, zodat je altijd kunt zien wat er aan de hand is.
Stap 3: Je sensoren
Na installatie zie je twee soorten sensoren:
- Categorie-sensoren: tonen per uur of het moment tot de goedkoopste uren, de goede uren, de normale of de dure uren van de dag behoort. Gebruik deze om apparaten op de beste momenten te schakelen.
- Percentagesensoren (10–90%): aan/uit-sensoren die aangeven of een apparaat mag draaien om met een bepaald deel van de dag (bijvoorbeeld 20%) de goedkoopste uren te benutten. De sensor staat aan zodra het huidige uur binnen dat goedkoopste deel valt. Ideaal voor apparaten met een vast draaibudget, zoals een boiler van twee uur per dag.
Stap 4: Apparaten koppelen met de blueprint
- Ga naar Instellingen → Automatiseringen → Blueprint importeren en importeer onze blueprint Run device during cheapest hours via de GitHub-repository.
- Kies in de blueprint:
- de categorie-sensor (bijvoorbeeld de sensor voor de goedkoopste uren)
- de apparaatschakelaar die je wilt aansturen (bijvoorbeeld de boiler)
- Klaar: het apparaat schakelt automatisch mee op de goedkoopste uren. De blueprint controleert regelmatig of het apparaat op het juiste moment aan of uit staat.
Boiler slim schakelen
- Zet een elektrisch geschakelde boiler op minimaal 60 °C (legionella-veiligheid). De tank werkt als thermische batterij: opwarmen in de goedkoopste uren, stroom uit tijdens de piek — je hebt nog steeds warm water.
- Temper bij aftap met een thermostatische mengkraan: 60 °C in de tank is niet 60 °C uit de kraan.
- Heb je een warmtepompboiler? Plan nooit alle goedkope uren vol — houd altijd een paar slots inhaalcapaciteit.
Dagelijkse KPI-rapportage
Elke dag ontvang je een kort rapport met je besparingen, verbruik en rendement — via de Home Assistant Companion-app of per e-mail. Zo zie je elke dag wat de slimme sturing oplevert.
Problemen oplossen
Sensoren tonen een foutmelding:
- Ongeldige API-key — controleer of de key exact is overgenomen uit je bestelmail, zonder spaties.
- Abonnement inactief — controleer de status van je abonnement of neem contact op met support.
- Nog geen prijzen beschikbaar — nieuwe prijzen worden gedurende de dag gepubliceerd; wacht even en controleer opnieuw.
Sensoren of de integratie ontbreken:
- Herstart Home Assistant na de installatie.
- Controleer of de integratie in de lijst bij Apparaten en diensten staat.
Kom je er niet uit? Stuur via het contactformulier een korte beschrijving en een screenshot van de foutmelding. Met het AI-onderhoud proberen we storingen bovendien te detecteren voordat je ze merkt.
Meer informatie
- Broncode en updates: https://github.com/MI-Services/energy-price-calculator
- Uitgebreide handleiding (NL/EN): binnenkort op deze pagina
- Support: contactformulier
Privacy
We gaan zorgvuldig om met je gegevens. De integratie haalt per dag één keer prijsgegevens op met je persoonlijke API-key; je verbruiksgegevens blijven in je eigen Home Assistant. We verkopen geen gegevens en delen ze niet met derden.
Voorwaarden
Op het abonnement en het gebruik van de dienst zijn onze algemene voorwaarden van toepassing: https://goedkopeuren.nl/voorwaarden