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
Freischaltung erforderlich
In: header
Path Parameters
Kennung der Ausschreibung
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 '{}'{
"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"
}/inbox GET
Die Ausschreibungen auflisten, auf die das angemeldete Verkäuferunternehmen Zugang anfragen kann: veröffentlichte Ausschreibungen an alle Verkäufer, auf die es noch keinen Zugang hat, und Ausschreibungen, zu denen es eingeladen ist, auch bei invite_only — jeweils bis einschließlich des Tages der Frist für indikative Angebote. Jeder Eintrag ist anonym, auch eine Einladung: sichtbar sind Eckdaten, öffentliche Beschreibung, Fristen, Lieferprofil, ob ein Lastgang vorliegt, Bonitätsindex und Branche des Käufers. Unternehmen auf der Ausschlussliste sehen die Ausschreibung nicht. Erforderlicher Scope: tenders:read
/tenders/{tender_id}/application DELETE
Eine offene Zugangsanfrage (requested) zurückziehen; der Zugang wechselt auf cancelled. Eine Einladung lässt sich auf diesem Weg nicht zurückziehen (409). Ein zugelassener Verkäufer verlässt die Ausschreibung mit leaveTender. Erforderlicher Scope: tenders:offer