> ## Documentation Index
> Fetch the complete documentation index at: https://podpora.cubee.cz/llms.txt
> Use this file to discover all available pages before exploring further.

# Číselníky pro kalkulačku

> Endpointy, které naplní vstupy kalkulátoru — distributoři, sazby, HDO, poplatky a jističe

Než sestavíte požadavek pro [výpočet úspor](/partner/calculator-description) (`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.

<Info>
  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).
</Info>

## Doporučený postup

<Steps>
  <Step title="Načtěte distributory">
    `GET /api/v1/reference/distributors` → uživatel vybere distributora (`CEZ`, `PRE`, `EGD`).
  </Step>

  <Step title="Načtěte distribuční sazby">
    `GET /api/v1/reference/distribution-rates` → uživatel vybere sazbu (např. `D57d`).
  </Step>

  <Step title="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).
  </Step>

  <Step title="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í.
  </Step>
</Steps>

***

## Distributoři

```http theme={null}
GET /api/v1/reference/distributors
```

Seznam podporovaných distributorů.

```json Odpověď theme={null}
[
  { "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

```http theme={null}
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).

```json Odpověď theme={null}
[
  { "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

```http theme={null}
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.

```json Odpověď theme={null}
[
  { "key": "STRED", "name": "Střed" },
  { "key": "ZAPAD", "name": "Západ" }
]
```

***

## HDO příkazy

```http theme={null}
GET /api/v1/reference/distributors/{distributor}/commands?regionKey={regionKey}
```

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

```json Odpověď theme={null}
["A1B4DP6", "A3B7DP1", "EVV2"]
```

<Warning>
  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`).
</Warning>

***

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

```http theme={null}
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.

```json Odpověď theme={null}
[
  {
    "command": "EVV2",
    "distributorKey": "CEZ",
    "regionTypeKey": null,
    "tariffSchedules": [
      {
        "dayTypeKey": "WORKDAY",
        "timeRanges": [{ "periodStart": "00:00:00", "periodEnd": "06:00:00" }]
      }
    ]
  }
]
```

***

## Poplatky z ceníku

```http theme={null}
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**.

```json Odpověď theme={null}
{
  "distributorFeeHighPerMWh": 712.00,
  "distributorFeeLowPerMWh": 201.25,
  "ntAvailable": true,
  "renewableEnergyFeePerMWh": 0.0,
  "systemServicesFeePerMWh": 212.0,
  "feeSourceYear": 2025
}
```

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

***

## Jističe

```http theme={null}
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í.

```json Odpověď theme={null}
[
  { "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í

```http theme={null}
GET /api/v1/reference/periods
```

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

```json Odpověď theme={null}
["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

```http theme={null}
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](#distribu%C4%8Dn%C3%AD-sazby)) vykreslíte křivku po měsících.

```json Odpověď (zkráceno) theme={null}
[
  { "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.

***

<Card title="Sestavení požadavku výpočtu" icon="calculator" href="/partner/calculator-description">
  Jakmile máte vstupy vyplněné, pokračujte na popis požadavku a odpovědi kalkulátoru.
</Card>