Strona główna › Biblioteka › Korekty salda › Korekty dostawców usług

Korekty salda dostawców usług

Czym są korekty salda dostawców usług?

Korekty salda dostawców usług to mechanizm korygowania błędów w rozliczeniach z dostawcami mediów (prąd, gaz, woda, internet itp.). Korekty mogą być zarówno dodatnie (dodatkowe obciążenie), jak i ujemne (zmniejszenie zadłużenia lub rekompensata).

Kiedy potrzebna jest korekta?

  • Dostawca błędnie obciążył większą kwotę
  • Wykryto niedopłatę z powodu błędu odczytu licznika
  • Licznik działał nieprawidłowo i potrzebne jest przeliczenie
  • Przyznano rekompensatę za niską jakość usług
  • Wynegocjowano rabat lub bonus z dostawcą

Pola korekty

Data korekty

Data wykonania korekty

Dostawca usług

Dostawca usług, dla którego wykonywana jest korekta

Kwota

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

Waluta

Waluta kwoty korekty

Uwagi

Opis przyczyny korekty (pole opcjonalne)

Wydatek (opcjonalnie)

Powiązanie z konkretnym wydatkiem (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 na potwierdzenie

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

Całkowicie potwierdzone

W pełni potwierdzone przez obie strony

REST API

API umożliwia programowe zarządzanie korektami salda. Poniżej znajdują się dostępne punkty końcowe z przykładami żądań i odpowiedzi.

Uwaga dotycząca warstwy usługowej

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

Pobierz listę wszystkich korekt salda dla nieruchomości

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/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": "€"
      },
      "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

Utwórz nową korektę salda

Treść żądania

{
  "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
}

Przykładowa odpowiedź

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

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

Pobierz szczegółowe informacje o korekcie

Przykładowa odpowiedź

{
  "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}

Zaktualizuj istniejącą korektę

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}/adjustments/{aid}

Usuń korektę

Przykładowa odpowiedź

{
  "message": "Adjustment deleted successfully"
}

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

Dołącz dokument do korekty

Treść żądania

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

Przykładowa odpowiedź

{
  "message": "Document attached successfully"
}

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

Odłącz dokument od korekty

Przykładowa odpowiedź

{
  "message": "Document detached successfully"
}

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

Potwierdź korektę jako wynajmujący

Przykładowa odpowiedź

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

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

Potwierdź korektę jako najemca

Przykładowa odpowiedź

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

Przykłady użycia

Scenariusz 1: Nadpłata za prąd

Dostawca prądu obciążył 200 EUR, ale po weryfikacji okazało się, że powinno być 150 EUR. Trzeba wykonać korektę na -50 EUR.

  1. Utwórz korektę z kwotą -50 EUR
  2. Wskaż dostawcę "Firma elektryczna" i dołącz dokument potwierdzający
  3. Wynajmujący potwierdza korektę
  4. Najemca potwierdza korektę - status staje się "W pełni potwierdzone"

Scenariusz 2: Rekompensata za przerwy w świadczeniu usług

Dostawca internetu udzielił 30 EUR rabatu za przerwy w działaniu sieci w ciągu miesiąca.

  1. Utwórz korektę z kwotą -30 EUR
  2. Wskaż powód "Rekompensata za przerwy w sieci"
  3. Potwierdź przez obie strony