Nebenkosten

Was sind Nebenkosten?

Nebenkosten ermöglichen es Ihnen, Kosten für Versorgungsleistungen zu verfolgen: Strom, Wasser, Gas, Heizung, Internet und andere immobilienbezogene Ausgaben. Jede Ausgabe ist mit einem Ausgabentyp verknüpft und kann mehrere Zähler für die automatische Verbrauchserfassung haben.

Arbeitsablauf: Ausgabentypen → Gebühren

Zonenpreise

Mehrzonen-Tarifsystem ermöglicht unterschiedliche Preise für verschiedene Zeiträume:

Wie konfigurieren

Gebührenerstellung

Zählerbasierte Gebühren werden automatisch oder manuell erstellt:

Einfache Gebühr

Die einfachste Option - Verwendung der TOTAL-Zone mit einem Preis. Das System berechnet die Differenz zwischen vorherigem und aktuellem Stand, multipliziert mit dem Preis und erstellt eine Gebühr.

Beispiel

Period: January 1-31, 2026
Service: Internet
Quantity: 1 unit
Price: €45.00 per unit
Total: €45.00

Mehrzonen-Gebühr

Für Zähler mit unterschiedlichen Tarifzonen (Tag/Nacht oder Spitze/Halbspitze/Nacht) erstellt das System separate Gebührenpositionen für jede Zone. Dies spiegelt den Verbrauch bei verschiedenen Tarifen genau wider.

• Zähler
• Zählerstände
• Verbrauch
• Preis
• Betrag

Beispiel

Counter: Main meter (two-zone)
Period: January 1-31, 2026

Item 1 - DAY zone:
Previous reading: 500.00 kWh
Current reading: 600.00 kWh
Consumption: 100.00 kWh
Price: €0.15 per kWh
Amount: €15.00

Item 2 - NIGHT zone:
Previous reading: 200.00 kWh
Current reading: 250.00 kWh
Consumption: 50.00 kWh
Price: €0.08 per kWh
Amount: €4.00

Total charge: €19.00

Zählerstände

Zählerstände sind die Grundlage für automatische Gebührenberechnungen:

Manuelle Gebührenerstellung (UI)

Für Ausgaben mit Verbrauchstyp "Nach Aufwand" oder Berechnungszeitraum "MANUAL" können Sie Gebühren manuell über die Weboberfläche erstellen.

Automatische Generierung

Das System kann automatisch Nebenkostengebühren basierend auf Zählerständen erstellen:

Berechnungszeiträume

Berechnungszeiträume

Berechnungszeitraum bestimmt, wie oft Gebühren erstellt werden:

Dokumentenverwaltung

Dokumente können auf zwei Ebenen im Ausgabenmodul angehängt werden, wobei jede einem anderen Zweck dient:

REST API

Haupt-API-Endpunkte für Nebenkosten:

Service-Layer-Hinweis

Ausgabentypen-API

GET    /api/v1/properties/{propertyId}/expenses              # List expenses
POST   /api/v1/properties/{propertyId}/expenses              # Create expense
GET    /api/v1/properties/{propertyId}/expenses/{id}         # Expense details
PUT    /api/v1/properties/{propertyId}/expenses/{id}         # Update expense
DELETE /api/v1/properties/{propertyId}/expenses/{id}         # Delete expense
POST   /api/v1/properties/{propertyId}/expenses/{id}/toggle  # Toggle active/inactive
POST   /api/v1/properties/{propertyId}/expenses/refresh-all  # Refresh all charges
POST   /api/v1/properties/{propertyId}/expenses/{id}/refresh # Refresh single expense

Gebühren

GET    /api/v1/properties/{propertyId}/expenses/{expenseId}/charges             # List charges
POST   /api/v1/properties/{propertyId}/expenses/{expenseId}/charges             # Create charge
GET    /api/v1/properties/{propertyId}/expenses/{expenseId}/unlinked-readings   # Get unlinked readings
GET    /api/v1/properties/{propertyId}/charges/{id}                             # Charge details
PUT    /api/v1/properties/{propertyId}/charges/{id}                             # Update charge
DELETE /api/v1/properties/{propertyId}/charges/{id}                             # Delete charge
POST   /api/v1/properties/{propertyId}/charges/{id}/confirm                     # Confirm charge

