# Nominierungsdateien (https://docs.otark.com/de/developer/nomination-files)

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`, wobei `SALDO = IN - OUT`
* `IN` bezeichnet den Leistungsfluss in den Bilanzkreis des BKV, `OUT` den Fluss heraus
* Übertragungsnetzbetreiber (TSOs) werden mit folgenden Abkürzungen bezeichnet:
  * `50H`: 50Hertz
  * `TEN`: TenneT
  * `AMP`: Amprion
  * `TRA`: 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](https://docs.otark.com/de/developer/metering-files) 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`)                                                                                                                         |

<Callout type="info">
  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.
</Callout>

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 | <a href="https://static.otark.com/files/brp-example/seller-a-2026-03-02.csv" download>seller-a-2026-03-02.csv</a> |
| Seller B | Leer — Seller B hat keine aktiven PPAs                    | <a href="https://static.otark.com/files/brp-example/seller-b-2026-03-02.csv" download>seller-b-2026-03-02.csv</a> |
| Buyer X  | Enthält das PPA A→X aus Käuferperspektive                 | <a href="https://static.otark.com/files/brp-example/buyer-x-2026-03-02.csv" download>buyer-x-2026-03-02.csv</a>   |
| Buyer Y  | Enthält das PPA A→Y aus Käuferperspektive                 | <a href="https://static.otark.com/files/brp-example/buyer-y-2026-03-02.csv" download>buyer-y-2026-03-02.csv</a>   |

***

## 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](https://docs.otark.com/de/green-spot) — sie tragen keine Vertragsnummer, sondern erscheinen als eigene Spaltengruppe |
| Green SPOT — Intraday               | Intraday-Transaktionen aus [Green Intraday](https://docs.otark.com/de/green-spot/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](https://docs.otark.com/de/green-spot/green-intraday)).

<Callout type="info">
  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.
</Callout>

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                                              |
| E-Mail           | 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 | <a href="https://static.otark.com/files/brp-example/seller-a-2026-03-02.xlsx" download>seller-a-2026-03-02.xlsx</a> |
| Seller B | Leer — Seller B hat keine aktiven PPAs                    | <a href="https://static.otark.com/files/brp-example/seller-b-2026-03-02.xlsx" download>seller-b-2026-03-02.xlsx</a> |
| Buyer X  | Enthält das PPA A→X aus Käuferperspektive                 | <a href="https://static.otark.com/files/brp-example/buyer-x-2026-03-02.xlsx" download>buyer-x-2026-03-02.xlsx</a>   |
| Buyer Y  | Enthält das PPA A→Y aus Käuferperspektive                 | <a href="https://static.otark.com/files/brp-example/buyer-y-2026-03-02.xlsx" download>buyer-y-2026-03-02.xlsx</a>   |
