Счётчики

Что такое счётчики?

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

Тарифные зоны электроэнергии

Для счётчиков электроэнергии вы можете выбрать разные типы тарифов в зависимости от возможностей вашего счётчика.

Как создать счётчик?

Добавление показаний

После создания счётчика вы можете добавлять показания для отслеживания потребления со временем.

Корректировки и исправления

Иногда показания счётчиков необходимо корректировать из-за отката счётчика, замены или корректировок от поставщика услуг.

Когда использовать корректировки?

• Замена счётчика - новый счётчик начинает с меньшего значения
• Откат счётчика после достижения максимального значения
• Корректировка от поставщика услуг после перерасчёта
• Исправление ошибки в ранее введённом показании

Показания, привязанные к начислениям

Когда начисление создаётся на основе показаний счётчика, система автоматически привязывает показание к начислению.

Правила привязки

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

При создании начисления для расходов со счётчиками вы выбираете существующее показание вместо ввода значений вручную. Это обеспечивает целостность данных и правильный учёт.

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

# 1. Get available unlinked readings:
GET /api/v1/properties/{propertyId}/expenses/{expenseId}/unlinked-readings

# Response:
{
  "has_counters": true,
  "has_unlinked_readings": true,
  "counters": [
    {
      "counter_id": 5,
      "serial_number": "ABC-123456",
      "unlinked_readings": [
        {
          "id": 12,
          "date": "2026-01-15",
          "value": "1500.00",
          "previous_value": "1350.00",
          "consumption": "150.0000"
        }
      ]
    }
  ]
}

# 2. Create charge with selected reading:
POST /api/v1/properties/{propertyId}/expenses/{expenseId}/charges
{
  "charge_date": "2026-01-21",
  "period_start": "2025-12-01",
  "period_end": "2025-12-31",
  "counter_value_ids": [12]
}

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

Разные участники объекта имеют разные права на счётчики и показания.

Права на счётчики

Права на показания

Статус счётчика

Счётчики могут быть активированы или деактивированы в зависимости от того, используются ли они в данный момент.

Когда деактивировать счётчик?

• Счётчик заменён на новый
• Счётчик временно не работает
• Счётчик больше не актуален для объекта

Удаление счётчика

Для сохранения целостности данных счётчики с привязанными начислениями нельзя удалить.

REST API

Все API-эндпоинты требуют JWT-аутентификации.

Примечание уровня сервиса

API счётчиков

GET    /api/v1/properties/{propertyId}/counters              # List counters for property
POST   /api/v1/properties/{propertyId}/counters              # Create counter
GET    /api/v1/properties/{propertyId}/counters/{id}         # Counter details with readings
PUT    /api/v1/properties/{propertyId}/counters/{id}         # Update counter
DELETE /api/v1/properties/{propertyId}/counters/{id}         # Delete counter (if no linked charges)
POST   /api/v1/properties/{propertyId}/counters/{id}/toggle  # Toggle active/inactive status

API показаний

POST   /api/v1/properties/{propertyId}/counters/{counterId}/values          # Add reading
PUT    /api/v1/properties/{propertyId}/counters/{counterId}/values/{id}     # Edit reading
DELETE /api/v1/properties/{propertyId}/counters/{counterId}/values/{id}     # Delete reading

Документы счётчика

POST   /properties/{propertyId}/counters/{id}/documents/upload                          # Upload document (multipart/form-data)
POST   /properties/{propertyId}/counters/{id}/documents/{documentId}/delete             # Delete document

Документы показания

POST   /properties/{propertyId}/counters/{id}/values/{valueId}/documents/upload          # Upload document (multipart/form-data)
POST   /properties/{propertyId}/counters/{id}/values/{valueId}/documents/{documentId}/delete  # Delete document

Пример: Создание счётчика

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

{
  "expense_type_id": 1,
  "serial_number": "ABC-123456",
  "tariff_type": "TWO_ZONE",
  "initial_value": "100.500",
  "initial_value_t1": "60.300",
  "initial_value_t2": "40.200",
  "initial_value_date": "2026-01-01"
}

Пример: Добавление показания

POST /api/v1/properties/1/counters/5/values
Content-Type: application/json
Authorization: Bearer <token>

# Single-zone counter (regular consumption):
{ "value": "1350.75", "date": "2026-01-07" }

# Multi-zone counter (total auto-calculated):
{
  "value_t1": "150.300",
  "value_t2": "80.200",
  "date": "2026-01-07"
}

# Adjustment reading (correction):
{
  "value": "50.000",
  "date": "2026-01-07",
  "is_adjustment": true
}

Документы счётчика: Upload

POST /properties/1/counters/5/documents/upload
Content-Type: multipart/form-data

documents[]    — file (jpg, jpeg, png, gif, webp, heic, pdf), max 20 MB
comment        — string (optional)

# Response:
{ "success": true, "uploaded": 1 }

Документы показания: Upload

POST /properties/1/counters/5/values/12/documents/upload
Content-Type: multipart/form-data

documents[]    — file (jpg, jpeg, png, gif, webp, heic, pdf), max 20 MB
comment        — string (optional)

# Response:
{ "success": true, "uploaded": 2 }

Пример ответа

{
  "id": 12,
  "value": "230.500",
  "value_t1": "150.300",
  "value_t2": "80.200",
  "value_t3": null,
  "date": "2026-01-07",
  "is_initial": false,
  "is_adjustment": false,
  "has_linked_charge": true,
  "expense_charge_id": 45,
  "can_edit": false,
  "can_delete": false,
  "documents_count": 2,
  "created_at": "2026-01-07T10:30:00+00:00"
}

Связанные разделы

Swagger / OpenAPI

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