Skip to main content
Die Property-Domäne ist das strukturelle Fundament der API. Jede Zeile jeder anderen Domäne führt property_id, das sich auf einen Datensatz in properties zurückführen lässt. Nutze diese Domäne, um Objekte, ihre interne Struktur (Einheiten, Kostenstellen), zugewiesene Dienstleister und technische/gemessene Objekte abzurufen.

properties

GET /property/properties — eine Zeile pro Objekt.
integer
erforderlich
Eindeutige Objekt-ID. Der primäre Verknüpfungsschlüssel über alle Domänen hinweg.
integer
Interner Surrogatschlüssel. Nicht stabil über Daten-Reloads hinweg — verknüpfe über property_id, nicht über dieses Feld.
string
Kombiniertes Anzeigelabel: Objekt-ID und Name.
string
Objektname.
string
Primäre Gebäudeeingangs-/Straßenadresskomponente. Es gibt bis zu fünf Eingangsfelder (entrance_1entrance_5) für Objekte mit mehreren Eingängen.
string
Kombinierte Adresszeile.
string
Postleitzahl.
string
Stadt.
Example request

property_structure

GET /property/property_structure — der Hierarchiebaum, der Gebäude, Kostenstellen und Flächen verbindet. Dies ist die Bridge-Tabelle für den Rest der API: Buchungs- und Mietvertragsdaten verknüpfen sich über join_key mit einer bestimmten Einheit oder Kostenstelle, nicht direkt über floor_area_id.
integer
erforderlich
Eindeutige Objekt-ID.
string
erforderlich
Bridge-Key. Entspricht account_id für Kostenstellenknoten oder floor_area_id für Flächenknoten. Accounting.booking_header und Accounting.booking_positions verknüpfen sich über join_key mit dieser Tabelle.
integer
Flächen-ID, wenn dieser Knoten eine Einheit statt einer Kostenstelle repräsentiert.
string
Anzeigename des Strukturknotens (Kostenstellen- oder Einheitenname).
string
Knotentyp — unterscheidet Kostenstellen von Flächen.
property_structure hat selbst keinen natürlichen einspaltigen Primärschlüssel — join_key ist pro Objekt eindeutig, behandle also (property_id, join_key) als effektiven Schlüssel bei Deduplizierung oder Verknüpfung.

property_creditor_services

GET /property/property_creditor_services — welcher Kreditor welche Dienstleistung für ein Objekt erbringt und ob diese Zuweisung exklusiv ist.
integer
erforderlich
Eindeutige Objekt-ID.
integer
erforderlich
Referenziert Stakeholder.creditor.
integer
erforderlich
Identifiziert den Dienstleistungstyp.
string
Name der Dienstleistung (z. B. Reinigung, Aufzugswartung).
string
Ob der Kreditor eine exklusive Zuweisung für diese Dienstleistung bei diesem Objekt hält.

technical_objects

GET /property/technical_objects — technische/gemessene Installationen an einem Objekt (Aufzüge, Heizungsanlagen, Zähler und ähnliche Anlagen).
integer
erforderlich
Eindeutige Objekt-ID.
integer
Fläche, in der das technische Objekt installiert ist, falls zutreffend.
integer
Für das Objekt verantwortlicher Wartungskreditor. Referenziert Stakeholder.creditor.
integer
erforderlich
ID des technischen Objekts.
string
Nummer des technischen Objekts.
string
Objektname.
string
Objekttyp.
date
Installations-/Baudatum.
Es gibt keinen separaten Endpunkt für Zählerstände. Eine technical_objects-Zeile kann einen Zähler repräsentieren, aber dieser Endpunkt liefert nur die Stammdaten des Objekts (Typ, Standort, verantwortlicher Kreditor) — keine Verbrauchsablesungen.