Головна › Бібліотека › Налаштування витрат › Разові нарахування

Разові нарахування

Разові нарахування для нерегулярних витрат: ремонти, аварійні служби, одноразові збори.

Огляд

Разові нарахування дозволяють орендодавцям створювати одноразові нарахування без налаштування окремого типу витрат. Кожен об'єкт має прихований тип витрат "разові", який створюється автоматично.

Швидке створення

Не потрібно створювати тип витрат — просто вкажіть дату, суму та опис.

Автоматичний тип витрат

Система автоматично створює та керує прихованим типом разових витрат для кожного об'єкта.

Мультивалютність

Кожне нарахування може використовувати будь-яку валюту. Автоматична конвертація при відображенні.

Групований перегляд

Всі разові нарахування доступні на окремій сторінці, відділеній від регулярних.

Як це працює

OneTimeChargeControllerUI для створення/перегляду
↓
OneTimeExpenseServiceАвтоматично створює прихований тип витрат
↓
ExpenseChargeСтандартний запис нарахування

Поля форми

Поле Тип Обов'язково Опис
charge_datedate*Дата виникнення витрат
period_startdate*Початок розрахункового періоду
period_enddate*Кінець розрахункового періоду
amountdecimal*Сума нарахування (додатне число)
currency_idinteger*Ідентифікатор валюти
notestextОпис, видимий орендарю

Контроль доступу

Роль Створення Перегляд
PROPERTY_LANDLORD
PROPERTY_LANDLORD_AGENT
PROPERTY_TENANT
PROPERTY_TENANT_AGENT

Кінцеві точки API

Примітка рівня обслуговування

GET  /properties/{propertyId}/one-time-charges        - Список разових нарахувань
POST /properties/{propertyId}/one-time-charges/new    - Створити разове нарахування

Цей маршрут — веб-форма сесії (потребує входу та CSRF-токена), а не JSON API-виклик із bearer-токеном.

Разові нарахування також доступні через стандартні API ендпоінти ExpenseCharge.

Swagger / OpenAPI

Повна API документація в Swagger UI: /api/v1/doc