9 Anfangssalden
Erfassen Sie ausstehende Schulden und Vorauszahlungen für Mieter und Dienstleister zum Startdatum — sonst bleibt die Historie von Zahlungen und Belastungen unvollständig.
Warum das wichtig ist
Wenn Sie eine Immobilie anschließen, die bereits vermietet wurde — zum Startdatum haben Sie höchstwahrscheinlich offene Schulden oder Vorauszahlungen in vier Szenarien:
- Der Mieter schuldet Ihnen aus vergangenen Perioden (überfällige Miete, Nebenkosten, Entschädigungen).
- Der Mieter hat einen Vorschuss geleistet oder zu viel gezahlt — der Betrag wird auf künftige Belastungen angerechnet.
- Sie schulden einem Dienstleister (Strom, Wasser, Gas, Internet) aus vergangenen Perioden.
- Beim Dienstleister liegt Ihre Überzahlung — sie mindert künftige Rechnungen.
Vermieter–Mieter-Ausgleich
Das Formular befindet sich in der Immobilienkarte → «Vermieter–Mieter-Ausgleich» → «Hinzufügen». Geben Sie Betrag, Richtung (Mieter schuldet Vermieter / Vermieter schuldet Mieter) und das Datum an, auf das sich die Schuld bezieht. Bei Bedarf einen Nachweis anhängen. Der Mieter kann den Eintrag später bestätigen — dann fließt er automatisch in den gemeinsamen Saldo ein.
Ausgleich mit Dienstleistern
Das Formular liegt in der Immobilienkarte → «Ausgleich mit Dienstleistern» → «Hinzufügen». Wählen Sie den Dienstleister, geben Sie Betrag, Richtung (Vermieter schuldet Dienstleister / Dienstleister schuldet Vermieter) und Datum ein. Bei Bedarf einen Beleg-Scan anhängen. Die Korrektur wirkt sich sofort auf den Saldo aus — sie erhöht oder verringert Ihre Schuld gegenüber dem Dienstleister zusätzlich zu dem, was das System aus Zählerständen berechnet.
Für Entwickler: REST API
Für Integrationen und Massenimport stehen REST-Endpunkte bereit. Beide liefern den vollständigen erstellten Datensatz — bewahren Sie die `id` für Folgeoperationen (Bestätigung, Dokumentanhang) auf.
POST Vermieter–Mieter-Ausgleich anlegen
▶Erstellt eine Saldo-Korrektur zwischen Vermieter und Mieter der Immobilie. Richtung `tenant_owes_landlord` — der Mieter schuldet Ihnen; `landlord_owes_tenant` — Sie schulden dem Mieter. `occurred_at` legt fest, welchem Zeitraum der Eintrag zugeordnet wird.
POST /api/v1/properties/{id}/lt-adjustments
Header:
Authorization: Bearer {token}
Content-Type: application/json
Anfragekörper:
{
"amount": "1500.00",
"direction": "tenant_owes_landlord",
"occurred_at": "2026-01-01",
"note": "Стартовая задолженность арендатора на дату подключения"
}
Antwort (201 Created):
{
"message": "Landlord-tenant adjustment created",
"data": {
"id": "01H8...",
"amount": "1500.00",
"direction": "tenant_owes_landlord",
"occurred_at": "2026-01-01"
}
}
POST Ausgleich mit Dienstleister anlegen
▶Erstellt eine Saldo-Korrektur zwischen Vermieter und einem konkreten Dienstleister. Richtung `landlord_owes_provider` — Sie schulden dem Dienstleister; `provider_owes_landlord` — der Dienstleister schuldet Ihnen. `service_provider_id` ist die erforderliche `id` aus dem Dienstleister-Verzeichnis der Immobilie.
POST /api/v1/properties/{id}/adjustments
Header:
Authorization: Bearer {token}
Content-Type: application/json
Anfragekörper:
{
"service_provider_id": "01H8...",
"amount": "820.00",
"direction": "landlord_owes_provider",
"occurred_at": "2026-01-01",
"note": "Долг за электроэнергию до подключения"
}
Antwort (201 Created):
{
"message": "Service provider adjustment created",
"data": {
"id": "01H8...",
"amount": "820.00",
"direction": "landlord_owes_provider",
"occurred_at": "2026-01-01"
}
}
cURL-Beispiele
▶1. Vermieter–Mieter-Ausgleich anlegen
curl -X POST https://landlordkeeper.com/api/v1/properties/019a1b2c-3d4e-7f5a-8b9c-0123456789ab/lt-adjustments \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-d '{
"amount": "1500.00",
"direction": "tenant_owes_landlord",
"occurred_at": "2026-01-01",
"note": "Starting tenant debt on go-live"
}'
2. Ausgleich mit Dienstleister anlegen
curl -X POST https://landlordkeeper.com/api/v1/properties/019a1b2c-3d4e-7f5a-8b9c-0123456789ab/adjustments \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-d '{
"service_provider_id": "01H8...",
"amount": "820.00",
"direction": "landlord_owes_provider",
"occurred_at": "2026-01-01",
"note": "Debt to provider on go-live"
}'