Skip to main content
POST
/
v2
/
datev-duo
/
kassenbuch-advanced
Kassenbucheintrag (advanced)
curl --request POST \
  --url https://api.business-os.de/v2/datev-duo/kassenbuch-advanced \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "waehrung": "EUR",
  "kassenname": "Kasse",
  "betrag": 119,
  "transaktionsdatum": "2025-03-01T00:00:00Z",
  "belegzeilen": [
    {
      "belegtext": "Büromaterial",
      "gegenkonto": "4930",
      "belegNummer": "INV-123",
      "betrag": 119,
      "steuersatz": {
        "prozent": 19,
        "buSchluessel": "3"
      },
      "kostenstelle1": "<string>",
      "kostenstelle2": "<string>"
    }
  ],
  "belegbilder": [
    {
      "content": "<string>",
      "dateiname": "beleg.pdf"
    }
  ]
}
'
{ "erstellungsdatum": "2023-11-07T05:31:56Z", "waehrung": "EUR", "belegzeilen": [ { "gegenkonto": "<string>", "erstellungsdatum": "2023-11-07T05:31:56Z", "waehrung": "<string>", "belegtext": "<string>", "belegnummer": "<string>", "betrag": 123, "steuersatz": { "prozent": 123, "buSchluessel": "<string>" }, "kostenstellen": [ { "name": "<string>" } ] } ], "belegbilder": [ {} ], "kassenname": "<string>", "betrag": 123, "transaktionsdatum": "2023-11-07T05:31:56Z", "datevAntwort": { "status": "<string>", "meldungen": [ { "dateiname": "<string>", "nachricht": "<string>", "zeitstempel": "2023-11-07T05:31:56Z", "typ": "<string>" } ] }, "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
​
waehrung
string
required
Example:

"EUR"

​
kassenname
string
required

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

Example:

"Kasse"

​
betrag
number
required

Der Transaktionsbetrag. Muss gleich der Summe der einzelnen Belegzeilen entsprechen. Ein positiver Wert stellt eine Einnahme dar, ein negativer Wert eine Ausgabe.

Example:

119

​
transaktionsdatum
string<date-time>
required

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

Example:

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

​
belegzeilen
object[]
required

Liste der Belegzeilen. Für jede Belegzeile wird ein Kassenbucheintrag erstellt.

​
belegbilder
object[]

Optionale Belegbilder (Quittungen/Dokumente)

Response

Kassenbucheintrag (advanced) erfolgreich erstellt

​
erstellungsdatum
string<date-time>
​
waehrung
string
Example:

"EUR"

​
belegzeilen
object[]
​
belegbilder
object[]

Metadaten zu hochgeladenen Belegbildern

​
kassenname
string
​
betrag
number
​
transaktionsdatum
string<date-time>
​
datevAntwort
object

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

​
business-os
object