Dokumentacja | Dokumentacja API

Czym są opłaty za wynajem?

Opłaty za wynajem to automatycznie generowane miesięczne płatności za wynajem na podstawie aktywnych umów najmu. System oblicza opłaty na podstawie miesięcznej kwoty czynszu określonej w umowie i rzeczywistej liczby dni najmu w każdym okresie.

Kluczowe funkcje

Automatyczne miesięczne rozliczenia
Proporcjonalne wyliczenie za niepełne miesiące
Elastyczny dzień płatności
Zunifikowany interfejs z wydatkami medialnymi
Obsługa wielu walut

Jak to działa

1

Krok 1: Konfiguracja umowy

Wypełnij pola MONTHLY_RENT_AMOUNT i RENT_PAYMENT_DAY w umowie najmu

2

Krok 2: Automatyczne generowanie

System automatycznie wygeneruje opłaty czynszowe co miesiąc o 00:01

3

Krok 3: Przegląd i zarządzanie

Przeglądaj i zarządzaj wygenerowanymi opłatami w sekcji "Wydatki"

Logika wyliczania płatności

Wyliczenie okresu

System automatycznie określa okres rozliczeniowy na podstawie daty rozpoczęcia umowy i dnia płatności:

Zasady określania okresu

Jeśli umowa rozpoczyna się 1-go, okres rozpoczyna się od 1-go
Jeśli umowa rozpoczyna się po dniu płatności, pierwszy okres będzie krótki (wyliczenie proporcjonalne)
Jeśli umowa rozpoczyna się przed dniem płatności, pierwszy okres rozpoczyna się od daty rozpoczęcia
Każdy kolejny okres rozpoczyna się w dniu następującym po dniu płatności poprzedniego okresu

Wyliczenie proporcjonalne

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

Przykład wyliczenia

Scenariusz

Miesięczny czynsz: 10,000 UAH
Data rozpoczęcia: 15 stycznia 2026
Dzień płatności: 5-ty

Wygenerowane opłaty

Okres	Dni	Wyliczenie	Kwota
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

Pola umowy dla opłat czynszowych

Aby automatycznie generować opłaty czynszowe, w umowie najmu należy wypełnić następujące pola:

Nazwa pola	Wymagane	Opis
`MONTHLY_RENT_AMOUNT`	Wymagane	Miesięczna kwota czynszu. Jeśli nie określono lub wynosi 0, opłaty czynszowe nie zostaną wygenerowane.
`RENT_PAYMENT_DAY`	opcjonalnie	Dzień miesiąca dla płatności (1-28). Jeśli nie określono, używany jest początek miesiąca.

Przykład

Umowa najmu

API opłat czynszowych

Następujące punkty końcowe API są dostępne do pracy z opłatami czynszowymi:

Uwaga dotycząca warstwy usługowej

GET /api/v1/rental-charges
    Lista opłat czynszowych
    
GET /api/v1/rental-charges/{id}
    Szczegóły opłaty czynszowej
    
GET /api/v1/rental-charges/contract/{id}
    Lista opłat według umowy
    
GET /api/v1/rental-charges/contract/{id}/next
    Następny okres rozliczeniowy
    
POST /api/v1/rental-charges/contract/{id}/generate
    Generowanie opłat czynszowych
    
DELETE /api/v1/rental-charges/{id}
    Usuwanie opłaty czynszowej

Przykład API

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

Ograniczenia

Ważne

Automatyczne opłaty są generowane codziennie o 00:01 (strefa czasowa serwera)
Automatycznie wygenerowanych opłat nie można edytować
Automatycznie wygenerowane opłaty mogą być usuwane tylko przez administratora
Opłaty są generowane tylko dla aktywnych umów
System nie generuje duplikatów opłat za już zakończone okresy

Podgląd opłat

Zobacz wygenerowane opłaty w sekcji "Wydatki" nieruchomości

Rozwiązywanie problemów

Nie znaleziono opłat

Jeśli opłaty czynszowe nie są generowane automatycznie, sprawdź następujące:

Sprawdź, czy pole MONTHLY_RENT_AMOUNT jest wypełnione
Sprawdź daty rozpoczęcia i zakończenia umowy
Przejrzyj ustawienia waluty umowy
Sprawdź logi systemu pod kątem błędów
Upewnij się, że umowa jest aktywna
Sprawdź, czy generowanie opłat nie jest zablokowane dla tej umowy
Skontaktuj się z administratorem, jeśli problem nie ustępuje

Nieprawidłowa kwota

Jeśli kwota opłaty jest wyliczona nieprawidłowo, może to być spowodowane proporcjonalnym wyliczeniem za niepełny miesiąc. Sprawdź okres płatności i liczbę dni w okresie.