Разовые начисления
Разовые начисления для нерегулярных расходов: ремонты, аварийные службы, разовые сборы.
Обзор
Разовые начисления позволяют арендодателям создавать одноразовые начисления без настройки отдельного типа расходов. Каждый объект имеет скрытый тип расходов "разовые", который создаётся автоматически.
Быстрое создание
Не нужно создавать тип расходов — просто укажите дату, сумму и описание.
Автоматический тип расходов
Система автоматически создаёт и управляет скрытым типом разовых расходов для каждого объекта.
Мультивалютность
Каждое начисление может использовать любую валюту. Автоматическая конвертация при отображении.
Группированный просмотр
Все разовые начисления доступны на отдельной странице, отделённой от регулярных.
Как это работает
Поля формы
| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
| charge_date | date | * | Дата возникновения расходов |
| period_start | date | * | Начало расчётного периода |
| period_end | date | * | Конец расчётного периода |
| amount | decimal | * | Сумма начисления (положительное число) |
| currency_id | integer | * | Идентификатор валюты |
| notes | text | Описание, видимое арендатору |
Контроль доступа
| Роль | Создание | Просмотр |
|---|---|---|
| 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