Zum Hauptinhalt springen
Keine der vier Tabellen unten verknüpft sich direkt mit einer anderen. employees, owners und tenants verknüpfen sich über property_id mit Property; tenants überbrückt zusätzlich über floor_area_person_id nach Contracts. creditors ist eine eigenständige Entität ohne property_id-Spalte, referenziert aus Property und Accounting über creditor_id. Das vollständige domänenübergreifende Diagramm steht in der Datenmodell-Übersicht. Jede Kante hier wechselt in eine andere Domäne — keine der vier Stakeholder-Tabellen verknüpft sich direkt mit einer anderen.
person_id ist nicht über alle Endpunkte hinweg typkonsistent, die es führen: tenants.person_id und Accounting.booking_headers.person_id sind Strings (z. B. "2001-1"), Accounting.booking_positions.person_id dagegen ein Integer, bei dem der Bindestrich beim Cast entfernt wurde — ein Rück-Cast auf String liefert nicht den ursprünglichen Wert. booking_positions deshalb nicht direkt über person_id mit tenants verknüpfen, sondern über booking_positions.booking_header_id → booking_headers.person_id.

​
creditors

GET /v1/stakeholder/creditors — Kreditoren-Stammdaten. Der einzige Stakeholder-Endpunkt ohne property_id-Spalte — ein Kreditor ist eine eigenständige Entität, die für mehrere Objekte tätig sein kann, referenziert über creditor_id aus Property.technical_objects, Property.property_creditor_services, Contracts.service_contracts und Accounting.booking_headers/booking_positions.
​
string
erforderlich
Eindeutige Kreditorenkennung.
​
string
Nur mit dem Grant personal sichtbar. Erster Namensteil (Firma oder Nachname).
​
string
Nur mit dem Grant personal sichtbar. Zweiter Namensteil.
​
string
Kreditorentyp.
​
string
Nur mit dem Grant personal sichtbar. Erste Adresszeile, oberhalb von street_address.
​
string
Nur mit dem Grant personal sichtbar. Straße und Hausnummer.
​
string
Nur mit dem Grant personal sichtbar. Postleitzahl und Ort, zu einem Feld zusammengefasst.
​
string
Nur mit dem Grant personal sichtbar. E-Mail-Adresse.
​
string
Nur mit dem Grant personal sichtbar. Website-URL. Ein wörtlicher Platzhalter "---" im Quellsystem wird zu null.
​
string
Nur mit dem Grant personal sichtbar. Benannter Ansprechpartner beim Kreditor.
​
string[]
Nur mit dem Grant personal sichtbar. Telefonnummern, bis zu drei je Datensatz. Leere Einträge werden weggelassen.
​
string
Nur mit dem Grant personal_financial sichtbar. Bankname.
​
string
Nur mit dem Grant personal_financial sichtbar. IBAN.
​
string
Nur mit dem Grant personal_financial sichtbar. BIC-Code der Bank des Kreditors.
​
string
Nur mit dem Grant personal_financial sichtbar. Steuernummer.
​
boolean
Ob eine Freistellungsbescheinigung (§48b EStG) vorliegt. Relevant, wenn der Kreditor Bauleistungen erbringt.
​
date
Datum auf der Freistellungsbescheinigung.
​
string
Branchenzuordnung.
​
string
Zusätzliche Brancheninformation.
​
string
Link zum verknüpften Dokument im DMS.

​
employees

GET /v1/stakeholder/employees — das für ein Objekt zuständige Verwaltungsteam.
​
string
erforderlich
Eindeutige Objektkennung.
​
string
Teambezeichnung, die für das Objekt zuständig ist.
​
string
Nur mit dem Grant personal sichtbar. Vorname des Mitarbeiters.
​
string
Nur mit dem Grant personal sichtbar. Nachname des Mitarbeiters.
​
string
Nur mit dem Grant personal sichtbar. Kontakt-Telefonnummer.
​
string
Nur mit dem Grant personal sichtbar. Kontakt-E-Mail-Adresse.
​
boolean
Ob der Mitarbeiter-Datensatz inaktiv ist.
Dieser Endpunkt liefert eine Zeile je Objekt mit dem zuständigen Team/Mitarbeiter — kein allgemeines Mitarbeiterverzeichnis.

