Tender API

POST /v1/tenders/{tender_id}/signed-ppas

Einen außerhalb der Plattform unterzeichneten PPA erfassen, mit Bezug auf ein angenommenes Angebot. Erfassen kann der Verkäufer oder der Käufer; der Käufer nennt dabei den Verkäufer (counterparty_company_id, sonst COUNTERPARTY_REQUIRED). Voraussetzung ist ein Verkäufer auf der Shortlist (SHORTLISTED_ACCESS_REQUIRED) und ein angenommenes Angebot dieses Verkäufers in dieser Ausschreibung (OFFER_REQUIRED, OFFER_MISMATCH). Die Angaben entsprechen dem unterzeichneten Vertrag; der Vertrag selbst wird als PDF bis 50 MB hochgeladen (CONTRACT_MUST_BE_PDF) und ist für beide Seiten sichtbar. Das Erfassen ist eine Erklärung, keine Prüfung: Die Gegenseite bestätigt nichts, und die Otark GmbH prüft den Vertrag nicht. Der erste erfasste PPA schließt die Ausschreibung; zu weiteren angenommenen Angeboten lassen sich danach noch PPAs erfassen. Der PPA erscheint bei beiden Seiten unter den laufenden PPAs. Erforderlicher Scope: tenders:sign (Käufer) oder tenders:offer (Verkäufer)

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}/signed-ppas
X-Api-Key<token>

In: header

Path Parameters

tender_idstring

Kennung der Ausschreibung

offer_idstring

Das angenommene Angebot, auf das sich der PPA bezieht

counterparty_company_id?string

Nur für Käufer: der Verkäufer auf der Shortlist, mit dem der PPA unterzeichnet ist

ppa_typestring

Lieferprofil des PPA, wie unterzeichnet

Value in"forecasted" | "produced" | "consumed" | "baseload" | "shaped" | "peakload"
delivery_startstring

Lieferbeginn (YYYY-MM-DD), wie unterzeichnet

Formatdate
delivery_endstring

Lieferende (YYYY-MM-DD), wie unterzeichnet

Formatdate
sourcesstring

Die Technologien des PPA als JSON-Array von SignedPpaSource, mindestens eine, jede Technologie höchstens einmal

contractstring

Der unterzeichnete Vertrag (PDF, bis 50 MB)

Response Body

curl -X POST "https://api.otark.com/v1/tenders/ten_7g4k2m9p/signed-ppas" \  -F offer_id="ten_off_8m2p6r9t" \  -F ppa_type="forecasted" \  -F delivery_start="2027-01-01" \  -F delivery_end="2036-12-31" \  -F sources="[{\"asset_type\":\"solar\",\"nominal_power_mw\":30,\"annual_delivery_volume\":31500,\"price_per_mwh\":54.5}]" \  -F contract="string"
{
  "id": "ppa_ctm_sign_3d6f9h2k"
}

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