Dokumentation | API-Referenz

Was sind Tarifzonen?

Tarifzonen ermöglichen die Erfassung des Stromverbrauchs nach verschiedenen Tarifen abhängig von der Tageszeit. Einzonen-Zähler zeigen den Gesamtverbrauch, Zweizonen-Zähler trennen Tag und Nacht, und Dreizonen-Zähler erfassen Spitze, Halbspitze und Nacht.

Unterstützte Länder:

Ukraine - Strom

Tariftypen

Einzonen

TOTAL T1

Gesamt

Einheitstarif für 24 Stunden

100%

Dreizonen

PEAK T1

Spitze

08:00–11:00, 20:00–22:00 (150% des Tarifs)

150% 08:00–11:00, 20:00–22:00

HALF_PEAK T2

Nebenlast

07:00–08:00, 11:00–20:00, 22:00–23:00 (100% des Tarifs)

100% 07:00–08:00, 11:00–20:00, 22:00–23:00

NIGHT T3

Nacht

23:00–07:00 (50% des Tarifs)

40% 23:00–07:00

Zweizonen

DAY T1

Tag

07:00–23:00 (100% des Tarifs)

100% 07:00–23:00

NIGHT T2

Nacht

23:00–07:00 (50% des Tarifs)

50% 23:00–07:00

Wie zu verwenden

Wählen Sie beim Erstellen eines Stromzählers den Tariftyp (Einzonen, Zweizonen oder Dreizonen).
Wählen Sie beim Eingeben von Zählerständen die Tarifzone aus, wenn der Zähler mehrzonig ist.
Tarifkoeffizienten (100%, 50%, 150% usw.) werden zur Kostenberechnung angewendet.

REST API

Informationen zu Tarifzonen über REST API abrufen:

GET /api/v1/tariff-zones?country=UA&expense_type_id=3
GET /api/v1/tariff-zones/tariff-types?country=UA&expense_type_id=3
GET /api/v1/tariff-zones/by-tariff-type?country=UA&expense_type_id=3&tariff_type=TWO_ZONE
GET /api/v1/tariff-zones/has-zones?country=UA&expense_type_id=3

Beispielantwort

{
  "tariff_zones": [
    {
      "id": 2,
      "zone_code": "DAY",
      "name": {
        "en": "Day",
        "uk": "День",
        "ru": "День",
        "pl": "Dzień"
      },
      "description": {
        "en": "07:00–23:00 (100% of tariff)",
        ...
      },
      "coefficient": 100,
      "time_ranges": [{"from": "07:00", "to": "23:00"}],
      "meter_index": "T1",
      "tariff_type": "TWO_ZONE"
    },
    {
      "id": 3,
      "zone_code": "NIGHT",
      "name": {"en": "Night", ...},
      "coefficient": 50,
      "time_ranges": [{"from": "23:00", "to": "07:00"}],
      "meter_index": "T2",
      "tariff_type": "TWO_ZONE"
    }
  ],
  "total": 2
}

Swagger / OpenAPI

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