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

Что такое коммунальные начисления?

Коммунальные начисления позволяют отслеживать затраты на коммунальные услуги: электроэнергию, воду, газ, отопление, интернет и другие расходы, связанные с недвижимостью. Каждый расход привязан к типу расходов и может иметь несколько счетчиков для автоматического отслеживания потребления.

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

Зонные цены

Многозонная система тарифов позволяет устанавливать разные цены для разных временных периодов:

Как настроить

Создание начислений

Начисления на основе счетчиков создаются автоматически или вручную:

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

Самый простой вариант - использование зоны 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-токеном.

Поля формы

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