Buchung erstellen

curl --request POST \
  --url https://api.business-os.de/v2/datev-rewe/buchung \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "kontenrahmen": "SKR03",
  "kontonummernLaenge": 4,
  "geschaeftsjahrStartDatum": "2025-01-01",
  "waehrung": "EUR",
  "sollHabenKennzeichen": "HABEN",
  "buchungstext": "Ausgangsrechnung März 2025",
  "belegfeld1": "RE-2025-0042",
  "transaktionsdatum": "2025-03-31T00:00:00Z",
  "buchungszeilen": [
    {
      "kontonummer": 8400,
      "umsatz": 119,
      "buSchluessel": "03",
      "kostenstelle1": "Marketing",
      "kostenstelle2": "Projekt-42",
      "skontobetrag": 2.38
    }
  ],
  "belegId": "768E0E789A70499B91729C4516143135",
  "lieferdatum": "2025-03-28T00:00:00Z",
  "faelligkeitsdatum": "2025-04-30T00:00:00Z",
  "wechselkurs": "1,082500",
  "steuererfassungsdatum": "2025-03-31T00:00:00Z"
}
'

import requests

url = "https://api.business-os.de/v2/datev-rewe/buchung"

payload = {
    "kontenrahmen": "SKR03",
    "kontonummernLaenge": 4,
    "geschaeftsjahrStartDatum": "2025-01-01",
    "waehrung": "EUR",
    "sollHabenKennzeichen": "HABEN",
    "buchungstext": "Ausgangsrechnung März 2025",
    "belegfeld1": "RE-2025-0042",
    "transaktionsdatum": "2025-03-31T00:00:00Z",
    "buchungszeilen": [
        {
            "kontonummer": 8400,
            "umsatz": 119,
            "buSchluessel": "03",
            "kostenstelle1": "Marketing",
            "kostenstelle2": "Projekt-42",
            "skontobetrag": 2.38
        }
    ],
    "belegId": "768E0E789A70499B91729C4516143135",
    "lieferdatum": "2025-03-28T00:00:00Z",
    "faelligkeitsdatum": "2025-04-30T00:00:00Z",
    "wechselkurs": "1,082500",
    "steuererfassungsdatum": "2025-03-31T00:00:00Z"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    kontenrahmen: 'SKR03',
    kontonummernLaenge: 4,
    geschaeftsjahrStartDatum: '2025-01-01',
    waehrung: 'EUR',
    sollHabenKennzeichen: 'HABEN',
    buchungstext: 'Ausgangsrechnung März 2025',
    belegfeld1: 'RE-2025-0042',
    transaktionsdatum: '2025-03-31T00:00:00Z',
    buchungszeilen: [
      {
        kontonummer: 8400,
        umsatz: 119,
        buSchluessel: '03',
        kostenstelle1: 'Marketing',
        kostenstelle2: 'Projekt-42',
        skontobetrag: 2.38
      }
    ],
    belegId: '768E0E789A70499B91729C4516143135',
    lieferdatum: '2025-03-28T00:00:00Z',
    faelligkeitsdatum: '2025-04-30T00:00:00Z',
    wechselkurs: '1,082500',
    steuererfassungsdatum: '2025-03-31T00:00:00Z'
  })
};

