Meterbeheer biedt een toegankelijk API om meters toe te voegen en de meetdata op te halen. De Engelstalige documentatie is beschikbaar na het inloggen op het dashboard.
De basis API is onderdeel van de standaard diensten van Meterbeheer. Stamsgegevens en storingscodes van kleinverbruik aansluitingen worden weergegeven in het dashboard.
Via het API+ abonnement zijn deze gegevens ook beschikbaar via de API. De gegevens worden per aansluiting in de JSON van de betreffende aansluiting opgenomen.
Demofeed #
De API bevat een demofeed met fictieve meetdata. Deze feed wordt elke 24 uur bijgewerkt, net als een echte feed.
Het meetgegevensveld van de testfeed bevat waarden die helpen te zien wanneer de feed is gegenereerd. Dit wordt gedaan om gemakkelijk tests met de data uit te voeren. Deze logica geldt alleen voor de testfeed. Echte feeds bevatten de werkelijke waarden zonder enige logica.
De eerste decimaal van alle waarden vertegenwoordigt de dag van de week, volgens deze tabel:
| Maandag | 1 |
| Dinsdag | 2 |
| Woensdag | 3 |
| Donderdag | 4 |
| Vrijdag | 5 |
| Zaterdag | 6 |
| Zondag | 7 |
Er is meer logica in de demo-feed: het laatste deel van de decimalen kan worden gezien als een teller die begint met 1 (het eerste blok van 15 minuten van de feed) en eindigt met 96 (het laatste blok van 15 minuten van de feed), aangezien er 96 blokken van 15 minuten zijn in een volle dag (24 * 4).
De decimale waarden van de testfeed zijn willekeurig en bevatten geen logica.
Voorbeelden:
- Een waarde van 385,101 staat voor een maandagfeed en is de eerste waarde van die feed;
- Een waarde van 10,411 vertegenwoordigt een donderdagfeed en is de elfde waarde van die feed;
- Een waarde van 376,696 staat voor een zaterdagfeed en is de 96e (en laatste) waarde van die feed.
API+ abonnement – Stamsgegevens en storingscodes #
- EAN
- Channel
- Eenheid (kWh of m3)
- Start periode
- Eind periode
Bij een API+ abonnement worden de volgens gegevens aan de JSON URL toevoegen:
- Type aansluiting (kleinverbruik of grootverbruik)
- Netbeheerder
- Datum plaatsing huidige meter
- Startdatum mandaat (gelijk aan de beschikbaarheid historische data)
- Einddatum mandaat
Storingscodes EDSN #
Indien een EDSN aansluiting geen meetdata ontvangt geeft de EDSN een storingscode. De code wordt getoond in het dashboard van Meterbeheer. Indien het API+ abonnement is geactiveerd wordt de storingscode ook weergegeven in de JSON-URL bij het betreffende data-interval.
| Foutcodes vanuit de EDSN | Omschrijving | Actie door | Toelichting |
| 006 | De EAN-aansluiting is onbekend. | Klant | De juiste combinatie EAN, postcode & huisnummer dient te worden ingevoerd. |
| 007 | Geen slimme meter op de EAN-aansluiting aanwezig. | Eigenaar aansluiting | Slimme meter aanvragen bij de netbeheerder. |
| 008 | De verzoekende partij is niet geautoriseerd. | Klant | Het mandaat voor dit EAN met de juiste datum toevoegen. |
| 009 | Geen meetdata beschikbaar. De Slimme meter zit in de deployment fase. | Eigenaar aansluiting / netbeheerder | De slimme meter diente worden geactiveerd door de netbeheerder. |
| 010 | De datum voor de gevraagde data ligt in de toekomst. | Klant | De datum van de aanvraag aanpassen. |
| 011 | De datum van de gevraagde data is te oud. Meterstanden niet meer beschikbaar. | Klant | De datum van de aanvraag aanpassen. |
| 012 | Gevraagde meetdata niet beschikbaar, meter tijdelijk in storing | Netbeheerder | De netbeheerder dient de storing te verhelpen. |
| 013 | Dit specifieke verzoek kan niet worden uitgevoerd door de meter. | Klant | Instructies aanpassen. |
| 014 | Gevraagd meetdata niet beschikbaar: storing is bekend en in behandeling. | Netbeheerder | De netbeheerder dient de storing te verhelpen. |
| 038 | De slimme meter staat administratief uit. | Eigenaar aansluiting | De eigenaar van de aansluiting dient akkoord te geven bij de netbeheerder om de meetdata op afstand uit te lezen. |
| 039 | Er hangt een technisch niet op afstand uitleesbare slimme meter | Eigenaar aansluiting | De slimme meter dient te worden vervangen. |
| 040 | De aanvragende partij is niet (meer) gemandateerd omdat de autorisatie is beëindigd n.a.v. een wijziging van contractant op de aansluiting. | Klant | Er is een nieuwe contractpartij waardoor de meter dient worden verwijderd en opnieuw dient te worden aangemeld. |
| 041 | Gevraagde meetdata niet beschikbaar: grootschalige storing. | Netbeheerder | Netbeheerder dient de storing te verhelpen. |
Prijzen #
De kosten van een aanvullend API+ abonnement zijn als volgt:
| Aantal aansluitingen | Kosten per maand |
| Tot 100 aansluitingen | € 49,- |
| 101 – 1.000 aansluitingen | € 89,- |
| 1.000 – 5.000 aansluitingen | € 249,- |
| 5.000 – 10.000 aansluitingen | € 349,- |
| meer dan 10.000 aansluitingen | Neem contact met ons op voor een offerte. |
Alle genoemde prijzen zijn exclusief btw.