Laadsessies, ERE en status in Home Assistant
Joulo levert een REST API met dezelfde data als je dashboard. Eén YAML-blok in je configuration.yaml en je hebt sensors voor laadstatus, kWh per sessie, totale ERE-credits en de actieve TAG-ID.
Liever eerst het waarom? Lees Joulo in Home Assistant • hoe je laadsessies, ERE en TAG-ID via één YAML-blok binnenhaalt.
wat je krijgt
Vier datastromen, één token
De Joulo REST API geeft een handvol endpoints. Daarboven bouw je in Home Assistant zoveel sensors als je wilt • status, energie, sessies, EVCC-koppeling en een herstart-knop.
Realtime status
GET /chargers • status van elk laadstation, of er actief geladen wordt en de kWh die je huidige sessie tot nu toe heeft binnengehaald.
Sessies
GET /sessions • lijst van de laatste laadsessies met kWh, start- en eindtijd, en de bijbehorende ERE-credits per sessie.
Energie & ERE
GET /energy • totaal geladen kWh en opgebouwde ERE-credits. Ideaal voor één-getalsindicatoren op je dashboard.
EVCC TAG-ID
current_session.id_tag • de RFID/TAG-ID achter de actieve sessie. Plak die in EVCC zodat je weet welke auto er staat te laden.
setup
In vier stappen werkend
De integratie gebruikt de standaard rest: integratie van Home Assistant. Geen custom component, geen HACS • gewoon YAML.
01 • API-token genereren
Log in op je Joulo-dashboard en open de API-tab. Activeer de API en kopieer het token. Het token werkt alleen op je eigen Joulo-data • Joulo heeft géén toegang tot je Home Assistant.
02 • secrets.yaml
Zet de volledige headerwaarde • dus Bearer plus je token • in secrets.yaml onder de key joulo_api_auth. Configuration.yaml verwijst er dan naar als !secret joulo_api_auth, zonder aanhalingstekens: YAML vult een !secret niet in binnen een string.
03 • configuration.yaml
Voeg het rest:-blok hieronder toe. De drie endpoints (chargers, energy, sessions) leveren samen alle sensors die je nodig hebt.
04 • Restart Home Assistant
Doe een volledige restart (niet alleen reload YAML). Na een minuut staan de Joulo-entities in Developer Tools → States.
configuratie
Kopieer-en-plak YAML
Plak dit in je configuration.yaml. Wijzig [0] in een index of slug als je meerdere laadstations hebt.
# secrets.yaml # Plak je token precies zoals het dashboard het toont. Het begint niet met joulo_. joulo_api_auth: "Bearer JOUW_API_TOKEN"
# configuration.yaml • Joulo sensors
# Elke sensor heeft een unique_id. Dan maakt Home Assistant na een YAML-reload
# geen nieuwe entiteit aan, en kun je de sensor in de interface hernoemen.
rest:
- resource: https://api.joulo.nl/functions/v1/api/chargers
scan_interval: 300
headers:
Authorization: !secret joulo_api_auth
sensor:
- name: "Joulo Charger Status"
unique_id: joulo_charger_status
value_template: >-
{{ value_json.chargers[0].status | default('unknown') }}
- name: "Joulo Session kWh"
unique_id: joulo_session_kwh
value_template: >-
{% set s = value_json.chargers[0].current_session | default(none) %}
{{ (s.kwh_so_far if s else 0) | float(0) }}
unit_of_measurement: "kWh"
device_class: energy
state_class: total_increasing
# Geschatte netto-opbrengst van de lopende sessie in euro. 0 als je niet laadt.
- name: "Joulo Opbrengst Huidige Sessie"
unique_id: joulo_opbrengst_huidige_sessie
value_template: >-
{% set s = value_json.chargers[0].current_session | default(none) %}
{{ (s.estimated_euro if s and s.estimated_euro is not none else 0) | float(0) }}
unit_of_measurement: "EUR"
device_class: monetary
# RFID/TAG-ID van de actieve sessie • handig voor EVCC om
# de auto achter de sessie te identificeren.
- name: "Joulo Active TAG ID"
unique_id: joulo_active_tag_id
value_template: >-
{% set s = value_json.chargers[0].current_session | default(none) %}
{{ s.id_tag if s and s.id_tag else '' }}
binary_sensor:
- name: "Joulo Is Charging"
unique_id: joulo_is_charging
value_template: "{{ value_json.chargers[0].is_charging | default(false) }}"
device_class: power
- resource: https://api.joulo.nl/functions/v1/api/energy
scan_interval: 3600
headers:
Authorization: !secret joulo_api_auth
sensor:
- name: "Joulo Total kWh"
unique_id: joulo_total_kwh
value_template: "{{ value_json.total_kwh | float(0) }}"
unit_of_measurement: "kWh"
device_class: energy
state_class: total_increasing
- name: "Joulo Total ERE"
unique_id: joulo_total_ere
value_template: "{{ value_json.total_ere_credits | float(0) }}"
state_class: total_increasing
- resource: https://api.joulo.nl/functions/v1/api/sessions?limit=10
scan_interval: 600
headers:
Authorization: !secret joulo_api_auth
sensor:
- name: "Joulo Last Session kWh"
unique_id: joulo_last_session_kwh
value_template: "{{ value_json.sessions[0].kwh | float(0) }}"
unit_of_measurement: "kWh"
device_class: energy
- name: "Joulo Last Session ERE"
unique_id: joulo_last_session_ere
value_template: "{{ value_json.sessions[0].ere_credits | float(0) }}"
- resource: https://api.joulo.nl/functions/v1/api/ere-position
scan_interval: 3600
headers:
Authorization: !secret joulo_api_auth
sensor:
# Verkocht en nog niet op je rekening: klaar voor uitbetaling plus gereserveerd.
- name: "Joulo Nog Uit Te Betalen"
unique_id: joulo_nog_uit_te_betalen
value_template: >-
{{ ((value_json.payable.net_eur | float(0))
+ (value_json.reserved.net_eur | float(0))) | round(2) }}
unit_of_measurement: "EUR"
device_class: monetary
dashboard
Lovelace-kaart in vijf regels
Een basis entities-kaart laat de belangrijkste Joulo-sensors zien. Vervang gerust door een gauge, history-graph of mini-graph card voor een rijker beeld.
# Lovelace dashboard kaart
type: entities
title: Joulo laadstation
entities:
- entity: sensor.joulo_charger_status
name: Status
- entity: binary_sensor.joulo_is_charging
name: Laadt nu
- entity: sensor.joulo_session_kwh
name: Huidige sessie
- entity: sensor.joulo_opbrengst_huidige_sessie
name: Opbrengst huidige sessie
- entity: sensor.joulo_nog_uit_te_betalen
name: Nog uit te betalen
- entity: sensor.joulo_total_kwh
name: Totaal geladen
- entity: sensor.joulo_total_ere
name: ERE-credits
automations
Twee automation-recepten
Wat je doet met de data is aan jou. Twee veelgebruikte patronen die je direct kunt overnemen:
Push-notificatie bij sessie-einde
# automations.yaml • notify wanneer sessie eindigt
- id: joulo_session_done
alias: "Joulo • sessie afgerond"
trigger:
- platform: state
entity_id: binary_sensor.joulo_is_charging
from: "on"
to: "off"
action:
- service: notify.mobile_app_jouw_telefoon
data:
title: "Laadsessie klaar"
message: >-
{{ states('sensor.joulo_session_kwh') }} kWh geladen.
Totaal vandaag: {{ states('sensor.joulo_total_kwh') }} kWh.
EVCC auto-identificatie via TAG-ID
# evcc.yaml • gebruik de Joulo TAG-ID voor auto-identificatie
vehicles:
- name: tesla
type: template
template: tesla
identifiers:
# Plak hier de waarde van sensor.joulo_active_tag_id na een
# eerste laadsessie. EVCC herkent dan welke auto er laadt.
- "DEADBEEF12345678"
beheer
Herstart je laadstation vanuit Home Assistant
Loopt je laadstation vast? POST /chargers/reboot stuurt een OCPP Reset via de Joulo-backend • voor laadstations die via OCPP of de Joulo Proxy gekoppeld zijn. Een actieve sessie stopt, het commando komt alleen aan als het laadstation online is, en per laadstation geldt een cooldown van zo'n 5 minuten.
rest_command definiëren
# configuration.yaml • herstart je laadstation op afstand
# charger_id = het "id" uit GET /chargers. type "Soft" rondt een actieve
# sessie netjes af; "Hard" herstart direct.
rest_command:
joulo_reboot_charger:
url: https://api.joulo.nl/functions/v1/api/chargers/reboot
method: POST
headers:
Authorization: !secret joulo_api_auth
content_type: "application/json"
payload: '{"charger_id": "CHARGER_ID", "type": "Soft"}'
Knop op je dashboard
# Lovelace • knop die de herstart aanroept
type: button
name: Herstart laadstation
icon: mdi:restart
tap_action:
action: call-service
service: rest_command.joulo_reboot_charger
confirmation:
text: Laadstation herstarten? Een actieve sessie stopt.
troubleshooting
Als entities leeg blijven
401 Unauthorized
Token niet correct gekopieerd, of in secrets.yaml staan aanhalingstekens om het token. Verwijder ze, herstart Home Assistant en check de log.
unavailable / unknown
value_template kan de waarde niet vinden • meestal omdat er nog geen actieve sessie is. Gebruik | default(0) of | default('') zoals in het voorbeeld.
Meerdere laadstations
Het response is een array. Vervang chargers[0] door chargers[1], of filter op slug met chargers | selectattr('slug', 'eq', 'mijn-laadstation') | first.
Rate limiting
Houd scan_interval op 300 s of meer voor /chargers en op 600 s of meer voor /sessions en /energy. Sneller pollen geeft je niet meer data • Joulo synct elke 15 min vanaf de upstream-provider.
Gerelateerde pagina's
Joulo voor developers
Overzicht van alle tools, API's en integraties.
OCPP-koppeling
Verbind elke OCPP 1.6J-laadstation met Joulo.
OCPP API
OCPP WebSocket-integratie en configuratie.
Platform status
Realtime status van alle Joulo-diensten.
Developer Docs
Quickstart, authenticatie, guides en REST API-referentie.
status.joulo.nl
Realtime status van alle Joulo-diensten.
Klaar om te starten?
Maak een gratis account aan en verbind je laadstation. Je API-token vind je direct in het dashboard.