fetch('https://api.business-os.de/v2/datev-rewe/buchung', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.business-os.de/v2/datev-rewe/buchung",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'kontenrahmen' => 'SKR03',
    'kontonummernLaenge' => 4,
    'geschaeftsjahrStartDatum' => '2025-01-01',
    'waehrung' => 'EUR',
    'sollHabenKennzeichen' => 'HABEN',
    'buchungstext' => 'Ausgangsrechnung März 2025',
    'belegfeld1' => 'RE-2025-0042',
    'transaktionsdatum' => '2025-03-31T00:00:00Z',
    'buchungszeilen' => [
        [
                'kontonummer' => 8400,
                'umsatz' => 119,
                'buSchluessel' => '03',
                'kostenstelle1' => 'Marketing',
                'kostenstelle2' => 'Projekt-42',
                'skontobetrag' => 2.38
        ]
    ],
    'belegId' => '768E0E789A70499B91729C4516143135',
    'lieferdatum' => '2025-03-28T00:00:00Z',
    'faelligkeitsdatum' => '2025-04-30T00:00:00Z',
    'wechselkurs' => '1,082500',
    'steuererfassungsdatum' => '2025-03-31T00:00:00Z'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.business-os.de/v2/datev-rewe/buchung"

	payload := strings.NewReader("{\n  \"kontenrahmen\": \"SKR03\",\n  \"kontonummernLaenge\": 4,\n  \"geschaeftsjahrStartDatum\": \"2025-01-01\",\n  \"waehrung\": \"EUR\",\n  \"sollHabenKennzeichen\": \"HABEN\",\n  \"buchungstext\": \"Ausgangsrechnung März 2025\",\n  \"belegfeld1\": \"RE-2025-0042\",\n  \"transaktionsdatum\": \"2025-03-31T00:00:00Z\",\n  \"buchungszeilen\": [\n    {\n      \"kontonummer\": 8400,\n      \"umsatz\": 119,\n      \"buSchluessel\": \"03\",\n      \"kostenstelle1\": \"Marketing\",\n      \"kostenstelle2\": \"Projekt-42\",\n      \"skontobetrag\": 2.38\n    }\n  ],\n  \"belegId\": \"768E0E789A70499B91729C4516143135\",\n  \"lieferdatum\": \"2025-03-28T00:00:00Z\",\n  \"faelligkeitsdatum\": \"2025-04-30T00:00:00Z\",\n  \"wechselkurs\": \"1,082500\",\n  \"steuererfassungsdatum\": \"2025-03-31T00:00:00Z\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.business-os.de/v2/datev-rewe/buchung")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"kontenrahmen\": \"SKR03\",\n  \"kontonummernLaenge\": 4,\n  \"geschaeftsjahrStartDatum\": \"2025-01-01\",\n  \"waehrung\": \"EUR\",\n  \"sollHabenKennzeichen\": \"HABEN\",\n  \"buchungstext\": \"Ausgangsrechnung März 2025\",\n  \"belegfeld1\": \"RE-2025-0042\",\n  \"transaktionsdatum\": \"2025-03-31T00:00:00Z\",\n  \"buchungszeilen\": [\n    {\n      \"kontonummer\": 8400,\n      \"umsatz\": 119,\n      \"buSchluessel\": \"03\",\n      \"kostenstelle1\": \"Marketing\",\n      \"kostenstelle2\": \"Projekt-42\",\n      \"skontobetrag\": 2.38\n    }\n  ],\n  \"belegId\": \"768E0E789A70499B91729C4516143135\",\n  \"lieferdatum\": \"2025-03-28T00:00:00Z\",\n  \"faelligkeitsdatum\": \"2025-04-30T00:00:00Z\",\n  \"wechselkurs\": \"1,082500\",\n  \"steuererfassungsdatum\": \"2025-03-31T00:00:00Z\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.business-os.de/v2/datev-rewe/buchung")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"kontenrahmen\": \"SKR03\",\n  \"kontonummernLaenge\": 4,\n  \"geschaeftsjahrStartDatum\": \"2025-01-01\",\n  \"waehrung\": \"EUR\",\n  \"sollHabenKennzeichen\": \"HABEN\",\n  \"buchungstext\": \"Ausgangsrechnung März 2025\",\n  \"belegfeld1\": \"RE-2025-0042\",\n  \"transaktionsdatum\": \"2025-03-31T00:00:00Z\",\n  \"buchungszeilen\": [\n    {\n      \"kontonummer\": 8400,\n      \"umsatz\": 119,\n      \"buSchluessel\": \"03\",\n      \"kostenstelle1\": \"Marketing\",\n      \"kostenstelle2\": \"Projekt-42\",\n      \"skontobetrag\": 2.38\n    }\n  ],\n  \"belegId\": \"768E0E789A70499B91729C4516143135\",\n  \"lieferdatum\": \"2025-03-28T00:00:00Z\",\n  \"faelligkeitsdatum\": \"2025-04-30T00:00:00Z\",\n  \"wechselkurs\": \"1,082500\",\n  \"steuererfassungsdatum\": \"2025-03-31T00:00:00Z\"\n}"

