Tender API

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

Als Markdown anzeigen

Freischaltung erforderlich

Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
POST
/v1/tenders/{tender_id}/offers/{offer_id}/revisions
X-Api-Key<token>

In: header

Path Parameters

tender_idstring

Kennung der Ausschreibung

offer_idstring

Kennung des Angebots

pricing_modelstring

Preismodell: fixed (Fixpreis) oder discount (Abschlag auf den EEX-Base-Future je Lieferzeitraum)

Value in"fixed" | "discount"
price_schedule?string

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)

Value in"flat" | "per_period"
price_per_mwh?number

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

period_discounts?array<PeriodDiscount>

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)

year_prices?array<YearPrice>

Bei fixed mit per_period Pflicht — ein Preis je Kalenderjahr der Laufzeit (OFFER_YEAR_PRICE_MISSING)

price_per_gonumber

Preis je HKN in EUR/MWh, getrennt vom Energiepreis (bis zu 4 Nachkommastellen); Pflicht, 0 ist zulässig

technologystring

Eine Technologie je Angebot — bei einer gemischten Ausschreibung geben Sie Solar und Wind getrennt ab

Value in"solar" | "wind"
start_datestring

Lieferbeginn (YYYY-MM-DD); nicht vor dem Lieferbeginn der Ausschreibung

Formatdate
contract_yearsinteger

Vertragslaufzeit in Jahren, innerhalb der Spanne der Ausschreibung

Range1 <= value <= 30
end_date?string

Genaues, einschließendes Enddatum bei abweichender Laufzeit; entfällt, wenn contract_years gilt

Formatdate
delivery_profilestring

Angebotenes Lieferprofil

Value in"baseload" | "pay_as_forecasted" | "pay_as_produced" | "shaped" | "pay_as_indexed" | "pay_as_consumed"
price_index?string

Abrechnungsindex bei Pay as Indexed

Value in"enwex_solar" | "enwex_wind"
volume_per_yearnumber

Angebotene Menge in MWh pro Jahr, über 0 (bis zu 3 Nachkommastellen)

capacity_mwnumber

Installierte Leistung, die das Angebot unterlegt, in MW, über 0

offer_message?string

Anmerkungen (bis zu 2.000 Zeichen)

asset_idsarray<string>

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"
}