> ## 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.

# Kassenbucheintrag (advanced)

> Write: Erstelle einen oder mehrere Kassenbucheinträge in DATEV Unternehmen Online mit strukturierten buchhalterischen Daten. Ein positiver Betrag stellt eine Einnahme dar, ein negativer Betrag eine Ausgabe.

## Definition

Über den DATEV Kassenbuchdatenservice und DATEV Rechnungsdatenservice kannst du erweiterte Kassenbucheinträge erstellen. Im Vergleich zum einfachen Kassenbucheintrag kannst du hier strukturierte buchhalterische Daten mitgeben — z.B. Steuersätze, Sachkonten oder Kostenstellen. So wird die Buchung in DATEV Rechnungswesen direkt als Buchungsvorschlag bereitgestellt.

## Attribute

<ParamField path="waehrung" type="string" required>
  Währungscode nach ISO 4217, z.B. `EUR`.
</ParamField>

<ParamField path="kassenname" type="string" required>
  Name des Kassenbuchs (wie in DATEV angelegt). Kann aus `GET /v2/datev-duo/kassenbuecher` (Feld `bezeichnung`) ausgelesen werden.
</ParamField>

<ParamField path="betrag" type="number" required>
  Der Transaktionsbetrag. Muss gleich der Summe der einzelnen Belegzeilen entsprechen. Ein positiver Wert stellt eine Einnahme dar, ein negativer Wert eine Ausgabe.
</ParamField>

<ParamField path="transaktionsdatum" type="string" required>
  ISO-8601-Datum und -Uhrzeit mit Zeitzone (RFC 3339), z. B. `2025-03-01T00:00:00Z`.
</ParamField>

<ParamField path="belegzeilen" type="array" required>
  Liste der Belegzeilen. Für jede Belegzeile wird ein Kassenbucheintrag erstellt. Pro Zeile ist **`belegtext` verpflichtend** (nicht leer); dazu u.a. `gegenkonto` (Sachkonto als Gegenkonto zur Kasse), `betrag` (Bruttobetrag der Belegzeile). Optional: `belegNummer` (Beleg- bzw. Dokumentnummer für die Zeile), optional verschachtelt `steuersatz` mit `prozent` (Steuersatz in Prozent) und/oder `buSchluessel` (DATEV-BU-Schlüssel), optional `kostenstelle1` / `kostenstelle2`.

  <Snippet file="betrag.mdx" />
</ParamField>

<ParamField path="belegbilder" type="array">
  Belegbilder (Quittungen/Dokumente): jedes Element mit `content` (Base64) und `dateiname`.
</ParamField>

## Verbrauch

<Check>
  Für das Ausführen dieses Moduls wird **1 Credit** berechnet. Deinen detaillierten Verbrauch kannst Du in deinem Dashboard ansehen.
</Check>