SFTP: Nominierungsdateiformate

Ein BKV-Export enthält Energienominierungen von Otark 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
Balance Group	Ein virtuelles Energiekonto, für das der BKV verantwortlich ist.
Customer	Ein Stromkäufer oder -verkäufer auf Otark. Jeder Customer wird vom BKV einer Balance Group zugeordnet.
PPA	Ein Stromliefervertrag zwischen zwei Customers.
Time slot	Ein 15-Minuten-Abschnitt eines Tages, nummeriert 1–96 an normalen Tagen. An Tagen mit Sommerzeitumstellung (Vorstellung) entfallen die Slots 9–12 (92 Slots insgesamt). An Tagen mit Winterzeitumstellung (Rückstellung) werden die Slots 9–12 wiederholt als `9a`, `10a`, `11a`, `12a`, `9b`, `10b`, `11b`, `12b` (100 Slots insgesamt).
Transaction	Strom, der zwischen zwei Customers über Otark geliefert werden soll, in einem Time slot.
Nomination	Saldierte Leistung, die zwischen der Balance Group des BKV und der Balance Group von Otark geliefert werden soll, in einem Time slot. Dies ist ein Aggregat über alle Transactions der Balance Group, die über Otark 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 Nomination/Transaction wird durch drei Spalten dargestellt: SALDO/IN/OUT, wobei SALDO = IN - OUT
IN bezeichnet den Leistungsfluss in die Balance Group des BKV, OUT den Fluss heraus
Übertragungsnetzbetreiber (TSOs) werden mit folgenden Abkürzungen bezeichnet:
- 50H: 50Hertz
- TEN: TenneT
- AMP: Amprion
- TRA: TransnetBW

Beispieldateien finden Sie auf der Seite Beispielexporte.

CSV-Export

Der CSV-Export enthält Nominierungen pro Balance Group (Saldo, Eingang und Ausgang).

Format

Feldtrenner: Komma (,)
Kopfzeile als erste Zeile
Eine Zeile pro Time slot

Spalten

Column	Beschreibung
`#`	Time-slot-Kennung. Numerisch an normalen Tagen (1–96). An Tagen mit Winterzeitumstellung verwenden die wiederholten Slots String-Suffixe: `9a`…`12a`, `9b`…`12b`
`datetime_iso8601_from`	Slot-Beginn im ISO-8601-Format mit UTC-Offset
`datetime_iso8601_to`	Slot-Ende im ISO-8601-Format mit UTC-Offset
`datetime_utc_from`	Slot-Beginn in UTC (`DD.MM.YYYY HH:MM:SS`)
`datetime_utc_to`	Slot-Ende in UTC (`DD.MM.YYYY HH:MM:SS`)
`datetime_local_from`	Slot-Beginn in Lokalzeit (`DD.MM.YYYY HH:MM`)
`datetime_local_to`	Slot-Ende 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 jede Balance Group wiederholt:

Column pattern	Beschreibung
`{TSO}_{BG_EIC}`	Nomination (Saldo)
`{TSO}_{BG_EIC}_IN`	Eingehende Nomination
`{TSO}_{BG_EIC}_OUT`	Ausgehende Nomination

Dabei ist {TSO} die TSO-Abkürzung (z.B. 50H, AMP) und {BG_EIC} die EIC-Kennung der Balance Group.

Excel-Export

Der Excel-Export enthält drei Tabellenblätter mit detaillierten Nominations- und Transaktionsdaten.

Sheet 1: PPAs

Listet alle aktiven PPAs auf, die über die vom BKV verwalteten Balance Groups laufen. Ein PPA erscheint einmal pro beteiligtem Customer. 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).

Column	Beschreibung
PPA	PPA-Kennung (z.B. `PPA #ext_ppa_001`)
Period	Kurzbezeichnung des Vertragszeitraums (z.B. `2025-2026`)
Delivery Start	Startdatum der Stromlieferung
Delivery End	Enddatum der Stromlieferung
Nominal Power (MW)	Vertraglich vereinbartes Nennleistungs-Liefervolumen
Type	PPA-Typ (z.B. `pay-as-indexed`)
Index	Energieindex (Lieferprofil)
Name	Name des Customers
Role	Rolle des Customers (`Seller` oder `Buyer`)

Sheet 2: Transactions

Das Hauptdatenblatt mit einer Zeile pro Time slot. Es ist in eine linke Seite (Nominations) und eine rechte Seite (Transactions) unterteilt. Beachten Sie, dass einige Spalten standardmäßig ausgeblendet sind und ggf. eingeblendet werden müssen. Zeilenspalten (alle Zeilen):

Column	Beschreibung
#	Time-slot-Nummer
Period	Lesbarer Zeitbereich (z.B. `00:00 - 00:15`)
Datetime From	Slot-Beginn (`YYYY-MM-DD HH:MM`)
Datetime To	Slot-Ende (`YYYY-MM-DD HH:MM`)

Linke Seite — Nominations: Für jede der folgenden Gruppen werden drei Spalten bereitgestellt: SALDO, IN und OUT.

Column group	Beschreibung
All nominations	Summe aller Nominations über alle Balance Groups
`{BG_EIC} ({TSO})`	Nomination für eine bestimmte Balance Group (wiederholt pro Balance Group)

Rechte Seite — Transactions: Für jede der folgenden Gruppen werden drei Spalten bereitgestellt: SALDO, IN und OUT.

Column group	Beschreibung
All transactions	Summe aller Transaktionstypen (Spot + PPAs)
Green SPOT — Day ahead	Day-Ahead-Spotmarkt-Transaktionen (für zukünftige Nutzung reserviert)
Green SPOT — Intraday	Intraday-Spotmarkt-Transaktionen (für zukünftige Nutzung reserviert)
1-Click-PPAs — Total	Summe aller 1-Click-PPA-Transaktionen
`PPA #{id}` — `{BG_ID} ({TSO})`	Einzelne PPA-Transaktionen pro Balance Group (wiederholt pro PPA)

Die SALDO- und TOTAL-Spalten verwenden Excel-Formeln (z.B. =IN - OUT bzw. =A1+B1+C1+...), enthalten aber auch vorberechnete Anzeigewerte, die direkt gelesen werden können.

Die letzte Zeile enthält Summen mit SUM-Formeln über alle Time slots.

Sheet 3: Metadata

Enthält Informationen zum Export.

Field	Erklärung
Export range	immer `Day`
Delivery Day	Datum im ISO-8601-Format: `2025-03-30`
Resolution	Time-slot-Granularität, 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. `2025-12-22 15:54:55`)
Counterparty	Gegenpartei der Nominations (Otark)
Phone	BKV-Hotline von Otark
E-Mail	BKV-Support-E-Mail von Otark
Operating Areas	TSOs, in denen Otark tätig ist
Counterparty EIC	immer `11Y0-0000-3333-F`
Exported by	immer `Otark Schedule System`
Exported	Zeitstempel der Export-Erstellung

BKV Connect

SFTP

Webhooks

BKV-API

Contracts

Transactions

Nominations

Customers

SFTP: Nominierungsdateiformate

Konzepte und Konventionen

CSV-Export

Format

Spalten

Excel-Export

Sheet 1: PPAs

Sheet 2: Transactions

Sheet 3: Metadata

​Konzepte und Konventionen

​CSV-Export

​Format

​Spalten

​Excel-Export

​Sheet 1: PPAs

​Sheet 2: Transactions

​Sheet 3: Metadata

Konzepte und Konventionen

CSV-Export

Format

Spalten

Excel-Export

Sheet 1: PPAs

Sheet 2: Transactions

Sheet 3: Metadata