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
}'