# Tender API (https://docs.otark.com/de/developer/tender-api)

<Callout type="warn" title="Freischaltung erforderlich">
  Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den [Support](https://docs.otark.com/de/support).
</Callout>

Die Tender API bietet programmatischen Zugang zu PPA-Ausschreibungen, eine API für beide Seiten einer Ausschreibung. **Käufer** legen Ausschreibungen an, laden den Lastgang hoch und reichen zur Prüfung ein. Sie entscheiden über Zugangsanfragen, laden Verkäufer ein, setzen die Shortlist, bewerten indikative Angebote und nehmen sie an. **Verkäufer** lesen ihre [Tender Inbox](https://docs.otark.com/de/ppa-tender/tender-inbox), fragen Zugang an und reichen indikative Angebote ein. Den unterzeichneten PPA erfasst der Käufer oder der Verkäufer. Beide Seiten teilen sich den Nachrichtenkanal je Ausschreibung und den [Datenraum](https://docs.otark.com/de/ppa-tender/data-room).

## Basis-URL

```
https://api.otark.com/v1
```

Alle Anfragen müssen HTTPS verwenden. Antworten werden im JSON-Format zurückgegeben.

## Authentifizierung

Alle Anfragen müssen den `X-Api-Key`-Header enthalten:

```bash
curl -X GET "https://api.otark.com/v1/tenders" \
-H "X-Api-Key: IHR_API_KEY"
```

Wie die Authentifizierung plattformweit funktioniert und wo die Schlüssel der übrigen APIs entstehen, steht unter [Authentifizierung](https://docs.otark.com/de/developer/authentication).

API-Schlüssel werden in den Kontoeinstellungen auf app.otark.com erstellt und tragen Scopes. Fehlt einem Schlüssel der Scope einer Operation, antwortet die API mit `401` und dem Fehlercode `INSUFFICIENT_SCOPES`.

| Scope                                               | Berechtigung                                                                                                                                                                                                                      |
| --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `tenders:read`                                      | Ausschreibungen, Zugänge, Angebote und die Tender Inbox lesen                                                                                                                                                                     |
| `tenders:write`                                     | Käufer: Ausschreibungen anlegen, ändern, einreichen, zurücknehmen und schließen, den Lastgang hochladen, über Zugänge entscheiden, Verkäufer einladen, die Shortlist setzen, Angebote anfordern und ablehnen, Änderungen anfragen |
| `tenders:offer`                                     | Verkäufer: Zugang anfragen und zurückziehen, die Ausschreibung verlassen, indikative Angebote abgeben, überarbeiten und zurückziehen, den unterzeichneten PPA erfassen                                                            |
| `tenders:sign`                                      | Käufer: Angebote annehmen und den unterzeichneten PPA erfassen                                                                                                                                                                    |
| `chats:read`, `chats:write`                         | Den Nachrichtenkanal lesen und Nachrichten senden                                                                                                                                                                                 |
| `data-rooms:tender:read`, `data-rooms:tender:write` | Den Datenraum lesen und Dokumente hochladen                                                                                                                                                                                       |

## Konventionen

| Konvention             | Regel                                                                                                                                                                           |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Paginierung            | Listen nehmen `limit` (1–100, Vorgabe 10) und einen Cursor `after` entgegen; die Antwort führt `pagination` mit `has_more` und `next_cursor`                                    |
| Zeitstempel            | ISO 8601 in UTC (`2026-09-01T07:00:00Z`)                                                                                                                                        |
| Fristen und Liefertage | Kalendertage als `YYYY-MM-DD`. Eine Frist endet mit ihrem Tag nach Europe/Berlin, der Fristtag zählt noch voll                                                                  |
| Mengen und Preise      | Mengen in MWh (bis zu 3 Nachkommastellen), Preise in EUR/MWh (bis zu 4 Nachkommastellen)                                                                                        |
| Fehler                 | Problem Details nach RFC 9457 (`application/problem+json`); das Feld `error` trägt den Fehlercode der Plattform, etwa `TENDER_ADMISSION_DEADLINE_PASSED`                        |
| Ratenbegrenzung        | **300 Anfragen je 60-Sekunden-Fenster**, plattformweit gleich; die Antwort führt `X-RateLimit-Limit`, `-Remaining` und `-Reset` mit, bei Überschreitung `429 Too Many Requests` |

## Ressourcen

| Ressource                 | Zweck                                                                                                                                                    | Rolle     |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
| Ausschreibung             | Anlegen, Ändern, einen Entwurf löschen, den Lastgang hochladen, zur Prüfung einreichen, in den Entwurf zurücknehmen, schließen, abbrechen, wieder öffnen | Käufer    |
| Zugang                    | Über Zugangsanfragen entscheiden, den Zugang entziehen, Verkäufer einladen, Einladungen erneut senden und zurückziehen, die Shortlist setzen             | Käufer    |
| Angebote (Käufersicht)    | Einsehen mit Bewertung je Kriterium, Gesamtscore und Einstufung; Angebote anfordern, ablehnen, Änderungen anfragen und annehmen                          | Käufer    |
| Tender Inbox              | Ausschreibungen an alle Verkäufer und Einladungen, anonym bis zur Zulassung                                                                              | Verkäufer |
| Zugangsanfrage            | Anfragen, zurückziehen, die Ausschreibung verlassen                                                                                                      | Verkäufer |
| Indikatives Angebot       | Abgeben, überarbeiten und zurückziehen; eine neue Fassung ersetzt die alte                                                                               | Verkäufer |
| Unterzeichneter PPA       | Erfassen mit Bezug auf ein angenommenes Angebot                                                                                                          | beide     |
| Nachrichten und Datenraum | Nachrichtenkanal je zugelassenem Verkäufer, Datenraum je Verkäufer auf der Shortlist                                                                     | beide     |

## Regeln, die die API durchsetzt

* **Prüfung vor der ersten Veröffentlichung.** Jede Ausschreibung prüft die Otark GmbH vor ihrer ersten Veröffentlichung, in der Regel binnen 24 Stunden ab Einreichung, spätestens bis zum Ende des folgenden Werktags. Eine erneute Veröffentlichung braucht keine zweite Prüfung ([Empfängerkreis und Veröffentlichung](https://docs.otark.com/de/ppa-tender/publication)).
* **Die Frist für indikative Angebote ist ein Zieldatum.** Bis einschließlich ihres Tages können Verkäufer Zugang anfragen und der Käufer kann einladen, danach nicht mehr. Zugelassene Verkäufer können auch danach Angebote abgeben. Eine nach der Veröffentlichung abgelaufene Frist lässt sich nicht mehr ändern ([Zeitplan und Fristen](https://docs.otark.com/de/ppa-tender/timeline)).
* **Der Käufer bleibt bis zur Zulassung anonym**, gegenüber jedem Verkäufer, auch einem eingeladenen. Eine Einladung ist ein Hinweis: Der eingeladene Verkäufer fragt selbst Zugang an, und der Käufer entscheidet. Verkäufer sind gegenüber dem Käufer nie anonym ([Bewerbung, Einladung und Zulassung](https://docs.otark.com/de/ppa-tender/applying)).
* **Angenommen wird ein Angebot eines Verkäufers auf der Shortlist.** Der Käufer kann mehrere Angebote annehmen, auch mehrere desselben Verkäufers. Die Annahme ist kein Vertrag. Ein angenommenes Angebot kann der Verkäufer weder zurückziehen noch überarbeiten, und der Käufer kann es weder ablehnen noch Änderungen anfragen ([Shortlist und Annahme](https://docs.otark.com/de/ppa-tender/shortlist-and-acceptance)).
* **Der erste erfasste PPA schließt die Ausschreibung.** Käufer oder Verkäufer erfassen den PPA mit Bezug auf ein angenommenes Angebot; zu weiteren angenommenen Angeboten lassen sich danach noch PPAs erfassen. Die Gegenseite bestätigt nichts, und die Otark GmbH prüft den Vertrag nicht. Verstreicht der Geplante PPA-Abschluss, solange die Ausschreibung aktiv ist, schließt die Plattform sie als abgelaufen ([Unterzeichnete PPAs](https://docs.otark.com/de/ppa-tender/signed-ppas)).

## Support

Bei Fragen oder für weitere Unterstützung erreichen Sie uns über den [Support](https://docs.otark.com/de/support).
