POST /v1/tenders/{tender_id}/offers/{offer_id}/revisions
Eine neue Fassung eines eigenen indikativen Angebots abgeben. Die Revision ist für sich ein vollständiges Angebot; der Vorgänger wird in derselben Transaktion zurückgezogen und bleibt für den Käufer als zurückgezogen sichtbar. So beantworten Sie eine Änderungsanfrage des Käufers. Ein angenommenes Angebot lässt sich nicht überarbeiten (409). Erforderlicher Scope: tenders:offer
Freischaltung erforderlich
In: header
Path Parameters
Kennung der Ausschreibung
Kennung des Angebots
Preismodell: fixed (Fixpreis) oder discount (Abschlag auf den EEX-Base-Future je Lieferzeitraum)
"fixed" | "discount"Wie der Energiepreis über die Laufzeit abgerechnet wird: flat (ein einheitlicher Preis, das mengengewichtete Mittel der Zeiträume, Voreinstellung) oder per_period (jeder Zeitraum zu seinem eigenen Preis)
"flat" | "per_period"Energiepreis in EUR/MWh (bis zu 4 Nachkommastellen) — Pflicht bei fixed mit flat. Bei discount und bei per_period errechnet die Plattform den Wert als mengengewichtetes Mittel
Bei discount Pflicht — ein Abschlag je Lieferzeitraum der Laufzeit. Für jeden Zeitraum muss ein EEX-Future notiert sein (OFFER_TERM_OUTSIDE_EEX_HORIZON, OFFER_PERIOD_DISCOUNT_MISSING)
Bei fixed mit per_period Pflicht — ein Preis je Kalenderjahr der Laufzeit (OFFER_YEAR_PRICE_MISSING)
Preis je HKN in EUR/MWh, getrennt vom Energiepreis (bis zu 4 Nachkommastellen); Pflicht, 0 ist zulässig
Eine Technologie je Angebot — bei einer gemischten Ausschreibung geben Sie Solar und Wind getrennt ab
"solar" | "wind"Lieferbeginn (YYYY-MM-DD); nicht vor dem Lieferbeginn der Ausschreibung
dateVertragslaufzeit in Jahren, innerhalb der Spanne der Ausschreibung
1 <= value <= 30Genaues, einschließendes Enddatum bei abweichender Laufzeit; entfällt, wenn contract_years gilt
dateAngebotenes Lieferprofil
"baseload" | "pay_as_forecasted" | "pay_as_produced" | "shaped" | "pay_as_indexed" | "pay_as_consumed"Abrechnungsindex bei Pay as Indexed
"enwex_solar" | "enwex_wind"Angebotene Menge in MWh pro Jahr, über 0 (bis zu 3 Nachkommastellen)
Installierte Leistung, die das Angebot unterlegt, in MW, über 0
Anmerkungen (bis zu 2.000 Zeichen)
Erzeugungsanlagen der angebotenen Technologie, mindestens eine, höchstens 100 (OFFER_ASSETS_INVALID)
Response Body
curl -X POST "https://api.otark.com/v1/tenders/ten_7g4k2m9p/offers/ten_off_8m2p6r9t/revisions" \ -H "Content-Type: application/json" \ -d '{ "technology": "solar", "start_date": "2027-01-01", "contract_years": 10, "delivery_profile": "pay_as_forecasted", "volume_per_year": 31500, "capacity_mw": 30, "asset_ids": [ "ast_1w4y7z2c" ] }'{
"pricing_model": "fixed",
"price_schedule": "flat",
"price_per_mwh": 54.5,
"period_discounts": [
{
"key": "cal-2027",
"discount_percent": 36
}
],
"year_prices": [
{
"year": 2027,
"price_per_mwh": 54.5
}
],
"price_per_go": 0.8,
"id": "ten_off_8m2p6r9t",
"tender_id": "ten_7g4k2m9p",
"seller_company_id": "com_9k3m7p2r",
"technology": "solar",
"status": "submitted",
"accepted_at": null,
"start_date": "2027-01-01",
"contract_years": 10,
"end_date": null,
"delivery_profile": "pay_as_forecasted",
"price_index": null,
"volume_per_year": 31500,
"capacity_mw": 30,
"discount_percent": null,
"price_periods": [
{
"key": "cal-2027",
"period_start": "2027-01-01",
"period_end": "2027-12-31",
"partial": false,
"discount_percent": 36,
"future_price": 85,
"price_per_mwh": 54.4
}
],
"price_settlement_date": "2026-10-09",
"offer_message": "Profil 2023–2025 ist die reale Einspeisung.",
"assets": [
{
"id": "ast_1w4y7z2c",
"name": "Solarpark Niederbayern",
"mastr_number": "SEE931570002846",
"technology": "solar",
"capacity_mw": 30
}
],
"production_profile_available": true,
"replaces_offer_id": null,
"score": {
"composite": 76,
"rating": "recommended",
"ko": false,
"ko_criteria": [],
"completeness": 1,
"seller_completeness": 1,
"criteria": [
{
"key": "capture",
"value": 86,
"score": 0,
"missing": null
}
]
},
"submitted_at": "2026-10-10T14:20:00Z",
"created_at": "2026-10-10T14:20:00Z"
}{
"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}/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
/tenders/{tender_id}/offers/{offer_id} DELETE
Ein eigenes Angebot zurückziehen (withdrawn). Ein angenommenes oder bereits zurückgezogenes Angebot weist die API mit 409 zurück. Der Käufer erhält eine E-Mail. Das Angebot bleibt für beide Seiten als zurückgezogen sichtbar; ein neues Angebot ist weiterhin möglich. Erforderlicher Scope: tenders:offer