Home › Library › Tariff Zones

Tariff Zones

Multi-zone electricity metering

What are tariff zones?

Tariff zones allow tracking electricity consumption at different rates depending on the time of day. Single-zone meters show total consumption, two-zone meters separate day and night, and three-zone meters track peak, off-peak, and night usage.

Supported countries:
  • Ukraine - Electricity

Tariff Types

single-zone

TOTAL T1

Total

Single tariff for 24 hours

100%

three-zone

PEAK T1

Peak

08:00–11:00, 20:00–22:00 (150% of tariff)

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

Off-peak

07:00–08:00, 11:00–20:00, 22:00–23:00 (100% of tariff)

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

Night

23:00–07:00 (50% of tariff)

40% 23:00–07:00

two-zone

DAY T1

Day

07:00–23:00 (100% of tariff)

100% 07:00–23:00
NIGHT T2

Night

23:00–07:00 (50% of tariff)

50% 23:00–07:00

How to Use

  1. When creating an electricity meter, select the tariff type (single-zone, two-zone, or three-zone).
  2. When entering readings, select the tariff zone if the meter is multi-zone.
  3. Tariff coefficients (100%, 50%, 150%, etc.) are applied to calculate costs.

REST API

Get tariff zones information via REST API:

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

Example Response

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

Full API documentation is available in Swagger UI: /api/v1/doc