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

Начисления за оренду

Автоматична щомісячна генерація начислень оренди з договорів

Що таке начисления за оренду?

Начисления за оренду - це автоматично генеровані щомісячні платежі за оренду на основі активних договорів оренди. Система розраховує начисления на основі щомісячної суми оренди, вказаної в договорі, та фактичної кількості днів оренди в кожному періоді.

Основні можливості

  • Автоматичне нарахування щомісяця
  • Пропорційний розрахунок за неповний місяць
  • Гнучкий день платежу
  • Єдиний інтерфейс з комунальними витратами
  • Підтримка мультивалютності

Як це працює

1

Крок 1: Налаштування договору

Заповніть поля MONTHLY_RENT_AMOUNT та RENT_PAYMENT_DAY в договорі оренди

2

Крок 2: Автоматична генерація

Система автоматично згенерує орендні платежі щомісяця о 00:01

3

Крок 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
  • Перевірити дату початку та закінчення договору
  • Переглянути налаштування валюти договору
  • Перевірити логи системи на наявність помилок
  • Переконатися, що договір активний
  • Перевірити, чи не заблокована генерація платежів для цього договору
  • Зверну тися до адміністратора, якщо проблема не вирішується

Неправильна сума

Якщо сума платежу розрахована неправильно, це може бути через пропорційний розрахунок за неповний місяць. Перевірте період платежу та кількість днів у періоді.