POST /v1/tenders/{tender_id}/offers/{offer_id}/accept
Ein eingereichtes Angebot eines Verkäufers auf der Shortlist annehmen. Angebote anderer Verkäufer weist die API mit 409 zurück, ebenso abgelehnte und zurückgezogene. Der Käufer kann mehrere Angebote annehmen, auch mehrere desselben Verkäufers; eine erneute Annahme desselben Angebots ändert nichts. Die Annahme legt fest, auf welches Angebot sich der unterzeichnete PPA bezieht. Sie erzeugt weder einen Vertrag noch ein Dokument. Danach ist das Angebot unveränderlich: Der Verkäufer kann es weder zurückziehen noch überarbeiten und die Ausschreibung nicht mehr verlassen, der Käufer kann es weder ablehnen noch Änderungen anfragen. Bei einem Angebot mit Abschlag schreibt die Annahme die Preise fest. Der Verkäufer erhält eine E-Mail. Erforderlicher Scope: tenders:sign
Freischaltung erforderlich
In: header
Path Parameters
Kennung der Ausschreibung
Kennung des Angebots
Response Body
curl -X POST "https://api.otark.com/v1/tenders/ten_7g4k2m9p/offers/ten_off_8m2p6r9t/accept"{
"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/{offer_id}/request-changes POST
Zu einem eingereichten, nicht angenommenen Angebot Änderungen anfragen. Die Nachricht ist Pflicht (bis zu 2.000 Zeichen) und steht im Nachrichtenkanal; der Status des Angebots bleibt. Der Verkäufer antwortet mit einer Revision. Ein angenommenes, zurückgezogenes oder abgelehntes Angebot weist die API mit 409 zurück. Erforderlicher Scope: tenders:write
/inbox GET
Die Ausschreibungen auflisten, auf die das angemeldete Verkäuferunternehmen Zugang anfragen kann: veröffentlichte Ausschreibungen an alle Verkäufer, auf die es noch keinen Zugang hat, und Ausschreibungen, zu denen es eingeladen ist, auch bei invite_only — jeweils bis einschließlich des Tages der Frist für indikative Angebote. Jeder Eintrag ist anonym, auch eine Einladung: sichtbar sind Eckdaten, öffentliche Beschreibung, Fristen, Lieferprofil, ob ein Lastgang vorliegt, Bonitätsindex und Branche des Käufers. Unternehmen auf der Ausschlussliste sehen die Ausschreibung nicht. Erforderlicher Scope: tenders:read