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)
Freischaltung erforderlich
In: header
Path Parameters
Kennung der Ausschreibung
Das angenommene Angebot, auf das sich der PPA bezieht
Nur für Käufer: der Verkäufer auf der Shortlist, mit dem der PPA unterzeichnet ist
Lieferprofil des PPA, wie unterzeichnet
"forecasted" | "produced" | "consumed" | "baseload" | "shaped" | "peakload"Lieferbeginn (YYYY-MM-DD), wie unterzeichnet
dateLieferende (YYYY-MM-DD), wie unterzeichnet
dateDie Technologien des PPA als JSON-Array von SignedPpaSource, mindestens eine, jede Technologie höchstens einmal
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"
}/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
/tenders/{tender_id}/messages GET
Die Nachrichten des Kanals zwischen dem Käufer und einem zugelassenen Verkäufer auflisten. Jede Ausschreibung hat je zugelassenem Verkäufer einen Kanal: Der Käufer spricht einen Kanal über company_id an; ein Verkäufer liest seinen eigenen Kanal und lässt den Parameter weg. Der Kanal entsteht leer mit der Zulassung. Im Kanal stehen auch die Nachrichten des Käufers zu Angebotsanfragen, Änderungsanfragen und Ablehnungen. Erforderlicher Scope: chats:read