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
Freischaltung erforderlich
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."
}/rfqs/{rfq_id}/quotes GET
Die auf eine Anfrage eingegangenen Angebote auflisten. Verbindliche und indikative Angebote kommen gemeinsam zurück — der Filter type trennt sie. Annehmbar sind allein verbindliche Angebote; indikative dienen der Preisfindung und lassen sich nicht annehmen. Zurückgezogene Angebote werden nicht geliefert. Erforderlicher Scope: rfq:read
/contracts GET
Die Einzelverträge des angemeldeten Unternehmens auflisten — als Käufer und als Verkäufer, der neueste zuerst. Erforderlicher Scope: contracts:read