POST /v1/tenders/{tender_id}/access-requests/{access_id}/respond
Über eine Zugangsanfrage entscheiden oder einem zugelassenen Verkäufer den Zugang entziehen, solange die Ausschreibung aktiv ist (sonst 409). approved lässt einen Verkäufer mit Status requested zu: Er sieht Name und Unternehmensdaten des Käufers, den Lastgang, die Detailbeschreibung und die Anhänge, der Nachrichtenkanal entsteht, und er kann indikative Angebote abgeben. Ein eingeladener Verkäufer muss zuerst selbst Zugang anfragen (409). denied lehnt eine Anfrage ab oder entzieht einem Verkäufer mit Status approved oder shortlisted den Zugang; seine Angebote bleiben für den Käufer sichtbar. Ein nie zugelassener Verkäufer erfährt den Namen des Käufers auch mit der Ablehnung nicht. Die freiwillige Antwort (bis zu 2.000 Zeichen) steht in der E-Mail an den Verkäufer, nicht im Nachrichtenkanal. Eine Frist für die Entscheidung gibt es nicht. Erforderlicher Scope: tenders:write
Freischaltung erforderlich
In: header
Path Parameters
Kennung der Ausschreibung
Kennung des Zugangs (die Beziehung zwischen der Ausschreibung und einem Verkäuferunternehmen)
Die Entscheidung des Käufers
"approved" | "denied"Freiwillige Antwort an den Verkäufer per E-Mail (bis zu 2.000 Zeichen)
Response Body
curl -X POST "https://api.otark.com/v1/tenders/ten_7g4k2m9p/access-requests/ten_acc_2f6h9k3m/respond" \ -H "Content-Type: application/json" \ -d '{ "decision": "approved" }'{
"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"
}/tenders/{tender_id}/access-requests GET
Jede Zugangsbeziehung der Ausschreibung auflisten — offene Einladungen und Anfragen, zugelassene Verkäufer und solche auf der Shortlist, abgelehnte und zurückgezogene —, filterbar nach Status. Jeder Eintrag zeigt den Verkäufer mit Namen und Kurzprofil: Verkäufer sind gegenüber dem Käufer nie anonym. Erforderlicher Scope: tenders:read
/tenders/{tender_id}/invitations POST
Verkäuferunternehmen auf die Ausschreibung hinweisen. Die Einladung ist ein Hinweis, keine Zulassung: Der Eingeladene erhält eine E-Mail, die den Käufer nicht nennt, sieht die Ausschreibung anonym in seiner Tender Inbox — auch bei invite_only —, fragt Zugang an, und der Käufer entscheidet. Ablehnen kann der Verkäufer eine Einladung nicht; er fragt einfach keinen Zugang an. Einladbar ist jedes verifizierte Unternehmen, das nicht auf der Ausschlussliste steht und noch keinen Zugang hat; die Antwort nennt je Unternehmen das Ergebnis. Einladen lässt sich nur bei einer aktiven, veröffentlichten Ausschreibung (TENDER_INVITATIONS_CLOSED) und bis einschließlich des Tages der Frist für indikative Angebote (TENDER_ADMISSION_DEADLINE_PASSED). Vor der Veröffentlichung dient die Einladungsliste der Ausschreibung. Erforderlicher Scope: tenders:write