Mietverträge per API, Mietaufstellung im Web-Exposé
Mietverträge lassen sich jetzt über die Public API anlegen, lesen, ändern und löschen — mit Mietern, Bürgen, Miete, Kaution und eigenen Feldern. Und die Mietaufstellung kommt ins Web-Exposé: je Einheit Lage, Fläche, Status und Kaltmiete, Leerstand als eigene Zeile, mit Summen. Ein Schalter am Objekt gibt sie frei; ohne Freigabe verlassen keine Mietdaten das CRM.
- Mietverträge über die Public API anlegen, lesen, ändern und löschen — mit fünf eigenen Rechten je API-Schlüssel
- Mieter, Mitmieter, Bürgen und Vermieter als Kontakte oder Unternehmen, dazu Status, Laufzeit, Miete, Kaution, Kündigung und eigene Felder
- Liste nach Status, Objekt oder eigenem Feld filtern; Änderungen mit ETag gegen gleichzeitiges Überschreiben abgesichert
- Mietaufstellung im Web-Exposé: je Einheit Lage, Fläche, Status, Kaltmiete, Miete je m² und Mietbeginn, freie Einheiten als eigene Zeile, mit Summen
- Freigabe am Objekt unter Veröffentlichung, standardmäßig aus — ohne Freigabe liefert propgen keine Mietdaten an die Landingpage
- Im Standard-Web-Exposé und in eigenen Landingpage-Vorlagen
Wer vermietete Häuser verkauft oder verwaltet, hat die Mietverträge oft schon in einem anderen System. Bisher ließen sie sich in propgen nur in der Oberfläche pflegen. Jetzt kommen sie auch über die Public API — und was aus ihnen folgt, die Mietaufstellung, landet auf Wunsch im Web-Exposé. Kaufinteressenten einer Kapitalanlage sehen dort, was das Haus heute einbringt und wo Leerstand ist.
Mietaufstellung im Web-Exposé
- Je Einheit eine Zeile. Lage, Fläche, Status, Kaltmiete, Miete je m² und Mietbeginn kommen aus den Mietverträgen. Jede freie Einheit bekommt eine eigene Leerstandszeile, darunter stehen die Summen für Fläche, Leerstandsquote und Kaltmiete.
- Erst nach Freigabe. Unter Objekt-Details → Veröffentlichung → „Mietaufstellung auf der Landingpage anzeigen“. Der Schalter ist standardmäßig aus. Solange er aus ist, liefert propgen keine Mietdaten an die Landingpage, und der Block entfällt ganz. Objekte ohne Mietverträge zeigen ihn ohnehin nicht.
- Im Standard und in eigenen Vorlagen. Die Mietaufstellung erscheint im Standard-Web-Exposé. Wer eine eigene Landingpage-Vorlage nutzt, bekommt dieselben Daten und gestaltet sie selbst — etwa neben Kennzahlen wie Kaufpreisfaktor und Rendite.
- Auch im Dokument. In PDF-Exposé und Briefvorlagen steht die Mietaufstellung ebenfalls zur Verfügung — mehr dazu bei den Mietvertragskennzahlen.
Mietverträge per API
Mietverträge lassen sich über /leases anlegen, lesen, ändern und löschen — so lassen sich Bestände aus einer Hausverwaltungs-Software übernehmen und laufend abgleichen.
POST /public_api/v1/leases
{
"lease": {
"property_id": 1234,
"status": "active",
"start_date": "2025-01-15",
"monthly_rent": 851.00,
"deposit": 2553.00,
"contacts": [
{ "contact_id": 4711, "role": "hauptmieter" }
]
}
}- Was ein Vertrag trägt. Objekt, Status (Entwurf, aktiv, gekündigt, abgelaufen), Beginn und Ende, Monatsmiete, Kaution, Kündigungsdatum und -grund, frühester Kündigungstermin und Zuständigkeit. Mieter, Mitmieter, Bürgen und Vermieter hängen als Kontakte oder Unternehmen daran. Eigene Felder aus den angepassten Mietvertragsformularen kommen mit.
- Gezielt abrufen. Die Liste lässt sich nach Status, Objekt oder eigenem Feld filtern und seitenweise durchgehen.
- Sicher schreiben. Fünf eigene Rechte je API-Schlüssel — auflisten, lesen, anlegen, ändern, löschen. Änderungen lassen sich per ETag absichern, damit kein gleichzeitiger Stand überschrieben wird. Gelöschte Verträge bleiben als gelöschte Daten erhalten.
- Wie im übrigen Schnittstellenmodell. Aufbau, Rechte und Fehlermeldungen folgen denselben Regeln wie bei Objekten und Projekten.
Weiterlesen
Verwandte Releases: Mietvertragskennzahlen, Mietvertragsverwaltung & Einheiten-Hierarchie, Vom PDF zum angelegten Mietvertrag und Mietverträge digital unterschreiben. Die Schnittstelle im Überblick: Public API.