property_structure, tenants, contract_debits). Weil sie eine eigene Kategorie sind, lässt
sich ein Key auf kpi beschränken, ohne Zugriff auf diese Listen.
Beide Tabellen werden aus den /v1/-Tabellen der Domänen Property, Stakeholder und Contracts
abgeleitet und folgen deshalb derselben Objektauswahl. Mit der Property-Domäne verknüpfen sie
sich über property_id.
Stichtage
Jede Zeile gehört zu einemreference_date, dem Ersten eines Monats. Jede Tabelle deckt die
letzten 12 Monate einschließlich des laufenden ab, gerechnet ab dem letzten Sync. Eine Fläche
zählt an einem Stichtag, wenn ihr Gültigkeitszeitraum den Stichtag umfasst; ein Mietverhältnis
zählt, wenn sein Vertrag am Stichtag läuft.
property_kpis
GET /v1/kpi/property_kpis: eine Zeile je Objekt und Stichtag. Filterbar nach property_id
und reference_date.
string
erforderlich
Eindeutige Objekt-ID.
date
erforderlich
Stichtag, immer der Erste eines Monats.
integer
Anzahl der am Stichtag aktiven Flächen (Mieteinheiten).
number
Gesamtfläche in m². Nicht historisiert: Auch frühere Stichtage zeigen die aktuelle Fläche.
integer
Anzahl der Flächen ohne laufendes Mietverhältnis am Stichtag. Zählt alle Flächen, auch die
von der Vermarktung ausgeschlossenen.
number
m² der leerstehenden Flächen.
number
Leerstandsquote nach Anzahl Flächen in Prozent, auf zwei Nachkommastellen gerundet.
number
Leerstandsquote nach m² in Prozent, auf zwei Nachkommastellen gerundet.
null, wenn für keine
Fläche des Objekts m² gepflegt sind.integer
Anzahl verschiedener Mieter (Personen) mit laufendem Mietverhältnis auf einer aktiven Fläche.
Ein Mieter mit mehreren Einheiten zählt einmal.
integer
Anzahl laufender Mietverhältnisse (Fläche × Mieter) auf aktiven Flächen. Ein Mieter mit drei
Einheiten zählt dreimal.
integer
Anzahl Geschosse: verschiedene Geschossnamen des Objekts, nicht über Gebäude summiert. Zwei
Gebäude mit jeweils EG bis 2. OG ergeben 3, nicht 6.
number
Erfordert den
personal_financial-Grant.
Monatliches Nettosoll: die Nettomiet-Sollstellungen aller am Stichtag laufenden
Mietverhältnisse.number
Erfordert den
personal_financial-Grant.
net_rent_monthly × 12.property_kpis_by_floor_area_type
GET /v1/kpi/property_kpis_by_floor_area_type: die Flächen-, Leerstands- und Nettosoll-Werte
aus property_kpis, aufgeschlüsselt nach Nutzungsart. Eine Zeile je Objekt, Stichtag und
Nutzungsart. Filterbar nach property_id, reference_date und floor_area_type.
string
erforderlich
Eindeutige Objekt-ID.
date
erforderlich
Stichtag, immer der Erste eines Monats.
string
erforderlich
Nutzungsart der Flächen, wie in
property_structure.floor_area_type. Die Werte stammen aus dem
Katalog der Immobilienverwaltungs-Software des Kunden und sind nicht kundenübergreifend vereinheitlicht.
Flächen ohne Nutzungsart sind unter ohne Angabe zusammengefasst.integer
Wie in
property_kpis, je Nutzungsart.number
Wie in
property_kpis, je Nutzungsart.integer
Wie in
property_kpis, je Nutzungsart.number
Wie in
property_kpis, je Nutzungsart.number
Wie in
property_kpis, je Nutzungsart.number
Wie in
property_kpis, je Nutzungsart.number
Erfordert den
personal_financial-Grant.
Wie in property_kpis, je Nutzungsart.number
Erfordert den
personal_financial-Grant.
Wie in property_kpis, je Nutzungsart.Mieter-, Mietverhältnis- und Geschosszahlen gibt es nur in
property_kpis: Ein Mieter kann
Einheiten verschiedener Nutzungsarten mieten, deshalb lassen sich diese Zahlen nicht je
Nutzungsart aufsummieren. Alle anderen Werte schon: Die Summe von
property_kpis_by_floor_area_type über floor_area_type ergibt die Werte von property_kpis.Das Nettosoll erfordert den
personal_financial-Grant, weil es bei einer Gruppe mit nur einer
vermieteten Einheit die Miete eines einzelnen Mieters ist.