1-Click PPA API

POST /v1/quotes/{quote_id}/accept

Ein verbindliches Angebot annehmen. Die Annahme läuft als eine untrennbare Transaktion: Angebot und Anfrage gehen auf accepted, der Einzelvertrag entsteht mit seiner fünfstelligen Vertragsnummer und dem Merkmal GC-unterlegt aus der Anfrage, das Vertragsdokument wird erzeugt und unveränderlich archiviert, und jedes andere aktive Angebot auf die Anfrage geht auf not_selected. Die Antwort liefert den entstandenen Vertrag. Die Annahme ist möglich, solange die Anfrage active ist — veröffentlicht und vor dem Ende der Auswahlphase, 30 Minuten nach dem Ende des Angebotsfensters. Die Verbindung zwischen Käufer und Verkäufer muss im Moment der Annahme aktiv sein. **Indikative Angebote sind nicht annehmbar**; ihre Annahme antwortet mit 409. Es gibt keine Reservierung und keine Bestätigungsschleife: Die Annahme kann der Käufer nicht zurücknehmen, und der Verkäufer kann sie nicht ablehnen. Eine Anfrage erhält eine Annahme — eine Aufteilung der Menge auf mehrere Verkäufer gibt es nicht. Eine Zahlung wird nicht ausgelöst: Das Geld fließt mit der ersten Monatsrechnung des Verkäufers direkt zwischen den Parteien. Erforderlicher Scope: rfq:write

Als Markdown anzeigen

Freischaltung erforderlich

Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
POST
/v1/quotes/{quote_id}/accept
X-Api-Key<token>

In: header

Path Parameters

quote_idstring

Kennung des Angebots

Response Body

curl -X POST "https://api.otark.com/v1/quotes/qte_c4x8p2n6/accept"
{
  "contract_number": "7K2QP",
  "status": "in_progress",
  "role": "buyer",
  "buyer": {
    "company_id": "cmp_9s4w2e8b",
    "company_name": "Stadtwerke"
  },
  "seller": {
    "company_id": "cmp_7d3f9k2a",
    "company_name": "Solar Nord"
  },
  "energy_source": "solar",
  "reference_index": "ENWEX Solar DE",
  "delivery_period": {
    "id": "2026-Q3",
    "type": "quarter",
    "display_name": "Q3 2026",
    "delivery_start": "2026-07-01",
    "delivery_end": "2026-09-30"
  },
  "nominal_power": 10,
  "price_per_mwh": 52.11,
  "gc_backed": true,
  "assets": [
    {
      "id": "ast_3p7q1z5v",
      "name": "Solar Park SP-1",
      "technology": "solar",
      "nominal_power": 10,
      "annual_production": 10400,
      "mastr_number": "SEE900012345678"
    }
  ],
  "general_agreement_date": "2026-05-04",
  "concluded_at": "2026-05-12T08:42:17Z",
  "document_url": "https://api.otark.com/v1/contracts/7K2QP/document"
}

{
  "type": "https://api.otark.com/errors/invalid_api_key",
  "title": "Ungültiger API-Schlüssel",
  "status": 401
}

{
  "type": "https://api.otark.com/errors/insufficient_scopes",
  "title": "Unzureichende Scopes des API-Schlüssels",
  "status": 403,
  "detail": "Missing scope: rfq:write. Please create a new API key with the required scopes."
}

{
  "type": "https://api.otark.com/errors/rfq_not_found",
  "title": "Anfrage nicht gefunden",
  "status": 404,
  "instance": "/v1/rfqs/rfq_h7t2m9c4"
}

{
  "type": "https://api.otark.com/errors/indicative_quote_not_acceptable",
  "title": "Indikatives Angebot nicht annehmbar",
  "status": 409,
  "detail": "Indicative quotes cannot be accepted. Only binding quotes can be accepted."
}