Skip to main content
POST
Kassenbucheintrag (einfach)

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
waehrung
string
required

Währungscode (ISO 4217)

Example:

"EUR"

kassenname
string
required

Name des Kassenbuchs. Kann aus GET /v2/datev-duo/kassenbuecher (Feld bezeichnung) ausgelesen werden.

Example:

"Kasse"

belegtext
string
required

Text zur Buchungsbewegung

Example:

"Büromaterial"

betrag
number
required

Absolutbetrag; Vorzeichen der Buchung ergibt sich aus bewegung.

Example:

49.99

transaktionsdatum
string<date-time>
required

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

Example:

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

belegnummer
string
required

Eindeutige Transaktions-ID. Erlaubte Zeichen: a-z A-Z 0-9 $ % & * + - / (max. 36 Zeichen).

Pattern: ^[a-zA-Z0-9$%&*+\-/]{0,36}$
Example:

"TX-12345"

steuersatz
number
required

Steuersatz in Prozent

Example:

19

bewegung
enum<string>
required

Nur exakt EINNAHME oder AUSGABE (Großschreibung).

Available options:
EINNAHME,
AUSGABE
Example:

"AUSGABE"

gegenkonto
string

Sachkonto als Gegenkonto zur Kasse (z. B. Büromaterial).

Example:

"4930"

belegNummer
string

Kann die Belegnummer enthalten.

Example:

"INV-123"

belegbilder
object[]

Optionale Belegbilder (Quittungen)

Response

Kassenbucheintrag erfolgreich erstellt

belegnummer
string
Example:

"TX-12345"

kassenname
string
Example:

"Kasse"

transaktionsdatum
string<date-time>
Example:

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

bewegung
string
Example:

"AUSGABE"

betrag
number
Example:

-49.99

waehrung
string
Example:

"EUR"

belegtext
string
Example:

"Büromaterial"

gegenkonto
string
Example:

"4930"

belegNummer
string
Example:

"INV-123"

steuersatz
number
Example:

19

belegbilder
object[]

Metadaten zu hochgeladenen Belegbildern (Form je nach Schnittstelle)

datevAntwort
object | null

Ergebnis des DATEV-Async-Tasks. null, wenn kein Task gepollt wurde.

business-os
object