POST /v1/tenders/{tender_id}/leave
Als zugelassener Verkäufer (approved oder shortlisted) eine aktive Ausschreibung verlassen. Jedes offene Angebot wird zurückgezogen, der Zugang wechselt auf cancelled, und der Käufer erhält eine E-Mail mit der freiwilligen Nachricht. Der Schritt lässt sich nicht rückgängig machen. Nach einem angenommenen Angebot oder einem erfassten PPA ist das Verlassen nicht mehr möglich (409). Erforderlicher Scope: tenders:offer
Freischaltung erforderlich
In: header
Path Parameters
Kennung der Ausschreibung
Freiwillige Nachricht an den Käufer (bis zu 2.000 Zeichen)
Response Body
curl -X POST "https://api.otark.com/v1/tenders/ten_7g4k2m9p/leave" \ -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_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}/application DELETE
Eine offene Zugangsanfrage (requested) zurückziehen; der Zugang wechselt auf cancelled. Eine Einladung lässt sich auf diesem Weg nicht zurückziehen (409). Ein zugelassener Verkäufer verlässt die Ausschreibung mit leaveTender. Erforderlicher Scope: tenders:offer
/tenders/{tender_id}/offers POST
Als zugelassener Verkäufer (Zugangsstatus approved oder shortlisted, sonst 403) ein indikatives Angebot abgeben. Ein Angebot deckt eine Technologie ab — bei einer gemischten Ausschreibung geben Sie Solar und Wind getrennt ab — und nennt mindestens eine Erzeugungsanlage dieser Technologie. Lieferbeginn und Laufzeit liegen innerhalb der Ausschreibung. Die Frist für indikative Angebote ist ein Zieldatum: Auch danach nimmt die Plattform Angebote an. Ein Erzeugungsprofil (Werte in 5- bis 60-Minuten-Intervallen) wird im Angebots-Wizard der Plattform mit dem Angebot hochgeladen; ein über diese API abgegebenes Angebot trägt keines (production_profile_available bleibt false). Ohne Profil lassen sich Capture Rate, Effektivkosten und Verbrauchsmatching nicht bewerten. Baseload- und Pay-as-Indexed-Angebote brauchen kein Erzeugungsprofil. Einmal abgegeben, ist das Angebot für den Käufer sichtbar und unveränderlich; Änderungen erfolgen durch eine Revision. Erforderlicher Scope: tenders:offer