Zähler

Was sind Zähler?

Zähler ermöglichen die Verfolgung der Zählerstände von Messgeräten für Ihre Objekte: Strom, Wasser, Gas, Heizung und andere Nebenkosten. Jeder Zähler speichert Seriennummer, Anfangszählerstand und Historie aller Zählerstände.

Stromtarifzonen

Für Stromzähler können Sie verschiedene Tariftypen je nach den Fähigkeiten Ihres Zählers auswählen.

Wie erstelle ich einen Zähler?

Zählerstände hinzufügen

Nach dem Erstellen eines Zählers können Sie Zählerstände hinzufügen, um den Verbrauch im Zeitverlauf zu verfolgen.

Anpassungen und Korrekturen

Manchmal müssen Zählerstände aufgrund von Zählerrückstellung, Austausch oder Korrektur vom Dienstleister angepasst werden.

Wann sollte eine Anpassung verwendet werden?

• Zähleraustausch - neuer Zähler beginnt mit einem niedrigeren Wert
• Zählerrückstellung nach Erreichen des Maximalwertes
• Korrektur vom Dienstleister nach Neuberechnung
• Korrektur eines Fehlers in einem zuvor eingegebenen Zählerstand

Mit Abrechnungen verknüpfte Zählerstände

Wenn eine Abrechnung basierend auf Zählerständen erstellt wird, verknüpft das System automatisch den Zählerstand mit der Abrechnung.

Verknüpfungsregeln

Abrechnungen erstellen

Bei der Erstellung einer Abrechnung für zählerbasierte Ausgaben wählen Sie einen vorhandenen Zählerstand anstatt Werte manuell einzugeben. Dies gewährleistet Datenintegrität und korrekte Erfassung.

Abrechnungen über API erstellen

# 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]
}

Zugriffsrechte

Verschiedene Objektteilnehmer haben unterschiedliche Rechte für Zähler und Zählerstände.

Rechte für Zähler

Rechte für Zählerstände

Zählerstatus

Zähler können je nachdem, ob sie derzeit verwendet werden, aktiviert oder deaktiviert werden.

Wann sollte ein Zähler deaktiviert werden?

• Zähler wurde durch einen neuen ersetzt
• Zähler funktioniert vorübergehend nicht
• Zähler ist für das Objekt nicht mehr relevant

Zähler löschen

Um die Datenintegrität zu wahren, können Zähler mit verknüpften Abrechnungen nicht gelöscht werden.

REST API

Alle API-Endpunkte erfordern JWT-Authentifizierung.

Service-Layer-Hinweis

Zähler-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

Zählerstände-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

Zählerdokumente

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

Ablesungsdokumente

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

Beispiel: Zähler erstellen

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

Beispiel: Zählerstand hinzufügen

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
}

Zählerdokumente: 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 }

Ablesungsdokumente: 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 }

Beispielantwort

{
  "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"
}

Verwandte Abschnitte

Swagger / OpenAPI

Vollständige API-Dokumentation ist in Swagger UI verfügbar: /api/v1/doc