Home Assistant × Joulo

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.

REST
Bearer token
JSON
Geen add-on nodig

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
# 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
# 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.

ui-lovelace.yaml
# 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
# 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.

Klaar om te starten?

Maak een gratis account aan en verbind je laadstation. Je API-token vind je direct in het dashboard.