Tender API

POST /v1/tenders/{tender_id}/leave

Als zugelassener Verkäufer (approved oder shortlisted) eine aktive Ausschreibung verlassen. Jedes offene Angebot wird zurückgezogen, der Zugang wechselt auf cancelled, und der Käufer erhält eine E-Mail mit der freiwilligen Nachricht. Der Schritt lässt sich nicht rückgängig machen. Nach einem angenommenen Angebot oder einem erfassten PPA ist das Verlassen nicht mehr möglich (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}/leave
X-Api-Key<token>

In: header

Path Parameters

tender_idstring

Kennung der Ausschreibung

message?string

Freiwillige Nachricht an den Käufer (bis zu 2.000 Zeichen)

Response Body

curl -X POST "https://api.otark.com/v1/tenders/ten_7g4k2m9p/leave" \  -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_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"
}