Strona główna › Biblioteka › Korekty salda › Korekty wynajmujący-najemca

Korekty salda wynajmujący-najemca

Czym są korekty salda wynajmujący-najemca?

Korekty salda wynajmujący-najemca to mechanizm rozliczania spraw finansowych między stronami umowy najmu. Korekty mogą być zarówno dodatnie (dodatkowe obciążenie), jak i ujemne (zmniejszenie zadłużenia lub rekompensata za wykonane prace, rabaty).

Kiedy potrzebna jest korekta?

  • Korekta czynszu według porozumienia stron
  • Częściowe wykorzystanie kaucji na pokrycie wydatków
  • Rekompensata za uszkodzenie mienia
  • Zwrot nadpłaty najemcy
  • Rabat dobrej woli lub rekompensata za niedogodności

Pola korekty

Data korekty

Data wykonania korekty

Wynajmujący

Wynajmujący, dla którego wykonywana jest korekta

Najemca

Najemca, dla którego wykonywana jest korekta

Kwota

Kwota korekty: ujemna dla zmniejszenia zadłużenia najemcy (rekompensata, rabat), dodatnia dla dodatkowego obciążenia

Waluta

Waluta kwoty korekty

Uwagi

Opis przyczyny korekty (pole opcjonalne)

Umowa (opcjonalnie)

Powiązanie z umową (pole opcjonalne)

Potwierdzanie korekt

Korekty mogą być potwierdzone zarówno przez wynajmującego, jak i najemcę. Pełne potwierdzenie uzyskuje się dopiero po potwierdzeniu przez obie strony.

Statusy potwierdzenia

Oczekuje

Oczekuje na potwierdzenie od obu stron

Potwierdzone przez wynajmującego

Potwierdzone przez wynajmującego, oczekuje na potwierdzenie najemcy

Potwierdzone przez najemcę

Potwierdzone przez najemcę, oczekuje na potwierdzenie wynajmującego

W pełni potwierdzone

Potwierdzone przez obie strony

REST API

Moduł zapewnia REST API do pracy z korektami wynajmujący-najemca. Wszystkie endpointy wymagają autoryzacji przez token Bearer.

Uwaga dotycząca warstwy usługowej

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

Pobierz listę wszystkich korekt dla nieruchomości z obsługą paginacji

Parametry zapytania

  • page (opcjonalnie) - Numer strony (domyślnie: 1)
  • limit (opcjonalnie) - Elementy na stronę (domyślnie: 20, max: 100)

Przykładowe żądanie

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

Przykładowa odpowiedź

{
  "items": [
    {
      "id": 1,
      "adjustment_date": "2026-01-28",
      "amount": -150.50,
      "currency": {
        "id": 1,
        "code": "EUR",
        "symbol": "€"
      },
      "landlord": {
        "id": 5,
        "name": "John Landlord"
      },
      "tenant": {
        "id": 8,
        "name": "Jane Tenant"
      },
      "notes": "Rent correction for repairs",
      "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}/lt-adjustments

Utwórz nową korektę salda między wynajmującym a najemcą

Treść żądania

{
  "adjustment_date": "2026-01-28",
  "landlord_id": 5,
  "tenant_id": 8,
  "amount": -150.50,
  "currency_id": 1,
  "notes": "Rent correction for tenant-completed repairs",
  "contract_id": 5
}

Przykładowa odpowiedź

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

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

Pobierz szczegółowe informacje o korekcie ze wszystkimi powiązanymi danymi

Przykładowa odpowiedź

{
  "id": 1,
  "adjustment_date": "2026-01-28",
  "amount": -150.50,
  "currency": {
    "id": 1,
    "code": "EUR",
    "symbol": "€"
  },
  "landlord": {
    "id": 5,
    "name": "John Landlord"
  },
  "tenant": {
    "id": 8,
    "name": "Jane Tenant"
  },
  "notes": "Rent correction for repairs",
  "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",
  "contract": {
    "id": 5,
    "name": "Contract #5"
  },
  "documents": [
    {
      "id": 19,
      "original_name": "repair_receipt.pdf",
      "file_size": 245678,
      "comment": "Repair 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}/lt-adjustments/{aid}

Zaktualizuj istniejącą korektę (możliwe tylko przed pełnym potwierdzeniem)

Treść żądania

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

Przykładowa odpowiedź

{
  "message": "Adjustment updated successfully"
}

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

Usuń korektę (możliwe tylko przed potwierdzeniem przez którąkolwiek stronę)

Przykładowa odpowiedź

{
  "message": "Adjustment deleted successfully"
}

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

Dołącz dokument do korekty (paragony, akty, umowy)

Treść żądania

{
  "document_id": 42,
  "comment": "Repair receipt"
}

Przykładowa odpowiedź

{
  "message": "Document attached successfully"
}

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

Odłącz dokument od korekty

Przykładowa odpowiedź

{
  "message": "Document detached successfully"
}

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

Potwierdź korektę w imieniu wynajmującego

Przykładowa odpowiedź

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

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

Potwierdź korektę w imieniu najemcy

Przykładowa odpowiedź

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

Przykłady użycia

Scenariusz 1: Rekompensata za naprawy wykonane przez najemcę

Najemca wykonał drobne naprawy w mieszkaniu na własny koszt po uzgodnieniu z wynajmującym.

  1. Utwórz korektę na kwotę -150 EUR (ujemna, zmniejsza zadłużenie najemcy)
  2. Dołącz zdjęcia paragonów i rachunków za materiały budowlane
  3. Wynajmujący potwierdza korektę
  4. Najemca potwierdza korektę - kwota jest automatycznie zaliczana do przyszłych płatności

Scenariusz 2: Rabat za niedogodności podczas remontu

W budynku przeprowadzano kapitalny remont dachu, co powodowało hałas i niedogodności dla najemcy.

  1. Wynajmujący tworzy korektę na -200 EUR jako rekompensatę za 2 tygodnie niedogodności
  2. Obie strony potwierdzają korektę
  3. Rabat jest automatycznie uwzględniany w obliczeniach następnej płatności za czynsz