Joulo staat in HACS, en een klant heeft het gebouwd

In augustus vroeg Joulo-klant Martijn Giltay of hij een Home Assistant-integratie voor Joulo in HACS mocht zetten. Heel graag, zei ik, en ik beloofde hem een blog zodra hij erin stond. Sinds 18 oktober 2026 staat hij erin. Dit is die blog.

"REST in YAML is als een laadkabel met kroonsteentjes: hij doet het, maar je wilt het niet. Nu is het zoeken op Joulo, downloaden, token plakken, klaar."

Martijn Giltay

In mei schreef ik hier nog dat je Joulo in Home Assistant krijgt met "geen add-on, geen HACS. Alleen YAML." Dat klopt dus niet meer. En dat komt niet door ons, maar door een klant.

Waarom ik hier blij van word

Een open API was voor ons geen marketingbesluit. Je laaddata is van jou, dus moet je er zelf iets mee kunnen. In juli kwam daar je ERE-positie bij: wat al is uitbetaald, wat nog naar je toe komt en wat we verwachten. Ik dacht aan een paar developers die er een grafiekje van zouden maken.

Martijn maakte er 33 sensors van. Plus een voorbeelddashboard dat mooier is dan sommige schermen die we zelf bouwden.

Daarom zet je een API open. Iemand anders bouwt iets wat jij niet had bedacht.

Wat je krijgt

Per laadstation één apparaat in Home Assistant:

• Status: of je laadstation online is.
• Laden: aan zolang er een laadsessie loopt.
• Laadsessie: de kWh van de lopende laadsessie.
• TAG-ID: de tag van de lopende laadsessie. Handig voor EVCC, of om te zien welke auto laadt.
• Verwachte opbrengst: wat de lopende laadsessie je naar verwachting oplevert aan ERE's, na servicekosten.

En één apparaat voor je account:

• Totaal: je geladen kWh, je ERE's en je aantal laadsessies.
• ERE-positie: wat al is uitbetaald, wat nog naar je toe komt en wat we dit jaar verwachten.
• Dit kwartaal: hoeveel ERE's al verkocht zijn en tegen welke prijs.

Koppel je later een tweede laadstation, dan verschijnt dat vanzelf.

Alle bedragen komen uit de API. Het zijn dus dezelfde getallen als in je dashboard. Wat nog niet verkocht is, is een verwachting bij de huidige prijs. Wat uitbetaald is, staat vast.

Eén detail vond ik echt netjes. Tijdens het laden rekent de integratie de verwachte opbrengst zelf uit, met je vorige laadsessie en de prijs uit de API. Er staat geen enkel tarief vast in zijn code. Is de laadsessie klaar, dan neemt hij ons exacte getal over.

Installeren

1. Token ophalen. Open in je Joulo-dashboard Developer › API, zet de API aan en kopieer je token.
2. Downloaden in HACS. Open HACS in Home Assistant, zoek op Joulo en klik op Downloaden. Herstart daarna Home Assistant.
3. Integratie toevoegen. Ga naar Instellingen › Apparaten en diensten, voeg Joulo toe en plak je token.

Na een minuut staan je sensors erin. Het token geeft alleen leestoegang tot je eigen Joulo-gegevens. Wij zien niets van je Home Assistant en kunnen er niets in veranderen.

Liever zonder HACS? Op joulo.nl/home-assistant staat nog steeds het YAML-blok, met een Lovelace-kaart en twee automations. Het recept met je eigen token staat in je dashboard bij Developer › API › Recepten.

Het dashboard van Martijn

In de README van de integratie staat zijn voorbeelddashboard. Het gebruikt alleen de ERE-sensors: uitbetaald, nog te ontvangen, de verwachting voor dit jaar en je gemiddelde prijs. Kopieer de YAML en je hebt het in een paar minuten staan. Je hebt er drie kaarten uit HACS voor nodig: mushroom, apexcharts-card en card-mod.

Wie onderhoudt het?

Martijn. Het is zijn integratie, niet de onze, en zo wil ik het houden. Werkt de integratie niet goed, meld het dan op GitHub. Klopt een getal in je data niet, stuur ons dan een bericht in je dashboard. Dan kijken we mee.

Wij doen de rest: de integratie staat in je dashboard bij Developer › API, en we houden de API stabiel. Bouw je zelf iets op de Joulo API? Laat het me weten. Misschien wordt dat de volgende blog.

Martijn, bedankt. Mooier kan iemand onze API niet gebruiken.

Groet, Ruben