curl

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: <api-key>'

{
  "verfuegbar": true,
  "meta": {
    "kontonummer_laenge": 8,
    "geschaeftsjahr": {
      "jahr": 123,
      "start": "2023-12-25"
    },
    "vorjahr": 123,
    "letzte_periode_mit_daten": 12,
    "waehrung": "EUR",
    "disclaimer": "<string>",
    "quelle": "<string>",
    "mapping_version": "skr03-bwa-v1"
  },
  "perioden": [
    {
      "key": "2025-01",
      "label": "Jan 2025",
      "periode_nr": 123,
      "hat_daten": true
    }
  ],
  "zeilen": [
    {
      "key": "umsatz",
      "label": "Umsatzerlöse",
      "ist_aggregat": true,
      "werte": [
        {
          "wert": 123,
          "vorperiode": {
            "wert": 123,
            "delta": 123,
            "delta_pct": 123
          },
          "vorjahr": {
            "wert": 123,
            "delta": 123,
            "delta_pct": 123
          }
        }
      ],
      "jahr": {
        "wert": 123,
        "vorjahr": {
          "wert": 123,
          "delta": 123,
          "delta_pct": 123
        }
      },
      "formel": [
        "<string>"
      ],
      "konten": [
        {
          "kontonummer": "<string>",
          "kontobeschriftung": "<string>",
          "jahreswert": 123,
          "bwa_position": "<string>"
        }
      ]
    }
  ],
  "nicht_zugeordnet": {
    "anzahl": 123,
    "summe_jahr": 123,
    "hinweis": "<string>",
    "konten": [
      {
        "kontonummer": "<string>",
        "kontobeschriftung": "<string>",
        "jahreswert": 123,
        "klasse": 123,
        "grund": "<string>"
      }
    ]
  },
  "kontrolle": {
    "guv_konten_gesamt": 123,
    "zugeordnet": 123,
    "nicht_zugeordnet": 123,
    "bestandskonten_ignoriert": 123,
    "abdeckung_prozent": 100,
    "jahresergebnis_bwa": 123
  },
  "business-os": {
    "neuesGuthaben": 123
  }
}

DATEV ReWe - Read

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

GET

datev-rewe-read

bwa

curl

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: <api-key>'

{
  "verfuegbar": true,
  "meta": {
    "kontonummer_laenge": 8,
    "geschaeftsjahr": {
      "jahr": 123,
      "start": "2023-12-25"
    },
    "vorjahr": 123,
    "letzte_periode_mit_daten": 12,
    "waehrung": "EUR",
    "disclaimer": "<string>",
    "quelle": "<string>",
    "mapping_version": "skr03-bwa-v1"
  },
  "perioden": [
    {
      "key": "2025-01",
      "label": "Jan 2025",
      "periode_nr": 123,
      "hat_daten": true
    }
  ],
  "zeilen": [
    {
      "key": "umsatz",
      "label": "Umsatzerlöse",
      "ist_aggregat": true,
      "werte": [
        {
          "wert": 123,
          "vorperiode": {
            "wert": 123,
            "delta": 123,
            "delta_pct": 123
          },
          "vorjahr": {
            "wert": 123,
            "delta": 123,
            "delta_pct": 123
          }
        }
      ],
      "jahr": {
        "wert": 123,
        "vorjahr": {
          "wert": 123,
          "delta": 123,
          "delta_pct": 123
        }
      },
      "formel": [
        "<string>"
      ],
      "konten": [
        {
          "kontonummer": "<string>",
          "kontobeschriftung": "<string>",
          "jahreswert": 123,
          "bwa_position": "<string>"
        }
      ]
    }
  ],
  "nicht_zugeordnet": {
    "anzahl": 123,
    "summe_jahr": 123,
    "hinweis": "<string>",
    "konten": [
      {
        "kontonummer": "<string>",
        "kontobeschriftung": "<string>",
        "jahreswert": 123,
        "klasse": 123,
        "grund": "<string>"
      }
    ]
  },
  "kontrolle": {
    "guv_konten_gesamt": 123,
    "zugeordnet": 123,
    "nicht_zugeordnet": 123,
    "bestandskonten_ignoriert": 123,
    "abdeckung_prozent": 100,
    "jahresergebnis_bwa": 123
  },
  "business-os": {
    "neuesGuthaben": 123
  }
}

Authorizations

x-api-key

string

header

required

Dein Business OS API Key. Erstelle einen unter app.business-os.de → API Keys.

Query Parameters

connectionId

string<uuid>

required

UUID der DATEV-Verbindung. Abrufbar über den /connections-Endpunkt des jeweiligen Moduls (z. B. GET /v2/datev-duo/connections).

Example:

"abbc18fd-ba5e-4dfd-afc4-9dec0c0ad145"

companyId

string

Mandanten-ID im Format <Beraternummer>-<Mandantennummer>. 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.

Example:

"386587-29183"

geschaeftsjahrStartDatum

string<date>

required

Startdatum des Geschäftsjahrs (YYYY-MM-DD). Das Vorjahr (für YoY) wird automatisch abgeleitet.

einheit

enum<string>

default:monat

Perioden-Granularität der Ausgabe. Default: monat.

Available options:

monat,

quartal,

jahr

kontenrahmen

enum<string>

Optionaler Override. Ohne Angabe wird der Kontenrahmen aus dem Kontenplan erkannt.

Available options:

SKR03,

SKR04

quelle

string

default:API

Kennzeichnung der Aufrufquelle für die Nutzungsanalyse. Standard bei Weglassen: API (direkter API-Aufruf). Für Automationen aus Make z. B. Make angeben.

Example:

"Make"

Response

BWA-Auswertung (oder verfuegbar: false bei nicht unterstütztem Kontenrahmen)

verfuegbar

boolean

false, wenn der Kontenrahmen nicht SKR03/SKR04 ist oder keine Daten vorliegen.