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
Freischaltung erforderlich
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"
}/tenders/{tender_id}/load-profile POST
Den Lastgang des Käufers für die Ausschreibung hochladen; ein neuer Lastgang ersetzt den bisherigen. Angenommen werden CSV- oder TSV-Dateien bis 25 MB mit Intervallen von 5, 15, 30 oder 60 Minuten und Werten in kW, MW, kWh oder MWh. Der Import läuft im Hintergrund — die Antwort nennt seinen Anfangsstand, load_profile_status der Ausschreibung den aktuellen. Auch ein lückenhafter Lastgang wird aktiv (partial). Zugelassene Verkäufer sehen Kennzahlen und Profile des Lastgangs, nicht die Datei. Ohne Lastgang entfällt das Verbrauchsmatching für alle Angebote. Erforderlicher Scope: tenders:write
/tenders/{tender_id}/unpublish POST
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