Документація | Довідник API

Що таке тарифні зони?

Тарифні зони дозволяють вести облік споживання електроенергії за різними тарифами залежно від часу доби. Однозонні лічильники показують загальне споживання, двозонні розділяють день і ніч, а тризонні - пік, напівпік та ніч.

Підтримувані країни:

Україна - Електроенергія

Типи тарифів

однозонний

TOTAL T1

Загальний

Єдиний тариф на всю добу

100%

тризонний

PEAK T1

Пік

08:00–11:00, 20:00–22:00 (150% тарифу)

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

HALF_PEAK T2

Напівпік

07:00–08:00, 11:00–20:00, 22:00–23:00 (100% тарифу)

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

NIGHT T3

Ніч

23:00–07:00 (50% тарифу)

40% 23:00–07:00

двозонний

DAY T1

День

07:00–23:00 (100% тарифу)

100% 07:00–23:00

NIGHT T2

Ніч

23:00–07:00 (50% тарифу)

50% 23:00–07:00

Як використовувати

При створенні лічильника електроенергії оберіть тип тарифу (однозонний, двозонний або тризонний).
При внесенні показань оберіть тарифну зону, якщо лічильник багатозонний.
Коефіцієнти тарифів (100%, 50%, 150% тощо) застосовуються для розрахунку вартості.

REST API

Отримуйте інформацію про тарифні зони через 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

Приклад відповіді

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

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