​
owners

GET /v1/stakeholder/owners — Eigentümer-Stammdaten inklusive Eigentumsanteil bei Miteigentum.
​
string
erforderlich
Eindeutige Objektkennung.
​
integer
erforderlich
Eigentümerkennung.
​
number
Eigentumsanteil in Prozent, auf 100 gekappt. null bedeutet: kein Anteil erfasst. Ein Objekt kann mehrere owners-Zeilen haben, die sich zum Gesamtanteil summieren.
​
string
Nur mit dem Grant personal sichtbar. Anrede/Titel.
​
string
Nur mit dem Grant personal sichtbar. Eigentümername (Person oder Firma).
​
string
Nur mit dem Grant personal sichtbar. Zweiter Namensteil.
​
string
Nur mit dem Grant personal sichtbar. Straße und Hausnummer.
​
string
Nur mit dem Grant personal sichtbar. Postleitzahl und Ort, zu einem Feld zusammengefasst.
​
string
Nur mit dem Grant personal sichtbar. Kontakt-Telefonnummer.
​
string
Nur mit dem Grant personal_financial sichtbar. Bankname.
​
string
Nur mit dem Grant personal sichtbar. Faxnummer.
​
string
Nur mit dem Grant personal sichtbar. Kontakt-E-Mail-Adresse.
​
string
Nur mit dem Grant personal_financial sichtbar. BIC-Code der Bank des Eigentümers.
​
string
Nur mit dem Grant personal_financial sichtbar. IBAN.
​
string
Nur mit dem Grant personal_financial sichtbar. Eigene Kontonummer des Eigentümers, zusammen mit iban. Nicht zu verwechseln mit Accounting.accounts.account_number, das ein Konto in der Kontenübersicht identifiziert.

​
tenants

GET /v1/stakeholder/tenants — Mieter-Stammdaten und aktuelle Mietvertragskonditionen.
​
string
erforderlich
Eindeutige Objektkennung.
​
string
erforderlich
Kennzeichnet ein Mietverhältnis. Wird von Contracts.contract_debits, Contracts.contract_ends und Contracts.index_rent geteilt — die vollständige Schlüsselreferenz steht in der Datenmodell-Übersicht.
​
integer
Fläche, die der Mieter belegt. Verknüpft sich mit Property.property_structure.floor_area_id.
​
string
Kennzeichnet den Mieter. Nur in Kombination mit property_id gültig, da die Nummerierung je Objekt neu beginnt — siehe die Datenmodell-Übersicht.
​
string
Nur mit dem Grant personal sichtbar. Vollständiger Mietername als ein Feld. Kein getrennter Vor-/Nachname verfügbar.
​
string
Nur mit dem Grant personal sichtbar. Erster Namensteil der eigenen Kontaktadresse des Mieters, sofern abweichend von der Flächenadresse.
​
string
Nur mit dem Grant personal sichtbar. Zweiter Namensteil der eigenen Kontaktadresse des Mieters.
​
string
Nur mit dem Grant personal sichtbar. Straße und Hausnummer der eigenen Kontaktadresse des Mieters.
​
string
Nur mit dem Grant personal sichtbar. Postleitzahl und Ort der eigenen Kontaktadresse des Mieters, zu einem Feld zusammengefasst.
​
string
Nur mit dem Grant personal sichtbar. Haupttelefonnummer.
​
string
Nur mit dem Grant personal sichtbar. Kontakt-E-Mail-Adresse.
​
string[]
Nur mit dem Grant personal sichtbar. Weitere Telefonnummern, bis zu drei je Datensatz — dieselbe Form wie Stakeholder.creditors.phones. Leere Einträge werden weggelassen.
​
string
Nur mit dem Grant personal_financial sichtbar. IBAN.
​
string
Nur mit dem Grant personal_financial sichtbar. Bankname.
​
object
Der Mietvertragszeitraum.
​
date
Vertragsende bei Ausübung einer Verlängerungsoption.
​
date
Frist, bis zu der die Verlängerungsoption ausgeübt werden kann.
​
string
Link zum verknüpften Dokument im DMS.