Tender API

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

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}/access-requests/{access_id}/respond
X-Api-Key<token>

In: header

Path Parameters

tender_idstring

Kennung der Ausschreibung

access_idstring

Kennung des Zugangs (die Beziehung zwischen der Ausschreibung und einem Verkäuferunternehmen)

decisionstring

Die Entscheidung des Käufers

Value in"approved" | "denied"
response_message?string

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