Tender API

POST /v1/tenders/{tender_id}/application

Als Verkäufer Zugang zu einer Ausschreibung anfragen — auf eine Ausschreibung an alle Verkäufer oder auf eine Einladung, auch bei invite_only. Die freiwillige Nachricht (bis zu 2.000 Zeichen) liest der Käufer zusammen mit dem Unternehmensprofil — Name, Adresse, Technologie, Gründungsjahr, Portfolio, Märkte und Bonitätsindex. Verkäufer sind gegenüber dem Käufer nie anonym. Der Zugang wechselt auf requested; der Käufer entscheidet. Anfragen kann nur ein verifiziertes Unternehmen (403), nur bei einer veröffentlichten Ausschreibung aus der eigenen Tender Inbox und nur bis einschließlich des Tages der Frist für indikative Angebote (403). Eine zweite Anfrage weist die API mit 409 zurück. 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}/application
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/application" \  -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"
}