Tender API

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.

Als Markdown anzeigen

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/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:

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.

ScopeBerechtigung
tenders:readAusschreibungen, Zugänge, Angebote und die Tender Inbox lesen
tenders:writeKä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:offerVerkäufer: Zugang anfragen und zurückziehen, die Ausschreibung verlassen, indikative Angebote abgeben, überarbeiten und zurückziehen, den unterzeichneten PPA erfassen
tenders:signKäufer: Angebote annehmen und den unterzeichneten PPA erfassen
chats:read, chats:writeDen Nachrichtenkanal lesen und Nachrichten senden
data-rooms:tender:read, data-rooms:tender:writeDen Datenraum lesen und Dokumente hochladen

Konventionen

KonventionRegel
PaginierungListen nehmen limit (1–100, Vorgabe 10) und einen Cursor after entgegen; die Antwort führt pagination mit has_more und next_cursor
ZeitstempelISO 8601 in UTC (2026-09-01T07:00:00Z)
Fristen und LiefertageKalendertage als YYYY-MM-DD. Eine Frist endet mit ihrem Tag nach Europe/Berlin, der Fristtag zählt noch voll
Mengen und PreiseMengen in MWh (bis zu 3 Nachkommastellen), Preise in EUR/MWh (bis zu 4 Nachkommastellen)
FehlerProblem Details nach RFC 9457 (application/problem+json); das Feld error trägt den Fehlercode der Plattform, etwa TENDER_ADMISSION_DEADLINE_PASSED
Ratenbegrenzung300 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

RessourceZweckRolle
AusschreibungAnlegen, Ändern, einen Entwurf löschen, den Lastgang hochladen, zur Prüfung einreichen, in den Entwurf zurücknehmen, schließen, abbrechen, wieder öffnenKäufer
ZugangÜber Zugangsanfragen entscheiden, den Zugang entziehen, Verkäufer einladen, Einladungen erneut senden und zurückziehen, die Shortlist setzenKäufer
Angebote (Käufersicht)Einsehen mit Bewertung je Kriterium, Gesamtscore und Einstufung; Angebote anfordern, ablehnen, Änderungen anfragen und annehmenKäufer
Tender InboxAusschreibungen an alle Verkäufer und Einladungen, anonym bis zur ZulassungVerkäufer
ZugangsanfrageAnfragen, zurückziehen, die Ausschreibung verlassenVerkäufer
Indikatives AngebotAbgeben, überarbeiten und zurückziehen; eine neue Fassung ersetzt die alteVerkäufer
Unterzeichneter PPAErfassen mit Bezug auf ein angenommenes Angebotbeide
Nachrichten und DatenraumNachrichtenkanal je zugelassenem Verkäufer, Datenraum je Verkäufer auf der Shortlistbeide

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.

Zuletzt aktualisiert am