Joulz

API-key en subcode uit het e-Dataportal van Joulz.

Joulz is een commerciële meetdienst voor grootverbruikaansluitingen in Nederland.

API-key

Joulz controleert de toegang met een API-key. Die maak je aan in het e-Dataportal van Joulz, en die hoort bij het IP-adres van de server die de meetdata ophaalt: de server van Meterbeheer. Het juiste IP-adres staat hieronder.

Per e-Dataportal maak je maar één keer een API-key aan, ook als Meterbeheer er meerdere meters mee uitleest.

Subcode

Naast het (openbare) EAN van een aansluiting gebruikt Joulz een subcode als extra controle. De subcode is uniek per aansluiting en staat in het e-Dataportal bij de aansluiting. Zoek voor elke aansluiting die Meterbeheer moet uitlezen de subcode op.

Inloggen op het e-Dataportal

Stap 1. Ga naar het e-Dataportal via joulz.nl.

Het e-Dataportal op joulz.nl

Stap 2. Log in.

Het inlogscherm van het e-Dataportal

De API-key aanmaken

Stap 3. Klik linksboven op het persoonicoon.

Het persoonicoon in het e-Dataportal

Stap 4. Klik op het zwarte tandwiel.

Het tandwiel in het e-Dataportal

Stap 5. Vul het IP-adres van de server van Meterbeheer in: 116.203.112.240, en klik op Maak API Key.

Vul precies dit IP-adres in. Joulz toont de API-key maar één keer: bewaar hem op een veilige plek.

De subcode opzoeken

Stap 6. Open de pagina Aansluitingen in het e-Dataportal.

De pagina Aansluitingen in het e-Dataportal

Stap 7. Klik op het gemarkeerde icoon om de subcode van een aansluiting te tonen.

Het icoon dat de subcode toont

De subcode van een aansluiting

Channels

Elektriciteit

  • consumption: verbruik per kwartier (kWh)
  • production: teruglevering per kwartier (kWh)

Gas

  • consumption: verbruik per uur (m3)

Historische data

Bij het toevoegen haalt Meterbeheer de data van ruim 2,5 jaar terug op, voor zover Joulz die heeft. Ontbreekt er data in de feed? Neem dan contact op met Joulz via klantenservice@joulz.nl.

Foutmeldingen

Kan Meterbeheer geen data ophalen, dan geeft Joulz een foutmelding. Die staat in het dashboard van Meterbeheer op de pagina van de meter, en met API+ ook in de feed van de aansluiting.