Tender API
API für Käufer und Verkäufer bei PPA-Ausschreibungen: Ausschreibungen anlegen, prüfen lassen und veröffentlichen, Zugang steuern, Angebote bewerten und annehmen, den unterzeichneten PPA erfassen.
Freischaltung erforderlich
Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
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, 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.
Basis-URL
https://api.otark.com/v1Alle Anfragen müssen HTTPS verwenden. Antworten werden im JSON-Format zurückgegeben.
Authentifizierung
Alle Anfragen müssen den X-Api-Key-Header enthalten:
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.
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).
- 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).
- 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).
- 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).
- 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).
Support
Bei Fragen oder für weitere Unterstützung erreichen Sie uns über den Support.
/remit-setting PATCH
Den Meldemodus einmalig wählen, solange noch keiner gewählt ist; ist bereits ein Modus gewählt, antwortet der Vorgang mit 409. Ein späterer Wechsel des Meldemodus läuft über den Support. Die Wahl gilt für den Teilnehmer, für alle seine Verbindungen und für Green SPOT. Wer self_reporting wählt, meldet seine Seite selbst und trägt die Folgen einer unterlassenen Meldung allein; OES meldet dann nur die Seite der Gegenpartei. Bei 1-Click PPA vereinbaren die Parteien das Selbstmelden in der Anpassungsvereinbarung, die Wahl des Meldemodus ist ihre technische Umsetzung. Änderungen an der Marktteilnehmerkennung laufen über den Support, weil sie in laufende Meldeketten eingreifen. Erforderlicher Scope: rfq:write
/tenders POST
Eine Ausschreibung als Entwurf anlegen. Der Entwurf bleibt für Verkäufer unsichtbar, bis er zur Prüfung eingereicht, freigegeben und veröffentlicht ist. Pflicht beim Anlegen sind Energiequelle, Volumen je Technologie, Lieferbeginn und Laufzeitspanne; alles Übrige lässt sich später mit updateTender ergänzen. Land und Bundesland übernimmt die Plattform aus der Firmenadresse, die Postleitzahl des Verbrauchsorts ebenso als Vorbelegung. Fehlen die Fristen, setzt die Plattform ihren Vorschlag. Erforderlicher Scope: tenders:write
Zuletzt aktualisiert am