# Lastgangdateien (https://docs.otark.com/de/developer/metering-files)

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](https://docs.otark.com/de/developer/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](https://docs.otark.com/de/developer/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](https://docs.otark.com/de/developer/metering-api) ausgegeben wird in kWh. |              |
| **value**     | ja       | Dezimalzahl | Messwert, Dezimaltrenner ist der Punkt. Ganze Zahlen sind zulässig.                                                                                                                                                                                                                                                                            | `968900`     |
| **direction** | optional | String      | Energieflussrichtung: <br />• `P` — Erzeugung <br />• `C` — Verbrauch <br />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: <br />• `U` — uploaded (Standard, für normale Messungen) <br />• `F` — forecast (für Daten in der Zukunft) <br />• `E` — estimated (für geschätzte Daten in der Vergangenheit)                                                                                                                                   | `U`          |

***

## Beispieldatei

```csv
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;C
```

Die 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](https://docs.otark.com/de/developer/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.
