Skip to main content
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"
    }
  ]
}
'
{
  "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

​
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
​
personenkontoNummer
string
required

Personenkonto-Nummer. Ist die Nummer bereits vergeben, wird der bestehende Kontakt aktualisiert.

Example:

"70001"

​
kontaktTyp
enum<string>
required

Art des Geschäftspartners: NATUERLICHE_PERSON (z. B. Freelancer) oder UNTERNEHMEN (juristische Person).

Available options:
NATUERLICHE_PERSON,
UNTERNEHMEN
Example:

"UNTERNEHMEN"

​
kontenrahmen
string
required

Kontenrahmen des Mandanten.

Example:

"SKR03"

​
kontonummernLaenge
integer
required

Länge der Kontonummer des Mandanten.

Example:

5

​
geschaeftsjahrStartDatum
string<date>
required

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

Example:

"2025-01-01"

​
firmenname
string

Firmenname (für kontaktTyp: UNTERNEHMEN).

Example:

"Beispiel GmbH"

​
ustId
string

Umsatzsteuer-Identifikationsnummer (USt-IdNr.).

Example:

"DE123456789"

​
emailAdressen
object[]

E-Mail-Adressen des Geschäftspartners. Nur bei UNTERNEHMEN — bei NATUERLICHE_PERSON müssen E-Mail-Adressen innerhalb von kontaktpersonen angegeben werden.

​
telefonnummern
object[]

Telefonnummern des Geschäftspartners. Nur bei UNTERNEHMEN — bei NATUERLICHE_PERSON müssen Telefonnummern innerhalb von kontaktpersonen angegeben werden.

​
bankkonten
object[]

Bankverbindungen des Geschäftspartners.

​
kontaktpersonen
object[]

Kontaktpersonen des Geschäftspartners. Pflicht bei NATUERLICHE_PERSON (mind. 1 Eintrag). Verboten bei UNTERNEHMEN.

Minimum array length: 1
​
adressen
object[]

Adressen des Geschäftspartners.

Response

Geschäftspartner erfolgreich angelegt / aktualisiert

​
data
object
​
datevAntwort
object
​
business-os
object