Skip to main content
POST
/
v2
/
datev-rewe
/
buchung
Buchung erstellen
curl --request POST \
  --url https://api.business-os.de/v2/datev-rewe/buchung \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "kontenrahmen": "SKR03",
  "kontonummernLaenge": 4,
  "geschaeftsjahrStartDatum": "2025-01-01",
  "waehrung": "EUR",
  "sollHabenKennzeichen": "HABEN",
  "buchungstext": "Ausgangsrechnung März 2025",
  "belegfeld1": "RE-2025-0042",
  "transaktionsdatum": "2025-03-31T00:00:00Z",
  "buchungszeilen": [
    {
      "kontonummer": 8400,
      "umsatz": 119,
      "buSchluessel": "03",
      "kostenstelle1": "Marketing",
      "kostenstelle2": "Projekt-42",
      "skontobetrag": 2.38
    }
  ],
  "belegId": "768E0E789A70499B91729C4516143135",
  "lieferdatum": "2025-03-28T00:00:00Z",
  "faelligkeitsdatum": "2025-04-30T00:00:00Z",
  "wechselkurs": "1,082500",
  "steuererfassungsdatum": "2025-03-31T00:00:00Z"
}
'
{
  "datevAntwort": {
    "status": "ERFOLGREICH",
    "antwortDaten": null,
    "meldungen": []
  },
  "business-os": {
    "neuesGuthaben": 499
  }
}

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"

​
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"

Body

application/json
​
kontenrahmen
enum<string>
required

Kontenrahmen des Mandanten.

Available options:
SKR03,
SKR04,
SKR42,
SKR51,
SKR14
Example:

"SKR03"

​
kontonummernLaenge
integer
required

Länge der Sachkontonummern — muss der Konfiguration im DATEV-Mandanten entsprechen.

Example:

4

​
geschaeftsjahrStartDatum
string<date>
required

Erster Tag des Geschäftsjahres (YYYY-MM-DD). Üblicherweise der 1. Januar.

Example:

"2025-01-01"

​
waehrung
string
required

Währung (ISO 4217, 3-Buchstaben-Code).

Example:

"EUR"

​
sollHabenKennzeichen
enum<string>
required

SOLL (Debit) oder HABEN (Credit) für das Konto in der positiven Buchungszeile.

Available options:
SOLL,
HABEN
Example:

"HABEN"

​
buchungstext
string
required

Beschreibungstext der Buchung (max. 60 Zeichen).

Example:

"Ausgangsrechnung März 2025"

​
belegfeld1
string
required

Belegnummer. Erlaubte Zeichen: Ziffern, Groß- und Kleinbuchstaben sowie $ & % * + - /.

Example:

"RE-2025-0042"

​
transaktionsdatum
string<date-time>
required

Buchungsdatum. ISO-8601-Datum und -Uhrzeit mit Zeitzone (RFC 3339).

Example:

"2025-03-31T00:00:00Z"

​
buchungszeilen
object[]
required

Buchungszeilen. Jede Buchung muss mindestens zwei Zeilen enthalten — eine mit positivem und eine mit negativem umsatz.

Minimum array length: 2
​
belegId
string

ID einer zuvor mit POST /v2/datev-rewe/beleg-bereitstellen hochgeladenen Datei.

Example:

"768E0E789A70499B91729C4516143135"

​
lieferdatum
string<date-time>

Lieferdatum. ISO-8601-Datum und -Uhrzeit mit Zeitzone (RFC 3339). Wenn gesetzt, ist steuererfassungsdatum Pflicht.

Example:

"2025-03-28T00:00:00Z"

​
faelligkeitsdatum
string<date-time>

Fälligkeitsdatum. ISO-8601-Datum und -Uhrzeit mit Zeitzone (RFC 3339).

Example:

"2025-04-30T00:00:00Z"

​
wechselkurs
string

Wechselkurs — Pflicht wenn waehrung nicht EUR. Format: bis zu 4 Stellen, Komma, 2–6 Nachkommastellen (z. B. 1,234567).

Example:

"1,082500"

​
steuererfassungsdatum
string<date-time>

Steuererfassungsdatum. ISO-8601-Datum und -Uhrzeit mit Zeitzone (RFC 3339). Pflicht wenn lieferdatum gesetzt.

Example:

"2025-03-31T00:00:00Z"

Response

Buchung erfolgreich erstellt

​
datevAntwort
object
​
business-os
object