response = http.request(request)
puts response.read_body

{
  "datevAntwort": {
    "status": "ERFOLGREICH",
    "antwortDaten": null,
    "meldungen": []
  },
  "business-os": {
    "neuesGuthaben": 499
  }
}

POST

datev-rewe

buchung

Buchung erstellen

curl --request POST \
  --url https://api.business-os.de/v2/datev-rewe/buchung \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "kontenrahmen": "SKR03",
  "kontonummernLaenge": 4,
  "geschaeftsjahrStartDatum": "2025-01-01",
  "waehrung": "EUR",
  "sollHabenKennzeichen": "HABEN",
  "buchungstext": "Ausgangsrechnung März 2025",
  "belegfeld1": "RE-2025-0042",
  "transaktionsdatum": "2025-03-31T00:00:00Z",
  "buchungszeilen": [
    {
      "kontonummer": 8400,
      "umsatz": 119,
      "buSchluessel": "03",
      "kostenstelle1": "Marketing",
      "kostenstelle2": "Projekt-42",
      "skontobetrag": 2.38
    }
  ],
  "belegId": "768E0E789A70499B91729C4516143135",
  "lieferdatum": "2025-03-28T00:00:00Z",
  "faelligkeitsdatum": "2025-04-30T00:00:00Z",
  "wechselkurs": "1,082500",
  "steuererfassungsdatum": "2025-03-31T00:00:00Z"
}
'

import requests

url = "https://api.business-os.de/v2/datev-rewe/buchung"

payload = {
    "kontenrahmen": "SKR03",
    "kontonummernLaenge": 4,
    "geschaeftsjahrStartDatum": "2025-01-01",
    "waehrung": "EUR",
    "sollHabenKennzeichen": "HABEN",
    "buchungstext": "Ausgangsrechnung März 2025",
    "belegfeld1": "RE-2025-0042",
    "transaktionsdatum": "2025-03-31T00:00:00Z",
    "buchungszeilen": [
        {
            "kontonummer": 8400,
            "umsatz": 119,
            "buSchluessel": "03",
            "kostenstelle1": "Marketing",
            "kostenstelle2": "Projekt-42",
            "skontobetrag": 2.38
        }
    ],
    "belegId": "768E0E789A70499B91729C4516143135",
    "lieferdatum": "2025-03-28T00:00:00Z",
    "faelligkeitsdatum": "2025-04-30T00:00:00Z",
    "wechselkurs": "1,082500",
    "steuererfassungsdatum": "2025-03-31T00:00:00Z"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    kontenrahmen: 'SKR03',
    kontonummernLaenge: 4,
    geschaeftsjahrStartDatum: '2025-01-01',
    waehrung: 'EUR',
    sollHabenKennzeichen: 'HABEN',
    buchungstext: 'Ausgangsrechnung März 2025',
    belegfeld1: 'RE-2025-0042',
    transaktionsdatum: '2025-03-31T00:00:00Z',
    buchungszeilen: [
      {
        kontonummer: 8400,
        umsatz: 119,
        buSchluessel: '03',
        kostenstelle1: 'Marketing',
        kostenstelle2: 'Projekt-42',
        skontobetrag: 2.38
      }
    ],
    belegId: '768E0E789A70499B91729C4516143135',
    lieferdatum: '2025-03-28T00:00:00Z',
    faelligkeitsdatum: '2025-04-30T00:00:00Z',
    wechselkurs: '1,082500',
    steuererfassungsdatum: '2025-03-31T00:00:00Z'
  })
};

