Головна › Бібліотека › Коректування балансу › Коректування арендодавець-арендатор

Коректування балансу між арендодавцем та арендатором

Що таке коректування балансу між арендодавцем та арендатором?

Коректування балансу між арендодавцем та арендатором - це механізм для врегулювання фінансових питань між сторонами договору оренди. Коректування може бути як позитивним (додаткове нарахування), так і негативним (зменшення боргу або компенсація за виконані роботи, знижки).

Коли потрібно коректування?

  • Коректування орендної плати через домовленість сторін
  • Часткове використання депозиту для покриття витрат
  • Компенсація за пошкодження майна
  • Повернення переплати орендарю
  • Знижка за добрими намірами або компенсація незручностей

Поля коректування

Дата коректування

Дата, на яку виконується коректування

Орендодавець

Орендодавець, для якого виконується коректування

Орендар

Орендар, для якого виконується коректування

Сума

Сума коректування: негативна для зменшення боргу орендаря (компенсація, знижка), позитивна для додаткового нарахування

Валюта

Валюта суми коректування

Коментар

Опис причини коректування (необов'язкове поле)

Договір (необов'язково)

Зв'язок з договором (необов'язкове поле)

Підтвердження коректувань

Коректування може бути підтверджено як орендодавцем, так і орендарем. Повне підтвердження отримується тільки після підтвердження обома сторонами.

Статуси підтвердження

Очікує підтвердження

Очікує підтвердження від обох сторін

Підтверджено арендодавцем

Підтверджено орендодавцем, очікує підтвердження від орендаря

Підтверджено арендатором

Підтверджено орендарем, очікує підтвердження від орендодавця

Повністю підтверджено

Підтверджено обома сторонами

REST API

Модуль надає REST API для роботи з коректуваннями арендодавець-арендатор. Усі ендпоінти вимагають авторизації через Bearer токен.

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

GET /api/v1/properties/{id}/lt-adjustments

Отримати список усіх коректувань для об'єкту нерухомості з можливістю пагінації

Параметри запиту

  • page (необов'язково) - Номер сторінки (за замовчуванням: 1)
  • limit (необов'язково) - Кількість елементів на сторінці (за замовчуванням: 20, максимум: 100)

Приклад запиту

curl -X GET "https://landlordkeeper.com/api/v1/properties/1/lt-adjustments?page=1&limit=20" \
  -H "Authorization: Bearer YOUR_TOKEN"

Приклад відповіді

{
  "items": [
    {
      "id": 1,
      "adjustment_date": "2026-01-28",
      "amount": -150.50,
      "currency": {
        "id": 1,
        "code": "EUR",
        "symbol": "€"
      },
      "landlord": {
        "id": 5,
        "name": "John Landlord"
      },
      "tenant": {
        "id": 8,
        "name": "Jane Tenant"
      },
      "notes": "Rent correction for repairs",
      "status": "fully_confirmed",
      "is_confirmed_by_landlord": true,
      "is_confirmed_by_tenant": true,
      "documents_count": 2,
      "created_at": "2026-01-28T10:30:00+00:00",
      "created_by": {
        "id": 5,
        "name": "John Landlord"
      }
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 20
}

POST /api/v1/properties/{id}/lt-adjustments

Створити нове коректування балансу між арендодавцем та арендарем

Тіло запиту

{
  "adjustment_date": "2026-01-28",
  "landlord_id": 5,
  "tenant_id": 8,
  "amount": -150.50,
  "currency_id": 1,
  "notes": "Rent correction for tenant-completed repairs",
  "contract_id": 5
}

Приклад відповіді

{
  "id": 1,
  "message": "Adjustment created successfully"
}

GET /api/v1/properties/{id}/lt-adjustments/{aid}

Отримати детальну інформацію про коректування з усіма пов'язаними даними

Приклад відповіді

{
  "id": 1,
  "adjustment_date": "2026-01-28",
  "amount": -150.50,
  "currency": {
    "id": 1,
    "code": "EUR",
    "symbol": "€"
  },
  "landlord": {
    "id": 5,
    "name": "John Landlord"
  },
  "tenant": {
    "id": 8,
    "name": "Jane Tenant"
  },
  "notes": "Rent correction for repairs",
  "status": "fully_confirmed",
  "is_confirmed_by_landlord": true,
  "landlord_confirmed_by": {
    "id": 5,
    "name": "John Landlord"
  },
  "landlord_confirmed_at": "2026-01-28T11:00:00+00:00",
  "is_confirmed_by_tenant": true,
  "tenant_confirmed_by": {
    "id": 8,
    "name": "Jane Tenant"
  },
  "tenant_confirmed_at": "2026-01-28T12:00:00+00:00",
  "contract": {
    "id": 5,
    "name": "Contract #5"
  },
  "documents": [
    {
      "id": 19,
      "original_name": "repair_receipt.pdf",
      "file_size": 245678,
      "comment": "Repair invoice",
      "created_at": "2026-01-28T10:35:00+00:00"
    }
  ],
  "created_at": "2026-01-28T10:30:00+00:00",
  "created_by": {
    "id": 5,
    "name": "John Landlord"
  }
}

PUT /api/v1/properties/{id}/lt-adjustments/{aid}

Оновити існуюче коректування (можливо тільки до повного підтвердження)

Тіло запиту

{
  "adjustment_date": "2026-01-29",
  "amount": -180.00,
  "notes": "Updated correction amount"
}

Приклад відповіді

{
  "message": "Adjustment updated successfully"
}

DELETE /api/v1/properties/{id}/lt-adjustments/{aid}

Видалити коректування (можливо тільки до підтвердження будь-якою стороною)

Приклад відповіді

{
  "message": "Adjustment deleted successfully"
}

POST /api/v1/properties/{id}/lt-adjustments/{aid}/documents

Прикріпити документ до коректування (квитанції, акти, договори)

Тіло запиту

{
  "document_id": 42,
  "comment": "Repair receipt"
}

Приклад відповіді

{
  "message": "Document attached successfully"
}

DELETE /api/v1/properties/{id}/lt-adjustments/{aid}/documents/{did}

Відкріпити документ від коректування

Приклад відповіді

{
  "message": "Document detached successfully"
}

POST /api/v1/properties/{id}/lt-adjustments/{aid}/confirm-landlord

Підтвердити коректування від імені орендодавця

Приклад відповіді

{
  "message": "Confirmed by landlord",
  "status": "confirmed_by_landlord"
}

POST /api/v1/properties/{id}/lt-adjustments/{aid}/confirm-tenant

Підтвердити коректування від імені орендаря

Приклад відповіді

{
  "message": "Confirmed by tenant",
  "status": "fully_confirmed"
}

Приклади використання

Сценарій 1: Компенсація за ремонт, виконаний орендарем

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

  1. Створити коректування на суму -150 EUR (негативна, зменшує борг орендаря)
  2. Прикріпити фото квитанцій та чеків на будматеріали
  3. Орендодавець підтверджує коректування
  4. Орендар підтверджує коректування - сума автоматично враховується при наступних платежах

Сценарій 2: Знижка за незручності під час ремонту

У будинку проводився капітальний ремонт даху, що створювало шум та незручності для орендаря.

  1. Орендодавець створює коректування на -200 EUR як компенсацію за 2 тижні незручностей
  2. Обидві сторони підтверджують коректування
  3. Знижка автоматично враховується при розрахунку наступного платежу за оренду