POST /v1/tenders/{tender_id}/unpublish
Eine Ausschreibung im Status in_review oder active in den Entwurf zurücknehmen — die Einreichung zurückziehen oder die Veröffentlichung rückgängig machen. Verkäufer sehen die Ausschreibung dann nicht mehr. Im Entwurf lassen sich auch Einladungs- und Ausschlussliste wieder ändern. Eine Freigabe bleibt bestehen; die erneute Einreichung braucht keine zweite Prüfung. Erforderlicher Scope: tenders:write
Freischaltung erforderlich
curl -X POST "https://api.otark.com/v1/tenders/ten_7g4k2m9p/unpublish"{
"status": "in_review"
}{
"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}/submit-review POST
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
/tenders/{tender_id}/close POST
Eine aktive Ausschreibung schließen (closed). Andere Status weist die API mit 409 zurück. Unabhängig davon schließt die Plattform eine Ausschreibung selbst: mit dem ersten erfassten PPA und mit dem Ablauf des Geplanten PPA-Abschlusses. Erforderlicher Scope: tenders:write