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