Nominierungsdateien
CSV- und Excel-Format der BKV-Nominierungsexporte, mit Beispieldateien zum Herunterladen.
Ein BKV-Export enthält Energienominierungen von OES für einen einzelnen Liefertag (in der Zeitzone Europe/Berlin) und umfasst Daten für alle Bilanzkreise, die der BKV durch Angabe eines TSO aktiviert hat.
Konzepte und Konventionen
| Begriff | Beschreibung |
|---|---|
| Bilanzkreis | Ein virtuelles Energiekonto, für das der BKV verantwortlich ist. |
| Kunde | Ein Stromkäufer oder -verkäufer auf Otark. Jeden Kunden ordnet der BKV einem Bilanzkreis zu. |
| PPA | Ein Stromliefervertrag zwischen zwei Kunden. |
| Zeitscheibe | Ein 15-Minuten-Abschnitt eines Tages, nummeriert 1–96 an normalen Tagen. An Tagen mit Sommerzeitumstellung entfallen die Zeitscheiben 9–12 (92 Zeitscheiben insgesamt). An Tagen mit Winterzeitumstellung werden die Zeitscheiben 9–12 wiederholt als 9a, 10a, 11a, 12a, 9b, 10b, 11b, 12b (100 Zeitscheiben insgesamt). |
| Transaktion | Strom, der in einer Zeitscheibe über den Clearing-Bilanzkreis von OES geliefert werden soll: aus einem 1-Click-PPA-Einzelvertrag zwischen zwei Kunden oder aus einem Green-SPOT-Geschäft mit OTARK-CLEARING als Gegenseite. |
| Nominierung | Saldierte Leistung, die zwischen dem Bilanzkreis des BKV und dem Bilanzkreis von OES geliefert werden soll, in einer Zeitscheibe. Dies ist ein Aggregat über alle Transaktionen des Bilanzkreises, die über OES abgewickelt werden. |
Einheiten und Konventionen:
- Alle Leistungswerte sind in MW angegeben. Für MWh (Energie) pro Viertelstunde muss durch 4 geteilt werden.
- Lokale Zeiten sind in
Europe/Berlin(MEZ/MESZ), sofern nicht anders angegeben - Jede Nominierung und jede Transaktion wird durch drei Spalten dargestellt:
SALDO/IN/OUT, wobeiSALDO = IN - OUT INbezeichnet den Leistungsfluss in den Bilanzkreis des BKV,OUTden Fluss heraus- Übertragungsnetzbetreiber (TSOs) werden mit folgenden Abkürzungen bezeichnet:
50H: 50HertzTEN: TenneTAMP: AmprionTRA: TransnetBW
Das Beispielszenario
Die Beispieldateien dieses Abschnitts beschreiben durchgehend dasselbe Szenario. Vier Kunden sind auf Otark aktiv:
- Seller A (EIC:
11Y0-0000-0000-A, TSO: TenneT) - Seller B (EIC:
11Y0-0000-0000-B, TSO: Amprion) - Buyer X (EIC:
11Y0-0000-0000-X, TSO: TransnetBW) - Buyer Y (EIC:
11Y0-0000-0000-Y, TSO: Amprion)
Zwei PPAs sind aktiv:
| PPA | Verkäufer | Käufer | Nennleistung | Index |
|---|---|---|---|---|
| A → X | Seller A | Buyer X | 5 MW | ENWEX Solar DE |
| A → Y | Seller A | Buyer Y | 10 MW | ENWEX Wind DE |
Jeder Kunde hat in diesem Szenario einen anderen BKV, und jeder BKV erhält eine eigene Exportdatei. Für den Liefertag 2026-03-02 stehen die Exporte weiter unten zum Herunterladen — bei jedem Format vier Dateien, eine je BKV-Perspektive.
CSV-Export
Der CSV-Export enthält Nominierungen pro Bilanzkreis (Saldo, Eingang und Ausgang).
Format
- Feldtrenner: Komma (
,) — die Lastgangdateien verwenden dagegen das Semikolon - Dezimaltrenner: Punkt (
.); Werte stehen nicht in Anführungszeichen - Zeichenkodierung: UTF-8, ohne BOM
- Zeilenenden: CRLF
- Kopfzeile als erste Zeile
- Eine Zeile pro Zeitscheibe
Spalten
| Spalte | Beschreibung |
|---|---|
# | Kennung der Zeitscheibe. Numerisch an normalen Tagen (1–96). An Tagen mit Winterzeitumstellung tragen die wiederholten Zeitscheiben String-Suffixe: 9a...12a, 9b...12b |
datetime_iso8601_from | Beginn der Zeitscheibe im ISO-8601-Format mit UTC-Offset |
datetime_iso8601_to | Ende der Zeitscheibe im ISO-8601-Format mit UTC-Offset |
datetime_utc_from | Beginn der Zeitscheibe in UTC (DD.MM.YYYY HH:MM:SS) |
datetime_utc_to | Ende der Zeitscheibe in UTC (DD.MM.YYYY HH:MM:SS) |
datetime_local_from | Beginn der Zeitscheibe in Lokalzeit (DD.MM.YYYY HH:MM) |
datetime_local_to | Ende der Zeitscheibe in Lokalzeit (DD.MM.YYYY HH:MM) |
An Tagen mit Winterzeitumstellung sind die datetime_local-Spalten während der wiederholten Stunde (02:00–03:00 erscheint zweimal) mehrdeutig. Verwenden Sie das Suffix der #-Spalte (a vs b) oder die datetime_iso8601-Spalten (die den UTC-Offset enthalten: +02:00 für MESZ, +01:00 für MEZ), um zwischen den beiden Vorkommen zu unterscheiden.
Nach den Zeitstempel-Spalten werden drei Spalten für jeden Bilanzkreis wiederholt:
| Spaltenmuster | Beschreibung |
|---|---|
{TSO}_{BG_EIC} | Nominierung (Saldo) |
{TSO}_{BG_EIC}_IN | Eingehende Nominierung |
{TSO}_{BG_EIC}_OUT | Ausgehende Nominierung |
Dabei ist {TSO} die TSO-Abkürzung (z.B. 50H, AMP) und {BG_EIC} die EIC-Kennung des Bilanzkreises.
Beispieldateien
| BKV für | Beschreibung | Datei |
|---|---|---|
| Seller A | Enthält beide PPAs (A→X und A→Y) aus Verkäuferperspektive | seller-a-2026-03-02.csv |
| Seller B | Leer — Seller B hat keine aktiven PPAs | seller-b-2026-03-02.csv |
| Buyer X | Enthält das PPA A→X aus Käuferperspektive | buyer-x-2026-03-02.csv |
| Buyer Y | Enthält das PPA A→Y aus Käuferperspektive | buyer-y-2026-03-02.csv |
Excel-Export
Der Excel-Export enthält drei Tabellenblätter mit detaillierten Nominierungs- und Transaktionsdaten.
Sheet 1: PPAs
Listet alle aktiven PPAs auf, die über die vom BKV verwalteten Bilanzkreise laufen. Ein PPA erscheint einmal pro beteiligtem Kunden. Wenn beide Seiten eines PPA vom selben BKV verwaltet werden, hat das PPA zwei Zeilen (eine für den Verkäufer, eine für den Käufer).
| Spalte | Beschreibung |
|---|---|
| PPA | PPA-Kennung, die Vertragsnummer des Einzelvertrags (z.B. PPA #4M8XA) |
| Period | Kurzbezeichnung des Vertragszeitraums, ein Kalenderquartal oder Kalenderjahr (z.B. Q1-2026 oder 2026) |
| Delivery Start | Startdatum der Stromlieferung |
| Delivery End | Enddatum der Stromlieferung |
| Nominal Power (MW) | Vertraglich vereinbarte Leistung |
| Type | PPA-Typ (z.B. pay-as-indexed) |
| Index | Energieindex (Lieferprofil) |
| Name | Name des Kunden |
| Role | Rolle des Kunden (Seller oder Buyer) |
Sheet 2: Transactions
Das Hauptdatenblatt mit einer Zeile pro Zeitscheibe. Es ist in eine linke Seite (Nominierungen) und eine rechte Seite (Transaktionen) unterteilt. Einige Spalten sind standardmäßig ausgeblendet und müssen bei Bedarf eingeblendet werden.
Zeilenspalten (alle Zeilen):
| Spalte | Beschreibung |
|---|---|
| # | Nummer der Zeitscheibe |
| Period | Lesbarer Zeitbereich (z.B. 00:00 - 00:15) |
| Datetime From | Beginn der Zeitscheibe in Lokalzeit Europe/Berlin (YYYY-MM-DD HH:MM). An Tagen mit Winterzeitumstellung ist der Wert während der wiederholten Stunde mehrdeutig — maßgeblich ist dann die Nummer der Zeitscheibe in der Spalte # |
| Datetime To | Ende der Zeitscheibe (YYYY-MM-DD HH:MM) |
Linke Seite — Nominierungen:
Für jede der folgenden Gruppen werden drei Spalten bereitgestellt: SALDO, IN und OUT.
| Spaltengruppe | Beschreibung |
|---|---|
| All nominations | Summe aller Nominierungen über alle Bilanzkreise |
{BG_EIC} ({TSO}) | Nominierung für einen bestimmten Bilanzkreis (wiederholt je Bilanzkreis) |
Rechte Seite — Transaktionen:
Für jede der folgenden Gruppen werden drei Spalten bereitgestellt: SALDO, IN und OUT.
| Spaltengruppe | Beschreibung |
|---|---|
| All transactions | Summe aller Transaktionen aus Green SPOT und 1-Click PPA |
| Green SPOT — Day ahead | Day-ahead-Transaktionen aus Green SPOT — sie tragen keine Vertragsnummer, sondern erscheinen als eigene Spaltengruppe |
| Green SPOT — Intraday | Intraday-Transaktionen aus Green Intraday, ebenfalls ohne Vertragsnummer |
| 1-Click-PPAs — Total | Summe aller 1-Click-PPA-Transaktionen |
PPA #{id} — {BG_ID} ({TSO}) | Einzelne PPA-Transaktionen je Bilanzkreis (wiederholt je PPA) |
Nach jedem Intraday-Abschluss stellt OES eine neue Version der Nominierung bereit, in Portal, API und Dateien: als neue Datei unter nominations/archive/, und die Datei unter nominations/current/ zeigt den neuen Stand. Der BKV meldet die neue Version bis zur untertägigen Gate Closure des Fahrplanmanagements beim Übertragungsnetzbetreiber an (Green Intraday).
Die SALDO-Spalte verwendet eine Excel-Formel wie =IN - OUT, die TOTAL-Spalte eine wie =A1+B1+C1+....
Beide enthalten zusätzlich den vorberechneten Wert, der sich direkt auslesen lässt.
Die letzte Zeile enthält Summen mit SUM-Formeln über alle Zeitscheiben.
Sheet 3: Metadata
Enthält Informationen zum Export.
| Feld | Erklärung |
|---|---|
| Export range | immer Day |
| Delivery Day | Datum im ISO-8601-Format: 2026-03-02 |
| Resolution | Granularität der Zeitscheiben, immer 15 Minutes |
| Time Zone | Zeitzone für Zeitstempel, immer Europe/Berlin |
| Version | Version dieses Exports, bei Korrekturen |
| Last Update | Zeitpunkt der letzten Datenänderung (z.B. 2026-03-01 15:54:55) |
| Counterparty | Gegenpartei der Nominierungen (OES) |
| Phone | BKV-Hotline von OES |
| BKV-Support-E-Mail von OES | |
| Operating Areas | Regelzonen, in denen OES einen Bilanzkreis führt |
| Counterparty EIC | immer 11Y0-0000-3333-F |
| Exported by | immer Otark Schedule System |
| Exported | Zeitstempel der Export-Erstellung |
Beispieldateien
| BKV für | Beschreibung | Datei |
|---|---|---|
| Seller A | Enthält beide PPAs (A→X und A→Y) aus Verkäuferperspektive | seller-a-2026-03-02.xlsx |
| Seller B | Leer — Seller B hat keine aktiven PPAs | seller-b-2026-03-02.xlsx |
| Buyer X | Enthält das PPA A→X aus Käuferperspektive | buyer-x-2026-03-02.xlsx |
| Buyer Y | Enthält das PPA A→Y aus Käuferperspektive | buyer-y-2026-03-02.xlsx |
Lastgangdateien CSV
CSV-Format für den Upload von Zählerdaten auf Otark
Übersicht
REST-API zur Entdeckung von Anlagen für grüne Energie auf der Otark-Plattform
Zuletzt aktualisiert am