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

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

Что такое корректировки баланса между арендодателем и арендатором?

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

Когда нужна корректировка?

  • Корректировка арендной платы по договорённости сторон
  • Частичное использование депозита для покрытия расходов
  • Компенсация за повреждение имущества
  • Возврат переплаты арендатору
  • Скидка из добрых намерений или компенсация неудобств

Поля корректировки

Дата корректировки

Дата, на которую выполняется корректировка

Арендодатель

Арендодатель, для которого выполняется корректировка

Арендатор

Арендатор, для которого выполняется корректировка

Сумма

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

Валюта

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

Комментарий

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

Договор (необязательно)

Связь с договором (необязательное поле)

Подтверждение корректировок

Корректировки могут быть подтверждены как арендодателем, так и арендатором. Полное подтверждение получается только после подтверждения обеими сторонами.

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

Ожидает подтверждения

Ожидает подтверждения от обеих сторон

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

Подтверждено арендодателем, ожидает подтверждения от арендатора

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

Подтверждено арендатором, ожидает подтверждения от арендодателя

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

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

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. Скидка автоматически учитывается при расчёте следующего платежа за аренду