POST /v1/tenders/{tender_id}/offer-requests
Einen zugelassenen Verkäufer (approved oder shortlisted, sonst 409) um ein neues indikatives Angebot bitten oder an eines erinnern. Der Verkäufer erhält eine E-Mail; die freiwillige Nachricht steht zusätzlich im Nachrichtenkanal. Dieselbe Anfrage an denselben Verkäufer ist frühestens sieben Tage (7 × 24 Stunden) nach der letzten möglich, vorher antwortet die API mit 409. Erforderlicher Scope: tenders:write
Freischaltung erforderlich
In: header
Path Parameters
Kennung der Ausschreibung
Der Zugang des Verkäufers
Freiwillige Nachricht an den Verkäufer (bis zu 2.000 Zeichen)
Response Body
curl -X POST "https://api.otark.com/v1/tenders/ten_7g4k2m9p/offer-requests" \ -H "Content-Type: application/json" \ -d '{ "access_id": "ten_acc_2f6h9k3m" }'{
"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}/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
/tenders/{tender_id}/offers/{offer_id}/decline POST
Ein eingereichtes, nicht angenommenes Angebot ablehnen (declined). Ein angenommenes, zurückgezogenes oder bereits abgelehntes Angebot weist die API mit 409 zurück. Der Verkäufer bleibt zugelassen. Eine freiwillige Begründung (bis zu 2.000 Zeichen) steht im Nachrichtenkanal. Erforderlicher Scope: tenders:write