Strona główna › Biblioteka › Konfiguracja wydatków › Jednorazowe naliczenia

Jednorazowe naliczenia

Jednorazowe naliczenia za nieregularne wydatki: naprawy, służby awaryjne, opłaty jednorazowe.

Przegląd

Jednorazowe naliczenia pozwalają wynajmującym tworzyć jednorazowe opłaty bez konfigurowania osobnego typu wydatków.

Szybkie tworzenie

Nie trzeba tworzyć typu wydatków — wystarczy podać datę, kwotę i opis.

Automatyczny typ wydatków

System automatycznie tworzy i zarządza ukrytym typem jednorazowych wydatków dla każdej nieruchomości.

Wielowalutowość

Każde naliczenie może używać dowolnej waluty. Automatyczna konwersja przy wyświetlaniu.

Widok zgrupowany

Wszystkie jednorazowe naliczenia są widoczne na dedykowanej stronie.

Jak to działa

OneTimeChargeControllerUI do tworzenia/przeglądania
↓
OneTimeExpenseServiceAutomatycznie tworzy ukryty typ wydatków
↓
ExpenseChargeStandardowy wpis naliczenia

Pola formularza

Pole Typ Wymagane Opis
charge_datedate*Data powstania wydatku
period_startdate*Początek okresu rozliczeniowego
period_enddate*Koniec okresu rozliczeniowego
amountdecimal*Kwota naliczenia (liczba dodatnia)
currency_idinteger*ID waluty
notestextOpis widoczny dla najemcy

Kontrola dostępu

Rola Tworzenie Podgląd
PROPERTY_LANDLORD
PROPERTY_LANDLORD_AGENT
PROPERTY_TENANT
PROPERTY_TENANT_AGENT

Punkty końcowe API

Uwaga dotycząca warstwy usługowej

GET  /properties/{propertyId}/one-time-charges        - Lista jednorazowych naliczeń
POST /properties/{propertyId}/one-time-charges/new    - Utwórz jednorazowe naliczenie

Ta trasa to formularz sesji WWW (wymaga logowania i tokenu CSRF), a nie wywołanie API JSON z tokenem bearer.

Jednorazowe naliczenia są również dostępne przez standardowe endpointy API ExpenseCharge.

Swagger / OpenAPI

Pełna dokumentacja API w Swagger UI: /api/v1/doc