fetch('https://api.business-os.de/v2/datev-rewe/buchung', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.business-os.de/v2/datev-rewe/buchung",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'kontenrahmen' => 'SKR03',
    'kontonummernLaenge' => 4,
    'geschaeftsjahrStartDatum' => '2025-01-01',
    'waehrung' => 'EUR',
    'sollHabenKennzeichen' => 'HABEN',
    'buchungstext' => 'Ausgangsrechnung März 2025',
    'belegfeld1' => 'RE-2025-0042',
    'transaktionsdatum' => '2025-03-31T00:00:00Z',
    'buchungszeilen' => [
        [
                'kontonummer' => 8400,
                'umsatz' => 119,
                'buSchluessel' => '03',
                'kostenstelle1' => 'Marketing',
                'kostenstelle2' => 'Projekt-42',
                'skontobetrag' => 2.38
        ]
    ],
    'belegId' => '768E0E789A70499B91729C4516143135',
    'lieferdatum' => '2025-03-28T00:00:00Z',
    'faelligkeitsdatum' => '2025-04-30T00:00:00Z',
    'wechselkurs' => '1,082500',
    'steuererfassungsdatum' => '2025-03-31T00:00:00Z'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.business-os.de/v2/datev-rewe/buchung"

	payload := strings.NewReader("{\n  \"kontenrahmen\": \"SKR03\",\n  \"kontonummernLaenge\": 4,\n  \"geschaeftsjahrStartDatum\": \"2025-01-01\",\n  \"waehrung\": \"EUR\",\n  \"sollHabenKennzeichen\": \"HABEN\",\n  \"buchungstext\": \"Ausgangsrechnung März 2025\",\n  \"belegfeld1\": \"RE-2025-0042\",\n  \"transaktionsdatum\": \"2025-03-31T00:00:00Z\",\n  \"buchungszeilen\": [\n    {\n      \"kontonummer\": 8400,\n      \"umsatz\": 119,\n      \"buSchluessel\": \"03\",\n      \"kostenstelle1\": \"Marketing\",\n      \"kostenstelle2\": \"Projekt-42\",\n      \"skontobetrag\": 2.38\n    }\n  ],\n  \"belegId\": \"768E0E789A70499B91729C4516143135\",\n  \"lieferdatum\": \"2025-03-28T00:00:00Z\",\n  \"faelligkeitsdatum\": \"2025-04-30T00:00:00Z\",\n  \"wechselkurs\": \"1,082500\",\n  \"steuererfassungsdatum\": \"2025-03-31T00:00:00Z\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.business-os.de/v2/datev-rewe/buchung")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"kontenrahmen\": \"SKR03\",\n  \"kontonummernLaenge\": 4,\n  \"geschaeftsjahrStartDatum\": \"2025-01-01\",\n  \"waehrung\": \"EUR\",\n  \"sollHabenKennzeichen\": \"HABEN\",\n  \"buchungstext\": \"Ausgangsrechnung März 2025\",\n  \"belegfeld1\": \"RE-2025-0042\",\n  \"transaktionsdatum\": \"2025-03-31T00:00:00Z\",\n  \"buchungszeilen\": [\n    {\n      \"kontonummer\": 8400,\n      \"umsatz\": 119,\n      \"buSchluessel\": \"03\",\n      \"kostenstelle1\": \"Marketing\",\n      \"kostenstelle2\": \"Projekt-42\",\n      \"skontobetrag\": 2.38\n    }\n  ],\n  \"belegId\": \"768E0E789A70499B91729C4516143135\",\n  \"lieferdatum\": \"2025-03-28T00:00:00Z\",\n  \"faelligkeitsdatum\": \"2025-04-30T00:00:00Z\",\n  \"wechselkurs\": \"1,082500\",\n  \"steuererfassungsdatum\": \"2025-03-31T00:00:00Z\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.business-os.de/v2/datev-rewe/buchung")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"kontenrahmen\": \"SKR03\",\n  \"kontonummernLaenge\": 4,\n  \"geschaeftsjahrStartDatum\": \"2025-01-01\",\n  \"waehrung\": \"EUR\",\n  \"sollHabenKennzeichen\": \"HABEN\",\n  \"buchungstext\": \"Ausgangsrechnung März 2025\",\n  \"belegfeld1\": \"RE-2025-0042\",\n  \"transaktionsdatum\": \"2025-03-31T00:00:00Z\",\n  \"buchungszeilen\": [\n    {\n      \"kontonummer\": 8400,\n      \"umsatz\": 119,\n      \"buSchluessel\": \"03\",\n      \"kostenstelle1\": \"Marketing\",\n      \"kostenstelle2\": \"Projekt-42\",\n      \"skontobetrag\": 2.38\n    }\n  ],\n  \"belegId\": \"768E0E789A70499B91729C4516143135\",\n  \"lieferdatum\": \"2025-03-28T00:00:00Z\",\n  \"faelligkeitsdatum\": \"2025-04-30T00:00:00Z\",\n  \"wechselkurs\": \"1,082500\",\n  \"steuererfassungsdatum\": \"2025-03-31T00:00:00Z\"\n}"

