Startseite › Bibliothek › Saldokorrekturen › Dienstleisterkorrekturen

Saldokorrekturen der Dienstleister

Was sind Saldokorrekturen der Dienstleister?

Saldokorrekturen der Dienstleister sind ein Mechanismus zur Korrektur von Fehlern bei der Abrechnung mit Versorgungsdienstleistern (Strom, Gas, Wasser, Internet usw.). Anpassungen können entweder positiv (zusätzliche Belastung) oder negativ (Schuldenreduzierung oder Entschädigung) sein.

Wann ist eine Anpassung erforderlich?

  • Anbieter hat fälschlicherweise mehr berechnet
  • Unterzahlung aufgrund eines Zählerablesefehlersents entdeckt
  • Zähler funktionierte nicht ordnungsgemäß und Neuberechnung ist erforderlich
  • Entschädigung für schlechte Servicequalität gewährt
  • Rabatt oder Bonus mit Anbieter ausgehandelt

Anpassungsfelder

Anpassungsdatum

Datum, an dem die Anpassung vorgenommen wird

Dienstleister

Dienstleister, für den die Anpassung vorgenommen wird

Betrag

Anpassungsbetrag: negativ für Schuldenreduzierung (Entschädigung), positiv für zusätzliche Belastung

Währung

Währung des Anpassungsbetrags

Notizen

Beschreibung des Anpassungsgrunds (optionales Feld)

Ausgabe (optional)

Verknüpfung mit bestimmter Ausgabe (optionales Feld)

Vertrag (optional)

Verknüpfung mit Vertrag (optionales Feld)

Anpassungsbestätigung

Anpassungen können sowohl vom Vermieter als auch vom Mieter bestätigt werden. Vollständige Bestätigung wird erst nach Bestätigung durch beide Parteien erhalten.

Bestätigungsstatus

Ausstehend

Wartet auf Bestätigung von beiden Parteien

Vom Vermieter bestätigt

Vom Vermieter bestätigt, wartet auf Mieterbestätigung

Vom Mieter bestätigt

Vom Mieter bestätigt, wartet auf Vermieterbestätigung

Vollständig bestätigt

Vollständig von beiden Parteien bestätigt

REST API

Die API ermöglicht die programmatische Verwaltung von Saldokorrekturen. Unten sind die verfügbaren Endpunkte mit Anfrage- und Antwortbeispielen aufgeführt.

Service-Layer-Hinweis

GET /api/v1/properties/{id}/adjustments

Liste aller Saldokorrekturen für Immobilie abrufen

Abfrageparameter

  • page (optional) - Seitennummer (Standard: 1)
  • limit (optional) - Elemente pro Seite (Standard: 20, max: 100)

Beispielanfrage

curl -X GET "https://landlordkeeper.com/api/v1/properties/1/adjustments?page=1&limit=20" \
  -H "Authorization: Bearer YOUR_TOKEN"

Beispielantwort

