openapi: 3.0.0
info:
  title: Otark Tender API
  description: "API für PPA-Ausschreibungen auf der Otark-Plattform. Eine API für beide Seiten einer Ausschreibung: Käufer legen Ausschreibungen an, reichen sie zur Prüfung ein, veröffentlichen und verwalten sie, entscheiden über den Zugang von Verkäufern, bewerten Angebote und nehmen sie an; Verkäufer arbeiten ihre Tender Inbox ab, fragen Zugang an und geben indikative Angebote ab. Den unterzeichneten PPA erfasst der Käufer oder der Verkäufer. Den Nachrichtenkanal je Ausschreibung und den Datenraum teilen sich beide Seiten.\n\nPPA-Ausschreibungen stehen jedem Unternehmen offen, das das Plattform-Onboarding abgeschlossen hat. Veröffentlichen, einladen lassen und Zugang anfragen kann nur ein verifiziertes Unternehmen. API-Schlüssel entstehen in den Kontoeinstellungen auf app.otark.com."
  version: "2.0.0"
  contact: {}
servers:
  - url: https://api.otark.com
    description: Produktion
tags:
  - name: Buyers
    description: Ausschreibungen anlegen, einreichen, veröffentlichen und schließen, den Zugang von Verkäufern verwalten, Angebote bewerten und annehmen
  - name: Sellers
    description: Tender Inbox, Zugangsanfragen, indikative Angebote
  - name: Shared
    description: Was beide Seiten nutzen — der unterzeichnete PPA, der Nachrichtenkanal je Ausschreibung und der Datenraum
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
  parameters:
    AfterParam:
      name: after
      in: query
      description: Cursor für die nächste Seite — den Wert `next_cursor` aus der vorherigen Antwort übergeben
      schema:
        type: string
        example: ten_a1b2c3d4
    LimitParam:
      name: limit
      in: query
      description: Höchstzahl der Einträge pro Seite
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 10
    TenderIdParam:
      name: tender_id
      in: path
      required: true
      description: Kennung der Ausschreibung
      schema:
        type: string
        example: ten_7g4k2m9p
    AccessIdParam:
      name: access_id
      in: path
      required: true
      description: Kennung des Zugangs (die Beziehung zwischen der Ausschreibung und einem Verkäuferunternehmen)
      schema:
        type: string
        example: ten_acc_2f6h9k3m
    OfferIdParam:
      name: offer_id
      in: path
      required: true
      description: Kennung des Angebots
      schema:
        type: string
        example: ten_off_8m2p6r9t
    CompanyContextParam:
      name: company_id
      in: query
      description: "Nur für Käufer: das Verkäuferunternehmen, dessen Kanal oder Datenraum angesprochen wird — der Käufer hat je zugelassenem Verkäufer einen Kanal und je Verkäufer auf der Shortlist einen Datenraum. Verkäufer lassen diesen Parameter weg; gemeint ist dann ihr eigener Kanal oder Raum."
      schema:
        type: string
        example: com_9k3m7p2r
  headers:
    X-RateLimit-Limit:
      description: Höchstzahl der Anfragen je Zeitfenster
      schema:
        type: integer
    X-RateLimit-Remaining:
      description: Verbleibende Anfragen im laufenden Zeitfenster
      schema:
        type: integer
    X-RateLimit-Reset:
      description: Sekunden, bis das Zeitfenster der Ratenbegrenzung zurückgesetzt wird
      schema:
        type: integer
  responses:
    Done:
      description: Ausgeführt; die Antwort hat keinen Inhalt
      headers:
        x-ratelimit-limit:
          $ref: "#/components/headers/X-RateLimit-Limit"
        x-ratelimit-remaining:
          $ref: "#/components/headers/X-RateLimit-Remaining"
        x-ratelimit-reset:
          $ref: "#/components/headers/X-RateLimit-Reset"
    NotFound:
      description: Die Ressource existiert nicht, oder der Aufrufer hat keinen Zugriff
      content:
        application/problem+json:
          schema:
            $ref: "#/components/schemas/Problem"
          example:
            type: https://api.otark.com/errors/tender_not_found
            title: Ausschreibung nicht gefunden
            status: 404
            error: TENDER_NOT_FOUND
            instance: /v1/tenders/ten_7g4k2m9p
    BadRequest:
      description: Ungültige Anfrage — Validierungsfehler oder Verstoß gegen eine Geschäftsregel; `error` nennt den Grund
      content:
        application/problem+json:
          schema:
            $ref: "#/components/schemas/Problem"
          example:
            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
    Unauthorized:
      description: Fehlender oder ungültiger API-Schlüssel, oder dem Schlüssel fehlt ein erforderlicher Scope (`INSUFFICIENT_SCOPES`)
      content:
        application/problem+json:
          schema:
            $ref: "#/components/schemas/Problem"
          example:
            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."
    Forbidden:
      description: Der Vorgang ist für dieses Unternehmen nicht erlaubt — etwa ohne Verifizierung, für eine fremde Ausschreibung, ohne den nötigen Zugangsstatus oder ohne Freischaltung einer Funktion durch die Otark GmbH
      content:
        application/problem+json:
          schema:
            $ref: "#/components/schemas/Problem"
          example:
            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
    Conflict:
      description: Zustandskonflikt — der Vorgang lässt sich im aktuellen Zustand nicht ausführen
      content:
        application/problem+json:
          schema:
            $ref: "#/components/schemas/Problem"
          example:
            type: https://api.otark.com/errors/tender_admission_deadline_passed
            title: Frist für indikative Angebote abgelaufen
            status: 409
            error: TENDER_ADMISSION_DEADLINE_PASSED
    RateLimited:
      description: Ratenbegrenzung überschritten — die Antwort nennt Grenze und Rücksetzfenster in den Headern
      content:
        application/problem+json:
          schema:
            $ref: "#/components/schemas/Problem"
          example:
            type: https://api.otark.com/errors/rate_limited
            title: Ratenbegrenzung erreicht
            status: 429
  schemas:
    Pagination:
      type: object
      properties:
        limit:
          type: integer
          description: Höchstzahl der Einträge pro Seite
          example: 10
        has_more:
          type: boolean
          description: Ob nach dem letzten gelieferten Eintrag weitere Einträge folgen
          example: true
        next_cursor:
          type: string
          nullable: true
          description: Cursor, der als Query-Parameter `after` übergeben wird, um die nächste Seite abzurufen. Null, wenn keine weiteren Seiten folgen.
          example: ten_off_k8m2p4q7
      required:
        - limit
        - has_more
        - next_cursor
    Problem:
      type: object
      description: Fehlerantwort nach [RFC 9457 — Problem Details for HTTP APIs](https://www.rfc-editor.org/rfc/rfc9457), ergänzt um den Fehlercode der Plattform im Feld `error`.
      properties:
        type:
          type: string
          format: uri
          description: Absolute URI, die die Fehlerklasse bezeichnet
          example: https://api.otark.com/errors/validation
        title:
          type: string
          description: Kurze, lesbare Bezeichnung (bei gleicher Fehlerklasse unverändert)
          example: Validierung fehlgeschlagen
        status:
          type: integer
          description: HTTP-Statuscode
          example: 400
        error:
          type: string
          description: "Maschinenlesbarer Fehlercode der Plattform, etwa `TENDER_ADMISSION_DEADLINE_PASSED`, `TENDER_AUDIENCE_LOCKED`, `TENDER_DEADLINE_OFFERS_LOCKED`, `TENDER_CONSUMPTION_ZIP_REQUIRED`, `SHORTLISTED_ACCESS_REQUIRED` oder `OFFER_MISMATCH`"
          example: TENDER_CONSUMPTION_ZIP_REQUIRED
        detail:
          type: string
          description: Lesbare Erläuterung dieses konkreten Falls
        instance:
          type: string
          description: URI, die die konkrete Anfrage bezeichnet
          example: /v1/tenders/ten_7g4k2m9p
        errors:
          type: array
          description: Feldbezogene Validierungsfehler (nur bei fehlgeschlagener Validierung)
          items:
            $ref: "#/components/schemas/ProblemFieldError"
      required:
        - type
        - title
        - status
    ProblemFieldError:
      type: object
      description: Ein einzelner feldbezogener Validierungsfehler
      properties:
        field:
          type: string
          description: JSON-Pfad des Feldes, das den Fehler ausgelöst hat
          example: deadline_signing
        code:
          type: string
          description: "Maschinenlesbarer Fehlercode: `unknown_field`, `read_only_field`, `required`, `invalid_type`, `invalid_enum_value`, `invalid_format`, `invalid_literal`, `value_too_small`, `value_too_large` oder `validation_failed`"
          example: invalid_format
        message:
          type: string
          description: Lesbare Beschreibung des Fehlers
      required:
        - code
        - message
    ContactPerson:
      type: object
      description: Die Ansprechperson auf Käuferseite, die zugelassene Verkäufer sehen — ein Benutzer des Käuferunternehmens
      properties:
        id:
          type: string
          description: Kennung des Benutzers
          example: usr_3k8m1p5r
        name:
          type: string
          description: Vollständiger Name
          example: Maria Huber
        email:
          type: string
          description: Kontakt-E-Mail-Adresse
          example: energieeinkauf@example.com
      required:
        - id
        - name
        - email
    AdditionalField:
      type: object
      description: Ein strukturiertes Paar aus Bezeichnung und Wert, nur für zugelassene Verkäufer sichtbar
      properties:
        label:
          type: string
          description: Bezeichnung des Feldes (bis zu 200 Zeichen)
          example: "Min. Netzanschluss"
        value:
          type: string
          description: Wert des Feldes (bis zu 5.000 Zeichen)
          example: "110 kV"
      required:
        - label
        - value
    TenderDelivery:
      type: object
      description: Die physische Lieferung. Der Verkäufer liefert nach dem PPA direkt in den Bilanzkreis des Käufers oder seines Stromlieferanten; einen anderen Lieferweg gibt es nicht
      properties:
        current_supplier_id:
          type: string
          nullable: true
          description: Der aktuelle Stromlieferant des Käufers, als Marktakteur aus dem MaStR (bis zu 64 Zeichen). Entfällt, wenn der Käufer selbst Versorger ist. Zugelassene Verkäufer sehen den Namen
          example: SNB912345678901
        buyer_is_own_supplier:
          type: boolean
          nullable: true
          description: Der Käufer versorgt sich selbst mit Reststrom; dann braucht es keinen Stromlieferanten
          example: false
        current_supplier_contact_name:
          type: string
          nullable: true
          description: Ansprechperson beim Stromlieferanten (bis zu 200 Zeichen), freiwillig
        current_supplier_contact_email:
          type: string
          nullable: true
          description: E-Mail der Ansprechperson (bis zu 200 Zeichen), freiwillig
        current_supplier_contact_phone:
          type: string
          nullable: true
          description: Telefon der Ansprechperson (bis zu 64 Zeichen), freiwillig
        notes:
          type: string
          nullable: true
          description: Hinweise zur Lieferung (bis zu 5.000 Zeichen), freiwillig
        seeking_new_supplier:
          type: string
          nullable: true
          description: Ob der Käufer den Stromlieferanten für den Reststrom wechseln will. Die Angabe sieht nur die Otark GmbH, kein Verkäufer
          enum:
            - "yes"
            - "no"
            - undecided
          example: undecided
    ScoringRange:
      type: object
      description: Linearer Bewertungsbereich eines Kriteriums — der Wert für 100 und der für 0 Punkte. Null heißt nicht gesetzt; dann gilt der Standardbereich des Kriteriums
      properties:
        best:
          type: number
          nullable: true
          description: Wert, der 100 Punkte ergibt
          example: 60
        worst:
          type: number
          nullable: true
          description: Wert, der 0 Punkte ergibt
          example: 90
      required:
        - best
        - worst
    ScoringBucket:
      type: object
      description: K.-o.-Schwelle und Bewertungsbereich für eine Technologie
      properties:
        ko_enabled:
          type: boolean
          description: Ob die K.-o.-Schwelle gilt
        ko_threshold:
          type: number
          nullable: true
          description: Schwellwert, ab dem das Angebot ausscheidet
        range:
          $ref: "#/components/schemas/ScoringRange"
      required:
        - ko_enabled
        - range
    ScoringCriterionConfig:
      type: object
      description: K.-o.-Schwelle und Bewertungsbereich eines Kriteriums
      properties:
        ko_enabled:
          type: boolean
          description: Ob die K.-o.-Schwelle gilt. Ein Kriterium mit Gewicht 0 schließt nie aus
          example: true
        ko_threshold:
          type: number
          nullable: true
          description: Schwellwert, ab dem das Angebot ausscheidet
          example: 3.0
        range:
          $ref: "#/components/schemas/ScoringRange"
        per_tech:
          type: object
          description: "Getrennte Werte für Solar und Wind; nur bei `effective`, `ppa_price`, `capture` und `benchmark`"
          properties:
            enabled:
              type: boolean
              description: Ob die getrennten Werte gelten
            solar:
              $ref: "#/components/schemas/ScoringBucket"
            wind:
              $ref: "#/components/schemas/ScoringBucket"
          required:
            - enabled
      required:
        - ko_enabled
        - range
    ScoringConfig:
      type: object
      description: "Die Bewertungskriterien der Ausschreibung. Kriterien: `effective` (Effektivkosten), `ppa_price` (PPA-Preis), `capture` (Capture Rate), `benchmark` (Markt-Benchmark), `go_price` (HKN-Preis), `matching` (Verbrauchsmatching), `creditworthiness` (Bonität des Verkäufers), `distance` (Regionalität). Verkäufer sehen die Kriterien nie"
      properties:
        template_id:
          type: string
          nullable: true
          description: Kennung der gewählten Vorlage; null oder `custom`, wenn der Käufer die Gewichte selbst gesetzt hat
          example: industrial
        weights:
          type: object
          description: Gewicht je Kriterium, 0 bis 100. Die Gewichte sind Anteile zueinander und müssen nicht 100 ergeben; mindestens eines liegt über 0. Ein Kriterium mit Gewicht 0 ist abgeschaltet
          additionalProperties:
            type: integer
            minimum: 0
            maximum: 100
          example:
            effective: 40
            ppa_price: 20
            capture: 10
            matching: 30
            creditworthiness: 10
            benchmark: 5
            distance: 0
            go_price: 0
        config:
          type: object
          nullable: true
          description: K.-o.-Schwelle und Bewertungsbereich je Kriterium; fehlt ein Kriterium, gelten seine Standardwerte
          additionalProperties:
            $ref: "#/components/schemas/ScoringCriterionConfig"
      required:
        - weights
    TenderInput:
      type: object
      description: Die Felder einer Ausschreibung, die der Käufer setzt
      properties:
        name:
          type: string
          nullable: true
          description: Interner Name (bis zu 200 Zeichen). Verkäufer sehen ihn nie. Ein Entwurf darf ohne Namen gespeichert werden; zum Einreichen ist er Pflicht
          example: Grünstrom Werk Süd 2027
        public_name:
          type: string
          nullable: true
          description: Öffentlicher Name für Verkäufer (bis zu 100 Zeichen). Ohne ihn sehen Verkäufer einen Namen aus Technologie und Bundesland; ist er gesetzt, bleibt das Bundesland bis zur Zulassung verborgen
          example: null
        energy_type:
          type: string
          description: Angefragte Energiequelle; `mixed` nimmt je Technologie ein eigenes Angebot entgegen
          enum:
            - solar
            - wind
            - mixed
          example: mixed
        solar_volume_per_year:
          type: number
          nullable: true
          description: Angefragte Solarmenge in MWh pro Jahr (bis zu 3 Nachkommastellen) — über 0, wenn `energy_type` Solar einschließt
          example: 30000.000
        wind_volume_per_year:
          type: number
          nullable: true
          description: Angefragte Windmenge in MWh pro Jahr (bis zu 3 Nachkommastellen) — über 0, wenn `energy_type` Wind einschließt
          example: 20000.000
        solar_nominal_power_mw:
          type: number
          nullable: true
          description: Indikative Solarleistung in MW — ein Größenhinweis für Verkäufer, keine Vorgabe
          example: 30.0
        wind_nominal_power_mw:
          type: number
          nullable: true
          description: Indikative Windleistung in MW — ein Größenhinweis für Verkäufer, keine Vorgabe
          example: 10.0
        solar_target_price_per_mwh:
          type: number
          nullable: true
          description: Interner Wunschpreis des Käufers für Solar in EUR/MWh — Verkäufern nie gezeigt
          example: 55.00
        wind_target_price_per_mwh:
          type: number
          nullable: true
          description: Interner Wunschpreis des Käufers für Wind in EUR/MWh — Verkäufern nie gezeigt
          example: 65.00
        delivery_start:
          type: string
          format: date
          description: Angefragter Lieferbeginn (`YYYY-MM-DD`)
          example: "2027-01-01"
        contract_years_min:
          type: integer
          minimum: 1
          maximum: 30
          description: Mindestlaufzeit des Vertrags in Jahren; Angebote müssen innerhalb der Spanne bleiben
          example: 5
        contract_years_max:
          type: integer
          minimum: 1
          maximum: 30
          description: Höchste Vertragslaufzeit in Jahren, nicht unter der Mindestlaufzeit
          example: 10
        consumption_zip:
          type: string
          nullable: true
          description: Postleitzahl des Verbrauchsorts (vier oder fünf Ziffern), vorbelegt mit der Postleitzahl der Firmenadresse. Pflicht zum Einreichen; die Regionalität misst die Entfernung zu ihr
          example: "84028"
        delivery_profiles:
          type: array
          description: Lieferprofile, die der Käufer zulässt (Mehrfachauswahl). Voreinstellung bei einer neuen Ausschreibung ist `pay_as_forecasted`
          items:
            type: string
            enum:
              - baseload
              - pay_as_forecasted
              - pay_as_produced
              - shaped
              - pay_as_indexed
              - pay_as_consumed
          example:
            - pay_as_forecasted
            - pay_as_indexed
        delivery_profile:
          type: string
          nullable: true
          description: Das bevorzugte Profil innerhalb von `delivery_profiles`; der Verkäufer bleibt im Angebot frei
          enum:
            - baseload
            - pay_as_forecasted
            - pay_as_produced
            - shaped
            - pay_as_indexed
            - pay_as_consumed
          example: pay_as_forecasted
        delivery:
          $ref: "#/components/schemas/TenderDelivery"
        recipients:
          type: string
          description: "Empfängerkreis: alle Verkäufer (`public`, Voreinstellung) oder nur eingeladene Verkäufer (`invite_only`). `invite_only` sowie Einladungs- und Ausschlussliste gibt es nur, wenn die Otark GmbH das Unternehmen dafür freigeschaltet hat; dann ist `invite_only` voreingestellt. Ohne Freischaltung antwortet die API mit `TENDER_RECIPIENT_RESTRICTION_NOT_ALLOWED`"
          enum:
            - public
            - invite_only
          example: public
        invited_company_ids:
          type: array
          description: Einladungsliste — Unternehmen, die mit der Veröffentlichung eine Einladung erhalten. Nur mit Freischaltung durch die Otark GmbH und nur im Entwurf änderbar (`TENDER_AUDIENCE_LOCKED`)
          items:
            type: string
          example: []
        excluded_company_ids:
          type: array
          description: Ausschlussliste — Unternehmen, die die Ausschreibung nicht sehen. Nur mit Freischaltung durch die Otark GmbH und nur im Entwurf änderbar (`TENDER_AUDIENCE_LOCKED`)
          items:
            type: string
          example: []
        anonymous_until_admission:
          type: boolean
          description: "Den Käufer bis zur Zulassung verbergen (Voreinstellung `true`). Gegenüber jedem Verkäufer, auch einem eingeladenen, bleibt der Käufer bis zur Zulassung anonym. `false` ist nur bei `public` möglich und nur, wenn die Otark GmbH das Unternehmen dafür freigeschaltet hat (sonst `ANONYMITY_OVERRIDE_NOT_ALLOWED`); dann erscheinen Name und Logo des Käufers in der täglichen E-Mail-Zusammenstellung neuer Ausschreibungen, während Tender Inbox und Ausschreibung anonym bleiben"
          example: true
        public_description:
          type: string
          nullable: true
          description: Öffentlicher Kurztext in der Tender Inbox (bis zu 500 Zeichen), sichtbar auch, solange der Käufer anonym ist
          example: "Industrieller Verbraucher in Bayern sucht 50 GWh/a Solar und Wind ab 2027, 5–10 Jahre."
        restricted_description:
          type: string
          nullable: true
          description: Detailbeschreibung (bis zu 5.000 Zeichen), nur für zugelassene Verkäufer sichtbar
          example: "Standort Werk Süd, 110-kV-Anschluss."
        additional_fields:
          type: array
          description: Eigene Felder, nur für zugelassene Verkäufer sichtbar
          items:
            $ref: "#/components/schemas/AdditionalField"
        contact_person_id:
          type: string
          nullable: true
          description: Der Benutzer des Käuferunternehmens, den zugelassene Verkäufer als Ansprechperson sehen; voreingestellt ist der Benutzer, der die Ausschreibung anlegt
          example: usr_3k8m1p5r
        scoring:
          $ref: "#/components/schemas/ScoringConfig"
        load_profile_skipped:
          type: boolean
          description: Der Käufer verzichtet auf einen Lastgang; dann entfällt das Verbrauchsmatching für alle Angebote
          example: false
        planned_publication_at:
          type: string
          format: date-time
          nullable: true
          description: Geplante Veröffentlichung (ISO 8601 UTC); bleibt sie weg, wird mit der Freigabe veröffentlicht. Sie darf nicht nach dem Tag der Frist für indikative Angebote liegen (`PUBLICATION_DEADLINE_CONFLICT`)
          example: "2026-09-01T07:00:00Z"
        deadline_offers:
          type: string
          format: date
          description: "Frist für indikative Angebote (`YYYY-MM-DD`), ein Zieldatum. Bis einschließlich dieses Tages können Verkäufer Zugang anfragen und der Käufer kann einladen; danach nicht mehr. Zugelassene Verkäufer können auch danach Angebote abgeben. Fristen sind Kalendertage und enden mit dem Tag nach Europe/Berlin. Vorschlag beim Anlegen: heute + 7 Tage, bei früherem Lieferbeginn spätestens zwei Tage davor"
          example: "2026-10-13"
        deadline_signing:
          type: string
          format: date
          description: "Geplanter PPA-Abschluss (`YYYY-MM-DD`), nach der Frist für indikative Angebote und vor dem Lieferbeginn. Verstreicht er, während die Ausschreibung aktiv ist, schließt die Plattform sie als abgelaufen. Vorschlag beim Anlegen: heute + 21 Tage, bei früherem Lieferbeginn ein Tag davor"
          example: "2026-11-24"
    Tender:
      description: Eine Ausschreibung in der Sicht des Käufers
      allOf:
        - $ref: "#/components/schemas/TenderInput"
        - type: object
          properties:
            id:
              type: string
              description: Eindeutige Kennung der Ausschreibung
              example: ten_7g4k2m9p
            status:
              type: string
              description: "Status der Ausschreibung. `draft`: Entwurf, kein Verkäufer sieht ihn. `in_review`: zur Prüfung eingereicht. `active`: freigegeben — mit `published_at` in der Zukunft ist die Ausschreibung geplant und für Verkäufer noch unsichtbar, sonst veröffentlicht. `closed`: geschlossen, durch den ersten erfassten PPA, den verstrichenen Geplanten PPA-Abschluss, `close` oder `cancel`"
              enum:
                - draft
                - in_review
                - active
                - closed
              example: active
            country_code:
              type: string
              description: Land, aus der Adresse des Käuferunternehmens übernommen — nicht änderbar
              example: DE
            state:
              type: string
              nullable: true
              description: Bundesland, aus der Adresse des Käuferunternehmens übernommen — nicht änderbar
              example: Bayern
            contact_person:
              $ref: "#/components/schemas/ContactPerson"
            load_profile_status:
              type: string
              description: Stand des Lastgang-Imports, Werte wie in `LoadProfileImport.status`
              enum:
                - none
                - pending
                - importing
                - complete
                - partial
                - failed
              example: complete
            approved_at:
              type: string
              format: date-time
              nullable: true
              description: Zeitpunkt der Freigabe durch die Otark GmbH (ISO 8601 UTC); mit einer Freigabe braucht eine erneute Veröffentlichung keine zweite Prüfung
              example: "2026-08-26T10:00:00Z"
            published_at:
              type: string
              format: date-time
              nullable: true
              description: Veröffentlichungszeitpunkt (ISO 8601 UTC); vor der Freigabe null
              example: "2026-09-01T07:00:00Z"
            created_at:
              type: string
              format: date-time
              description: Zeitpunkt der Anlage (ISO 8601 UTC)
              example: "2026-08-18T10:15:00Z"
            updated_at:
              type: string
              format: date-time
              description: Zeitpunkt der letzten Änderung (ISO 8601 UTC)
              example: "2026-09-01T07:00:00Z"
          required:
            - id
            - status
            - energy_type
            - delivery_start
            - contract_years_min
            - contract_years_max
            - recipients
            - created_at
            - updated_at
    TenderCreated:
      type: object
      properties:
        id:
          type: string
          description: Kennung der angelegten Ausschreibung
          example: ten_7g4k2m9p
      required:
        - id
    TenderStatusResult:
      type: object
      properties:
        status:
          type: string
          description: Der neue Status der Ausschreibung
          enum:
            - draft
            - in_review
            - active
            - closed
          example: in_review
      required:
        - status
    TenderList:
      type: object
      properties:
        tenders:
          type: array
          description: Die Ausschreibungen des Käuferunternehmens
          items:
            $ref: "#/components/schemas/Tender"
        pagination:
          $ref: "#/components/schemas/Pagination"
      required:
        - tenders
        - pagination
    InboxTender:
      type: object
      description: Eine Ausschreibung, wie ein Verkäufer sie in der Tender Inbox sieht — der Käufer bleibt bis zur Zulassung anonym, auch bei einer Einladung
      properties:
        id:
          type: string
          description: Kennung der Ausschreibung
          example: ten_7g4k2m9p
        display_name:
          type: string
          description: Der öffentliche Name, den der Käufer gesetzt hat, sonst ein Name aus Technologie und Bundesland — nie der interne Name des Käufers
          example: Solar + Wind PPA - Bayern
        energy_type:
          type: string
          description: Angefragte Energiequelle
          enum:
            - solar
            - wind
            - mixed
          example: mixed
        solar_volume_per_year:
          type: number
          nullable: true
          description: Angefragte Solarmenge in MWh pro Jahr
          example: 30000.000
        wind_volume_per_year:
          type: number
          nullable: true
          description: Angefragte Windmenge in MWh pro Jahr
          example: 20000.000
        solar_nominal_power_mw:
          type: number
          nullable: true
          description: Indikative Solarleistung in MW
          example: 30.0
        wind_nominal_power_mw:
          type: number
          nullable: true
          description: Indikative Windleistung in MW
          example: 10.0
        delivery_start:
          type: string
          format: date
          description: Angefragter Lieferbeginn (`YYYY-MM-DD`)
          example: "2027-01-01"
        contract_years_min:
          type: integer
          description: Mindestlaufzeit des Vertrags in Jahren
          example: 5
        contract_years_max:
          type: integer
          description: Höchste Vertragslaufzeit in Jahren
          example: 10
        delivery_profile:
          type: string
          nullable: true
          description: Das bevorzugte Lieferprofil des Käufers
          enum:
            - baseload
            - pay_as_forecasted
            - pay_as_produced
            - shaped
            - pay_as_indexed
            - pay_as_consumed
          example: pay_as_forecasted
        deadline_offers:
          type: string
          format: date
          description: Frist für indikative Angebote (`YYYY-MM-DD`); bis einschließlich dieses Tages lässt sich Zugang anfragen
          example: "2026-10-13"
        published_at:
          type: string
          format: date-time
          description: Veröffentlichungszeitpunkt (ISO 8601 UTC)
          example: "2026-09-01T07:00:00Z"
        public_description:
          type: string
          nullable: true
          description: Der öffentliche Kurztext des Käufers (bis zu 500 Zeichen)
          example: "Industrieller Verbraucher in Bayern sucht 50 GWh/a Solar und Wind ab 2027, 5–10 Jahre."
        state:
          type: string
          nullable: true
          description: Bundesland des Käufers; null, wenn der Käufer einen öffentlichen Namen gesetzt hat
          example: Bayern
        load_profile_available:
          type: boolean
          description: Ob ein Lastgang vorliegt (sein Inhalt öffnet sich mit der Zulassung)
          example: true
        buyer:
          type: object
          description: Was ein Verkäufer vor der Zulassung vom Käufer sieht
          properties:
            credit_rating:
              type: number
              nullable: true
              description: Bonitätsindex des Käufers von 1,0 (beste) bis 6,0
              example: 1.5
            industry:
              type: string
              nullable: true
              description: Branche aus dem Unternehmensprofil des Käufers, sofern angegeben
              example: manufacturing
          required:
            - credit_rating
            - industry
      required:
        - id
        - display_name
        - energy_type
        - delivery_start
        - contract_years_min
        - contract_years_max
        - deadline_offers
        - published_at
        - buyer
    InboxTenderList:
      type: object
      properties:
        tenders:
          type: array
          description: Die Ausschreibungen in der Tender Inbox des Verkäufers, die neueste zuerst
          items:
            $ref: "#/components/schemas/InboxTender"
        pagination:
          $ref: "#/components/schemas/Pagination"
      required:
        - tenders
        - pagination
    SellerCompany:
      type: object
      description: Das Verkäuferunternehmen, wie der Käufer es sieht — Verkäufer sind gegenüber dem Käufer nie anonym
      properties:
        id:
          type: string
          description: Unternehmenskennung
          example: com_9k3m7p2r
        name:
          type: string
          description: Name des Unternehmens
          example: Solar Nord
        founded_year:
          type: integer
          nullable: true
          description: Gründungsjahr aus dem Unternehmensprofil
          example: 2019
        portfolio_mw:
          type: number
          nullable: true
          description: Portfoliogröße in MW aus dem Unternehmensprofil
          example: 85.0
        credit_rating:
          type: number
          nullable: true
          description: Bonitätsindex des Verkäufers von 1,0 (beste) bis 6,0
          example: 1.8
      required:
        - id
        - name
    TenderAccess:
      type: object
      description: Die Zugangsbeziehung zwischen einer Ausschreibung und einem Verkäuferunternehmen — entstanden aus einer Zugangsanfrage oder einer Einladung
      properties:
        id:
          type: string
          description: Kennung des Zugangs
          example: ten_acc_2f6h9k3m
        tender_id:
          type: string
          description: Kennung der Ausschreibung
          example: ten_7g4k2m9p
        seller_company:
          $ref: "#/components/schemas/SellerCompany"
        status:
          type: string
          description: "Zugangsstatus. `invited`: Der Käufer hat eingeladen, der Verkäufer hat noch keinen Zugang angefragt. `requested`: Die Anfrage liegt beim Käufer. `approved`: zugelassen — Name und Unternehmensdaten des Käufers, Lastgang, Detailbeschreibung, eigene Felder, Anhänge und der Nachrichtenkanal stehen offen, indikative Angebote sind möglich. `shortlisted`: auf der Shortlist — zusätzlich der Datenraum, und der Käufer kann Angebote annehmen. `denied`: Anfrage abgelehnt oder Zugang entzogen. `cancelled`: Der Verkäufer hat seine Anfrage zurückgezogen oder die Ausschreibung verlassen"
          enum:
            - invited
            - requested
            - approved
            - shortlisted
            - denied
            - cancelled
          example: approved
        origin:
          type: string
          description: Wie die Beziehung begonnen hat — bleibt über alle späteren Statuswechsel hinweg unverändert
          enum:
            - application
            - invitation
          example: application
        request_message:
          type: string
          nullable: true
          description: Die freiwillige Nachricht des Verkäufers zu seiner Zugangsanfrage (bis zu 2.000 Zeichen)
          example: "Solarpark in Niederbayern, 30 MW, seit 2024 in Betrieb, Erzeugungsdaten liegen vor."
        response_message:
          type: string
          nullable: true
          description: Die Antwort des Käufers auf die Anfrage (bis zu 2.000 Zeichen); sie steht in der E-Mail an den Verkäufer, nicht im Nachrichtenkanal
          example: "Bitte bis zur Frist auch das Erzeugungsprofil hochladen."
        anchor_offer_ids:
          type: array
          description: Die Angebote, auf denen der Eintrag in der Shortlist beruht (nur bei `shortlisted`, freiwillig)
          items:
            type: string
          example: []
        requested_at:
          type: string
          format: date-time
          nullable: true
          description: Zeitpunkt der Zugangsanfrage (ISO 8601 UTC)
          example: "2026-09-05T08:42:00Z"
        admitted_at:
          type: string
          format: date-time
          nullable: true
          description: Zeitpunkt der ersten Zulassung (ISO 8601 UTC); bleibt erhalten, wenn der Zugang später endet. Ein einmal offengelegter Käufername bleibt für den Verkäufer sichtbar
          example: "2026-09-08T09:12:00Z"
        created_at:
          type: string
          format: date-time
          description: Zeitpunkt der Anlage (ISO 8601 UTC)
          example: "2026-09-05T08:42:00Z"
        updated_at:
          type: string
          format: date-time
          description: Zeitpunkt der letzten Änderung (ISO 8601 UTC)
          example: "2026-09-08T09:12:00Z"
      required:
        - id
        - tender_id
        - seller_company
        - status
        - origin
        - created_at
        - updated_at
    TenderAccessList:
      type: object
      properties:
        accesses:
          type: array
          description: Zugangsbeziehungen der Ausschreibung
          items:
            $ref: "#/components/schemas/TenderAccess"
        pagination:
          $ref: "#/components/schemas/Pagination"
      required:
        - accesses
        - pagination
    InvitationResult:
      type: object
      description: Das Ergebnis einer Einladung je Unternehmen
      properties:
        invited:
          type: array
          description: Eingeladene Unternehmen
          items:
            type: string
          example:
            - com_5t8v2w6y
        skipped:
          type: array
          description: Übersprungene Unternehmen — sie haben schon einen Zugang oder stehen auf der Ausschlussliste
          items:
            type: string
          example: []
        ineligible:
          type: array
          description: Nicht einladbare Unternehmen — unbekannt, nicht verifiziert oder das eigene Unternehmen
          items:
            type: string
          example: []
      required:
        - invited
        - skipped
        - ineligible
    OfferAsset:
      type: object
      description: Eine Erzeugungsanlage, die ein Angebot unterlegt
      properties:
        id:
          type: string
          description: Kennung der Anlage
          example: ast_1w4y7z2c
        name:
          type: string
          description: Name der Anlage
          example: Solarpark Niederbayern
        mastr_number:
          type: string
          nullable: true
          description: MaStR-Einheitennummer der Anlage
          example: SEE931570002846
        technology:
          type: string
          description: Erzeugungstechnologie
          enum:
            - solar
            - wind
          example: solar
        capacity_mw:
          type: number
          nullable: true
          description: Installierte Leistung in MW
          example: 30.0
      required:
        - id
        - name
        - technology
    CriterionScore:
      type: object
      description: Die Bewertung eines Kriteriums für ein Angebot
      properties:
        key:
          type: string
          description: "Kennung des Kriteriums: Effektivkosten, PPA-Preis, Capture Rate, Markt-Benchmark, HKN-Preis, Verbrauchsmatching, Bonität, Regionalität (Entfernung)"
          enum:
            - effective
            - ppa_price
            - capture
            - benchmark
            - go_price
            - matching
            - creditworthiness
            - distance
          example: capture
        value:
          type: number
          nullable: true
          description: Rohwert des Kriteriums in seiner natürlichen Einheit (etwa Capture Rate in Prozent, Entfernung in km); null, wenn die Kennzahl nicht vorliegt
          example: 86.0
        score:
          type: number
          nullable: true
          description: Punkte 0–100 nach der linearen Abbildung zwischen bestem und schlechtestem Wert aus der Bewertungskonfiguration der Ausschreibung; null, wenn kein Wert vorliegt
        missing:
          type: string
          nullable: true
          description: "Warum der Wert fehlt: `buyer`, wenn die Lücke aus der Ausschreibung stammt (etwa kein Lastgang), `seller`, wenn sie aus dem Angebot stammt (etwa kein Erzeugungsprofil). Null, wenn ein Wert vorliegt"
          enum:
            - buyer
            - seller
          example: null
      required:
        - key
        - value
        - score
    OfferScore:
      type: object
      description: Die Bewertung eines Angebots gegen die Bewertungskriterien der Ausschreibung. Nur in der Sicht des Käufers — ein Verkäufer sieht weder Rang noch Punkte
      properties:
        composite:
          type: number
          nullable: true
          description: Gewichteter Gesamtscore 0–100 über die Kriterien mit Gewicht über 0 und vorhandenem Wert; null, wenn das Angebot ausgeschieden ist oder kein Kriterium einen Wert trägt
          example: 76
        rating:
          type: string
          description: "Bewertungsstufe aus dem gerundeten Gesamtscore: `highly_recommended` ab 80 (Sehr empfehlenswert), `recommended` ab 50 (Empfehlenswert), `moderate` darunter (Mäßig); `limited`, wenn kein Kriterium einen Wert trägt (Eingeschränkt); `ko`, wenn ein aktives K.-o.-Kriterium die Bewertung beendet hat. Sind weniger als 90 % der Gewichte belegt, ist das Angebot nicht bewertbar. Ist weniger als die Hälfte der dem Verkäufer zurechenbaren Gewichte belegt, wird `highly_recommended` auf `recommended` begrenzt"
          enum:
            - highly_recommended
            - recommended
            - moderate
            - limited
            - ko
          example: recommended
        ko:
          type: boolean
          description: Gesetzt, wenn mindestens ein K.-o.-Kriterium seinen Schwellwert verletzt hat
          example: false
        ko_criteria:
          type: array
          description: Kennungen der Kriterien, an denen das Angebot gescheitert ist; leer, wenn `ko` nicht gesetzt ist
          items:
            type: string
          example: []
        completeness:
          type: number
          nullable: true
          description: Anteil der konfigurierten Gewichte, für den Daten vorlagen, 0–1
          example: 1
        seller_completeness:
          type: number
          nullable: true
          description: Anteil der dem Verkäufer zurechenbaren Gewichte, für den Daten vorlagen, 0–1 — Lücken auf Käuferseite bleiben außer Betracht
          example: 1
        criteria:
          type: array
          description: Werte und Punkte je Kriterium
          items:
            $ref: "#/components/schemas/CriterionScore"
      required:
        - composite
        - rating
        - ko
        - criteria
    PeriodDiscount:
      type: object
      description: Der Abschlag eines Lieferzeitraums bei `pricing_model` `discount`
      properties:
        key:
          type: string
          description: "Lieferzeitraum als EEX-Base-Future: ein Kalenderjahr (`cal-YYYY`) oder bei einem angebrochenen Jahr ein Quartal (`qN-YYYY`)"
          example: cal-2027
        discount_percent:
          type: number
          description: Abschlag auf den Future des Zeitraums in Prozent, zwischen −100 und 100 (ausschließlich), 2 Nachkommastellen. Positiv ist ein Abschlag, negativ ein Aufschlag
          example: 36.0
      required:
        - key
        - discount_percent
    YearPrice:
      type: object
      description: Der Energiepreis eines Kalenderjahres bei `pricing_model` `fixed` und `price_schedule` `per_period`
      properties:
        year:
          type: integer
          description: Kalenderjahr
          example: 2027
        price_per_mwh:
          type: number
          description: Energiepreis in EUR/MWh, über 0 und unter 10.000 (bis zu 4 Nachkommastellen)
          example: 54.50
      required:
        - year
        - price_per_mwh
    PricePeriod:
      type: object
      description: Ein Lieferzeitraum eines Angebots mit seinem Preis
      properties:
        key:
          type: string
          description: Lieferzeitraum (`cal-YYYY` oder `qN-YYYY`)
          example: cal-2027
        period_start:
          type: string
          format: date
          description: Erster Tag des Zeitraums innerhalb der Laufzeit (`YYYY-MM-DD`)
          example: "2027-01-01"
        period_end:
          type: string
          format: date
          description: Letzter Tag des Zeitraums innerhalb der Laufzeit (`YYYY-MM-DD`)
          example: "2027-12-31"
        partial:
          type: boolean
          description: Ob der Zeitraum nur einen Teil seines Jahres oder Quartals abdeckt
          example: false
        discount_percent:
          type: number
          nullable: true
          description: Abschlag in Prozent (nur bei `discount`)
          example: 36.0
        future_price:
          type: number
          nullable: true
          description: Abrechnungspreis des Futures in EUR/MWh, auf dem der Preis beruht (nur bei `discount`); mit der Annahme festgeschrieben
          example: 85.00
        price_per_mwh:
          type: number
          nullable: true
          description: "Energiepreis des Zeitraums in EUR/MWh; bei `discount` gilt Future × (1 − Abschlag / 100)"
          example: 54.40
      required:
        - key
        - period_start
        - period_end
    OfferPricingInput:
      type: object
      description: Die Preisangaben eines Angebots
      properties:
        pricing_model:
          type: string
          description: "Preismodell: `fixed` (Fixpreis) oder `discount` (Abschlag auf den EEX-Base-Future je Lieferzeitraum)"
          enum:
            - fixed
            - discount
          example: fixed
        price_schedule:
          type: string
          description: "Wie der Energiepreis über die Laufzeit abgerechnet wird: `flat` (ein einheitlicher Preis, das mengengewichtete Mittel der Zeiträume, Voreinstellung) oder `per_period` (jeder Zeitraum zu seinem eigenen Preis)"
          enum:
            - flat
            - per_period
          example: flat
        price_per_mwh:
          type: number
          description: Energiepreis in EUR/MWh (bis zu 4 Nachkommastellen) — Pflicht bei `fixed` mit `flat`. Bei `discount` und bei `per_period` errechnet die Plattform den Wert als mengengewichtetes Mittel
          example: 54.50
        period_discounts:
          type: array
          description: Bei `discount` Pflicht — ein Abschlag je Lieferzeitraum der Laufzeit. Für jeden Zeitraum muss ein EEX-Future notiert sein (`OFFER_TERM_OUTSIDE_EEX_HORIZON`, `OFFER_PERIOD_DISCOUNT_MISSING`)
          items:
            $ref: "#/components/schemas/PeriodDiscount"
        year_prices:
          type: array
          description: Bei `fixed` mit `per_period` Pflicht — ein Preis je Kalenderjahr der Laufzeit (`OFFER_YEAR_PRICE_MISSING`)
          items:
            $ref: "#/components/schemas/YearPrice"
        price_per_go:
          type: number
          description: Preis je HKN in EUR/MWh, getrennt vom Energiepreis (bis zu 4 Nachkommastellen); Pflicht, 0 ist zulässig
          example: 0.80
    OfferSubmission:
      description: Anfrage-Body für die Abgabe eines indikativen Angebots oder einer Revision
      allOf:
        - $ref: "#/components/schemas/OfferPricingInput"
        - type: object
          properties:
            technology:
              type: string
              description: Eine Technologie je Angebot — bei einer gemischten Ausschreibung geben Sie Solar und Wind getrennt ab
              enum:
                - solar
                - wind
              example: solar
            start_date:
              type: string
              format: date
              description: Lieferbeginn (`YYYY-MM-DD`); nicht vor dem Lieferbeginn der Ausschreibung
              example: "2027-01-01"
            contract_years:
              type: integer
              minimum: 1
              maximum: 30
              description: Vertragslaufzeit in Jahren, innerhalb der Spanne der Ausschreibung
              example: 10
            end_date:
              type: string
              format: date
              description: Genaues, einschließendes Enddatum bei abweichender Laufzeit; entfällt, wenn `contract_years` gilt
            delivery_profile:
              type: string
              description: Angebotenes Lieferprofil
              enum:
                - baseload
                - pay_as_forecasted
                - pay_as_produced
                - shaped
                - pay_as_indexed
                - pay_as_consumed
              example: pay_as_forecasted
            price_index:
              type: string
              description: Abrechnungsindex bei Pay as Indexed
              enum:
                - enwex_solar
                - enwex_wind
            volume_per_year:
              type: number
              description: Angebotene Menge in MWh pro Jahr, über 0 (bis zu 3 Nachkommastellen)
              example: 31500.000
            capacity_mw:
              type: number
              description: Installierte Leistung, die das Angebot unterlegt, in MW, über 0
              example: 30.0
            offer_message:
              type: string
              description: Anmerkungen (bis zu 2.000 Zeichen)
              example: "Profil 2023–2025 ist die reale Einspeisung."
            asset_ids:
              type: array
              description: Erzeugungsanlagen der angebotenen Technologie, mindestens eine, höchstens 100 (`OFFER_ASSETS_INVALID`)
              items:
                type: string
              example:
                - ast_1w4y7z2c
          required:
            - technology
            - start_date
            - contract_years
            - delivery_profile
            - volume_per_year
            - capacity_mw
            - pricing_model
            - price_per_go
            - asset_ids
    Offer:
      description: Ein indikatives Angebot. Abgegebene Angebote sind unveränderlich; eine Revision erzeugt ein neues Angebot und zieht das alte zurück
      allOf:
        - $ref: "#/components/schemas/OfferPricingInput"
        - type: object
          properties:
            id:
              type: string
              description: Kennung des Angebots
              example: ten_off_8m2p6r9t
            tender_id:
              type: string
              description: Kennung der Ausschreibung
              example: ten_7g4k2m9p
            seller_company_id:
              type: string
              description: Das Verkäuferunternehmen, das das Angebot abgegeben hat
              example: com_9k3m7p2r
            technology:
              type: string
              description: Technologie des Angebots
              enum:
                - solar
                - wind
              example: solar
            status:
              type: string
              description: "Status des Angebots. `submitted`: für den Käufer sichtbar. `declined`: vom Käufer abgelehnt. `withdrawn`: vom Verkäufer zurückgezogen, durch eine Revision ersetzt oder beim Verlassen der Ausschreibung zurückgezogen. Ob der Käufer das Angebot angenommen hat, zeigt `accepted_at`"
              enum:
                - submitted
                - declined
                - withdrawn
              example: submitted
            accepted_at:
              type: string
              format: date-time
              nullable: true
              description: Zeitpunkt der Annahme durch den Käufer (ISO 8601 UTC). Ein angenommenes Angebot ist unveränderlich; die Annahme ist kein Vertrag
              example: null
            start_date:
              type: string
              format: date
              description: Lieferbeginn des Angebots (`YYYY-MM-DD`)
              example: "2027-01-01"
            contract_years:
              type: integer
              description: Vertragslaufzeit in Jahren
              example: 10
            end_date:
              type: string
              format: date
              nullable: true
              description: Genaues, einschließendes Enddatum bei abweichender Laufzeit; null, wenn `contract_years` gilt
              example: null
            delivery_profile:
              type: string
              description: Angebotenes Lieferprofil
              enum:
                - baseload
                - pay_as_forecasted
                - pay_as_produced
                - shaped
                - pay_as_indexed
                - pay_as_consumed
              example: pay_as_forecasted
            price_index:
              type: string
              nullable: true
              description: Abrechnungsindex bei Pay as Indexed; sonst null
              enum:
                - enwex_solar
                - enwex_wind
              example: null
            volume_per_year:
              type: number
              description: Angebotene Menge in MWh pro Jahr
              example: 31500.000
            capacity_mw:
              type: number
              description: Installierte Leistung, die das Angebot unterlegt, in MW
              example: 30.0
            discount_percent:
              type: number
              nullable: true
              description: Bei `discount` der effektive, mengengewichtete Abschlag über die Laufzeit in Prozent; sonst null
              example: null
            price_periods:
              type: array
              description: Die Lieferzeiträume der Laufzeit mit ihrem Preis. Bei `discount` rechnet die Plattform die Preise bis zur Annahme mit dem jeweils letzten Abrechnungspreis neu und schreibt sie mit der Annahme fest
              items:
                $ref: "#/components/schemas/PricePeriod"
            price_settlement_date:
              type: string
              format: date
              nullable: true
              description: Datum des EEX-Abrechnungspreises, auf dem die Preise beruhen (`YYYY-MM-DD`)
              example: "2026-10-09"
            offer_message:
              type: string
              nullable: true
              description: Anmerkungen des Verkäufers (bis zu 2.000 Zeichen)
              example: "Profil 2023–2025 ist die reale Einspeisung."
            assets:
              type: array
              description: Erzeugungsanlagen, die das Angebot unterlegen (bis zu 100)
              items:
                $ref: "#/components/schemas/OfferAsset"
            production_profile_available:
              type: boolean
              description: "Ob der Verkäufer ein Erzeugungsprofil hochgeladen hat (Werte in 5- bis 60-Minuten-Intervallen). Ohne Profil lassen sich Capture Rate, Effektivkosten und Verbrauchsmatching nicht bewerten. Baseload- und Pay-as-Indexed-Angebote brauchen kein Erzeugungsprofil; bei Pay as Indexed tritt die ENWEX-Kurve an seine Stelle"
              example: true
            replaces_offer_id:
              type: string
              nullable: true
              description: Der Vorgänger, den diese Revision ersetzt; er wird in derselben Transaktion zurückgezogen
              example: null
            score:
              nullable: true
              description: Die Bewertung; nur in der Sicht des Käufers vorhanden
              allOf:
                - $ref: "#/components/schemas/OfferScore"
            submitted_at:
              type: string
              format: date-time
              description: Zeitpunkt der Abgabe (ISO 8601 UTC) — von da an ist das Angebot für den Käufer sichtbar und unveränderlich
              example: "2026-10-10T14:20:00Z"
            created_at:
              type: string
              format: date-time
              description: Zeitpunkt der Anlage (ISO 8601 UTC)
              example: "2026-10-10T14:20:00Z"
          required:
            - id
            - tender_id
            - seller_company_id
            - technology
            - status
            - accepted_at
            - start_date
            - contract_years
            - delivery_profile
            - volume_per_year
            - capacity_mw
            - pricing_model
            - price_schedule
            - price_per_mwh
            - price_per_go
            - submitted_at
            - created_at
    OfferList:
      type: object
      properties:
        offers:
          type: array
          description: Die Angebote der Ausschreibung
          items:
            $ref: "#/components/schemas/Offer"
        pagination:
          $ref: "#/components/schemas/Pagination"
      required:
        - offers
        - pagination
    LoadProfileImport:
      type: object
      description: Der Stand eines Lastgang-Imports. Der Import läuft im Hintergrund
      properties:
        upload_id:
          type: string
          description: Kennung des Uploads
          example: ten_dem_upl_4e7g1i5k
        status:
          type: string
          description: "Stand des Imports. `none`: kein Lastgang. `pending`: hochgeladen, der Import hat noch nicht begonnen. `importing`: läuft. `complete`: vollständig importiert. `partial`: importiert, mit Lücken oder verworfenen Werten — der Lastgang ist trotzdem aktiv. `failed`: gescheitert; solange kein neuer Lastgang vorliegt und der Käufer nicht auf ihn verzichtet, lässt sich die Ausschreibung nicht einreichen (`DEMAND_IMPORT_FAILED`)"
          enum:
            - none
            - pending
            - importing
            - complete
            - partial
            - failed
          example: pending
        file_name:
          type: string
          nullable: true
          description: Name der hochgeladenen Datei
          example: Lastgang-Werk-Sued-2025.csv
        uploaded_at:
          type: string
          format: date-time
          nullable: true
          description: Zeitpunkt des Uploads (ISO 8601 UTC)
          example: "2026-08-20T09:30:00Z"
      required:
        - upload_id
        - status
    SignedPpaSource:
      type: object
      description: Eine Technologie des unterzeichneten PPA mit Leistung, Menge und Preis
      properties:
        asset_type:
          type: string
          description: Technologie; jede höchstens einmal je PPA
          enum:
            - solar
            - wind
          example: solar
        nominal_power_mw:
          type: number
          description: Leistung in MW, wie unterzeichnet
          example: 30.0
        annual_delivery_volume:
          type: integer
          description: Jährliche Liefermenge in MWh, ganzzahlig, wie unterzeichnet
          example: 31500
        price_per_mwh:
          type: number
          description: Energiepreis in EUR/MWh, wie unterzeichnet
          example: 54.50
        price_per_go:
          type: number
          description: Preis je HKN in EUR/MWh, wie unterzeichnet (freiwillig)
          example: 0.80
      required:
        - asset_type
        - nominal_power_mw
        - annual_delivery_volume
        - price_per_mwh
    SignedPpaCreated:
      type: object
      properties:
        id:
          type: string
          description: Kennung des erfassten PPA
          example: ppa_ctm_sign_3d6f9h2k
      required:
        - id
    Message:
      type: object
      description: Eine Nachricht im Kanal zwischen dem Käufer und einem zugelassenen Verkäufer
      properties:
        id:
          type: string
          description: Kennung der Nachricht
          example: msg_7h1k4n8q
        tender_id:
          type: string
          description: Kennung der Ausschreibung
          example: ten_7g4k2m9p
        sender_company_id:
          type: string
          description: Unternehmen, das die Nachricht gesendet hat
          example: com_4b8d2f6h
        sender_role:
          type: string
          description: Seite des Absenders in dieser Ausschreibung
          enum:
            - buyer
            - seller
          example: buyer
        content:
          type: string
          description: Nachrichtentext (bis zu 2.000 Zeichen)
          example: "Bitte bis zur Frist auch das Erzeugungsprofil hochladen."
        attachments:
          type: array
          description: Angehängte Dateien (bis zu 5 je Nachricht, je 30 MB)
          items:
            type: object
            properties:
              file_name:
                type: string
                description: Dateiname
                example: Erzeugungsprofil-2023-2025.csv
              size_bytes:
                type: integer
                description: Dateigröße in Bytes
                example: 1848320
            required:
              - file_name
              - size_bytes
        created_at:
          type: string
          format: date-time
          description: Sendezeitpunkt (ISO 8601 UTC)
          example: "2026-09-09T09:12:00Z"
      required:
        - id
        - tender_id
        - sender_company_id
        - sender_role
        - content
        - created_at
    MessageList:
      type: object
      properties:
        messages:
          type: array
          description: Die Nachrichten des Kanals, die neueste zuletzt
          items:
            $ref: "#/components/schemas/Message"
        pagination:
          $ref: "#/components/schemas/Pagination"
      required:
        - messages
        - pagination
    DataRoomDocumentVersion:
      type: object
      description: Eine Version eines Dokuments im Datenraum
      properties:
        version_number:
          type: integer
          description: Versionsnummer, beginnend bei 1
          example: 2
        change_note:
          type: string
          nullable: true
          description: Was sich in dieser Version geändert hat
          example: "§ 7 Sicherheiten: Konzernbürgschaft ergänzt"
        size_bytes:
          type: integer
          description: Dateigröße in Bytes
          example: 482133
        uploaded_by_company_id:
          type: string
          description: Unternehmen, das diese Version hochgeladen hat
          example: com_9k3m7p2r
        created_at:
          type: string
          format: date-time
          description: Zeitpunkt des Uploads (ISO 8601 UTC)
          example: "2026-10-29T13:05:00Z"
      required:
        - version_number
        - size_bytes
        - uploaded_by_company_id
        - created_at
    DataRoomDocument:
      type: object
      description: Ein Dokument im Datenraum eines Paares aus Käufer und Verkäufer. Dokumente wachsen in Versionen; die Liste des Raums ist flach
      properties:
        id:
          type: string
          description: Kennung des Dokuments
          example: doc_5j8l2n6q
        file_name:
          type: string
          description: Dateiname des Dokuments
          example: PPA Solar Nord Entwurf v1.docx
        mime_type:
          type: string
          description: MIME-Typ des Dokuments; jede Version muss ihn beibehalten
          example: application/vnd.openxmlformats-officedocument.wordprocessingml.document
        category:
          type: string
          description: Kategorie des Dokuments
          enum:
            - contract
            - technical
            - commercial
            - corporate
            - financial
            - permits
          example: contract
        current_version:
          type: integer
          description: Nummer der neuesten Version
          example: 2
        versions:
          type: array
          description: Alle Versionen, die älteste zuerst
          items:
            $ref: "#/components/schemas/DataRoomDocumentVersion"
        created_at:
          type: string
          format: date-time
          description: Zeitpunkt der Anlage des Dokuments (ISO 8601 UTC)
          example: "2026-10-20T08:55:00Z"
      required:
        - id
        - file_name
        - mime_type
        - category
        - current_version
        - versions
        - created_at
    DataRoomDocumentList:
      type: object
      properties:
        documents:
          type: array
          description: Dokumente des Datenraums
          items:
            $ref: "#/components/schemas/DataRoomDocument"
        pagination:
          $ref: "#/components/schemas/Pagination"
      required:
        - documents
        - pagination
paths:
  /v1/tenders:
    post:
      operationId: createTender
      summary: Ausschreibungsentwurf anlegen
      description: "Eine Ausschreibung als Entwurf anlegen. Der Entwurf bleibt für Verkäufer unsichtbar, bis er zur Prüfung eingereicht, freigegeben und veröffentlicht ist. Pflicht beim Anlegen sind Energiequelle, Volumen je Technologie, Lieferbeginn und Laufzeitspanne; alles Übrige lässt sich später mit `updateTender` ergänzen. Land und Bundesland übernimmt die Plattform aus der Firmenadresse, die Postleitzahl des Verbrauchsorts ebenso als Vorbelegung. Fehlen die Fristen, setzt die Plattform ihren Vorschlag.\n\nErforderlicher Scope: `tenders:write`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:write
      requestBody:
        required: true
        content:
          application/json:
            schema:
              allOf:
                - $ref: "#/components/schemas/TenderInput"
                - type: object
                  required:
                    - energy_type
                    - delivery_start
                    - contract_years_min
                    - contract_years_max
      responses:
        "201":
          description: Der angelegte Entwurf
          headers:
            x-ratelimit-limit:
              $ref: "#/components/headers/X-RateLimit-Limit"
            x-ratelimit-remaining:
              $ref: "#/components/headers/X-RateLimit-Remaining"
            x-ratelimit-reset:
              $ref: "#/components/headers/X-RateLimit-Reset"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TenderCreated"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "403":
          $ref: "#/components/responses/Forbidden"
    get:
      operationId: listTenders
      summary: Ausschreibungen auflisten
      description: "Die Ausschreibungen des angemeldeten Käuferunternehmens auflisten.\n\nErforderlicher Scope: `tenders:read`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:read
      parameters:
        - $ref: "#/components/parameters/LimitParam"
        - $ref: "#/components/parameters/AfterParam"
      responses:
        "200":
          description: Liste der Ausschreibungen
          headers:
            x-ratelimit-limit:
              $ref: "#/components/headers/X-RateLimit-Limit"
            x-ratelimit-remaining:
              $ref: "#/components/headers/X-RateLimit-Remaining"
            x-ratelimit-reset:
              $ref: "#/components/headers/X-RateLimit-Reset"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TenderList"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
  /v1/tenders/{tender_id}:
    get:
      operationId: getTender
      summary: Ausschreibung abrufen
      description: "Eine Ausschreibung des angemeldeten Käuferunternehmens über ihre Kennung abrufen, samt Empfängerkreis, Fristen, Lieferung, Bewertungskriterien und Beschreibungen.\n\nErforderlicher Scope: `tenders:read`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:read
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
      responses:
        "200":
          description: Angaben zur Ausschreibung
          headers:
            x-ratelimit-limit:
              $ref: "#/components/headers/X-RateLimit-Limit"
            x-ratelimit-remaining:
              $ref: "#/components/headers/X-RateLimit-Remaining"
            x-ratelimit-reset:
              $ref: "#/components/headers/X-RateLimit-Reset"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Tender"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
    patch:
      operationId: updateTender
      summary: Ausschreibung ändern
      description: "Felder einer eigenen Ausschreibung ändern; nicht übergebene Felder bleiben unverändert.\n\n**Einladungs- und Ausschlussliste** lassen sich nur im Entwurf ändern (`TENDER_AUDIENCE_LOCKED`); danach lädt der Käufer einzeln mit `inviteSeller` ein.\n\n**Fristen:** Eine Frist darf nie in der Vergangenheit liegen, heute ist zulässig (`TENDER_DEADLINE_OFFERS_PAST`, `TENDER_DEADLINE_SIGNING_PAST`). Eine noch laufende Frist darf früher oder später gelegt werden. Ist eine Frist nach der Veröffentlichung abgelaufen, lässt sie sich nicht mehr ändern (`TENDER_DEADLINE_OFFERS_LOCKED`, `TENDER_DEADLINE_SIGNING_LOCKED`). Der Geplante PPA-Abschluss liegt nach der Frist für indikative Angebote und vor dem Lieferbeginn (`TENDER_DEADLINE_SIGNING_BEFORE_OFFERS`, `TENDER_DEADLINE_SIGNING_AFTER_DELIVERY`); die geplante Veröffentlichung liegt nicht nach dem Tag der Frist für indikative Angebote (`PUBLICATION_DEADLINE_CONFLICT`).\n\n**Wesentliche Änderungen:** Ändert der Käufer an einer veröffentlichten Ausschreibung Fristen, Empfängerkreis, Anonymität, Detailbeschreibung oder Veröffentlichungszeitpunkt, benachrichtigt die Plattform die zugelassenen Verkäufer. Alle übrigen Änderungen sind sofort sichtbar, ohne Benachrichtigung. Bewertungskriterien bleiben änderbar; die Bewertungen werden neu berechnet.\n\nErforderlicher Scope: `tenders:write`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:write
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/TenderInput"
      responses:
        "200":
          $ref: "#/components/responses/Done"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "403":
          $ref: "#/components/responses/Forbidden"
        "404":
          $ref: "#/components/responses/NotFound"
        "409":
          $ref: "#/components/responses/Conflict"
    delete:
      operationId: deleteTender
      summary: Entwurf löschen
      description: "Einen Entwurf mit allen Dateien löschen. Nur ein Entwurf lässt sich löschen; eine eingereichte oder veröffentlichte Ausschreibung nimmt der Käufer mit `unpublishTender` in den Entwurf zurück oder schließt sie.\n\nErforderlicher Scope: `tenders:write`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:write
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
      responses:
        "204":
          $ref: "#/components/responses/Done"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
        "409":
          $ref: "#/components/responses/Conflict"
  /v1/tenders/{tender_id}/load-profile:
    post:
      operationId: uploadLoadProfile
      summary: Lastgang hochladen
      description: "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`).\n\nZugelassene Verkäufer sehen Kennzahlen und Profile des Lastgangs, nicht die Datei. Ohne Lastgang entfällt das Verbrauchsmatching für alle Angebote.\n\nErforderlicher Scope: `tenders:write`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:write
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  type: string
                  format: binary
                  description: Lastgangdatei (CSV oder TSV, bis 25 MB)
              required:
                - file
      responses:
        "201":
          description: Stand des Lastgang-Imports
          headers:
            x-ratelimit-limit:
              $ref: "#/components/headers/X-RateLimit-Limit"
            x-ratelimit-remaining:
              $ref: "#/components/headers/X-RateLimit-Remaining"
            x-ratelimit-reset:
              $ref: "#/components/headers/X-RateLimit-Reset"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/LoadProfileImport"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
  /v1/tenders/{tender_id}/submit-review:
    post:
      operationId: submitTenderForReview
      summary: Ausschreibung zur Prüfung einreichen
      description: "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`.\n\nVoraussetzungen, 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`).\n\nLä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.\n\nErforderlicher Scope: `tenders:write`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:write
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
      responses:
        "201":
          description: "Der neue Status: `in_review` oder, bei vorhandener Freigabe, `active`"
          headers:
            x-ratelimit-limit:
              $ref: "#/components/headers/X-RateLimit-Limit"
            x-ratelimit-remaining:
              $ref: "#/components/headers/X-RateLimit-Remaining"
            x-ratelimit-reset:
              $ref: "#/components/headers/X-RateLimit-Reset"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TenderStatusResult"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "403":
          $ref: "#/components/responses/Forbidden"
        "404":
          $ref: "#/components/responses/NotFound"
        "409":
          $ref: "#/components/responses/Conflict"
  /v1/tenders/{tender_id}/unpublish:
    post:
      operationId: unpublishTender
      summary: In den Entwurf zurücknehmen
      description: "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.\n\nErforderlicher Scope: `tenders:write`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:write
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
      responses:
        "201":
          description: "Der neue Status `draft`"
          headers:
            x-ratelimit-limit:
              $ref: "#/components/headers/X-RateLimit-Limit"
            x-ratelimit-remaining:
              $ref: "#/components/headers/X-RateLimit-Remaining"
            x-ratelimit-reset:
              $ref: "#/components/headers/X-RateLimit-Reset"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TenderStatusResult"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
        "409":
          $ref: "#/components/responses/Conflict"
  /v1/tenders/{tender_id}/close:
    post:
      operationId: closeTender
      summary: Aktive Ausschreibung schließen
      description: "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.\n\nErforderlicher Scope: `tenders:write`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:write
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
      responses:
        "201":
          $ref: "#/components/responses/Done"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
        "409":
          $ref: "#/components/responses/Conflict"
  /v1/tenders/{tender_id}/cancel:
    post:
      operationId: cancelTender
      summary: Ausschreibung abbrechen
      description: "Eine Ausschreibung in jedem Status abbrechen; sie ist danach `closed`. Ist sie schon geschlossen, ändert sich nichts.\n\nErforderlicher Scope: `tenders:write`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:write
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
      responses:
        "201":
          $ref: "#/components/responses/Done"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
  /v1/tenders/{tender_id}/reopen:
    post:
      operationId: reopenTender
      summary: Geschlossene Ausschreibung wieder öffnen
      description: "Eine geschlossene Ausschreibung wieder öffnen. Hat sie eine Freigabe der Otark GmbH, wird sie `active`, sonst `draft`. Andere Status weist die API mit `409` zurück.\n\nErforderlicher Scope: `tenders:write`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:write
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
      responses:
        "201":
          $ref: "#/components/responses/Done"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
        "409":
          $ref: "#/components/responses/Conflict"
  /v1/tenders/{tender_id}/access-requests:
    get:
      operationId: listAccessRequests
      summary: Zugänge auflisten
      description: "Jede Zugangsbeziehung der Ausschreibung auflisten — offene Einladungen und Anfragen, zugelassene Verkäufer und solche auf der Shortlist, abgelehnte und zurückgezogene —, filterbar nach Status. Jeder Eintrag zeigt den Verkäufer mit Namen und Kurzprofil: Verkäufer sind gegenüber dem Käufer nie anonym.\n\nErforderlicher Scope: `tenders:read`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:read
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
        - name: status
          in: query
          description: Nach dem Zugangsstatus filtern
          schema:
            type: string
            enum:
              - invited
              - requested
              - approved
              - shortlisted
              - denied
              - cancelled
        - $ref: "#/components/parameters/LimitParam"
        - $ref: "#/components/parameters/AfterParam"
      responses:
        "200":
          description: Zugangsbeziehungen der Ausschreibung
          headers:
            x-ratelimit-limit:
              $ref: "#/components/headers/X-RateLimit-Limit"
            x-ratelimit-remaining:
              $ref: "#/components/headers/X-RateLimit-Remaining"
            x-ratelimit-reset:
              $ref: "#/components/headers/X-RateLimit-Reset"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TenderAccessList"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
  /v1/tenders/{tender_id}/access-requests/{access_id}/respond:
    post:
      operationId: respondToAccessRequest
      summary: Über einen Zugang entscheiden
      description: "Über eine Zugangsanfrage entscheiden oder einem zugelassenen Verkäufer den Zugang entziehen, solange die Ausschreibung aktiv ist (sonst `409`).\n\n`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.\n\nDie 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.\n\nErforderlicher Scope: `tenders:write`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:write
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
        - $ref: "#/components/parameters/AccessIdParam"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                decision:
                  type: string
                  description: Die Entscheidung des Käufers
                  enum:
                    - approved
                    - denied
                  example: approved
                response_message:
                  type: string
                  description: Freiwillige Antwort an den Verkäufer per E-Mail (bis zu 2.000 Zeichen)
                  example: "Bitte bis zur Frist auch das Erzeugungsprofil hochladen."
              required:
                - decision
      responses:
        "200":
          $ref: "#/components/responses/Done"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
        "409":
          $ref: "#/components/responses/Conflict"
  /v1/tenders/{tender_id}/invitations:
    post:
      operationId: inviteSeller
      summary: Verkäufer einladen
      description: "Verkäuferunternehmen auf die Ausschreibung hinweisen. Die Einladung ist ein Hinweis, keine Zulassung: Der Eingeladene erhält eine E-Mail, die den Käufer nicht nennt, sieht die Ausschreibung anonym in seiner Tender Inbox — auch bei `invite_only` —, fragt Zugang an, und der Käufer entscheidet. Ablehnen kann der Verkäufer eine Einladung nicht; er fragt einfach keinen Zugang an.\n\nEinladbar ist jedes verifizierte Unternehmen, das nicht auf der Ausschlussliste steht und noch keinen Zugang hat; die Antwort nennt je Unternehmen das Ergebnis. Einladen lässt sich nur bei einer aktiven, veröffentlichten Ausschreibung (`TENDER_INVITATIONS_CLOSED`) und bis einschließlich des Tages der Frist für indikative Angebote (`TENDER_ADMISSION_DEADLINE_PASSED`). Vor der Veröffentlichung dient die Einladungsliste der Ausschreibung.\n\nErforderlicher Scope: `tenders:write`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:write
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                company_ids:
                  type: array
                  description: Die einzuladenden Verkäuferunternehmen (1 bis 200)
                  minItems: 1
                  maxItems: 200
                  items:
                    type: string
                  example:
                    - com_5t8v2w6y
              required:
                - company_ids
      responses:
        "201":
          description: Das Ergebnis je Unternehmen
          headers:
            x-ratelimit-limit:
              $ref: "#/components/headers/X-RateLimit-Limit"
            x-ratelimit-remaining:
              $ref: "#/components/headers/X-RateLimit-Remaining"
            x-ratelimit-reset:
              $ref: "#/components/headers/X-RateLimit-Reset"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/InvitationResult"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
        "409":
          $ref: "#/components/responses/Conflict"
  /v1/tenders/{tender_id}/invitations/{access_id}/resend:
    post:
      operationId: resendInvitation
      summary: Einladung erneut senden
      description: "Die E-Mail einer offenen Einladung (`invited`) erneut senden. Es gelten dieselben Bedingungen wie beim Einladen; eine Sperrfrist gibt es nicht.\n\nErforderlicher Scope: `tenders:write`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:write
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
        - $ref: "#/components/parameters/AccessIdParam"
      responses:
        "204":
          $ref: "#/components/responses/Done"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
        "409":
          $ref: "#/components/responses/Conflict"
  /v1/tenders/{tender_id}/invitations/{access_id}:
    delete:
      operationId: withdrawInvitation
      summary: Einladung zurückziehen
      description: "Eine offene Einladung (`invited`) einer aktiven Ausschreibung zurückziehen. Die Einladung entfällt; bei einer Ausschreibung an alle Verkäufer kann das Unternehmen weiterhin selbst Zugang anfragen.\n\nErforderlicher Scope: `tenders:write`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:write
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
        - $ref: "#/components/parameters/AccessIdParam"
      responses:
        "204":
          $ref: "#/components/responses/Done"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
        "409":
          $ref: "#/components/responses/Conflict"
  /v1/tenders/{tender_id}/shortlist:
    post:
      operationId: shortlistSeller
      summary: Verkäufer auf die Shortlist setzen
      description: "Einen zugelassenen Verkäufer auf die Shortlist setzen (Zugangsstatus `shortlisted`) oder wieder herunternehmen (`approved`), solange die Ausschreibung aktiv ist. Ein Angebot braucht es dafür nicht, eine Frist gibt es nicht. Die Shortlist öffnet den Datenraum, und der Käufer kann die Angebote des Verkäufers annehmen. Wer von der Shortlist genommen wird, sieht den Datenraum nicht mehr.\n\nFreiwillig nennt der Käufer die Angebote, auf denen der Eintrag beruht (bis zu 50, eigene Angebote des Verkäufers, nicht abgelehnt oder zurückgezogen). Die Annahme eines Angebots hängt nicht an dieser Auswahl.\n\nErforderlicher Scope: `tenders:write`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:write
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                access_id:
                  type: string
                  description: Der Zugang des Verkäufers
                  example: ten_acc_2f6h9k3m
                shortlisted:
                  type: boolean
                  description: Gesetzt, um den Verkäufer auf die Shortlist zu setzen; nicht gesetzt, um ihn herunterzunehmen
                  example: true
                anchor_offer_ids:
                  type: array
                  description: Die Angebote, auf denen der Eintrag beruht (freiwillig, bis zu 50)
                  maxItems: 50
                  items:
                    type: string
                  example:
                    - ten_off_8m2p6r9t
              required:
                - access_id
                - shortlisted
      responses:
        "200":
          $ref: "#/components/responses/Done"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
        "409":
          $ref: "#/components/responses/Conflict"
  /v1/tenders/{tender_id}/offers:
    get:
      operationId: listTenderOffers
      summary: Angebote einer Ausschreibung auflisten
      description: "Die Angebote der Ausschreibung auflisten. Der Käufer sieht alle Angebote, jedes mit seiner Bewertung (`score`) gegen die Bewertungskriterien: Werte und Punkte je Kriterium, den gewichteten Gesamtscore 0–100 und die Bewertungsstufe. Ein Verkäufer erhält mit demselben Aufruf nur seine eigenen Angebote, ohne Bewertung; Rang und Punkte sieht er nie.\n\nZurückgezogene und abgelehnte Angebote bleiben mit ihrem Status gelistet; eine Revision ersetzt ihren Vorgänger.\n\nErforderlicher Scope: `tenders:read`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:read
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
        - name: technology
          in: query
          description: Nach Technologie filtern
          schema:
            type: string
            enum:
              - solar
              - wind
        - $ref: "#/components/parameters/LimitParam"
        - $ref: "#/components/parameters/AfterParam"
      responses:
        "200":
          description: Die Angebote der Ausschreibung
          headers:
            x-ratelimit-limit:
              $ref: "#/components/headers/X-RateLimit-Limit"
            x-ratelimit-remaining:
              $ref: "#/components/headers/X-RateLimit-Remaining"
            x-ratelimit-reset:
              $ref: "#/components/headers/X-RateLimit-Reset"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/OfferList"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
    post:
      operationId: submitIndicativeOffer
      summary: Indikatives Angebot abgeben
      description: "Als zugelassener Verkäufer (Zugangsstatus `approved` oder `shortlisted`, sonst `403`) ein indikatives Angebot abgeben. Ein Angebot deckt eine Technologie ab — bei einer gemischten Ausschreibung geben Sie Solar und Wind getrennt ab — und nennt mindestens eine Erzeugungsanlage dieser Technologie. Lieferbeginn und Laufzeit liegen innerhalb der Ausschreibung. Die Frist für indikative Angebote ist ein Zieldatum: Auch danach nimmt die Plattform Angebote an.\n\nEin Erzeugungsprofil (Werte in 5- bis 60-Minuten-Intervallen) wird im Angebots-Wizard der Plattform mit dem Angebot hochgeladen; ein über diese API abgegebenes Angebot trägt keines (`production_profile_available` bleibt `false`). Ohne Profil lassen sich Capture Rate, Effektivkosten und Verbrauchsmatching nicht bewerten. Baseload- und Pay-as-Indexed-Angebote brauchen kein Erzeugungsprofil.\n\nEinmal abgegeben, ist das Angebot für den Käufer sichtbar und unveränderlich; Änderungen erfolgen durch eine Revision.\n\nErforderlicher Scope: `tenders:offer`"
      tags:
        - Sellers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:offer
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/OfferSubmission"
      responses:
        "201":
          description: Das abgegebene Angebot
          headers:
            x-ratelimit-limit:
              $ref: "#/components/headers/X-RateLimit-Limit"
            x-ratelimit-remaining:
              $ref: "#/components/headers/X-RateLimit-Remaining"
            x-ratelimit-reset:
              $ref: "#/components/headers/X-RateLimit-Reset"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Offer"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "403":
          $ref: "#/components/responses/Forbidden"
        "404":
          $ref: "#/components/responses/NotFound"
        "409":
          $ref: "#/components/responses/Conflict"
  /v1/tenders/{tender_id}/offer-requests:
    post:
      operationId: requestOffer
      summary: Angebot anfordern
      description: "Einen zugelassenen Verkäufer (`approved` oder `shortlisted`, sonst `409`) um ein neues indikatives Angebot bitten oder an eines erinnern. Der Verkäufer erhält eine E-Mail; die freiwillige Nachricht steht zusätzlich im Nachrichtenkanal. Dieselbe Anfrage an denselben Verkäufer ist frühestens sieben Tage (7 × 24 Stunden) nach der letzten möglich, vorher antwortet die API mit `409`.\n\nErforderlicher Scope: `tenders:write`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:write
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                access_id:
                  type: string
                  description: Der Zugang des Verkäufers
                  example: ten_acc_2f6h9k3m
                message:
                  type: string
                  description: Freiwillige Nachricht an den Verkäufer (bis zu 2.000 Zeichen)
                  example: "Bitte ein Angebot mit Pay as produced ergänzen."
              required:
                - access_id
      responses:
        "201":
          $ref: "#/components/responses/Done"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
        "409":
          $ref: "#/components/responses/Conflict"
  /v1/tenders/{tender_id}/offers/{offer_id}/decline:
    post:
      operationId: declineOffer
      summary: Angebot ablehnen
      description: "Ein eingereichtes, nicht angenommenes Angebot ablehnen (`declined`). Ein angenommenes, zurückgezogenes oder bereits abgelehntes Angebot weist die API mit `409` zurück. Der Verkäufer bleibt zugelassen. Eine freiwillige Begründung (bis zu 2.000 Zeichen) steht im Nachrichtenkanal.\n\nErforderlicher Scope: `tenders:write`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:write
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
        - $ref: "#/components/parameters/OfferIdParam"
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                note:
                  type: string
                  description: Freiwillige Begründung (bis zu 2.000 Zeichen)
                  example: "Preis liegt über unserem Zielkorridor."
      responses:
        "200":
          $ref: "#/components/responses/Done"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
        "409":
          $ref: "#/components/responses/Conflict"
  /v1/tenders/{tender_id}/offers/{offer_id}/request-changes:
    post:
      operationId: requestOfferChanges
      summary: Änderungen an einem Angebot anfragen
      description: "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.\n\nErforderlicher Scope: `tenders:write`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:write
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
        - $ref: "#/components/parameters/OfferIdParam"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                note:
                  type: string
                  description: Was sich ändern soll (bis zu 2.000 Zeichen)
                  example: "Bitte die Laufzeit auf zehn Jahre verlängern."
              required:
                - note
      responses:
        "200":
          $ref: "#/components/responses/Done"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
        "409":
          $ref: "#/components/responses/Conflict"
  /v1/tenders/{tender_id}/offers/{offer_id}/accept:
    post:
      operationId: acceptOffer
      summary: Angebot annehmen
      description: "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.\n\nDie 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.\n\nErforderlicher Scope: `tenders:sign`"
      tags:
        - Buyers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:sign
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
        - $ref: "#/components/parameters/OfferIdParam"
      responses:
        "201":
          $ref: "#/components/responses/Done"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
        "409":
          $ref: "#/components/responses/Conflict"
  /v1/tenders/{tender_id}/offers/{offer_id}/revisions:
    post:
      operationId: reviseIndicativeOffer
      summary: Indikatives Angebot überarbeiten
      description: "Eine neue Fassung eines eigenen indikativen Angebots abgeben. Die Revision ist für sich ein vollständiges Angebot; der Vorgänger wird in derselben Transaktion zurückgezogen und bleibt für den Käufer als zurückgezogen sichtbar. So beantworten Sie eine Änderungsanfrage des Käufers. Ein angenommenes Angebot lässt sich nicht überarbeiten (`409`).\n\nErforderlicher Scope: `tenders:offer`"
      tags:
        - Sellers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:offer
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
        - $ref: "#/components/parameters/OfferIdParam"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/OfferSubmission"
      responses:
        "201":
          description: Die neue Fassung des Angebots; `replaces_offer_id` nennt den zurückgezogenen Vorgänger
          headers:
            x-ratelimit-limit:
              $ref: "#/components/headers/X-RateLimit-Limit"
            x-ratelimit-remaining:
              $ref: "#/components/headers/X-RateLimit-Remaining"
            x-ratelimit-reset:
              $ref: "#/components/headers/X-RateLimit-Reset"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Offer"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "403":
          $ref: "#/components/responses/Forbidden"
        "404":
          $ref: "#/components/responses/NotFound"
        "409":
          $ref: "#/components/responses/Conflict"
  /v1/tenders/{tender_id}/offers/{offer_id}:
    delete:
      operationId: withdrawOffer
      summary: Angebot zurückziehen
      description: "Ein eigenes Angebot zurückziehen (`withdrawn`). Ein angenommenes oder bereits zurückgezogenes Angebot weist die API mit `409` zurück. Der Käufer erhält eine E-Mail. Das Angebot bleibt für beide Seiten als zurückgezogen sichtbar; ein neues Angebot ist weiterhin möglich.\n\nErforderlicher Scope: `tenders:offer`"
      tags:
        - Sellers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:offer
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
        - $ref: "#/components/parameters/OfferIdParam"
      responses:
        "204":
          $ref: "#/components/responses/Done"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "403":
          $ref: "#/components/responses/Forbidden"
        "404":
          $ref: "#/components/responses/NotFound"
        "409":
          $ref: "#/components/responses/Conflict"
  /v1/inbox:
    get:
      operationId: listInboxTenders
      summary: Tender Inbox auflisten
      description: "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.\n\nErforderlicher Scope: `tenders:read`"
      tags:
        - Sellers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:read
      parameters:
        - name: state
          in: query
          description: Nach dem Bundesland des Käufers filtern
          schema:
            type: string
            example: Bayern
        - $ref: "#/components/parameters/LimitParam"
        - $ref: "#/components/parameters/AfterParam"
      responses:
        "200":
          description: Die Ausschreibungen in der Tender Inbox, die neueste zuerst
          headers:
            x-ratelimit-limit:
              $ref: "#/components/headers/X-RateLimit-Limit"
            x-ratelimit-remaining:
              $ref: "#/components/headers/X-RateLimit-Remaining"
            x-ratelimit-reset:
              $ref: "#/components/headers/X-RateLimit-Reset"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/InboxTenderList"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
  /v1/tenders/{tender_id}/application:
    post:
      operationId: applyToTender
      summary: Zugang anfragen
      description: "Als Verkäufer Zugang zu einer Ausschreibung anfragen — auf eine Ausschreibung an alle Verkäufer oder auf eine Einladung, auch bei `invite_only`. Die freiwillige Nachricht (bis zu 2.000 Zeichen) liest der Käufer zusammen mit dem Unternehmensprofil — Name, Adresse, Technologie, Gründungsjahr, Portfolio, Märkte und Bonitätsindex. Verkäufer sind gegenüber dem Käufer nie anonym. Der Zugang wechselt auf `requested`; der Käufer entscheidet.\n\nAnfragen kann nur ein verifiziertes Unternehmen (`403`), nur bei einer veröffentlichten Ausschreibung aus der eigenen Tender Inbox und nur bis einschließlich des Tages der Frist für indikative Angebote (`403`). Eine zweite Anfrage weist die API mit `409` zurück.\n\nErforderlicher Scope: `tenders:offer`"
      tags:
        - Sellers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:offer
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                message:
                  type: string
                  description: Freiwillige Nachricht an den Käufer (bis zu 2.000 Zeichen)
                  example: "Solarpark in Niederbayern, 30 MW, seit 2024 in Betrieb, Erzeugungsdaten liegen vor."
      responses:
        "201":
          $ref: "#/components/responses/Done"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "403":
          $ref: "#/components/responses/Forbidden"
        "404":
          $ref: "#/components/responses/NotFound"
        "409":
          $ref: "#/components/responses/Conflict"
    delete:
      operationId: withdrawApplication
      summary: Zugangsanfrage zurückziehen
      description: "Eine offene Zugangsanfrage (`requested`) zurückziehen; der Zugang wechselt auf `cancelled`. Eine Einladung lässt sich auf diesem Weg nicht zurückziehen (`409`). Ein zugelassener Verkäufer verlässt die Ausschreibung mit `leaveTender`.\n\nErforderlicher Scope: `tenders:offer`"
      tags:
        - Sellers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:offer
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
      responses:
        "200":
          $ref: "#/components/responses/Done"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
        "409":
          $ref: "#/components/responses/Conflict"
  /v1/tenders/{tender_id}/leave:
    post:
      operationId: leaveTender
      summary: Ausschreibung verlassen
      description: "Als zugelassener Verkäufer (`approved` oder `shortlisted`) eine aktive Ausschreibung verlassen. Jedes offene Angebot wird zurückgezogen, der Zugang wechselt auf `cancelled`, und der Käufer erhält eine E-Mail mit der freiwilligen Nachricht. Der Schritt lässt sich nicht rückgängig machen. Nach einem angenommenen Angebot oder einem erfassten PPA ist das Verlassen nicht mehr möglich (`409`).\n\nErforderlicher Scope: `tenders:offer`"
      tags:
        - Sellers
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:offer
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                message:
                  type: string
                  description: Freiwillige Nachricht an den Käufer (bis zu 2.000 Zeichen)
                  example: "Unsere Anlage steht für diesen Zeitraum nicht mehr zur Verfügung."
      responses:
        "204":
          $ref: "#/components/responses/Done"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
        "409":
          $ref: "#/components/responses/Conflict"
  /v1/tenders/{tender_id}/signed-ppas:
    post:
      operationId: uploadSignedPpa
      summary: Unterzeichneten PPA erfassen
      description: "Einen außerhalb der Plattform unterzeichneten PPA erfassen, mit Bezug auf ein angenommenes Angebot. Erfassen kann der Verkäufer oder der Käufer; der Käufer nennt dabei den Verkäufer (`counterparty_company_id`, sonst `COUNTERPARTY_REQUIRED`). Voraussetzung ist ein Verkäufer auf der Shortlist (`SHORTLISTED_ACCESS_REQUIRED`) und ein angenommenes Angebot dieses Verkäufers in dieser Ausschreibung (`OFFER_REQUIRED`, `OFFER_MISMATCH`). Die Angaben entsprechen dem unterzeichneten Vertrag; der Vertrag selbst wird als PDF bis 50 MB hochgeladen (`CONTRACT_MUST_BE_PDF`) und ist für beide Seiten sichtbar.\n\nDas Erfassen ist eine Erklärung, keine Prüfung: Die Gegenseite bestätigt nichts, und die Otark GmbH prüft den Vertrag nicht. Der erste erfasste PPA schließt die Ausschreibung; zu weiteren angenommenen Angeboten lassen sich danach noch PPAs erfassen. Der PPA erscheint bei beiden Seiten unter den laufenden PPAs.\n\nErforderlicher Scope: `tenders:sign` (Käufer) oder `tenders:offer` (Verkäufer)"
      tags:
        - Shared
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - tenders:sign
        - tenders:offer
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                offer_id:
                  type: string
                  description: Das angenommene Angebot, auf das sich der PPA bezieht
                  example: ten_off_8m2p6r9t
                counterparty_company_id:
                  type: string
                  description: "Nur für Käufer: der Verkäufer auf der Shortlist, mit dem der PPA unterzeichnet ist"
                  example: com_9k3m7p2r
                ppa_type:
                  type: string
                  description: Lieferprofil des PPA, wie unterzeichnet
                  enum:
                    - forecasted
                    - produced
                    - consumed
                    - baseload
                    - shaped
                    - peakload
                  example: forecasted
                delivery_start:
                  type: string
                  format: date
                  description: Lieferbeginn (`YYYY-MM-DD`), wie unterzeichnet
                  example: "2027-01-01"
                delivery_end:
                  type: string
                  format: date
                  description: Lieferende (`YYYY-MM-DD`), wie unterzeichnet
                  example: "2036-12-31"
                sources:
                  type: string
                  description: "Die Technologien des PPA als JSON-Array von `SignedPpaSource`, mindestens eine, jede Technologie höchstens einmal"
                  example: '[{"asset_type":"solar","nominal_power_mw":30,"annual_delivery_volume":31500,"price_per_mwh":54.5}]'
                contract:
                  type: string
                  format: binary
                  description: Der unterzeichnete Vertrag (PDF, bis 50 MB)
              required:
                - offer_id
                - ppa_type
                - delivery_start
                - delivery_end
                - sources
                - contract
      responses:
        "201":
          description: Der erfasste PPA
          headers:
            x-ratelimit-limit:
              $ref: "#/components/headers/X-RateLimit-Limit"
            x-ratelimit-remaining:
              $ref: "#/components/headers/X-RateLimit-Remaining"
            x-ratelimit-reset:
              $ref: "#/components/headers/X-RateLimit-Reset"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/SignedPpaCreated"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "403":
          $ref: "#/components/responses/Forbidden"
        "404":
          $ref: "#/components/responses/NotFound"
  /v1/tenders/{tender_id}/messages:
    get:
      operationId: listMessages
      summary: Nachrichten auflisten
      description: "Die Nachrichten des Kanals zwischen dem Käufer und einem zugelassenen Verkäufer auflisten. Jede Ausschreibung hat je zugelassenem Verkäufer einen Kanal: Der Käufer spricht einen Kanal über `company_id` an; ein Verkäufer liest seinen eigenen Kanal und lässt den Parameter weg. Der Kanal entsteht leer mit der Zulassung. Im Kanal stehen auch die Nachrichten des Käufers zu Angebotsanfragen, Änderungsanfragen und Ablehnungen.\n\nErforderlicher Scope: `chats:read`"
      tags:
        - Shared
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - chats:read
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
        - $ref: "#/components/parameters/CompanyContextParam"
        - $ref: "#/components/parameters/LimitParam"
        - $ref: "#/components/parameters/AfterParam"
      responses:
        "200":
          description: Die Nachrichten des Kanals
          headers:
            x-ratelimit-limit:
              $ref: "#/components/headers/X-RateLimit-Limit"
            x-ratelimit-remaining:
              $ref: "#/components/headers/X-RateLimit-Remaining"
            x-ratelimit-reset:
              $ref: "#/components/headers/X-RateLimit-Reset"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/MessageList"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
    post:
      operationId: postMessage
      summary: Nachricht senden
      description: "Eine Nachricht in den Kanal zwischen dem Käufer und einem zugelassenen Verkäufer senden. Der Nachrichtentext fasst bis zu 2.000 Zeichen; anhängen lassen sich bis zu 5 Dateien von je 30 MB. Der Käufer spricht einen Kanal an, indem er die `company_id` des Verkäufers als Formularfeld übergibt; ein Verkäufer schreibt in seinen eigenen Kanal und lässt sie weg. Über ungelesene Nachrichten wird die Gegenseite per E-Mail benachrichtigt.\n\nErforderlicher Scope: `chats:write`"
      tags:
        - Shared
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - chats:write
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                content:
                  type: string
                  description: Nachrichtentext (bis zu 2.000 Zeichen)
                  example: "Bitte bis zur Frist auch das Erzeugungsprofil hochladen."
                company_id:
                  type: string
                  description: "Nur für Käufer: das Verkäuferunternehmen, in dessen Kanal geschrieben wird"
                  example: com_9k3m7p2r
                attachments:
                  type: array
                  description: Angehängte Dateien (bis zu 5, je 30 MB)
                  items:
                    type: string
                    format: binary
              required:
                - content
      responses:
        "201":
          description: Die gesendete Nachricht
          headers:
            x-ratelimit-limit:
              $ref: "#/components/headers/X-RateLimit-Limit"
            x-ratelimit-remaining:
              $ref: "#/components/headers/X-RateLimit-Remaining"
            x-ratelimit-reset:
              $ref: "#/components/headers/X-RateLimit-Reset"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Message"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "404":
          $ref: "#/components/responses/NotFound"
  /v1/tenders/{tender_id}/data-room/documents:
    get:
      operationId: listDataRoomDocuments
      summary: Dokumente des Datenraums auflisten
      description: "Die Dokumente des Datenraums auflisten. Jede Ausschreibung hat je Verkäufer auf der Shortlist einen Datenraum, der genau diesem Paar aus Käufer und Verkäufer gehört — kein anderer Verkäufer sieht ihn. Der Käufer spricht einen Raum über `company_id` an; ein Verkäufer liest seinen eigenen Raum und lässt den Parameter weg. Zugang hat nur ein Verkäufer mit Zugangsstatus `shortlisted`.\n\nJedes Dokument führt seine Versionen samt Änderungshinweisen auf, die älteste zuerst. Die Dateien werden über die Plattform heruntergeladen.\n\nErforderlicher Scope: `data-rooms:tender:read`"
      tags:
        - Shared
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - data-rooms:tender:read
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
        - $ref: "#/components/parameters/CompanyContextParam"
        - $ref: "#/components/parameters/LimitParam"
        - $ref: "#/components/parameters/AfterParam"
      responses:
        "200":
          description: Dokumente des Datenraums
          headers:
            x-ratelimit-limit:
              $ref: "#/components/headers/X-RateLimit-Limit"
            x-ratelimit-remaining:
              $ref: "#/components/headers/X-RateLimit-Remaining"
            x-ratelimit-reset:
              $ref: "#/components/headers/X-RateLimit-Reset"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/DataRoomDocumentList"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "403":
          $ref: "#/components/responses/Forbidden"
        "404":
          $ref: "#/components/responses/NotFound"
    post:
      operationId: uploadDataRoomDocument
      summary: Dokument in den Datenraum hochladen
      description: "Ein Dokument in den Datenraum hochladen oder eine neue Version eines vorhandenen Dokuments. Beide Seiten haben dieselben Rechte. Ein Dokument nimmt jeden Dateityp bis 500 MB auf; eine neue Version fügen Sie hinzu, indem Sie die `document_id` des vorhandenen Dokuments samt Änderungshinweis übergeben, und sie muss den Dateityp des Dokuments beibehalten (`DOCUMENT_VERSION_MIME_TYPE_MISMATCH`). Der Käufer spricht einen Raum an, indem er die `company_id` des Verkäufers als Formularfeld übergibt; ein Verkäufer lädt in seinen eigenen Raum hoch und lässt sie weg.\n\nFür Word- und PDF-Dokumente bis 25 MB je Version erzeugt der Raum im Portal einen Redline-Vergleich zweier Versionen.\n\nErforderlicher Scope: `data-rooms:tender:write`"
      tags:
        - Shared
      security:
        - ApiKeyAuth: []
      x-required-scopes:
        - data-rooms:tender:write
      parameters:
        - $ref: "#/components/parameters/TenderIdParam"
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  type: string
                  format: binary
                  description: Die hochzuladende Datei (beliebiger Typ, bis 500 MB)
                company_id:
                  type: string
                  description: "Nur für Käufer: der Verkäufer auf der Shortlist, in dessen Datenraum hochgeladen wird"
                  example: com_9k3m7p2r
                document_id:
                  type: string
                  description: Vorhandenes Dokument, dem eine neue Version hinzugefügt wird; bleibt die Angabe weg, entsteht ein neues Dokument
                  example: doc_5j8l2n6q
                category:
                  type: string
                  description: Kategorie des Dokuments (für neue Dokumente; Voreinstellung `contract`)
                  enum:
                    - contract
                    - technical
                    - commercial
                    - corporate
                    - financial
                    - permits
                  example: contract
                change_note:
                  type: string
                  description: Was sich in dieser Version geändert hat (bei neuen Versionen)
                  example: "§ 7 Sicherheiten: Konzernbürgschaft ergänzt"
              required:
                - file
      responses:
        "201":
          description: Das Dokument samt seiner aktualisierten Versionsliste
          headers:
            x-ratelimit-limit:
              $ref: "#/components/headers/X-RateLimit-Limit"
            x-ratelimit-remaining:
              $ref: "#/components/headers/X-RateLimit-Remaining"
            x-ratelimit-reset:
              $ref: "#/components/headers/X-RateLimit-Reset"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/DataRoomDocument"
        "400":
          $ref: "#/components/responses/BadRequest"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "403":
          $ref: "#/components/responses/Forbidden"
        "404":
          $ref: "#/components/responses/NotFound"