response = http.request(request)
puts response.read_body

{
  "datevAntwort": {
    "status": "ERFOLGREICH",
    "antwortDaten": null,
    "meldungen": []
  },
  "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

kontenrahmen

enum<string>

required

Kontenrahmen des Mandanten.

Available options:

SKR03,

SKR04,

SKR42,

SKR51,

SKR14

Example:

"SKR03"

kontonummernLaenge

integer

required

Länge der Sachkontonummern — muss der Konfiguration im DATEV-Mandanten entsprechen.

Example:

4

geschaeftsjahrStartDatum

string<date>

required

Erster Tag des Geschäftsjahres (YYYY-MM-DD). Üblicherweise der 1. Januar.

Example:

"2025-01-01"

waehrung

string

required

Währung (ISO 4217, 3-Buchstaben-Code).

Example:

"EUR"

sollHabenKennzeichen

enum<string>

required

SOLL (Debit) oder HABEN (Credit) für das Konto in der positiven Buchungszeile.

Available options:

SOLL,

HABEN

Example:

"HABEN"

buchungstext

string

required

Beschreibungstext der Buchung (max. 60 Zeichen).

Example:

"Ausgangsrechnung März 2025"

belegfeld1

string

required

Belegnummer. Erlaubte Zeichen: Ziffern, Groß- und Kleinbuchstaben sowie $ & % * + - /.

Example:

"RE-2025-0042"

transaktionsdatum

string<date-time>

required

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

Example:

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

buchungszeilen

object[]

required

Buchungszeilen. Jede Buchung muss mindestens zwei Zeilen enthalten — eine mit positivem und eine mit negativem umsatz.

Minimum array length: 2

Show child attributes

belegId

string

ID einer zuvor mit POST /v2/datev-rewe/beleg-bereitstellen hochgeladenen Datei.

Example:

"768E0E789A70499B91729C4516143135"

lieferdatum

string<date-time>

Lieferdatum. ISO-8601-Datum und -Uhrzeit mit Zeitzone (RFC 3339). Wenn gesetzt, ist steuererfassungsdatum Pflicht.

Example:

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

faelligkeitsdatum

string<date-time>

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

Example:

"2025-04-30T00:00:00Z"

wechselkurs

string

Wechselkurs — Pflicht wenn waehrung nicht EUR. Format: bis zu 4 Stellen, Komma, 2–6 Nachkommastellen (z. B. 1,234567).

Example:

"1,082500"

steuererfassungsdatum

string<date-time>

Steuererfassungsdatum. ISO-8601-Datum und -Uhrzeit mit Zeitzone (RFC 3339). Pflicht wenn lieferdatum gesetzt.

Example:

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

Response

Buchung erfolgreich erstellt

datevAntwort

object | null

Show child attributes

business-os

object

Show child attributes

Personenkonto anlegen / aktualisieren Verbindungen