Gebührendokumente-API

Verwaltung von Dokumenten, die an Ausgabengebühren angehängt sind (Belege, Rechnungen, Verträge).

GET    /api/v1/properties/{propertyId}/charges/{chargeId}/documents           # List charge documents
POST   /api/v1/properties/{propertyId}/charges/{chargeId}/documents           # Upload document to charge
GET    /api/v1/properties/{propertyId}/charges/{chargeId}/documents/{id}      # Document details
PUT    /api/v1/properties/{propertyId}/charges/{chargeId}/documents/{id}      # Update document comment
DELETE /api/v1/properties/{propertyId}/charges/{chargeId}/documents/{id}      # Remove document from charge

Beleg für eine Ausgabengebühr hochladen

POST /api/v1/properties/1/charges/42/documents
Content-Type: multipart/form-data
Authorization: Bearer <token>

file: (binary)
document_type_id: 1
comment: "Invoice for January 2026"

Ausgabentyp-Dokumente-API

Fügen Sie Dokumente (Verträge mit Auftragnehmern, Tarifpläne) direkt in der Ausgabentyp-Konfiguration an, zeigen Sie sie an und verwalten Sie sie.

GET    /api/v1/properties/{propertyId}/expenses/{expenseId}/documents           # List expense documents
POST   /api/v1/properties/{propertyId}/expenses/{expenseId}/documents           # Upload document to expense
GET    /api/v1/properties/{propertyId}/expenses/{expenseId}/documents/{id}      # Document details
PUT    /api/v1/properties/{propertyId}/expenses/{expenseId}/documents/{id}      # Update document comment
DELETE /api/v1/properties/{propertyId}/expenses/{expenseId}/documents/{id}      # Remove document from expense

API-Beispiel: Dokument zum Ausgabentyp hochladen

POST /api/v1/properties/1/expenses/3/documents
Content-Type: multipart/form-data
Authorization: Bearer <token>

file: (binary)
document_type_id: 1
comment: "Contractor agreement for heating service"

API-Beispiel

POST /api/v1/properties/1/expenses/3/charges
Content-Type: application/json
Authorization: Bearer <token>

{
  "charge_date": "2026-01-31",
  "period_start": "2026-01-01",
  "period_end": "2026-01-31",
  "charged_to_user_id": 5,
  "items": [
    {
      "counter_id": 5,
      "zone_code": "DAY",
      "previous_value": "500.00",
      "current_value": "600.00",
      "unit_price": "0.15"
    },
    {
      "counter_id": 5,
      "zone_code": "NIGHT",
      "previous_value": "200.00",
      "current_value": "250.00",
      "unit_price": "0.08"
    }
  ]
}

Kostenarten

Einmalige Gebühren

Wie es funktioniert

1. Navigieren Sie zur Seite der Immobilienausgaben
2. Klicken Sie auf die Schaltfläche "Einmalige Gebühr"
3. Füllen Sie den Betrag, das Datum, den Abrechnungszeitraum und optionale Notizen aus
4. Die Gebühr wird automatisch erstellt und als bestätigt markiert

Eigenschaften

• Verbrauchstyp: Nach Verbrauch
• Einheit: Gebühren
• Spezielle Markierung: Ausgabenart-Code ONE_TIME (nicht der zugewiesene Anbieter — dieser wird für diesen Container nicht angezeigt)
• Sichtbarkeit: Ausgeblendet von regulären Ausgabenlisten
• Automatische Erstellung von Gebühren: Nein - Gebühren nur manuell erstellt

Routen

Diese Route ist ein Web-Sitzungsformular (erfordert Anmeldung und CSRF-Token) – kein JSON-API-Aufruf mit Bearer-Token.

Formularfelder

• Datum* — Das Datum, an dem die Ausgabe entstanden ist
• Abrechnungszeitraum* — Wählen Sie den Abrechnungszeitraum für Buchhaltungszwecke
• Betrag* — Der zu berechnende Gesamtbetrag (erforderlich)
• Notizen — Optionale Beschreibung oder Erklärung