Tender API

POST /v1/tenders/{tender_id}/submit-review

Einen Entwurf zur Veröffentlichung einreichen. Vor der **ersten** Veröffentlichung prüft die Otark GmbH jede Ausschreibung, in der Regel binnen 24 Stunden ab Einreichung, spätestens bis zum Ende des folgenden Werktags; die Ausschreibung wechselt auf in_review. Mit der Freigabe wird sie active: sofort veröffentlicht oder zur geplanten Zeit. Freigegeben wird nur die Ausschreibung eines verifizierten Unternehmens. Hat die Ausschreibung schon eine Freigabe — sie wurde mit unpublishTender in den Entwurf zurückgenommen —, geht sie ohne zweite Prüfung direkt auf active. Voraussetzungen, sonst antwortet die API mit 400: ein Name (TENDER_NAME_REQUIRED), die Postleitzahl des Verbrauchsorts (TENDER_CONSUMPTION_ZIP_REQUIRED), beide Fristen (TENDER_SCHEDULE_REQUIRED), eine noch laufende Frist für indikative Angebote (OFFERS_DEADLINE_PASSED), eine Veröffentlichung spätestens an deren Tag (PUBLICATION_DEADLINE_CONFLICT), die Reihenfolge der Fristen (TENDER_DEADLINE_SIGNING_BEFORE_OFFERS, TENDER_DEADLINE_SIGNING_AFTER_DELIVERY) und kein gescheiterter Lastgang-Import ohne Ersatz oder Verzicht (DEMAND_IMPORT_FAILED). Läuft die Frist für indikative Angebote einer geplanten Ausschreibung vor der Veröffentlichung ab, setzt die Plattform sie in den Entwurf zurück; die Freigabe bleibt bestehen. Die Einladungen der Einladungsliste gehen mit der Veröffentlichung hinaus. 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}/submit-review
X-Api-Key<token>

In: header

Path Parameters

tender_idstring

Kennung der Ausschreibung

Response Body

curl -X POST "https://api.otark.com/v1/tenders/ten_7g4k2m9p/submit-review"
{
  "status": "in_review"
}

{
  "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_recipient_restriction_not_allowed",
  "title": "Empfängerkreis lässt sich nicht einschränken",
  "status": 403,
  "error": "TENDER_RECIPIENT_RESTRICTION_NOT_ALLOWED"
}

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