Skip to main content
POST
/
v2
/
datev-duo
/
kassenbuch-einfach
Kassenbucheintrag (einfach)
curl --request POST \
  --url https://api.business-os.de/v2/datev-duo/kassenbuch-einfach \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "waehrung": "EUR",
  "kassenname": "Kasse",
  "belegtext": "Büromaterial",
  "betrag": 49.99,
  "transaktionsdatum": "2025-03-01T00:00:00Z",
  "belegnummer": "TX-12345",
  "steuersatz": 19,
  "bewegung": "AUSGABE",
  "gegenkonto": "4930",
  "belegNummer": "INV-123",
  "belegbilder": [
    {
      "content": "<string>",
      "dateiname": "quittung-buero.pdf"
    }
  ]
}
'
{
  "belegnummer": "TX-12345",
  "kassenname": "Kasse",
  "transaktionsdatum": "2025-03-01T00:00:00Z",
  "bewegung": "AUSGABE",
  "betrag": -49.99,
  "waehrung": "EUR",
  "belegtext": "Büromaterial",
  "gegenkonto": "4930",
  "belegNummer": "INV-123",
  "steuersatz": 19,
  "belegbilder": [
    {
      "dateiname": "quittung-buero.pdf"
    }
  ],
  "datevAntwort": {
    "status": "ERFOLGREICH",
    "meldungen": [
      {
        "dateiname": "quittung-buero.pdf",
        "nachricht": "Beleg erfolgreich an das Kassenbuch übergeben.",
        "zeitstempel": "2023-11-07T05:31:56Z",
        "typ": "INFO"
      }
    ]
  },
  "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

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

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

​
business-os
object