Číselníky pro kalkulačku

Než sestavíte požadavek pro výpočet úspor (POST /api/v2/savings-calculator), potřebujete správně vyplnit vstupy — distributora, distribuční sazbu, HDO příkaz, regulované poplatky a jistič. Tyto číselníky vám dodá sada referenčních endpointů. Jsou to přesně stejná data, ze kterých staví formulář naše partnerská konzole i kalkulačka na webu — jeden společný zdroj.

Všechny endpointy vyžadují stejnou autorizaci jako samotný výpočet (partnerský API klíč, politika Calculator). Vrací pouze veřejná číselníková data (žádné údaje o zákaznících).

Doporučený postup

Načtěte distributory

GET /api/v1/reference/distributors → uživatel vybere distributora (CEZ, PRE, EGD).

Načtěte distribuční sazby

GET /api/v1/reference/distribution-rates → uživatel vybere sazbu (např. D57d).

U regionálních distributorů načtěte regiony a HDO příkazy

…/distributors/{distributor}/regions, poté …/distributors/{distributor}/commands — u dvoutarifních sazeb je HDO příkaz povinný (bez něj se celý výpočet počítá ve vysokém tarifu).

Předvyplňte poplatky a jistič z ceníku

…/fees a …/circuit-breakers vrátí regulované poplatky a poplatek za jistič pro dané období — uživatel je jen potvrdí.

Distributoři

GET /api/v1/reference/distributors

Seznam podporovaných distributorů.

Odpověď

[
  { "key": "CEZ", "name": "ČEZ Distribuce", "logoUrl": "…" },
  { "key": "PRE", "name": "PRE distribuce", "logoUrl": "…" },
  { "key": "EGD", "name": "EG.D", "logoUrl": "…" }
]

Hodnotu key použijete jako distribution.distributor v požadavku výpočtu.

Distribuční sazby

GET /api/v1/reference/distribution-rates

Všechny sazby (sazby) nabízené v kalkulačce, s popiskem a třídou typového diagramu dodávky (TDD).

Odpověď

[
  { "code": "D02d", "description": "Domácnosti s běžnými spotřebiči", "tdd": "TDD4" },
  { "code": "D57d", "description": "Domácnosti s elektrickým vytápěním", "tdd": "TDD7" }
]

code použijete jako distribution.distributionRate.

HDO regiony

GET /api/v1/reference/distributors/{distributor}/regions

Regiony pro nízký tarif u daného distributora. U distributorů, kde HDO příkazy nejsou vázané na region, vrací prázdné pole.

Odpověď

[
  { "key": "STRED", "name": "Střed" },
  { "key": "ZAPAD", "name": "Západ" }
]

HDO příkazy

GET /api/v1/reference/distributors/{distributor}/commands?regionKey={regionKey}

Aktuálně platné HDO příkazy pro distributora, volitelně zúžené na region (regionKey).

Odpověď

["A1B4DP6", "A3B7DP1", "EVV2"]

U dvoutarifní sazby je HDO příkaz povinný — musí odpovídat jednomu z těchto příkazů, jinak výpočet vrátí 400. Vybraný příkaz vložíte do distribution.lowTariffCommand (a případný region do distribution.lowTariffRegion).

Spínací plán HDO příkazu

GET /api/v1/reference/distributors/{distributor}/commands/{command}/periods?regionKey={regionKey}

Kdy daný HDO příkaz přepíná mezi vysokým (VT) a nízkým (NT) tarifem — po dnech v týdnu a časových intervalech. Hodí se pro zobrazení rozvrhu uživateli.

Odpověď

[
  {
    "command": "EVV2",
    "distributorKey": "CEZ",
    "regionTypeKey": null,
    "tariffSchedules": [
      {
        "dayTypeKey": "WORKDAY",
        "timeRanges": [{ "periodStart": "00:00:00", "periodEnd": "06:00:00" }]
      }
    ]
  }
]

Poplatky z ceníku

GET /api/v1/reference/fees?distributor={distributor}&rate={rate}&period={period}

Regulované poplatky pro danou kombinaci distributor + sazba + období (period je "2024", "2025" nebo "12M"). Slouží k předvyplnění formuláře — uživatel je jen potvrdí. Vše v Kč/MWh.

Odpověď

{
  "distributorFeeHighPerMWh": 712.00,
  "distributorFeeLowPerMWh": 201.25,
  "ntAvailable": true,
  "renewableEnergyFeePerMWh": 0.0,
  "systemServicesFeePerMWh": 212.0,
  "feeSourceYear": 2025
}

ntAvailable = true znamená, že sazba je dvoutarifní — pak je nutné zadat HDO příkaz. Hodnoty vložíte do distribution.distributorFeeHighPerMWh, …LowPerMWh, renewableEnergyFeePerMWh a systemServicesFeePerMWh.

Jističe

GET /api/v1/reference/circuit-breakers?distributor={distributor}&rate={rate}&period={period}

Dostupné velikosti hlavního jističe a jejich měsíční paušál (Kč/měsíc) pro dané období.

Odpověď

[
  { "code": "3x16", "label": "3×16 A", "monthlyFeeCzk": 155.0 },
  { "code": "3x25", "label": "3×25 A", "monthlyFeeCzk": 236.0 }
]

monthlyFeeCzk u vybrané velikosti vložíte do distribution.circuitBreakerMonthlyFee.

Období

GET /api/v1/reference/periods

Období, která kalkulačka přijímá.

Odpověď

["2024", "2025", "12M"]

"12M" = posledních 12 měsíců. Hodnotu použijete jako periodType v požadavku výpočtu.

Měsíční profil spotřeby

GET /api/v1/reference/consumption-profile?tdd={tdd}&yearlyConsumptionKWh={kWh}

Rozloží roční spotřebu do 12 kalendářních měsíců podle sezónního tvaru dané TDD třídy — stejného profilu, se kterým počítá kalkulačka. Hodí se pro graf spotřeby v průvodci: uživatel zadá roční spotřebu, vybere sazbu, a z jejího tdd (viz distribuční sazby) vykreslíte křivku po měsících.

Odpověď (zkráceno)

[
  { "month": 1, "consumptionKWh": 424.53 },
  { "month": 2, "consumptionKWh": 388.20 },
  { "month": 12, "consumptionKWh": 412.90 }
]

month je kalendářní měsíc 1–12 (leden–prosinec). Dvanáct hodnot dává součtem přesně zadanou roční spotřebu. Data jsou jen ilustrační pro graf — do požadavku výpočtu posíláte dál roční hodnotu (yearlyConsumptionKWh), ne měsíce.

Sestavení požadavku výpočtu

Jakmile máte vstupy vyplněné, pokračujte na popis požadavku a odpovědi kalkulátoru.

Začínáme

Kalkulačka

Endpoints

Doporučený postup

Distributoři

Distribuční sazby

HDO regiony

HDO příkazy

Spínací plán HDO příkazu

Poplatky z ceníku

Jističe

Období

Měsíční profil spotřeby

Sestavení požadavku výpočtu

​Doporučený postup

​Distributoři

​Distribuční sazby

​HDO regiony

​HDO příkazy

​Spínací plán HDO příkazu

​Poplatky z ceníku

​Jističe

​Období

​Měsíční profil spotřeby

Sestavení požadavku výpočtu

Doporučený postup

Distributoři

Distribuční sazby

HDO regiony

HDO příkazy

Spínací plán HDO příkazu

Poplatky z ceníku

Jističe

Období

Měsíční profil spotřeby