Начисления за оренду
Автоматична щомісячна генерація начислень оренди з договорів
Що таке начисления за оренду?
Начисления за оренду - це автоматично генеровані щомісячні платежі за оренду на основі активних договорів оренди. Система розраховує начисления на основі щомісячної суми оренди, вказаної в договорі, та фактичної кількості днів оренди в кожному періоді.
Основні можливості
- Автоматичне нарахування щомісяця
- Пропорційний розрахунок за неповний місяць
- Гнучкий день платежу
- Єдиний інтерфейс з комунальними витратами
- Підтримка мультивалютності
Як це працює
Крок 1: Налаштування договору
Заповніть поля MONTHLY_RENT_AMOUNT та RENT_PAYMENT_DAY в договорі оренди
Крок 2: Автоматична генерація
Система автоматично згенерує орендні платежі щомісяця о 00:01
Крок 3: Перегляд та управління
Переглядайте та управляйте згенерованими платежами в розділі "Витрати"
Логіка розрахунку платежів
Розрахунок періоду
Система автоматично визначає період для нарахування на основі дати початку договору та дня платежу:
Правила визначення періоду
- Якщо договір починається 1-го числа, період починається з 1-го числа
- Якщо договір починається після дня платежу, перший період буде коротким (пропорційний розрахунок)
- Якщо договір починається до дня платежу, перший період починається з дати початку
- Кожен наступний період починається з дня, наступного після дня платежу попереднього періоду
Пропорційний розрахунок
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
Приклад розрахунку
Сценарій
- Місячна оренда: 10,000 грн
- Дата початку: 15 січня 2026
- День платежу: 5-е число
Згенеровані платежі
| Період | Днів | Розрахунок | Сума |
|---|---|---|---|
| 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 |
Поля договору для орендних платежів
Для автоматичного нарахування орендних платежів в договорі оренди повинні бути заповнені наступні поля:
| Назва поля | Обов'язкове | Опис |
|---|---|---|
MONTHLY_RENT_AMOUNT |
Обов'язково | Місячна сума оренди. Якщо не вказано або дорівнює 0, орендні платежі не будуть генеруватися. |
RENT_PAYMENT_DAY |
необов'язково | День місяця для оплати (1-28). Якщо не вказано, використовується початок місяця. |
Приклад
Договір оренди
API для орендних платежів
Для роботи з орендними платежами доступні наступні API endpoints:
Примітка рівня обслуговування
GET /api/v1/rental-charges
Список орендних платежів
GET /api/v1/rental-charges/{id}
Деталі орендного платежу
GET /api/v1/rental-charges/contract/{id}
Список платежів за договором
GET /api/v1/rental-charges/contract/{id}/next
Наступний період для нарахування
POST /api/v1/rental-charges/contract/{id}/generate
Генерація орендних платежів
DELETE /api/v1/rental-charges/{id}
Видалення орендного платежу
Приклад 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"
}
Обмеження
Важливо
- Автоматичні платежі генеруються щодня о 00:01 (за часовим поясом сервера)
- Автоматично згенеровані платежі не можна редагувати
- Автоматично згенеровані платежі можна видалити лише адміністратором
- Платежі генеруються лише для активних договорів
- Система не генерує повторні платежі за вже завершені періоди
Перегляд платежів
Перегляньте згенеровані платежі в розділі "Витрати" нерухомості
Усунення проблем
Платежів не знайдено
Якщо орендні платежі не генеруються автоматично, перевірте наступне:
- Перевірити, чи заповнено поле MONTHLY_RENT_AMOUNT
- Перевірити дату початку та закінчення договору
- Переглянути налаштування валюти договору
- Перевірити логи системи на наявність помилок
- Переконатися, що договір активний
- Перевірити, чи не заблокована генерація платежів для цього договору
- Зверну тися до адміністратора, якщо проблема не вирішується
Неправильна сума
Якщо сума платежу розрахована неправильно, це може бути через пропорційний розрахунок за неповний місяць. Перевірте період платежу та кількість днів у періоді.