POST /v1/tenders/{tender_id}/shortlist
Einen zugelassenen Verkäufer auf die Shortlist setzen (Zugangsstatus shortlisted) oder wieder herunternehmen (approved), solange die Ausschreibung aktiv ist. Ein Angebot braucht es dafür nicht, eine Frist gibt es nicht. Die Shortlist öffnet den Datenraum, und der Käufer kann die Angebote des Verkäufers annehmen. Wer von der Shortlist genommen wird, sieht den Datenraum nicht mehr. Freiwillig nennt der Käufer die Angebote, auf denen der Eintrag beruht (bis zu 50, eigene Angebote des Verkäufers, nicht abgelehnt oder zurückgezogen). Die Annahme eines Angebots hängt nicht an dieser Auswahl. Erforderlicher Scope: tenders:write
Freischaltung erforderlich
In: header
Path Parameters
Kennung der Ausschreibung
Der Zugang des Verkäufers
Gesetzt, um den Verkäufer auf die Shortlist zu setzen; nicht gesetzt, um ihn herunterzunehmen
Die Angebote, auf denen der Eintrag beruht (freiwillig, bis zu 50)
items <= 50Response Body
curl -X POST "https://api.otark.com/v1/tenders/ten_7g4k2m9p/shortlist" \ -H "Content-Type: application/json" \ -d '{ "access_id": "ten_acc_2f6h9k3m", "shortlisted": true }'{
"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}/invitations/{access_id} DELETE
Eine offene Einladung (invited) einer aktiven Ausschreibung zurückziehen. Die Einladung entfällt; bei einer Ausschreibung an alle Verkäufer kann das Unternehmen weiterhin selbst Zugang anfragen. Erforderlicher Scope: tenders:write
/tenders/{tender_id}/offers GET
Die Angebote der Ausschreibung auflisten. Der Käufer sieht alle Angebote, jedes mit seiner Bewertung (score) gegen die Bewertungskriterien: Werte und Punkte je Kriterium, den gewichteten Gesamtscore 0–100 und die Bewertungsstufe. Ein Verkäufer erhält mit demselben Aufruf nur seine eigenen Angebote, ohne Bewertung; Rang und Punkte sieht er nie. Zurückgezogene und abgelehnte Angebote bleiben mit ihrem Status gelistet; eine Revision ersetzt ihren Vorgänger. Erforderlicher Scope: tenders:read