Consumption Data
Übermittelt Verbrauchsdaten im Rahmen des Services EcoTrend API
Diese Schnittstelle dient der Übertragung von Verbrauchsdaten auf Nutzeinheitenebene zur Visualisierung der unterjährigen Verbrauchsinformation (kurz uVI) in Partnersystemen.
- Uns bekannte Nutzeinheiten und deren Status können vorab abgefragt werden.
- Die Schnittstelle übermittelt auf Ebende der Nutzeinheit und Zeitraum folgende Werte:
- Verbrauch des abgefragten Monats in KWH
- Verbrauch des Vorjahresmonats in KWH
- Benchmark für den abgefragten Monats
- Angabe über mögliche Schätzwerte
Hinweise:
Die Schnittstelle übermittelt lediglich Verbrauchswerte. Welchem Empfänger die uVI zugestellt wird, wird im Partnersystem zugewiesen.
Die Monatswerte sind ab dem 08. Des Folgemonats abrufbar. Das beste Ergebnis der Benchmarks erhält man nach dem 18. Eines Monats.
Quelle: https://bved.info
Consumption Data (uVI) Beispiel-Szenario
Übermittelt Verbrauchsdaten im Rahmen des Services EcoTrend API
Verarbeitungshindernisse
- Die API erfordert eine Authentifizierung per OAuth 2.
- Falls die Authentifizierung fehlschlägt, wird die Anfrage mit 401 Unauthorized abgelehnt.
- Der Zugriff auf Abrechnungsdaten ist nur für autorisierte Benutzer möglich.
- Falls der Benutzer keine Berechtigung für die angeforderte Abrechnungseinheit besitzt, wird die Anfrage mit 403 Forbidden abgelehnt.
- Die API setzt voraus, dass eine vertragliche Vereinbarung zwischen Property Manager (PM) und Messdienstleister (MSC) besteht.
- Die Nummer der Abrechnungseinheit (billingunit) muss ein gültiges Format haben.
- Die Nutzeinheit (residentialunit) muss existieren und für den Datenaustausch geeignet sein.