Tender API

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

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}/shortlist
X-Api-Key<token>

In: header

Path Parameters

tender_idstring

Kennung der Ausschreibung

access_idstring

Der Zugang des Verkäufers

shortlistedboolean

Gesetzt, um den Verkäufer auf die Shortlist zu setzen; nicht gesetzt, um ihn herunterzunehmen

anchor_offer_ids?array<string>

Die Angebote, auf denen der Eintrag beruht (freiwillig, bis zu 50)

Itemsitems <= 50

Response 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  }'
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"
}