Tender API

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

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

In: header

Path Parameters

tender_idstring

Kennung der Ausschreibung

access_idstring

Der Zugang des Verkäufers

message?string

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