> ## Documentation Index
> Fetch the complete documentation index at: https://docs.business-os.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Geschäftspartner

> Write: Erstelle und aktualisiere Geschäftspartner (Kontaktpersonen und Unternehmen) in DATEV Rechnungswesen.

## Definition

Personenkonten sind individuelle Konten im Nebenbuch, die konkreten Geschäftspartnern zugeordnet sind. Sie dienen dazu, Forderungen und Verbindlichkeiten sowie Zahlungen pro Partner detailliert nachzuvollziehen (Offene-Posten-Buchführung). Über dieses Modul kannst du Geschäftspartner in DATEV Rechnungswesen anlegen und aktualisieren.

## Attribute

<ParamField path="personenkontoNummer" type="string" required>
  Personenkonto-Nummer. Ist die Nummer bereits vergeben, wird der bestehende Kontakt aktualisiert.
</ParamField>

<ParamField path="kontaktTyp" type="string" required>
  Art des Geschäftspartners: `NATUERLICHE_PERSON` (z. B. Freelancer) oder `UNTERNEHMEN` (juristische Person).
</ParamField>

<ParamField path="firmenname" type="string">
  Firmenname (für `kontaktTyp: UNTERNEHMEN`).
</ParamField>

<ParamField path="ustId" type="string">
  Umsatzsteuer-Identifikationsnummer (USt-IdNr.).
</ParamField>

<ParamField path="emailAdressen" type="EmailAdresse[]">
  E-Mail-Adressen des Geschäftspartners. Jedes Element mit `email` und `typ` (`GESCHAEFTLICH`).

  **Nur bei `UNTERNEHMEN`** — bei `NATUERLICHE_PERSON` müssen E-Mail-Adressen innerhalb von `kontaktpersonen` angegeben werden.
</ParamField>

<ParamField path="telefonnummern" type="Telefonnummer[]">
  Telefonnummern des Geschäftspartners. Jedes Element mit `nummer` und `typ` (`GESCHAEFTLICH` oder `MOBIL`).

  **Nur bei `UNTERNEHMEN`** — bei `NATUERLICHE_PERSON` müssen Telefonnummern innerhalb von `kontaktpersonen` angegeben werden.
</ParamField>

<ParamField path="bankkonten" type="Bankkonto[]">
  Bankverbindungen des Geschäftspartners. Jedes Element mit `iban`, `bic`, `name` und `istHauptkonto` (boolean).
</ParamField>

<ParamField path="kontaktpersonen" type="KontaktPerson[]">
  Jedes Element mit `vorname`, `nachname`, `anrede`, sowie `emailAdressen[]` und `telefonnummern[]`.

  **Pflicht bei `NATUERLICHE_PERSON`** (mindestens 1 Eintrag). **Verboten bei `UNTERNEHMEN`** — das Feld darf dann nicht mitgeschickt werden.
</ParamField>

<ParamField path="adressen" type="Adresse[]">
  Adressen des Geschäftspartners. Jedes Element mit `adresszeile`, `postleitzahl`, `ort`, `laendercode` (ISO 3166-1 alpha-2) und `typ` (`RECHNUNGSADRESSE` oder `GESCHAEFTLICH`).
</ParamField>

<ParamField path="kontenrahmen" type="string" required>
  Kontenrahmen des Mandanten, z.B. `SKR03`.
</ParamField>

<ParamField path="kontonummernLaenge" type="integer" required>
  Länge der Kontonummer des Mandanten, z.B. `5`.
</ParamField>

<ParamField path="geschaeftsjahrStartDatum" type="string" required>
  Erster Tag des Geschäftsjahres (YYYY-MM-DD). Üblicherweise der 1. Januar, z.B. `2025-01-01`.
</ParamField>

## Verbrauch

<Check>
  Für das Ausführen dieses Moduls wird **1 Credit** berechnet. Deinen detaillierten Verbrauch kannst Du in deinem Dashboard ansehen.
</Check>