Документація | Довідник API

Огляд

Модуль "Майно наймодавця" дозволяє власникам нерухомості вести облік майна (меблі, техніка тощо), яке передається наймачу у користування разом з приміщенням. Кожен об'єкт може мати переклади для багатомовної підтримки та прикріплені документи для фіксації стану.

Облік майна

Реєстрація майна з назвою, датою, описом та орієнтовною вартістю.

Багатомовність

Додавання перекладів назв майна різними мовами.

Документи та фото

Прикріплення фото та документів для фіксації стану майна.

Оцінка вартості

Вказання орієнтовної вартості у різних валютах для страхових цілей.

Процес роботи

Типовий процес документування майна наймодавця:

1

Реєстрація майна

Власник реєструє майно з назвою, датою та описом.

2

Вказати вартість

За бажанням вказати орієнтовну вартість та валюту для страхування.

3

Додати фото

Завантажити фото для фіксації стану майна з коментарями.

4

Додати переклади

Додати переклади назви майна для багатомовної документації.

Права доступу

Права доступу до майна наймодавця:

Дія	Хто може
Створення	Власники та їх агенти
Перегляд	Власники, наймачі та їх агенти
Редагування	Власники та їх агенти
Видалення	Власники та їх агенти
Прикріплення документів	Власники та їх агенти
Керування перекладами	Власники та їх агенти

REST API

Доступ до майна через REST API (потрібна JWT-автентифікація):

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

Майно

GET    /api/v1/properties/{id}/tenant-assets            - Список майна
POST   /api/v1/properties/{id}/tenant-assets            - Створити
GET    /api/v1/properties/{id}/tenant-assets/{aid}      - Деталі
PUT    /api/v1/properties/{id}/tenant-assets/{aid}      - Оновити
DELETE /api/v1/properties/{id}/tenant-assets/{aid}      - Видалити

Документи

POST   /api/v1/properties/{id}/tenant-assets/{aid}/documents      - Прикріпити документ
DELETE /api/v1/properties/{id}/tenant-assets/{aid}/documents/{did} - Відкріпити документ

Переклади

GET    /api/v1/properties/{id}/tenant-assets/{aid}/translations       - Список перекладів
POST   /api/v1/properties/{id}/tenant-assets/{aid}/translations       - Додати переклад
PUT    /api/v1/properties/{id}/tenant-assets/{aid}/translations/{tid} - Оновити переклад
DELETE /api/v1/properties/{id}/tenant-assets/{aid}/translations/{tid} - Видалити переклад

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

{
  "data": [
    {
      "id": 1,
      "property_id": 5,
      "name": "Samsung TV 55\"",
      "description": "Smart TV with mounting bracket",
      "asset_date": "2025-03-15",
      "estimated_value": 15000.00,
      "currency": {
        "id": 1,
        "code": "UAH",
        "symbol": "₴"
      },
      "created_by": {
        "id": 8,
        "name": "Owner Name"
      },
      "documents_count": 3,
      "translations_count": 2,
      "created_at": "2025-03-15T10:30:00+00:00"
    }
  ],
  "total": 1,
  "page": 1,
  "totalPages": 1
}

Swagger / OpenAPI

Повна документація API доступна у Swagger /api/v1/doc