> ## Documentation Index > Fetch the complete documentation index at: https://docs.business-os.de/llms.txt > Use this file to discover all available pages before exploring further. # BWA (Betriebswirtschaftliche Auswertung) > Aggregiert die Summen- und Saldenliste (aktuelles Geschäftsjahr + Vorjahr) zur **DATEV-Standard-BWA Form 01 ("Kurzfristige Erfolgsrechnung")** mit standardisierter SKR03/SKR04-Zuordnung. Perioden-orientierte Ausgabe je nach `einheit` (Monat/Quartal/Jahr) mit Veränderung zur Vorperiode (PoP) und zum Vorjahr (YoY) je Position. **Wichtig:** Dies ist **nicht** die kanzleiindividuelle DATEV-BWA des Steuerberaters, sondern eine standardisierte Auswertung auf Basis der Summen- und Saldenliste — sie kann von der offiziellen BWA abweichen. Keine steuerliche Beratung. Nur für Mandanten mit Kontenrahmen **SKR03 oder SKR04** (sonst `verfuegbar: false`). Der Kontenrahmen wird automatisch aus dem Kontenplan erkannt. **Kosten:** 1 Credit ## OpenAPI ````yaml GET /v2/datev-rewe-read/bwa openapi: 3.1.0 info: title: Business OS API description: >- API für Business OS – Zugang zu DATEV und Banking Enterprise-Schnittstellen. Alle Endpoints erfordern einen API Key im `x-api-key` Header. Credits werden pro API-Call abgezogen. version: 2.0.0 contact: name: Business OS Support email: impressum@business-os.de url: https://business-os.de/kontakt servers: - url: https://api.business-os.de description: Production security: - ApiKeyAuth: [] tags: - name: DATEV Allgemein description: >- Modulübergreifende DATEV-Endpunkte (z. B. Abo-/Service-Diagnose für Mandanten) - name: DATEV DUO description: DATEV Unternehmen Online — Kassenbuch, Belegbilder und Buchungsvorschläge - name: DATEV ReWe - Write description: 'DATEV Rechnungswesen — Write: Buchungen, Kontakte, Belegtypen, Steuersätze' - name: DATEV ReWe - Read description: >- DATEV Rechnungswesen — Read (Export): Geschäftsjahre und weitere Lesemodule - name: Banking AIS description: >- Account Information Services — Verbindungen, Kontostände und Transaktionen verwalten - name: Banking PIS description: Payment Initiation Services — Zahlungen ausführen und Status abrufen - name: Banking Webhooks description: Webhook-Konfiguration für Echtzeit-Benachrichtigungen paths: /v2/datev-rewe-read/bwa: get: tags: - DATEV ReWe - Read summary: BWA (Betriebswirtschaftliche Auswertung) description: >- Aggregiert die Summen- und Saldenliste (aktuelles Geschäftsjahr + Vorjahr) zur **DATEV-Standard-BWA Form 01 ("Kurzfristige Erfolgsrechnung")** mit standardisierter SKR03/SKR04-Zuordnung. Perioden-orientierte Ausgabe je nach `einheit` (Monat/Quartal/Jahr) mit Veränderung zur Vorperiode (PoP) und zum Vorjahr (YoY) je Position. **Wichtig:** Dies ist **nicht** die kanzleiindividuelle DATEV-BWA des Steuerberaters, sondern eine standardisierte Auswertung auf Basis der Summen- und Saldenliste — sie kann von der offiziellen BWA abweichen. Keine steuerliche Beratung. Nur für Mandanten mit Kontenrahmen **SKR03 oder SKR04** (sonst `verfuegbar: false`). Der Kontenrahmen wird automatisch aus dem Kontenplan erkannt. **Kosten:** 1 Credit parameters: - $ref: '#/components/parameters/ConnectionIdParam' - $ref: '#/components/parameters/CompanyIdParam' - name: geschaeftsjahrStartDatum in: query required: true schema: type: string format: date example: '2025-01-01' description: >- Startdatum des Geschäftsjahrs (YYYY-MM-DD). Das Vorjahr (für YoY) wird automatisch abgeleitet. - name: einheit in: query required: false schema: type: string enum: - monat - quartal - jahr default: monat example: monat description: 'Perioden-Granularität der Ausgabe. Default: monat.' - name: kontenrahmen in: query required: false schema: type: string enum: - SKR03 - SKR04 description: >- Optionaler Override. Ohne Angabe wird der Kontenrahmen aus dem Kontenplan erkannt. - $ref: '#/components/parameters/CreditQuelleParam' responses: '200': description: >- BWA-Auswertung (oder `verfuegbar: false` bei nicht unterstütztem Kontenrahmen) content: application/json: schema: type: object properties: verfuegbar: type: boolean description: >- false, wenn der Kontenrahmen nicht SKR03/SKR04 ist oder keine Daten vorliegen. meta: type: object properties: kontenrahmen: type: string enum: - SKR03 - SKR04 kontenrahmen_quelle: type: string enum: - inferiert_aus_kontenplan - explizit kontonummer_laenge: type: integer example: 8 einheit: type: string enum: - monat - quartal - jahr geschaeftsjahr: type: object properties: jahr: type: integer start: type: string format: date vorjahr: type: integer nullable: true letzte_periode_mit_daten: type: integer example: 12 waehrung: type: string example: EUR disclaimer: type: string quelle: type: string mapping_version: type: string example: skr03-bwa-v1 perioden: type: array description: >- Perioden-Achse (Spalten) gemäß einheit. Bei monat/quartal aus dem GJ-Start auf echte Monate gemappt. items: type: object properties: key: type: string example: 2025-01 label: type: string example: Jan 2025 typ: type: string enum: - monat - quartal - jahr periode_nr: type: integer hat_daten: type: boolean zeilen: type: array description: >- BWA-Staffel in Reihenfolge. Konten-Zeilen tragen konten[], Aggregat-Zeilen formel[]. items: type: object properties: key: type: string example: umsatz label: type: string example: Umsatzerlöse typ: type: string enum: - pos - neg - kost - sum - sumneg - result - final ist_aggregat: type: boolean werte: type: array description: >- Werte parallel zu perioden[]. Vorzeichen: Erträge positiv, Aufwendungen negativ. items: type: object properties: wert: type: number vorperiode: type: object nullable: true description: PoP properties: wert: type: number delta: type: number delta_pct: type: number nullable: true vorjahr: type: object nullable: true description: YoY properties: wert: type: number delta: type: number delta_pct: type: number nullable: true jahr: type: object description: Jahres-Aggregat der Zeile inkl. YoY. properties: wert: type: number vorjahr: type: object properties: wert: type: number delta: type: number delta_pct: type: number nullable: true formel: type: array items: type: string description: 'Nur bei Aggregat-Zeilen: die summierten Zeilen-Keys.' konten: type: array description: 'Nur bei Konten-Zeilen: zugeordnete Einzelkonten.' items: type: object properties: kontonummer: type: string kontobeschriftung: type: string jahreswert: type: number bwa_position: type: string nicht_zugeordnet: type: object description: >- GuV-Konten ohne eindeutige BWA-Zuordnung (Edge-Cases). NICHT in den Summen enthalten. properties: anzahl: type: integer summe_jahr: type: number hinweis: type: string konten: type: array items: type: object properties: kontonummer: type: string kontobeschriftung: type: string jahreswert: type: number klasse: type: integer grund: type: string kontrolle: type: object properties: guv_konten_gesamt: type: integer zugeordnet: type: integer nicht_zugeordnet: type: integer bestandskonten_ignoriert: type: integer abdeckung_prozent: type: number example: 100 jahresergebnis_bwa: type: number business-os: type: object properties: neuesGuthaben: type: integer nullable: true description: Verbleibende Credits nach Abbuchung '400': description: Fehlendes oder ungültiges geschaeftsjahrStartDatum / connectionId content: application/json: schema: $ref: '#/components/schemas/DatevError' example: error: >- Query-Parameter geschaeftsjahrStartDatum ist erforderlich (Format YYYY-MM-DD, Startdatum des Geschäftsjahrs). '401': $ref: '#/components/responses/DatevUnauthorized' '402': $ref: '#/components/responses/DatevPaymentRequired' '404': $ref: '#/components/responses/DatevNoConnection404Rewe' '500': $ref: '#/components/responses/DatevInternal500' '502': $ref: '#/components/responses/DatevBadGateway502' default: $ref: '#/components/responses/DatevServiceError' x-codeSamples: - lang: Shell label: curl source: |- curl --request GET \ --url 'https://api.business-os.de/v2/datev-rewe-read/bwa?geschaeftsjahrStartDatum=2025-01-01&einheit=monat&quelle=API' \ --header 'x-api-key: ' components: parameters: ConnectionIdParam: name: connectionId in: query required: true schema: type: string format: uuid example: abbc18fd-ba5e-4dfd-afc4-9dec0c0ad145 description: >- UUID der DATEV-Verbindung. Abrufbar über den `/connections`-Endpunkt des jeweiligen Moduls (z. B. `GET /v2/datev-duo/connections`). CompanyIdParam: name: companyId in: query required: false schema: type: string example: 386587-29183 description: >- Mandanten-ID im Format `-`. Nur nötig wenn die Connection mehrere Mandanten umfasst (Steuerberater-Account) und nicht der Default-Mandant gemeint ist. Ohne diesen Parameter nutzt DATEV den beim OAuth gewählten Default-Mandanten — der hat aber je nach Setup keine Export-Subscription, dann kommt 403 zurück. CreditQuelleParam: name: quelle in: query required: false schema: type: string default: API example: Make description: >- Kennzeichnung der Aufrufquelle für die Nutzungsanalyse. Standard bei Weglassen: `API` (direkter API-Aufruf). Für Automationen aus Make z. B. `Make` angeben. schemas: DatevError: type: object description: >- JSON-Fehlerantwort. Bei Fehlern der DATEV-Schnittstelle kann zusätzlich `details` gesetzt sein. Bei bekannten Fehlerkategorien ist ein stabiler `code` gesetzt, anhand dessen Automatisierungen reagieren können. required: - error properties: error: type: string description: Fehlermeldung message: type: string description: >- Zusätzliche Erläuterung; wenn der Header `x-api-key` fehlt: Hinweis zur erforderlichen Header-Zeile. code: type: string description: >- Stabiler, maschinenlesbarer Fehlercode für bekannte Fehlerkategorien. Wird nur gesetzt, wenn die Ursache eindeutig erkannt wurde. - `datev_connection_invalid`: Account-Key ist abgelaufen oder widerrufen — Reconnect über das Dashboard nötig. Begleitet von `reconnectUrl`. - `datev_export_service_missing`: Mandant hat keine relevante DATEV-Subscription gebucht (z. B. Belegbilderservice, Rechnungsdatenservice, Datenservice Export Rechnungswesen-Familie). Begleitet von `activeSubscriptions` mit der Liste der tatsächlich aktiven Services. - `datev_endpoint_not_authorized`: Subscription am Mandanten ist vorhanden und der Token gilt, aber das DATEV-RVO-Schreib-/Leserecht für den konkreten Endpoint fehlt für den authentifizierten Nutzer. Reconnect hilft hier nicht — der Steuerberater/Mandant-Inhaber muss in DATEV RVO das entsprechende Teilrecht freischalten. enum: - datev_connection_invalid - datev_export_service_missing - datev_endpoint_not_authorized reconnectUrl: type: string format: uri description: >- URL zum Business OS Dashboard, über die der Nutzer die DATEV-Verbindung erneuern kann. Gesetzt bei `code = datev_connection_invalid`. activeSubscriptions: type: array items: type: string description: >- Liste der aktuell aktiven DATEV-Service-Subscriptions des Mandanten (z. B. Belegbilderservice, Rechnungsdatenservice 1.0). Gesetzt bei `code = datev_export_service_missing`, damit Automationen erkennen, welche Services bereits gebucht sind. details: type: object description: >- Strukturierte Zusatzinformationen bei Antworten der DATEV-Schnittstelle. additionalProperties: true responses: DatevUnauthorized: description: >- API-Key fehlt, ist ungültig, widerrufen oder abgelaufen. Fehlt der Header `x-api-key`, enthält die Antwort zusätzlich `message`. content: application/json: schema: $ref: '#/components/schemas/DatevError' examples: ungueltigerKey: summary: Ungültiger oder unbekannter Key value: error: Ungültiger API-Key fehlenderHeader: summary: Fehlender x-api-key Header value: error: Fehlende Header message: x-api-key Header ist erforderlich. DatevPaymentRequired: description: Nicht genügend Credits für diesen Aufruf. content: application/json: schema: $ref: '#/components/schemas/DatevError' example: error: Nicht genügend Credits DatevNoConnection404Rewe: description: >- Es ist keine gespeicherte DATEV-Verbindung für das gewählte DATEV Rechnungswesen-Produkt (Read oder Write) vorhanden. content: application/json: schema: $ref: '#/components/schemas/DatevError' example: error: Keine Verbindung gefunden für DATEV Rechnungswesen - Write DatevInternal500: description: >- Unerwarteter Serverfehler oder fehlende Serverkonfiguration für den DATEV-Dienst. content: application/json: schema: $ref: '#/components/schemas/DatevError' example: error: API-Dienst nicht konfiguriert. DatevBadGateway502: description: >- Die DATEV-Schnittstelle war kurzzeitig nicht erreichbar (Netzwerk- oder Verbindungsfehler). content: application/json: schema: $ref: '#/components/schemas/DatevError' example: error: Die DATEV-Schnittstelle ist vorübergehend nicht erreichbar. DatevServiceError: description: >- Fehlerantwort der DATEV-Schnittstelle (HTTP-Status entspricht der DATEV-Antwort). Der Body enthält `error` und optional `details` mit Zusatzinformationen. Bei 403 wegen fehlendem DATEV Rechnungswesen-Exportservice ist zusätzlich `code = datev_export_service_missing` und `activeSubscriptions` gesetzt. content: application/json: schema: $ref: '#/components/schemas/DatevError' examples: mitDetails: summary: Beispiel mit details value: error: Validierung fehlgeschlagen details: message: … exportserviceFehlt: summary: 403 – DATEV Rechnungswesen-Exportservice nicht abonniert value: error: >- DATEV Rechnungswesen-Exportservice ist für diesen Mandanten nicht abonniert. Aktive Services: Belegbilderservice, Rechnungsdatenservice 1.0. Bitte den Service über DATEV beim Mandant aktivieren. code: datev_export_service_missing activeSubscriptions: - Belegbilderservice - Rechnungsdatenservice 1.0 details: errors: - message: 'RVO-Recht fehlt: Stammdaten' verbindungUngueltig: summary: 401 – DATEV-Verbindung ungültig (zur Referenz) value: error: >- Die DATEV-Verbindung ist ungültig oder abgelaufen. Bitte im Business OS Dashboard die Verbindung erneuern. code: datev_connection_invalid reconnectUrl: https://app.business-os.de/ securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Dein Business OS API Key. Erstelle einen unter [app.business-os.de](https://app.business-os.de/) → API Keys. ````