{
  "items": [
    {
      "id": 1,
      "adjustment_date": "2026-01-28",
      "amount": -150.50,
      "currency": {
        "id": 1,
        "code": "EUR",
        "symbol": "€"
      },
      "service_provider": {
        "id": 3,
        "name": "Electric Company"
      },
      "notes": "Overbilling correction",
      "status": "fully_confirmed",
      "is_confirmed_by_landlord": true,
      "is_confirmed_by_tenant": true,
      "documents_count": 2,
      "created_at": "2026-01-28T10:30:00+00:00",
      "created_by": {
        "id": 5,
        "name": "John Landlord"
      }
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 20
}

POST /api/v1/properties/{id}/adjustments

Neue Saldokorrektur erstellen

Anfragekörper

{
  "adjustment_date": "2026-01-28",
  "service_provider_id": 3,
  "amount": -150.50,
  "currency_id": 1,
  "notes": "Overbilling correction for January",
  "property_expense_id": 15,
  "contract_id": 5
}

Beispielantwort

{
  "id": 1,
  "message": "Adjustment created successfully"
}

GET /api/v1/properties/{id}/adjustments/{aid}

Detaillierte Informationen zur Anpassung abrufen

Beispielantwort

{
  "id": 1,
  "adjustment_date": "2026-01-28",
  "amount": -150.50,
  "currency": {
    "id": 1,
    "code": "EUR",
    "symbol": "€"
  },
  "service_provider": {
    "id": 3,
    "name": "Electric Company"
  },
  "notes": "Overbilling correction",
  "status": "fully_confirmed",
  "is_confirmed_by_landlord": true,
  "landlord_confirmed_by": {
    "id": 5,
    "name": "John Landlord"
  },
  "landlord_confirmed_at": "2026-01-28T11:00:00+00:00",
  "is_confirmed_by_tenant": true,
  "tenant_confirmed_by": {
    "id": 8,
    "name": "Jane Tenant"
  },
  "tenant_confirmed_at": "2026-01-28T12:00:00+00:00",
  "property_expense": {
    "id": 15,
    "name": "Electricity"
  },
  "contract": {
    "id": 5,
    "name": "Service Contract #5"
  },
  "documents": [
    {
      "id": 19,
      "original_name": "invoice_correction.pdf",
      "file_size": 245678,
      "comment": "Corrected invoice",
      "created_at": "2026-01-28T10:35:00+00:00"
    }
  ],
  "created_at": "2026-01-28T10:30:00+00:00",
  "created_by": {
    "id": 5,
    "name": "John Landlord"
  }
}

PUT /api/v1/properties/{id}/adjustments/{aid}

Bestehende Anpassung aktualisieren

Anfragekörper

{
  "adjustment_date": "2026-01-29",
  "amount": -180.00,
  "notes": "Updated correction amount"
}

Beispielantwort

{
  "message": "Adjustment updated successfully"
}

DELETE /api/v1/properties/{id}/adjustments/{aid}

Anpassung löschen

Beispielantwort

{
  "message": "Adjustment deleted successfully"
}

POST /api/v1/properties/{id}/adjustments/{aid}/documents

Dokument zur Anpassung anhängen

Anfragekörper

{
  "document_id": 42,
  "comment": "Invoice copy"
}

Beispielantwort

{
  "message": "Document attached successfully"
}

DELETE /api/v1/properties/{id}/adjustments/{aid}/documents/{did}

Dokument von Anpassung entfernen

Beispielantwort

{
  "message": "Document detached successfully"
}

POST /api/v1/properties/{id}/adjustments/{aid}/confirm-landlord

Anpassung als Vermieter bestätigen

Beispielantwort

{
  "message": "Confirmed by landlord",
  "status": "confirmed_by_landlord"
}

POST /api/v1/properties/{id}/adjustments/{aid}/confirm-tenant

Anpassung als Mieter bestätigen

Beispielantwort

{
  "message": "Confirmed by tenant",
  "status": "fully_confirmed"
}

Verwendungsbeispiele

Szenario 1: Stromüberzahlung

Stromanbieter hat 200 EUR berechnet, aber nach Überprüfung stellte sich heraus, dass es 150 EUR sein sollte. Anpassung um -50 EUR erforderlich.

  1. Anpassung mit Betrag -50 EUR erstellen
  2. Anbieter "Elektrizitätsunternehmen" angeben und Beleg anhängen
  3. Vermieter bestätigt Anpassung
  4. Mieter bestätigt Anpassung - Status wird "Vollständig bestätigt"

Szenario 2: Entschädigung für Serviceunterbrechungen

Internetanbieter gewährte 30 EUR Rabatt für Netzunterbrechungen während des Monats.

  1. Anpassung mit Betrag -30 EUR erstellen
  2. Grund angeben "Entschädigung für Netzunterbrechungen"
  3. Von beiden Parteien bestätigen