PATCH /v1/tenders/{tender_id}
Felder einer eigenen Ausschreibung ändern; nicht übergebene Felder bleiben unverändert. **Einladungs- und Ausschlussliste** lassen sich nur im Entwurf ändern (TENDER_AUDIENCE_LOCKED); danach lädt der Käufer einzeln mit inviteSeller ein. **Fristen:** Eine Frist darf nie in der Vergangenheit liegen, heute ist zulässig (TENDER_DEADLINE_OFFERS_PAST, TENDER_DEADLINE_SIGNING_PAST). Eine noch laufende Frist darf früher oder später gelegt werden. Ist eine Frist nach der Veröffentlichung abgelaufen, lässt sie sich nicht mehr ändern (TENDER_DEADLINE_OFFERS_LOCKED, TENDER_DEADLINE_SIGNING_LOCKED). Der Geplante PPA-Abschluss liegt nach der Frist für indikative Angebote und vor dem Lieferbeginn (TENDER_DEADLINE_SIGNING_BEFORE_OFFERS, TENDER_DEADLINE_SIGNING_AFTER_DELIVERY); die geplante Veröffentlichung liegt nicht nach dem Tag der Frist für indikative Angebote (PUBLICATION_DEADLINE_CONFLICT). **Wesentliche Änderungen:** Ändert der Käufer an einer veröffentlichten Ausschreibung Fristen, Empfängerkreis, Anonymität, Detailbeschreibung oder Veröffentlichungszeitpunkt, benachrichtigt die Plattform die zugelassenen Verkäufer. Alle übrigen Änderungen sind sofort sichtbar, ohne Benachrichtigung. Bewertungskriterien bleiben änderbar; die Bewertungen werden neu berechnet. Erforderlicher Scope: tenders:write
Freischaltung erforderlich
In: header
Path Parameters
Kennung der Ausschreibung
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 PATCH "https://api.otark.com/v1/tenders/ten_7g4k2m9p" \ -H "Content-Type: application/json" \ -d '{}'{
"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"
}{
"type": "https://api.otark.com/errors/tender_not_found",
"title": "Ausschreibung nicht gefunden",
"status": 404,
"error": "TENDER_NOT_FOUND",
"instance": "/v1/tenders/ten_7g4k2m9p"
}{
"type": "https://api.otark.com/errors/tender_admission_deadline_passed",
"title": "Frist für indikative Angebote abgelaufen",
"status": 409,
"error": "TENDER_ADMISSION_DEADLINE_PASSED"
}/tenders/{tender_id} GET
Eine Ausschreibung des angemeldeten Käuferunternehmens über ihre Kennung abrufen, samt Empfängerkreis, Fristen, Lieferung, Bewertungskriterien und Beschreibungen. Erforderlicher Scope: tenders:read
/tenders/{tender_id} DELETE
Einen Entwurf mit allen Dateien löschen. Nur ein Entwurf lässt sich löschen; eine eingereichte oder veröffentlichte Ausschreibung nimmt der Käufer mit unpublishTender in den Entwurf zurück oder schließt sie. Erforderlicher Scope: tenders:write