Lastgangdateien
CSV-Format für den Upload von Zählerdaten auf Otark
Lastgangdaten werden je Messstelle hochgeladen und einer Anlage zugeordnet; sie erscheinen anschließend auf der Detailseite der Anlage und lassen sich dort einsehen und vergleichen.
Für den Upload gibt es zwei Wege, beide im hier beschriebenen Format: den Messdaten-Upload in der Plattform unter Einstellungen → Integrationen & Apps → Messstellen und den CSV-Import der Metering API, die für das Konto freigeschaltet sein muss.
Allgemeine Anforderungen
- Ein Zähler pro Datei: Jede CSV-Datei enthält die Daten genau eines Zählers. Daten mehrerer Zähler in einer Datei werden nicht eingelesen. Die Datei selbst nennt den Zähler nicht: Beim Upload in der Plattform wählen Sie die Messstelle aus, beim CSV-Import der Metering API steht ihre Kennung im Pfad des Aufrufs.
- Jede Zeile muss ein 15-Minuten-Messintervall darstellen.
- Die erste Zeile der Datei muss eine Kopfzeile mit den Spaltennamen sein.
- Feldtrenner: Semikolon (
;). - Zeichenkodierung: Wird automatisch erkannt (verwenden Sie UTF-8 im Zweifelsfall).
Feldspezifikation
Die folgende Tabelle definiert die erlaubten und erforderlichen Felder.
| Feldname | Pflicht | Typ | Beschreibung | Beispiele |
|---|---|---|---|---|
| date | ja | String | Datum des Intervallbeginns in UTC (DD.MM.YYYY). | 01.02.2024 |
| time | ja | String | Uhrzeit des Intervallbeginns in UTC (HH:MM) — nicht des Intervallendes und nicht in Ortszeit. | 23:30 |
| unit | ja | String | Einheit der Messung. Erlaubte Werte: W, kW, Wh, kWh. Leistungsangaben (W, kW) gelten als Mittelwert über das 15-Minuten-Intervall, nicht als Momentanwert; die Plattform rechnet sie durch Division durch 4 in Energie um. Gespeichert und über die Metering API ausgegeben wird in kWh. | |
| value | ja | Dezimalzahl | Messwert, Dezimaltrenner ist der Punkt. Ganze Zahlen sind zulässig. | 968900 |
| direction | optional | String | Energieflussrichtung: • P — Erzeugung • C — Verbrauch Wenn leer, wird die Konfiguration des Zählers verwendet. Dieses Feld ist erforderlich, wenn der Zähler für beide Richtungen konfiguriert ist. | P |
| quality | optional | String | Zur Angabe der Datenqualität: • U — uploaded (Standard, für normale Messungen) • F — forecast (für Daten in der Zukunft) • E — estimated (für geschätzte Daten in der Vergangenheit) | U |
Beispieldatei
date;time;value;unit;direction
01.02.2025;00:00;8.5;kWh;C
01.02.2025;00:15;16;kWh;C
01.02.2025;00:30;32;kWh;C
01.02.2025;00:45;64;kW;CDie letzte Zeile zeigt die Umrechnung einer Leistungsangabe: 64 kW als Mittelwert der Viertelstunde ergeben 64 ÷ 4 = 16 kWh.
Fehlerhafte Dateien
Eine Datei wird vollständig importiert oder gar nicht. Enthält eine Zeile einen unzulässigen Wert, schreibt die Plattform keine einzige Zeile der Datei. Beim Import über die Metering API steht der Import danach im Status failed, und die Antwort nennt je Fehler die Zeilennummer, den Fehlercode und eine Beschreibung; beim Upload in der Plattform erscheint dieselbe Angabe in der Oberfläche. Korrigieren Sie die Datei und laden Sie sie erneut hoch.
Authentifizierung
Der API-Schlüssel im Header X-Api-Key — plattformweit für alle neun APIs, mit den zwei Abweichungen bei BRP Connect und GCR Connect
Nominierungsdateien CSV/XLSX
CSV- und Excel-Format der BKV-Nominierungsexporte, mit Beispieldateien zum Herunterladen.
Zuletzt aktualisiert am