Mietgebühren
Automatische monatliche Mietgebührengenerierung aus Mietverträgen
Was sind Mietgebühren?
Mietgebühren sind automatisch generierte monatliche Mietzahlungen auf Basis aktiver Mietverträge. Das System berechnet Gebühren basierend auf dem im Vertrag angegebenen monatlichen Mietbetrag und der tatsächlichen Anzahl der Miettage in jedem Zeitraum.
Hauptfunktionen
- Automatische monatliche Abrechnung
- Proportionale Berechnung für Teilmonate
- Flexibler Zahlungstag
- Einheitliche Oberfläche mit Nebenkosten
- Mehrwährungsunterstützung
Wie es funktioniert
Schritt 1: Vertragseinrichtung
Füllen Sie die Felder MONTHLY_RENT_AMOUNT und RENT_PAYMENT_DAY im Mietvertrag aus
Schritt 2: Automatische Generierung
Das System generiert automatisch monatlich um 00:01 Mietgebühren
Schritt 3: Überprüfung und Verwaltung
Überprüfen und verwalten Sie generierte Gebühren im Abschnitt "Ausgaben"
Zahlungsberechnungslogik
Periodenberechnung
Das System bestimmt automatisch den Abrechnungszeitraum basierend auf dem Vertragsbeginn und dem Zahlungstag:
Regeln zur Periodenbestimmung
- Wenn der Vertrag am 1. beginnt, beginnt der Zeitraum am 1.
- Wenn der Vertrag nach dem Zahlungstag beginnt, ist der erste Zeitraum kurz (proportionale Berechnung)
- Wenn der Vertrag vor dem Zahlungstag beginnt, beginnt der erste Zeitraum am Startdatum
- Jeder folgende Zeitraum beginnt am Tag nach dem Zahlungstag des vorherigen Zeitraums
Proportionale Berechnung
Daily rate = Monthly rent / Days in month Proportional amount = Daily rate × Actual rental days Example: Monthly rent: €1,000 Contract starts: January 20 Charge day: 5th Days in January: 31 First period: January 20 - February 4 (16 days) Daily rate: €1,000 / 31 = €32.26 Amount: €32.26 × 16 = €516.13 Second period: February 5 - March 4 (28 days, full month) Daily rate: €1,000 / 28 = €35.71 Amount: €35.71 × 28 = €1,000.00
Berechnungsbeispiel
Szenario
- Monatliche Miete: 10.000 UAH
- Startdatum: 15. Januar 2026
- Zahlungstag: 5.
Generierte Gebühren
| Zeitraum | Tage | Berechnung | Betrag |
|---|---|---|---|
| Jan 20 - Feb 04 | 16 | (€1,200 / 31) × 16 | €619.35 |
| Feb 05 - Mar 04 | 28 | (€1,200 / 28) × 28 | €1,200.00 |
| Mar 05 - Apr 04 | 31 | (€1,200 / 31) × 31 | €1,200.00 |
Vertragsfelder für Mietgebühren
Für die automatische Mietgebührenerstellung müssen die folgenden Felder im Mietvertrag ausgefüllt werden:
| Feldname | Erforderlich | Beschreibung |
|---|---|---|
MONTHLY_RENT_AMOUNT |
Erforderlich | Monatlicher Mietbetrag. Wenn nicht angegeben oder gleich 0, werden keine Mietgebühren generiert. |
RENT_PAYMENT_DAY |
optional | Tag des Monats für die Zahlung (1-28). Wenn nicht angegeben, wird Monatsbeginn verwendet. |
Beispiel
Mietvertrag
Mietgebühren-API
Die folgenden API-Endpunkte sind für die Arbeit mit Mietgebühren verfügbar:
Service-Layer-Hinweis
GET /api/v1/rental-charges
Mietgebührenliste
GET /api/v1/rental-charges/{id}
Mietgebührendetails
GET /api/v1/rental-charges/contract/{id}
Gebührenliste nach Vertrag
GET /api/v1/rental-charges/contract/{id}/next
Nächster Abrechnungszeitraum
POST /api/v1/rental-charges/contract/{id}/generate
Mietgebühren generieren
DELETE /api/v1/rental-charges/{id}
Mietgebühr löschen
API-Beispiel
GET /api/v1/rental-charges/contract/42/next
Authorization: Bearer <token>
Response:
{
"can_charge": false,
"reason": "period_not_ended",
"next_period_start": "2026-02-05",
"next_period_end": "2026-03-04",
"next_charge_date": "2026-03-05",
"rental_days": 28,
"amount": 1200.00,
"currency": "EUR"
}
Einschränkungen
Wichtig
- Automatische Gebühren werden täglich um 00:01 (Serverzeitzone) generiert
- Automatisch generierte Gebühren können nicht bearbeitet werden
- Automatisch generierte Gebühren können nur von einem Administrator gelöscht werden
- Gebühren werden nur für aktive Verträge generiert
- Das System generiert keine doppelten Gebühren für bereits abgeschlossene Zeiträume
Gebühren anzeigen
Generierte Gebühren im Abschnitt "Ausgaben" der Immobilie anzeigen
Fehlerbehebung
Keine Gebühren gefunden
Wenn Mietgebühren nicht automatisch generiert werden, überprüfen Sie Folgendes:
- Überprüfen, ob das Feld MONTHLY_RENT_AMOUNT ausgefüllt ist
- Vertragsbeginn und -ende prüfen
- Vertragswährungseinstellungen prüfen
- Systemprotokolle auf Fehler prüfen
- Sicherstellen, dass der Vertrag aktiv ist
- Prüfen, ob die Gebührenerstellung für diesen Vertrag nicht blockiert ist
- Administrator kontaktieren, wenn das Problem weiterhin besteht
Falscher Betrag
Wenn der Gebührenbetrag falsch berechnet wurde, kann dies an der proportionalen Berechnung für einen Teilmonat liegen. Überprüfen Sie den Zahlungszeitraum und die Anzahl der Tage im Zeitraum.