3 Инвентаризация имущества
Запишите мебель, технику и другие вещи в каждом объекте — со стоимостью, валютой и фото
Зачем вести инвентаризацию?
Инвентаризация — это перечень вещей, которые находятся в объекте на момент передачи. Это важная часть управления арендной недвижимостью — она защищает и владельца, и арендатора.
Инвентаризация помогает:
- Разрешать споры о повреждении или пропаже вещей при выезде арендатора
- Отслеживать общую стоимость вещей в объекте для страхования
- Создать чёткий акт передачи как часть договора аренды
- Вести историю того, что было в каждом объекте в любой момент времени
Как добавить вещи
Откройте любой объект, перейдите на вкладку «Инвентаризация» и нажмите «Добавить». Заполните название, описание, стоимость и при желании прикрепите фото.
Перейдите в «Объекты» → выберите объект → вкладка «Инвентаризация» → «Добавить».
Подробнее читайте в разделе Инвентаризация имущества в Библиотеке.
Что указывать
Для каждой вещи можно заполнить следующие поля:
Поддерживаемые валюты
Вы можете указать стоимость каждой вещи в любой из поддерживаемых валют. Это удобно, если вы управляете объектами в разных странах или вещь была куплена за границей.
Что записывать
Вот типичные вещи, которые владельцы включают в инвентаризацию объекта:
- Мебель — диваны, кровати, шкафы, столы, стулья, полки
- Техника — холодильник, стиральная машина, телевизор, микроволновка, посудомойка
- Ключи и доступ — ключи от дверей, пульты от ворот, карты паркинга
- Оборудование — бойлер, кондиционер, обогреватель, роутер
- Декор — шторы, лампы, зеркала, картины
- Кухонные принадлежности — кастрюли, посуда, приборы, мелкая техника
Многоязычные названия
Каждая вещь может иметь переводы названия на разных языках. Это полезно, если владелец и арендатор говорят на разных языках — арендатор увидит инвентаризацию на своём языке.
Для разработчиков: REST API
Вы можете управлять инвентаризацией через REST API. Все вещи привязаны к конкретному объекту.
POST Добавить вещь
▶Создайте новую запись инвентаризации для объекта. Название и дата обязательны. Стоимость и валюта — по желанию.
POST /api/v1/properties/{id}/tenant-assets
Заголовки:
Authorization: Bearer {token}
Content-Type: application/json
Тело запроса:
{
"name": "Sofa IKEA KIVIK",
"description": "Grey 3-seat sofa, good condition",
"asset_date": "2026-01-15",
"estimated_value": 15000.00,
"currency_id": 3
}
Ответ (201 Created):
{
"data": {
"id": 1,
"property_id": "019a1b2c-3d4e-7f5a-8b9c-0123456789ab",
"name": "Sofa IKEA KIVIK",
"description": "Grey 3-seat sofa, good condition",
"asset_date": "2026-01-15",
"estimated_value": 15000.00,
"currency": {"id": 3, "code": "UAH", "symbol": "₴"}
}
}
GET Список вещей
▶Получите постраничный список всех вещей объекта. Поддерживает фильтрацию по диапазону дат.
GET /api/v1/properties/{id}/tenant-assets
Параметры запроса (все необязательные):
Ответ (200 OK):
{
"data": [
{
"id": 1,
"name": "Sofa IKEA KIVIK",
"estimated_value": 15000.00,
"currency": {"code": "UAH", "symbol": "₴"},
"asset_date": "2026-01-15"
}
],
"total": 12,
"page": 1,
"totalPages": 1
}
PUT Обновить вещь
▶Обновите существующую запись инвентаризации. Отправляйте только те поля, которые хотите изменить.
PUT /api/v1/properties/{id}/tenant-assets/{assetId}
Заголовки:
Authorization: Bearer {token}
Content-Type: application/json
Тело запроса:
{
"name": "Sofa IKEA KIVIK (updated)",
"estimated_value": 12000.00,
"currency_id": 3
}
Ответ (200 OK):
{
"message": "Asset updated successfully",
"data": {
"id": 1,
"name": "Sofa IKEA KIVIK (updated)",
"estimated_value": 12000.00,
"currency": {"id": 3, "code": "UAH", "symbol": "₴"}
}
}
GET Получить доступные валюты
▶Используйте этот эндпоинт, чтобы получить список всех доступных валют и их ID. ID валюты нужен при создании или обновлении вещей с ценой.
GET /api/v1/currencies
Ответ (200 OK):
{
"currencies": [
{
"id": 1,
"code": "EUR",
"numeric_code": 978,
"symbol": "€",
"name": {"en": "Euro", "uk": "Євро"},
"is_base": true
},
{
"id": 2,
"code": "USD",
"numeric_code": 840,
"symbol": "$",
"name": {"en": "US Dollar", "uk": "Долар США"},
"is_base": false
},
{
"id": 3,
"code": "UAH",
"numeric_code": 980,
"symbol": "₴",
"name": {"en": "Hryvnia", "uk": "Гривня"},
"is_base": false
}
],
"base_currency": "EUR",
"total": 10
}
Примеры cURL:
curl https://landlordkeeper.com/api/v1/currencies
Примеры cURL
▶1. Добавить вещь
curl -X POST https://landlordkeeper.com/api/v1/properties/019a1b2c-3d4e-7f5a-8b9c-0123456789ab/tenant-assets \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-d '{
"name": "Sofa IKEA KIVIK",
"description": "Grey 3-seat sofa, good condition",
"asset_date": "2026-01-15",
"estimated_value": 15000.00,
"currency_id": 3
}'
2. Список вещей
curl https://landlordkeeper.com/api/v1/properties/019a1b2c-3d4e-7f5a-8b9c-0123456789ab/tenant-assets \
-H "Authorization: Bearer YOUR_TOKEN_HERE"
3. Обновить вещь
curl -X PUT https://landlordkeeper.com/api/v1/properties/019a1b2c-3d4e-7f5a-8b9c-0123456789ab/tenant-assets/1 \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-d '{
"estimated_value": 12000.00,
"currency_id": 3
}'