Tender API

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

Als Markdown anzeigen

Freischaltung erforderlich

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

In: header

Path Parameters

tender_idstring

Kennung der Ausschreibung

name?string | null

Interner Name (bis zu 200 Zeichen). Verkäufer sehen ihn nie. Ein Entwurf darf ohne Namen gespeichert werden; zum Einreichen ist er Pflicht

public_name?string | null

Ö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

energy_type?string

Angefragte Energiequelle; mixed nimmt je Technologie ein eigenes Angebot entgegen

Value in"solar" | "wind" | "mixed"
solar_volume_per_year?number | null

Angefragte Solarmenge in MWh pro Jahr (bis zu 3 Nachkommastellen) — über 0, wenn energy_type Solar einschließt

wind_volume_per_year?number | null

Angefragte Windmenge in MWh pro Jahr (bis zu 3 Nachkommastellen) — über 0, wenn energy_type Wind einschließt

solar_nominal_power_mw?number | null

Indikative Solarleistung in MW — ein Größenhinweis für Verkäufer, keine Vorgabe

wind_nominal_power_mw?number | null

Indikative Windleistung in MW — ein Größenhinweis für Verkäufer, keine Vorgabe

solar_target_price_per_mwh?number | null

Interner Wunschpreis des Käufers für Solar in EUR/MWh — Verkäufern nie gezeigt

wind_target_price_per_mwh?number | null

Interner Wunschpreis des Käufers für Wind in EUR/MWh — Verkäufern nie gezeigt

delivery_start?string

Angefragter Lieferbeginn (YYYY-MM-DD)

Formatdate
contract_years_min?integer

Mindestlaufzeit des Vertrags in Jahren; Angebote müssen innerhalb der Spanne bleiben

Range1 <= value <= 30
contract_years_max?integer

Höchste Vertragslaufzeit in Jahren, nicht unter der Mindestlaufzeit

Range1 <= value <= 30
consumption_zip?string | null

Postleitzahl des Verbrauchsorts (vier oder fünf Ziffern), vorbelegt mit der Postleitzahl der Firmenadresse. Pflicht zum Einreichen; die Regionalität misst die Entfernung zu ihr

delivery_profiles?array<string>

Lieferprofile, die der Käufer zulässt (Mehrfachauswahl). Voreinstellung bei einer neuen Ausschreibung ist pay_as_forecasted

delivery_profile?string | null

Das bevorzugte Profil innerhalb von delivery_profiles; der Verkäufer bleibt im Angebot frei

Value in"baseload" | "pay_as_forecasted" | "pay_as_produced" | "shaped" | "pay_as_indexed" | "pay_as_consumed"
delivery?TenderDelivery

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

recipients?string

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

Value in"public" | "invite_only"
invited_company_ids?array<string>

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)

excluded_company_ids?array<string>

Ausschlussliste — Unternehmen, die die Ausschreibung nicht sehen. Nur mit Freischaltung durch die Otark GmbH und nur im Entwurf änderbar (TENDER_AUDIENCE_LOCKED)

anonymous_until_admission?boolean

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

public_description?string | null

Öffentlicher Kurztext in der Tender Inbox (bis zu 500 Zeichen), sichtbar auch, solange der Käufer anonym ist

restricted_description?string | null

Detailbeschreibung (bis zu 5.000 Zeichen), nur für zugelassene Verkäufer sichtbar

additional_fields?array<AdditionalField>

Eigene Felder, nur für zugelassene Verkäufer sichtbar

contact_person_id?string | null

Der Benutzer des Käuferunternehmens, den zugelassene Verkäufer als Ansprechperson sehen; voreingestellt ist der Benutzer, der die Ausschreibung anlegt

scoring?ScoringConfig

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

load_profile_skipped?boolean

Der Käufer verzichtet auf einen Lastgang; dann entfällt das Verbrauchsmatching für alle Angebote

planned_publication_at?string | null

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)

Formatdate-time
deadline_offers?string

Frist 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

Formatdate
deadline_signing?string

Geplanter 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

Formatdate

Response Body

curl -X PATCH "https://api.otark.com/v1/tenders/ten_7g4k2m9p" \  -H "Content-Type: application/json" \  -d '{}'
Empty

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