Skip to main content
GET
curl

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.

meta
object
perioden
object[]

Perioden-Achse (Spalten) gemäß einheit. Bei monat/quartal aus dem GJ-Start auf echte Monate gemappt.

zeilen
object[]

BWA-Staffel in Reihenfolge. Konten-Zeilen tragen konten[], Aggregat-Zeilen formel[].

nicht_zugeordnet
object

GuV-Konten ohne eindeutige BWA-Zuordnung (Edge-Cases). NICHT in den Summen enthalten.

kontrolle
object
business-os
object