Skip to main content
POST
/
v2
/
datev-duo
/
beleg-bereitstellen
curl
curl --request POST \
  --url 'https://api.business-os.de/v2/datev-duo/beleg-bereitstellen?quelle=API' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "datei": {
    "content": "JVBERi0xLjQK...",
    "dateiname": "rechnung-2025-03.pdf"
  },
  "belegtyp": "Rechnungseingang",
  "id": "b5e624e5-fb9e-4836-a443-87a3820f5b48",
  "belegnotiz": "Bürobedarf März"
}
'
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "dateiname": "rechnung-2025-03.pdf",
  "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
​
datei
object
required
​
belegtyp
string
required

Belegtyp wie das Feld belegtyp aus GET /v2/datev-duo/belegtypen

Example:

"Rechnungseingang"

​
id
string<uuid>

Optionale GUID zur eindeutigen Identifikation des Dokuments

Example:

"b5e624e5-fb9e-4836-a443-87a3820f5b48"

​
belegnotiz
string

Optionale Notiz für den Steuerberater (max. 60 Zeichen)

Maximum string length: 60
Example:

"Bürobedarf März"

Response

Datei erfolgreich hochgeladen

​
id
string

Datei-ID in DATEV

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

​
dateiname
string

Gespeicherter Dateiname

Example:

"rechnung-2025-03.pdf"

​
business-os
object