Geschäftspartner anlegen / aktualisieren
curl --request POST \
--url https://api.business-os.de/v2/datev-rewe/personenkonto \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"personenkontoNummer": "70001",
"kontaktTyp": "UNTERNEHMEN",
"kontenrahmen": "SKR03",
"kontonummernLaenge": 5,
"geschaeftsjahrStartDatum": "2025-01-01",
"firmenname": "Beispiel GmbH",
"ustId": "DE123456789",
"emailAdressen": [
{
"email": "info@beispiel.de",
"typ": "GESCHAEFTLICH"
}
],
"telefonnummern": [
{
"nummer": "+49 89 123456",
"typ": "GESCHAEFTLICH"
}
],
"bankkonten": [
{
"iban": "DE89370400440532013000",
"bic": "COBADEFFXXX",
"name": "Geschäftskonto",
"istHauptkonto": true
}
],
"kontaktpersonen": [
{
"vorname": "Max",
"nachname": "Mustermann",
"anrede": "Herr",
"emailAdressen": [
{
"email": "m.mustermann@beispiel.de",
"typ": "GESCHAEFTLICH"
}
],
"telefonnummern": [
{
"nummer": "+49 89 123456",
"typ": "MOBIL"
}
]
}
],
"adressen": [
{
"adresszeile": "Musterstraße 1",
"postleitzahl": "80331",
"ort": "München",
"laendercode": "DE",
"typ": "RECHNUNGSADRESSE"
}
]
}
'import requests
url = "https://api.business-os.de/v2/datev-rewe/personenkonto"
payload = {
"personenkontoNummer": "70001",
"kontaktTyp": "UNTERNEHMEN",
"kontenrahmen": "SKR03",
"kontonummernLaenge": 5,
"geschaeftsjahrStartDatum": "2025-01-01",
"firmenname": "Beispiel GmbH",
"ustId": "DE123456789",
"emailAdressen": [
{
"email": "info@beispiel.de",
"typ": "GESCHAEFTLICH"
}
],
"telefonnummern": [
{
"nummer": "+49 89 123456",
"typ": "GESCHAEFTLICH"
}
],
"bankkonten": [
{
"iban": "DE89370400440532013000",
"bic": "COBADEFFXXX",
"name": "Geschäftskonto",
"istHauptkonto": True
}
],
"kontaktpersonen": [
{
"vorname": "Max",
"nachname": "Mustermann",
"anrede": "Herr",
"emailAdressen": [
{
"email": "m.mustermann@beispiel.de",
"typ": "GESCHAEFTLICH"
}
],
"telefonnummern": [
{
"nummer": "+49 89 123456",
"typ": "MOBIL"
}
]
}
],
"adressen": [
{
"adresszeile": "Musterstraße 1",
"postleitzahl": "80331",
"ort": "München",
"laendercode": "DE",
"typ": "RECHNUNGSADRESSE"
}
]
}
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({
personenkontoNummer: '70001',
kontaktTyp: 'UNTERNEHMEN',
kontenrahmen: 'SKR03',
kontonummernLaenge: 5,
geschaeftsjahrStartDatum: '2025-01-01',
firmenname: 'Beispiel GmbH',
ustId: 'DE123456789',
emailAdressen: [{email: 'info@beispiel.de', typ: 'GESCHAEFTLICH'}],
telefonnummern: [{nummer: '+49 89 123456', typ: 'GESCHAEFTLICH'}],
bankkonten: [
{
iban: 'DE89370400440532013000',
bic: 'COBADEFFXXX',
name: 'Geschäftskonto',
istHauptkonto: true
}
],
kontaktpersonen: [
{
vorname: 'Max',
nachname: 'Mustermann',
anrede: 'Herr',
emailAdressen: [{email: 'm.mustermann@beispiel.de', typ: 'GESCHAEFTLICH'}],
telefonnummern: [{nummer: '+49 89 123456', typ: 'MOBIL'}]
}
],
adressen: [
{
adresszeile: 'Musterstraße 1',
postleitzahl: '80331',
ort: 'München',
laendercode: 'DE',
typ: 'RECHNUNGSADRESSE'
}
]
})
};
fetch('https://api.business-os.de/v2/datev-rewe/personenkonto', 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/personenkonto",
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([
'personenkontoNummer' => '70001',
'kontaktTyp' => 'UNTERNEHMEN',
'kontenrahmen' => 'SKR03',
'kontonummernLaenge' => 5,
'geschaeftsjahrStartDatum' => '2025-01-01',
'firmenname' => 'Beispiel GmbH',
'ustId' => 'DE123456789',
'emailAdressen' => [
[
'email' => 'info@beispiel.de',
'typ' => 'GESCHAEFTLICH'
]
],
'telefonnummern' => [
[
'nummer' => '+49 89 123456',
'typ' => 'GESCHAEFTLICH'
]
],
'bankkonten' => [
[
'iban' => 'DE89370400440532013000',
'bic' => 'COBADEFFXXX',
'name' => 'Geschäftskonto',
'istHauptkonto' => true
]
],
'kontaktpersonen' => [
[
'vorname' => 'Max',
'nachname' => 'Mustermann',
'anrede' => 'Herr',
'emailAdressen' => [
[
'email' => 'm.mustermann@beispiel.de',
'typ' => 'GESCHAEFTLICH'
]
],
'telefonnummern' => [
[
'nummer' => '+49 89 123456',
'typ' => 'MOBIL'
]
]
]
],
'adressen' => [
[
'adresszeile' => 'Musterstraße 1',
'postleitzahl' => '80331',
'ort' => 'München',
'laendercode' => 'DE',
'typ' => 'RECHNUNGSADRESSE'
]
]
]),
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/personenkonto"
payload := strings.NewReader("{\n \"personenkontoNummer\": \"70001\",\n \"kontaktTyp\": \"UNTERNEHMEN\",\n \"kontenrahmen\": \"SKR03\",\n \"kontonummernLaenge\": 5,\n \"geschaeftsjahrStartDatum\": \"2025-01-01\",\n \"firmenname\": \"Beispiel GmbH\",\n \"ustId\": \"DE123456789\",\n \"emailAdressen\": [\n {\n \"email\": \"info@beispiel.de\",\n \"typ\": \"GESCHAEFTLICH\"\n }\n ],\n \"telefonnummern\": [\n {\n \"nummer\": \"+49 89 123456\",\n \"typ\": \"GESCHAEFTLICH\"\n }\n ],\n \"bankkonten\": [\n {\n \"iban\": \"DE89370400440532013000\",\n \"bic\": \"COBADEFFXXX\",\n \"name\": \"Geschäftskonto\",\n \"istHauptkonto\": true\n }\n ],\n \"kontaktpersonen\": [\n {\n \"vorname\": \"Max\",\n \"nachname\": \"Mustermann\",\n \"anrede\": \"Herr\",\n \"emailAdressen\": [\n {\n \"email\": \"m.mustermann@beispiel.de\",\n \"typ\": \"GESCHAEFTLICH\"\n }\n ],\n \"telefonnummern\": [\n {\n \"nummer\": \"+49 89 123456\",\n \"typ\": \"MOBIL\"\n }\n ]\n }\n ],\n \"adressen\": [\n {\n \"adresszeile\": \"Musterstraße 1\",\n \"postleitzahl\": \"80331\",\n \"ort\": \"München\",\n \"laendercode\": \"DE\",\n \"typ\": \"RECHNUNGSADRESSE\"\n }\n ]\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/personenkonto")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"personenkontoNummer\": \"70001\",\n \"kontaktTyp\": \"UNTERNEHMEN\",\n \"kontenrahmen\": \"SKR03\",\n \"kontonummernLaenge\": 5,\n \"geschaeftsjahrStartDatum\": \"2025-01-01\",\n \"firmenname\": \"Beispiel GmbH\",\n \"ustId\": \"DE123456789\",\n \"emailAdressen\": [\n {\n \"email\": \"info@beispiel.de\",\n \"typ\": \"GESCHAEFTLICH\"\n }\n ],\n \"telefonnummern\": [\n {\n \"nummer\": \"+49 89 123456\",\n \"typ\": \"GESCHAEFTLICH\"\n }\n ],\n \"bankkonten\": [\n {\n \"iban\": \"DE89370400440532013000\",\n \"bic\": \"COBADEFFXXX\",\n \"name\": \"Geschäftskonto\",\n \"istHauptkonto\": true\n }\n ],\n \"kontaktpersonen\": [\n {\n \"vorname\": \"Max\",\n \"nachname\": \"Mustermann\",\n \"anrede\": \"Herr\",\n \"emailAdressen\": [\n {\n \"email\": \"m.mustermann@beispiel.de\",\n \"typ\": \"GESCHAEFTLICH\"\n }\n ],\n \"telefonnummern\": [\n {\n \"nummer\": \"+49 89 123456\",\n \"typ\": \"MOBIL\"\n }\n ]\n }\n ],\n \"adressen\": [\n {\n \"adresszeile\": \"Musterstraße 1\",\n \"postleitzahl\": \"80331\",\n \"ort\": \"München\",\n \"laendercode\": \"DE\",\n \"typ\": \"RECHNUNGSADRESSE\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.business-os.de/v2/datev-rewe/personenkonto")
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 \"personenkontoNummer\": \"70001\",\n \"kontaktTyp\": \"UNTERNEHMEN\",\n \"kontenrahmen\": \"SKR03\",\n \"kontonummernLaenge\": 5,\n \"geschaeftsjahrStartDatum\": \"2025-01-01\",\n \"firmenname\": \"Beispiel GmbH\",\n \"ustId\": \"DE123456789\",\n \"emailAdressen\": [\n {\n \"email\": \"info@beispiel.de\",\n \"typ\": \"GESCHAEFTLICH\"\n }\n ],\n \"telefonnummern\": [\n {\n \"nummer\": \"+49 89 123456\",\n \"typ\": \"GESCHAEFTLICH\"\n }\n ],\n \"bankkonten\": [\n {\n \"iban\": \"DE89370400440532013000\",\n \"bic\": \"COBADEFFXXX\",\n \"name\": \"Geschäftskonto\",\n \"istHauptkonto\": true\n }\n ],\n \"kontaktpersonen\": [\n {\n \"vorname\": \"Max\",\n \"nachname\": \"Mustermann\",\n \"anrede\": \"Herr\",\n \"emailAdressen\": [\n {\n \"email\": \"m.mustermann@beispiel.de\",\n \"typ\": \"GESCHAEFTLICH\"\n }\n ],\n \"telefonnummern\": [\n {\n \"nummer\": \"+49 89 123456\",\n \"typ\": \"MOBIL\"\n }\n ]\n }\n ],\n \"adressen\": [\n {\n \"adresszeile\": \"Musterstraße 1\",\n \"postleitzahl\": \"80331\",\n \"ort\": \"München\",\n \"laendercode\": \"DE\",\n \"typ\": \"RECHNUNGSADRESSE\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": null,
"kontonummernLaenge": 4,
"kontenrahmen": "SKR03",
"erstelltAm": "2025-03-15T10:32:27.122Z",
"geschaeftsjahrStartDatum": "2025-01-01",
"eintraege": [
{
"id": null,
"kontaktTyp": "UNTERNEHMEN",
"personenkontoNummer": 70001,
"nummer": null,
"firmenname": "Musterbau GmbH",
"ustId": "DE123456789",
"aktualisiertAm": null,
"projektId": null,
"bankkonten": [
{
"iban": "DE89370400440532013000",
"bic": "COBADEFFXXX",
"name": "Geschäftskonto",
"istHauptkonto": true
}
],
"emailAdressen": [
{
"email": "info@musterbau.de",
"typ": "GESCHAEFTLICH"
}
],
"telefonnummern": [
{
"nummer": "+49 89 123456",
"typ": "GESCHAEFTLICH"
}
],
"kontaktpersonen": [
{
"vorname": "Max",
"nachname": "Mustermann",
"anrede": "Herr",
"emailAdressen": [
{
"email": "m.mustermann@musterbau.de",
"typ": "GESCHAEFTLICH"
}
],
"telefonnummern": [
{
"nummer": "+49 171 9876543",
"typ": "MOBIL"
}
]
}
],
"adressen": [
{
"adresszeile": "Musterstraße 12",
"adresszeile2": null,
"postleitzahl": "80331",
"ort": "München",
"laendercode": "DE",
"typ": "RECHNUNGSADRESSE"
}
]
}
]
},
"datevAntwort": {
"status": "ERFOLGREICH",
"antwortDaten": null,
"meldungen": []
},
"business-os": {
"neuesGuthaben": 499
}
}
DATEV ReWe - Write
Personenkonto anlegen / aktualisieren
Erstellt oder aktualisiert einen Geschäftspartner in DATEV Rechnungswesen.
Kosten: 1 Credit
POST
/
v2
/
datev-rewe
/
personenkonto
Geschäftspartner anlegen / aktualisieren
curl --request POST \
--url https://api.business-os.de/v2/datev-rewe/personenkonto \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"personenkontoNummer": "70001",
"kontaktTyp": "UNTERNEHMEN",
"kontenrahmen": "SKR03",
"kontonummernLaenge": 5,
"geschaeftsjahrStartDatum": "2025-01-01",
"firmenname": "Beispiel GmbH",
"ustId": "DE123456789",
"emailAdressen": [
{
"email": "info@beispiel.de",
"typ": "GESCHAEFTLICH"
}
],
"telefonnummern": [
{
"nummer": "+49 89 123456",
"typ": "GESCHAEFTLICH"
}
],
"bankkonten": [
{
"iban": "DE89370400440532013000",
"bic": "COBADEFFXXX",
"name": "Geschäftskonto",
"istHauptkonto": true
}
],
"kontaktpersonen": [
{
"vorname": "Max",
"nachname": "Mustermann",
"anrede": "Herr",
"emailAdressen": [
{
"email": "m.mustermann@beispiel.de",
"typ": "GESCHAEFTLICH"
}
],
"telefonnummern": [
{
"nummer": "+49 89 123456",
"typ": "MOBIL"
}
]
}
],
"adressen": [
{
"adresszeile": "Musterstraße 1",
"postleitzahl": "80331",
"ort": "München",
"laendercode": "DE",
"typ": "RECHNUNGSADRESSE"
}
]
}
'import requests
url = "https://api.business-os.de/v2/datev-rewe/personenkonto"
payload = {
"personenkontoNummer": "70001",
"kontaktTyp": "UNTERNEHMEN",
"kontenrahmen": "SKR03",
"kontonummernLaenge": 5,
"geschaeftsjahrStartDatum": "2025-01-01",
"firmenname": "Beispiel GmbH",
"ustId": "DE123456789",
"emailAdressen": [
{
"email": "info@beispiel.de",
"typ": "GESCHAEFTLICH"
}
],
"telefonnummern": [
{
"nummer": "+49 89 123456",
"typ": "GESCHAEFTLICH"
}
],
"bankkonten": [
{
"iban": "DE89370400440532013000",
"bic": "COBADEFFXXX",
"name": "Geschäftskonto",
"istHauptkonto": True
}
],
"kontaktpersonen": [
{
"vorname": "Max",
"nachname": "Mustermann",
"anrede": "Herr",
"emailAdressen": [
{
"email": "m.mustermann@beispiel.de",
"typ": "GESCHAEFTLICH"
}
],
"telefonnummern": [
{
"nummer": "+49 89 123456",
"typ": "MOBIL"
}
]
}
],
"adressen": [
{
"adresszeile": "Musterstraße 1",
"postleitzahl": "80331",
"ort": "München",
"laendercode": "DE",
"typ": "RECHNUNGSADRESSE"
}
]
}
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({
personenkontoNummer: '70001',
kontaktTyp: 'UNTERNEHMEN',
kontenrahmen: 'SKR03',
kontonummernLaenge: 5,
geschaeftsjahrStartDatum: '2025-01-01',
firmenname: 'Beispiel GmbH',
ustId: 'DE123456789',
emailAdressen: [{email: 'info@beispiel.de', typ: 'GESCHAEFTLICH'}],
telefonnummern: [{nummer: '+49 89 123456', typ: 'GESCHAEFTLICH'}],
bankkonten: [
{
iban: 'DE89370400440532013000',
bic: 'COBADEFFXXX',
name: 'Geschäftskonto',
istHauptkonto: true
}
],
kontaktpersonen: [
{
vorname: 'Max',
nachname: 'Mustermann',
anrede: 'Herr',
emailAdressen: [{email: 'm.mustermann@beispiel.de', typ: 'GESCHAEFTLICH'}],
telefonnummern: [{nummer: '+49 89 123456', typ: 'MOBIL'}]
}
],
adressen: [
{
adresszeile: 'Musterstraße 1',
postleitzahl: '80331',
ort: 'München',
laendercode: 'DE',
typ: 'RECHNUNGSADRESSE'
}
]
})
};
fetch('https://api.business-os.de/v2/datev-rewe/personenkonto', 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/personenkonto",
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([
'personenkontoNummer' => '70001',
'kontaktTyp' => 'UNTERNEHMEN',
'kontenrahmen' => 'SKR03',
'kontonummernLaenge' => 5,
'geschaeftsjahrStartDatum' => '2025-01-01',
'firmenname' => 'Beispiel GmbH',
'ustId' => 'DE123456789',
'emailAdressen' => [
[
'email' => 'info@beispiel.de',
'typ' => 'GESCHAEFTLICH'
]
],
'telefonnummern' => [
[
'nummer' => '+49 89 123456',
'typ' => 'GESCHAEFTLICH'
]
],
'bankkonten' => [
[
'iban' => 'DE89370400440532013000',
'bic' => 'COBADEFFXXX',
'name' => 'Geschäftskonto',
'istHauptkonto' => true
]
],
'kontaktpersonen' => [
[
'vorname' => 'Max',
'nachname' => 'Mustermann',
'anrede' => 'Herr',
'emailAdressen' => [
[
'email' => 'm.mustermann@beispiel.de',
'typ' => 'GESCHAEFTLICH'
]
],
'telefonnummern' => [
[
'nummer' => '+49 89 123456',
'typ' => 'MOBIL'
]
]
]
],
'adressen' => [
[
'adresszeile' => 'Musterstraße 1',
'postleitzahl' => '80331',
'ort' => 'München',
'laendercode' => 'DE',
'typ' => 'RECHNUNGSADRESSE'
]
]
]),
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/personenkonto"
payload := strings.NewReader("{\n \"personenkontoNummer\": \"70001\",\n \"kontaktTyp\": \"UNTERNEHMEN\",\n \"kontenrahmen\": \"SKR03\",\n \"kontonummernLaenge\": 5,\n \"geschaeftsjahrStartDatum\": \"2025-01-01\",\n \"firmenname\": \"Beispiel GmbH\",\n \"ustId\": \"DE123456789\",\n \"emailAdressen\": [\n {\n \"email\": \"info@beispiel.de\",\n \"typ\": \"GESCHAEFTLICH\"\n }\n ],\n \"telefonnummern\": [\n {\n \"nummer\": \"+49 89 123456\",\n \"typ\": \"GESCHAEFTLICH\"\n }\n ],\n \"bankkonten\": [\n {\n \"iban\": \"DE89370400440532013000\",\n \"bic\": \"COBADEFFXXX\",\n \"name\": \"Geschäftskonto\",\n \"istHauptkonto\": true\n }\n ],\n \"kontaktpersonen\": [\n {\n \"vorname\": \"Max\",\n \"nachname\": \"Mustermann\",\n \"anrede\": \"Herr\",\n \"emailAdressen\": [\n {\n \"email\": \"m.mustermann@beispiel.de\",\n \"typ\": \"GESCHAEFTLICH\"\n }\n ],\n \"telefonnummern\": [\n {\n \"nummer\": \"+49 89 123456\",\n \"typ\": \"MOBIL\"\n }\n ]\n }\n ],\n \"adressen\": [\n {\n \"adresszeile\": \"Musterstraße 1\",\n \"postleitzahl\": \"80331\",\n \"ort\": \"München\",\n \"laendercode\": \"DE\",\n \"typ\": \"RECHNUNGSADRESSE\"\n }\n ]\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/personenkonto")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"personenkontoNummer\": \"70001\",\n \"kontaktTyp\": \"UNTERNEHMEN\",\n \"kontenrahmen\": \"SKR03\",\n \"kontonummernLaenge\": 5,\n \"geschaeftsjahrStartDatum\": \"2025-01-01\",\n \"firmenname\": \"Beispiel GmbH\",\n \"ustId\": \"DE123456789\",\n \"emailAdressen\": [\n {\n \"email\": \"info@beispiel.de\",\n \"typ\": \"GESCHAEFTLICH\"\n }\n ],\n \"telefonnummern\": [\n {\n \"nummer\": \"+49 89 123456\",\n \"typ\": \"GESCHAEFTLICH\"\n }\n ],\n \"bankkonten\": [\n {\n \"iban\": \"DE89370400440532013000\",\n \"bic\": \"COBADEFFXXX\",\n \"name\": \"Geschäftskonto\",\n \"istHauptkonto\": true\n }\n ],\n \"kontaktpersonen\": [\n {\n \"vorname\": \"Max\",\n \"nachname\": \"Mustermann\",\n \"anrede\": \"Herr\",\n \"emailAdressen\": [\n {\n \"email\": \"m.mustermann@beispiel.de\",\n \"typ\": \"GESCHAEFTLICH\"\n }\n ],\n \"telefonnummern\": [\n {\n \"nummer\": \"+49 89 123456\",\n \"typ\": \"MOBIL\"\n }\n ]\n }\n ],\n \"adressen\": [\n {\n \"adresszeile\": \"Musterstraße 1\",\n \"postleitzahl\": \"80331\",\n \"ort\": \"München\",\n \"laendercode\": \"DE\",\n \"typ\": \"RECHNUNGSADRESSE\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.business-os.de/v2/datev-rewe/personenkonto")
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 \"personenkontoNummer\": \"70001\",\n \"kontaktTyp\": \"UNTERNEHMEN\",\n \"kontenrahmen\": \"SKR03\",\n \"kontonummernLaenge\": 5,\n \"geschaeftsjahrStartDatum\": \"2025-01-01\",\n \"firmenname\": \"Beispiel GmbH\",\n \"ustId\": \"DE123456789\",\n \"emailAdressen\": [\n {\n \"email\": \"info@beispiel.de\",\n \"typ\": \"GESCHAEFTLICH\"\n }\n ],\n \"telefonnummern\": [\n {\n \"nummer\": \"+49 89 123456\",\n \"typ\": \"GESCHAEFTLICH\"\n }\n ],\n \"bankkonten\": [\n {\n \"iban\": \"DE89370400440532013000\",\n \"bic\": \"COBADEFFXXX\",\n \"name\": \"Geschäftskonto\",\n \"istHauptkonto\": true\n }\n ],\n \"kontaktpersonen\": [\n {\n \"vorname\": \"Max\",\n \"nachname\": \"Mustermann\",\n \"anrede\": \"Herr\",\n \"emailAdressen\": [\n {\n \"email\": \"m.mustermann@beispiel.de\",\n \"typ\": \"GESCHAEFTLICH\"\n }\n ],\n \"telefonnummern\": [\n {\n \"nummer\": \"+49 89 123456\",\n \"typ\": \"MOBIL\"\n }\n ]\n }\n ],\n \"adressen\": [\n {\n \"adresszeile\": \"Musterstraße 1\",\n \"postleitzahl\": \"80331\",\n \"ort\": \"München\",\n \"laendercode\": \"DE\",\n \"typ\": \"RECHNUNGSADRESSE\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": null,
"kontonummernLaenge": 4,
"kontenrahmen": "SKR03",
"erstelltAm": "2025-03-15T10:32:27.122Z",
"geschaeftsjahrStartDatum": "2025-01-01",
"eintraege": [
{
"id": null,
"kontaktTyp": "UNTERNEHMEN",
"personenkontoNummer": 70001,
"nummer": null,
"firmenname": "Musterbau GmbH",
"ustId": "DE123456789",
"aktualisiertAm": null,
"projektId": null,
"bankkonten": [
{
"iban": "DE89370400440532013000",
"bic": "COBADEFFXXX",
"name": "Geschäftskonto",
"istHauptkonto": true
}
],
"emailAdressen": [
{
"email": "info@musterbau.de",
"typ": "GESCHAEFTLICH"
}
],
"telefonnummern": [
{
"nummer": "+49 89 123456",
"typ": "GESCHAEFTLICH"
}
],
"kontaktpersonen": [
{
"vorname": "Max",
"nachname": "Mustermann",
"anrede": "Herr",
"emailAdressen": [
{
"email": "m.mustermann@musterbau.de",
"typ": "GESCHAEFTLICH"
}
],
"telefonnummern": [
{
"nummer": "+49 171 9876543",
"typ": "MOBIL"
}
]
}
],
"adressen": [
{
"adresszeile": "Musterstraße 12",
"adresszeile2": null,
"postleitzahl": "80331",
"ort": "München",
"laendercode": "DE",
"typ": "RECHNUNGSADRESSE"
}
]
}
]
},
"datevAntwort": {
"status": "ERFOLGREICH",
"antwortDaten": null,
"meldungen": []
},
"business-os": {
"neuesGuthaben": 499
}
}
Authorizations
Dein Business OS API Key. Erstelle einen unter app.business-os.de → API Keys.
Query Parameters
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"
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
Personenkonto-Nummer. Ist die Nummer bereits vergeben, wird der bestehende Kontakt aktualisiert.
Example:
"70001"
Art des Geschäftspartners: NATUERLICHE_PERSON (z. B. Freelancer) oder UNTERNEHMEN (juristische Person).
Available options:
NATUERLICHE_PERSON, UNTERNEHMEN Example:
"UNTERNEHMEN"
Kontenrahmen des Mandanten.
Example:
"SKR03"
Länge der Kontonummer des Mandanten.
Example:
5
Erster Tag des Geschäftsjahres (YYYY-MM-DD). Üblicherweise der 1. Januar.
Example:
"2025-01-01"
Firmenname (für kontaktTyp: UNTERNEHMEN).
Example:
"Beispiel GmbH"
Umsatzsteuer-Identifikationsnummer (USt-IdNr.).
Example:
"DE123456789"
E-Mail-Adressen des Geschäftspartners. Nur bei UNTERNEHMEN — bei NATUERLICHE_PERSON müssen E-Mail-Adressen innerhalb von kontaktpersonen angegeben werden.
Show child attributes
Show child attributes
Telefonnummern des Geschäftspartners. Nur bei UNTERNEHMEN — bei NATUERLICHE_PERSON müssen Telefonnummern innerhalb von kontaktpersonen angegeben werden.
Show child attributes
Show child attributes
Bankverbindungen des Geschäftspartners.
Show child attributes
Show child attributes
Kontaktpersonen des Geschäftspartners. Pflicht bei NATUERLICHE_PERSON (mind. 1 Eintrag). Verboten bei UNTERNEHMEN.
Minimum array length:
1Show child attributes
Show child attributes
Adressen des Geschäftspartners.
Show child attributes
Show child attributes
⌘I