Комунальні начисления

Що таке комунальні начисления?

Комунальні начисления дозволяють відстежувати витрати на комунальні послуги: електроенергію, воду, газ, опалення, інтернет та інші витрати, пов'язані з нерухомістю. Кожна витрата прив'язана до типу витрат і може мати кілька лічильників для автоматичного відстеження споживання.

Робочий процес: Типи затрат → Затрати

Зонні ціни

Багатозонна система тарифів дозволяє встановлювати різні ціни для різних часових періодів:

Як налаштувати

Створення начислень

Начисления на основі лічильників створюється автоматично або вручну:

Просте начисления

Найпростіший варіант - використання зони TOTAL з однією ціною. Система обчислює різницю між попереднім та поточним показанням, множить на ціну і створює одне начисления.

Приклад

Period: January 1-31, 2026
Service: Internet
Quantity: 1 unit
Price: €45.00 per unit
Total: €45.00

Багатозонне начисления

Для лічильників з різними тарифними зонами (день/ніч або пік/напівпік/ніч) система створює окремі елементи начисления для кожної зони. Це дозволяє точно відобразити споживання за різними тарифами.

• Лічильник
• Показання
• Споживання
• Ціна
• Сума

Приклад

Counter: Main meter (two-zone)
Period: January 1-31, 2026

Item 1 - DAY zone:
Previous reading: 500.00 kWh
Current reading: 600.00 kWh
Consumption: 100.00 kWh
Price: €0.15 per kWh
Amount: €15.00

Item 2 - NIGHT zone:
Previous reading: 200.00 kWh
Current reading: 250.00 kWh
Consumption: 50.00 kWh
Price: €0.08 per kWh
Amount: €4.00

Total charge: €19.00

Показання лічильників

Показання лічильників є основою для автоматичного розрахунку начислень:

Створення начислень вручну (UI)

Для витрат з типом споживання "По факту" або періодом розрахунку "MANUAL" ви можете створювати начислення вручну через веб-інтерфейс.

Автоматична генерація

Система може автоматично створювати начисления за комунальні послуги на основі показань лічильників:

Періоди розрахунку

Періодичність розрахунку

Періодичність розрахунку визначає, як часто створюються начисления:

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

Документи можна прикріпити на двох рівнях у модулі витрат, кожен з яких служить різним цілям:

REST API

Основні API endpoints для роботи з витратами на комунальні послуги:

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

API типів затрат

GET    /api/v1/properties/{propertyId}/expenses              # List expenses
POST   /api/v1/properties/{propertyId}/expenses              # Create expense
GET    /api/v1/properties/{propertyId}/expenses/{id}         # Expense details
PUT    /api/v1/properties/{propertyId}/expenses/{id}         # Update expense
DELETE /api/v1/properties/{propertyId}/expenses/{id}         # Delete expense
POST   /api/v1/properties/{propertyId}/expenses/{id}/toggle  # Toggle active/inactive
POST   /api/v1/properties/{propertyId}/expenses/refresh-all  # Refresh all charges
POST   /api/v1/properties/{propertyId}/expenses/{id}/refresh # Refresh single expense

Начисления

GET    /api/v1/properties/{propertyId}/expenses/{expenseId}/charges             # List charges
POST   /api/v1/properties/{propertyId}/expenses/{expenseId}/charges             # Create charge
GET    /api/v1/properties/{propertyId}/expenses/{expenseId}/unlinked-readings   # Get unlinked readings
GET    /api/v1/properties/{propertyId}/charges/{id}                             # Charge details
PUT    /api/v1/properties/{propertyId}/charges/{id}                             # Update charge
DELETE /api/v1/properties/{propertyId}/charges/{id}                             # Delete charge
POST   /api/v1/properties/{propertyId}/charges/{id}/confirm                     # Confirm charge

API документів начислень

Керування документами, прикріпленими до начислень витрат (квитанції, рахунки, договори).

GET    /api/v1/properties/{propertyId}/charges/{chargeId}/documents           # List charge documents
POST   /api/v1/properties/{propertyId}/charges/{chargeId}/documents           # Upload document to charge
GET    /api/v1/properties/{propertyId}/charges/{chargeId}/documents/{id}      # Document details
PUT    /api/v1/properties/{propertyId}/charges/{chargeId}/documents/{id}      # Update document comment
DELETE /api/v1/properties/{propertyId}/charges/{chargeId}/documents/{id}      # Remove document from charge

Завантажити квитанцію для начислення витрат

POST /api/v1/properties/1/charges/42/documents
Content-Type: multipart/form-data
Authorization: Bearer <token>

file: (binary)
document_type_id: 1
comment: "Invoice for January 2026"

API документів типу затрат

Прикріплюйте, переглядайте та керуйте документами (договори з підрядниками, тарифні графіки) безпосередньо в конфігурації типу затрат.

GET    /api/v1/properties/{propertyId}/expenses/{expenseId}/documents           # List expense documents
POST   /api/v1/properties/{propertyId}/expenses/{expenseId}/documents           # Upload document to expense
GET    /api/v1/properties/{propertyId}/expenses/{expenseId}/documents/{id}      # Document details
PUT    /api/v1/properties/{propertyId}/expenses/{expenseId}/documents/{id}      # Update document comment
DELETE /api/v1/properties/{propertyId}/expenses/{expenseId}/documents/{id}      # Remove document from expense

Приклад API: Завантажити документ до типу затрат

POST /api/v1/properties/1/expenses/3/documents
Content-Type: multipart/form-data
Authorization: Bearer <token>

file: (binary)
document_type_id: 1
comment: "Contractor agreement for heating service"

Приклад API

POST /api/v1/properties/1/expenses/3/charges
Content-Type: application/json
Authorization: Bearer <token>

{
  "charge_date": "2026-01-31",
  "period_start": "2026-01-01",
  "period_end": "2026-01-31",
  "charged_to_user_id": 5,
  "items": [
    {
      "counter_id": 5,
      "zone_code": "DAY",
      "previous_value": "500.00",
      "current_value": "600.00",
      "unit_price": "0.15"
    },
    {
      "counter_id": 5,
      "zone_code": "NIGHT",
      "previous_value": "200.00",
      "current_value": "250.00",
      "unit_price": "0.08"
    }
  ]
}

Типи витрат

Разові платежі

Як це працює

1. Перейдіть на сторінку витрат об'єкта
2. Натисніть кнопку "Разовий платіж"
3. Заповніть суму, дату, розрахунковий період та додаткові примітки
4. Платіж буде автоматично створено та позначено як підтверджений

Характеристики

• Тип споживання: По факту споживання
• Одиниця виміру: платежі
• Спеціальна мітка: Код типу витрати ONE_TIME (не постачальник — він для цього контейнера не показується)
• Видимість: Приховано зі звичайних списків витрат
• Автостворення платежів: Ні - платежі створюються тільки вручну

Маршрути

Цей маршрут — веб-форма сесії (потребує входу та CSRF-токена), а не JSON API-виклик із bearer-токеном.

Поля форми

• Дата* — Дата, коли виникла витрата
• Розрахунковий період* — Виберіть розрахунковий період для обліку
• Сума* — Загальна сума для нарахування (обов'язково)
• Примітки — Додатковий опис або пояснення