POST /v1/tenders
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
Freischaltung erforderlich
In: header
Interner Name (bis zu 200 Zeichen). Verkäufer sehen ihn nie. Ein Entwurf darf ohne Namen gespeichert werden; zum Einreichen ist er Pflicht
Öffentlicher Name für Verkäufer (bis zu 100 Zeichen). Ohne ihn sehen Verkäufer einen Namen aus Technologie und Bundesland; ist er gesetzt, bleibt das Bundesland bis zur Zulassung verborgen
Angefragte Energiequelle; mixed nimmt je Technologie ein eigenes Angebot entgegen
"solar" | "wind" | "mixed"Angefragte Solarmenge in MWh pro Jahr (bis zu 3 Nachkommastellen) — über 0, wenn energy_type Solar einschließt
Angefragte Windmenge in MWh pro Jahr (bis zu 3 Nachkommastellen) — über 0, wenn energy_type Wind einschließt
Indikative Solarleistung in MW — ein Größenhinweis für Verkäufer, keine Vorgabe
Indikative Windleistung in MW — ein Größenhinweis für Verkäufer, keine Vorgabe
Interner Wunschpreis des Käufers für Solar in EUR/MWh — Verkäufern nie gezeigt
Interner Wunschpreis des Käufers für Wind in EUR/MWh — Verkäufern nie gezeigt
Angefragter Lieferbeginn (YYYY-MM-DD)
dateMindestlaufzeit des Vertrags in Jahren; Angebote müssen innerhalb der Spanne bleiben
1 <= value <= 30Höchste Vertragslaufzeit in Jahren, nicht unter der Mindestlaufzeit
1 <= value <= 30Postleitzahl des Verbrauchsorts (vier oder fünf Ziffern), vorbelegt mit der Postleitzahl der Firmenadresse. Pflicht zum Einreichen; die Regionalität misst die Entfernung zu ihr
Lieferprofile, die der Käufer zulässt (Mehrfachauswahl). Voreinstellung bei einer neuen Ausschreibung ist pay_as_forecasted
Das bevorzugte Profil innerhalb von delivery_profiles; der Verkäufer bleibt im Angebot frei
"baseload" | "pay_as_forecasted" | "pay_as_produced" | "shaped" | "pay_as_indexed" | "pay_as_consumed"Die physische Lieferung. Der Verkäufer liefert nach dem PPA direkt in den Bilanzkreis des Käufers oder seines Stromlieferanten; einen anderen Lieferweg gibt es nicht
Empfängerkreis: alle Verkäufer (public, Voreinstellung) oder nur eingeladene Verkäufer (invite_only). invite_only sowie Einladungs- und Ausschlussliste gibt es nur, wenn die Otark GmbH das Unternehmen dafür freigeschaltet hat; dann ist invite_only voreingestellt. Ohne Freischaltung antwortet die API mit TENDER_RECIPIENT_RESTRICTION_NOT_ALLOWED
"public" | "invite_only"Einladungsliste — Unternehmen, die mit der Veröffentlichung eine Einladung erhalten. Nur mit Freischaltung durch die Otark GmbH und nur im Entwurf änderbar (TENDER_AUDIENCE_LOCKED)
Ausschlussliste — Unternehmen, die die Ausschreibung nicht sehen. Nur mit Freischaltung durch die Otark GmbH und nur im Entwurf änderbar (TENDER_AUDIENCE_LOCKED)
Den Käufer bis zur Zulassung verbergen (Voreinstellung true). Gegenüber jedem Verkäufer, auch einem eingeladenen, bleibt der Käufer bis zur Zulassung anonym. false ist nur bei public möglich und nur, wenn die Otark GmbH das Unternehmen dafür freigeschaltet hat (sonst ANONYMITY_OVERRIDE_NOT_ALLOWED); dann erscheinen Name und Logo des Käufers in der täglichen E-Mail-Zusammenstellung neuer Ausschreibungen, während Tender Inbox und Ausschreibung anonym bleiben
Öffentlicher Kurztext in der Tender Inbox (bis zu 500 Zeichen), sichtbar auch, solange der Käufer anonym ist
Detailbeschreibung (bis zu 5.000 Zeichen), nur für zugelassene Verkäufer sichtbar
Eigene Felder, nur für zugelassene Verkäufer sichtbar
Der Benutzer des Käuferunternehmens, den zugelassene Verkäufer als Ansprechperson sehen; voreingestellt ist der Benutzer, der die Ausschreibung anlegt
Die Bewertungskriterien der Ausschreibung. Kriterien: effective (Effektivkosten), ppa_price (PPA-Preis), capture (Capture Rate), benchmark (Markt-Benchmark), go_price (HKN-Preis), matching (Verbrauchsmatching), creditworthiness (Bonität des Verkäufers), distance (Regionalität). Verkäufer sehen die Kriterien nie
Der Käufer verzichtet auf einen Lastgang; dann entfällt das Verbrauchsmatching für alle Angebote
Geplante Veröffentlichung (ISO 8601 UTC); bleibt sie weg, wird mit der Freigabe veröffentlicht. Sie darf nicht nach dem Tag der Frist für indikative Angebote liegen (PUBLICATION_DEADLINE_CONFLICT)
date-timeFrist für indikative Angebote (YYYY-MM-DD), ein Zieldatum. Bis einschließlich dieses 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. Fristen sind Kalendertage und enden mit dem Tag nach Europe/Berlin. Vorschlag beim Anlegen: heute + 7 Tage, bei früherem Lieferbeginn spätestens zwei Tage davor
dateGeplanter PPA-Abschluss (YYYY-MM-DD), nach der Frist für indikative Angebote und vor dem Lieferbeginn. Verstreicht er, während die Ausschreibung aktiv ist, schließt die Plattform sie als abgelaufen. Vorschlag beim Anlegen: heute + 21 Tage, bei früherem Lieferbeginn ein Tag davor
dateResponse Body
curl -X POST "https://api.otark.com/v1/tenders" \ -H "Content-Type: application/json" \ -d '{}'{
"id": "ten_7g4k2m9p"
}{
"type": "https://api.otark.com/errors/tender_deadline_signing_before_offers",
"title": "Geplanter PPA-Abschluss vor der Frist für indikative Angebote",
"status": 400,
"error": "TENDER_DEADLINE_SIGNING_BEFORE_OFFERS",
"instance": "/v1/tenders/ten_7g4k2m9p"
}{
"type": "https://api.otark.com/errors/insufficient_scopes",
"title": "Unzureichende Scopes des API-Schlüssels",
"status": 401,
"error": "INSUFFICIENT_SCOPES",
"detail": "Missing scope: tenders:write. Please create a new API key with the required scopes."
}{
"type": "https://api.otark.com/errors/tender_recipient_restriction_not_allowed",
"title": "Empfängerkreis lässt sich nicht einschränken",
"status": 403,
"error": "TENDER_RECIPIENT_RESTRICTION_NOT_ALLOWED"
}Übersicht
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.
/tenders GET
Die Ausschreibungen des angemeldeten Käuferunternehmens auflisten. Erforderlicher Scope: tenders:read