Документация | Справочник 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