> ## 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.

# Jak kalkulátor funguje

> Podrobný popis fungování kalkulátoru úspor Cubee

Kalkulátor úspor je pokročilý nástroj pro výpočet skutečných nákladů na elektřinu v různých konfiguracích energetického systému. Umožňuje porovnat, jak se liší náklady za elektřinu při použití chytré optimalizace Cubee oproti běžné fotovoltaice nebo dokonce úplně bez fotovoltaiky.

## Co kalkulátor počítá

Kalkulátor simuluje reálný provoz domácnosti po celé období a vypočítá tři scénáře:

<CardGroup cols={3}>
  <Card title="Without PV" icon="house">
    Domácnost bez fotovoltaiky – veškerá elektřina se nakupuje ze sítě
  </Card>

  <Card title="Basic PV" icon="solar-panel">
    Neoptimalizovaná fotovoltaika fungující v základním hybridním režimu
  </Card>

  <Card title="Smart PV" icon="brain-circuit">
    Fotovoltaika řízená optimalizačním modelem Cubee
  </Card>
</CardGroup>

### Výstup kalkulátoru

Pro každý scénář získáte přehled:

* Vyrobené energie (kWh)
* Spotřebované energie (kWh)
* Nakoupené energie ze sítě (kWh)
* Prodané energie do sítě (kWh)
* Náklady na nakoupenou elektřinu (Kč)
* Výnosy z prodané elektřiny (Kč)
* **Čisté náklady** (náklady minus výnosy)
* Průměrné ceny za nákup a prodej

<Info>
  Hlavní výsledek: **Úspora při použití Cubee oproti běžné fotovoltaice** v korunách za období.
</Info>

***

## Jak kalkulátor funguje

### 1. Vytvoření výrobního a spotřebního profilu

Kalkulátor nejprve vytvoří kompletní hodinové profily pro celé období:

**Spotřeba:**

* Buď z ročního údaje pomocí statistického modelu TDD (Typový diagram dodávky)
* Nebo z vašich vlastních hodinových dat

**Výroba:**

* Simulace osvitu panelů orientovaných na jih podle instalovaného výkonu (kWp)
* Nebo vaše vlastní výrobní data

### 2. Sestavení cenových křivek

Pro každou hodinu v roce se vypočítá kompletní cena:

**Nákupní cena zahrnuje:**

1. Silová cena (spotová nebo fixní)
2. Distribuční poplatky (VT/NT)
3. Poplatek obchodníka
4. Poplatek za systémové služby
5. Poplatek za obnovitelné zdroje
6. Daň z elektřiny (automaticky)
7. DPH (automaticky)

**Prodejní cena zahrnuje:**

1. Silová cena (spotová nebo fixní)
2. Poplatek obchodníka

<Warning>
  U prodejní ceny se **nepočítá DPH ani další daně** – jde pouze o silovou cenu a poplatek obchodníka.
</Warning>

### 3. Simulace střídače

Kalkulátor využívá pokročilý **simulátor reálného střídače**, který:

* Simuluje chování střídače v různých režimech
* Reaguje na okamžité změny spotřeby a výroby
* Počítá s technickými omezeními (výkon nabíjení/vybíjení baterie)

**Pro chytrou variantu (Smart PV):**

* Vytváří optimalizační plány na každý den v roce
* Generuje [příkazy pro střídač](/optimization-model/commands/overview) (nákup, prodej, nabíjení, vybíjení)
* Pracuje **stejně jako reálný optimalizační model Cubee**

<Info>
  Simulátor je založen na stejném kódu, který řídí vaši skutečnou elektrárnu. Proto výsledky kalkulátoru odpovídají reálnému chování systému.
</Info>

### 4. Výpočet nákladů a výnosů

Pro každý hodinový interval se spočítá:

```
Náklady = Množství nakoupené elektřiny × Nákupní cena v daném intervalu
Výnosy = Množství prodané elektřiny × Prodejní cena v daném intervalu
Čisté náklady = Celkové náklady - Celkové výnosy
```

Tento proces se opakuje pro všechny tři scénáře, čímž získáte přesné srovnání.

***

## Vstupní parametry

### Období (periodType)

Určete, pro jaké období chcete výpočet provést:

* **Rok 2024**: `"2024"` (celý kalendářní rok 2024)
* **Rok 2025**: `"2025"` (celý kalendářní rok 2025)
* **12 měsíců**: `"12M"` (posledních 12 měsíců od aktuálního data)

<Info>
  Pro konkrétní období můžete použít vlastní data v `customProductionConsumptionData`.
</Info>

***

### Spotřeba

Existují dva způsoby, jak zadat spotřebu domácnosti:

<Tabs>
  <Tab title="Roční spotřeba (jednodušší)">
    **Parametr:** `yearlyConsumptionKWh`

    Celková spotřeba za rok v kWh.

    **Výhody:**

    * Rychlé zadání
    * Není třeba mít detailní data
    * Kalkulátor vytvoří typický profil podle TDD

    **Nevýhody:**

    * Méně přesné pro neobvyklé spotřební vzory
    * Nezohledňuje specifika vaší domácnosti

    **Příklad:**

    ```json theme={null}
        {
          "yearlyConsumptionKWh": 6800
        }
    ```
  </Tab>

  <Tab title="Vlastní data (přesnější)">
    **Parametr:** `customProductionConsumptionData`

    Pole objektů s hodinovými hodnotami spotřeby a výroby.

    **Výhody:**

    * Maximální přesnost
    * Zohledňuje vaše skutečné návyky
    * Ideální pro netypické domácnosti

    **Nevýhody:**

    * Potřebujete historická data
    * Složitější příprava dat

    **Příklad:**

    ```json theme={null}
        {
          "customProductionConsumptionData": [
            {
              "time": "2024-01-01T00:00:00Z",
              "consumptionWh": 450,
              "productionWh": 0
            },
            {
              "time": "2024-01-01T01:00:00Z",
              "consumptionWh": 380,
              "productionWh": 0
            }
          ]
        }
    ```
  </Tab>
</Tabs>

<Warning>
  Pokud zadáte vlastní spotřební data (`customProductionConsumptionData`), parametr `yearlyConsumptionKWh` se **ignoruje**.
</Warning>

***

### Výroba

Podobně jako u spotřeby můžete zvolit dva způsoby:

<Tabs>
  <Tab title="Instalovaný výkon (jednodušší)">
    **Parametr:** `totalKWp` (povinný)

    Celkový instalovaný výkon panelů v kWp.

    **Co kalkulátor udělá:**

    * Simuluje osvit panelů orientovaných na jih
    * Vytvoří realistický výrobní profil pro celý rok
    * Zohledňuje počasí a sluneční svit

    **Příklad:**

    ```json theme={null}
        {
          "totalKWp": 8.5
        }
    ```
  </Tab>

  <Tab title="Vlastní data (přesnější)">
    **Parametr:** `customProductionConsumptionData`

    Stejné pole jako u spotřeby – zadáváte `productionWh` pro každou hodinu.

    **Kdy použít:**

    * Máte panely orientované jinak než na jih
    * Máte stínění nebo specifické podmínky
    * Chcete použít reálná historická data
  </Tab>
</Tabs>

***

### Baterie

Parametry bateriového úložiště výrazně ovlivňují možnosti optimalizace:

**Parametr:** `battery` (objekt, povinný)

| Parametr                             | Typ     | Povinný | Popis                               |
| ------------------------------------ | ------- | ------- | ----------------------------------- |
| `batterySizeKwh`                     | number  | ✅       | Celková kapacita baterie v kWh      |
| `reservedBatteryCapacityPercentage`  | integer | ✅       | Minimální úroveň nabití (0-100 %)   |
| `maximumBatteryChargingPowerWatt`    | integer | ❌       | Maximální výkon nabíjení ve wattech |
| `maximumBatteryDischargingPowerWatt` | integer | ❌       | Maximální výkon vybíjení ve wattech |

**Příklad kompletního nastavení baterie:**

```json theme={null}
{
  "battery": {
    "batterySizeKwh": 10.0,
    "reservedBatteryCapacityPercentage": 10,
    "maximumBatteryChargingPowerWatt": 5000,
    "maximumBatteryDischargingPowerWatt": 5000
  }
}
```

<Accordion title="Co když nemám baterii?">
  Kalkulátor funguje i bez baterie. V takovém případě:

  * Nastavte `batterySizeKwh: 0`
  * Optimalizace se zaměří pouze na přímou spotřebu z FVE
  * Rozdíl mezi Basic PV a Smart PV bude menší (bez možnosti časového posunu energie)
</Accordion>

***

### Distribuce

Parametry distribuce elektřiny zahrnují poplatky distributora a distribuční sazbu:

**Parametr:** `distribution` (objekt, povinný)

| Parametr                   | Typ    | Povinný | Popis                                                 |
| -------------------------- | ------ | ------- | ----------------------------------------------------- |
| `distributor`              | string | ✅       | Klíč distributora: `"CEZ"`, `"PRE"` nebo `"EGD"`      |
| `distributionRate`         | string | ✅       | Distribuční sazba (např. `"D02d"`, `"D57d"`)          |
| `lowTariffCommand`         | string | ✅       | HDO kód pro nízký tarif (např. `"EVV2"`, `"A4B3DP9"`) |
| `distributorFeeHighPerMWh` | number | ✅       | Poplatek za MWh ve vysokém tarifu (Kč/MWh)            |
| `distributorFeeLowPerMWh`  | number | ❌       | Poplatek za MWh v nízkém tarifu (Kč/MWh)              |
| `renewableEnergyFeePerMWh` | number | ✅       | Poplatek za obnovitelné zdroje (Kč/MWh)               |
| `systemServicesFeePerMWh`  | number | ✅       | Poplatek za systémové služby (Kč/MWh)                 |
| `circuitBreakerMonthlyFee` | number | ✅       | Měsíční paušál za jistič (Kč/měsíc)                   |

**Příklad kompletního nastavení distribuce:**

```json theme={null}
{
  "distribution": {
    "distributor": "CEZ",
    "distributionRate": "D02d",
    "lowTariffCommand": "EVV2",
    "distributorFeeHighPerMWh": 450.5,
    "distributorFeeLowPerMWh": 225.25,
    "renewableEnergyFeePerMWh": 495.0,
    "systemServicesFeePerMWh": 600.0,
    "circuitBreakerMonthlyFee": 150.0
  }
}
```

<Info>
  Hodnoty distribučních poplatků najdete ve svém [cenovém rozhodnutí](/guides/prices/distribution-parameters) od distributora. HDO kód najdete na vašem elektroměru nebo v distribuční smlouvě.
</Info>

***

### Nákupní cena elektřiny

Kalkulátor podporuje dva typy tarifů na dodávce (nákupu):

<Tabs>
  <Tab title="Fixní tarif (FIX)">
    **Parametr:** `electricityBuyingSettings` (objekt, povinný)

    | Parametr                            | Typ    | Povinný | Popis                          |
    | ----------------------------------- | ------ | ------- | ------------------------------ |
    | `buyingType`                        | string | ✅       | Musí být `"FIX"`               |
    | `fixedBuyPriceCzkPerMWh`            | number | ✅       | Pevná cena za MWh (VT)         |
    | `fixedBuyPriceCzkPerMwhInLowTariff` | number | ❌       | Pevná cena za MWh (NT)         |
    | `monthlyFeeCzk`                     | number | ✅       | Měsíční paušál (Kč/měsíc)      |
    | `vat`                               | number | ❌       | DPH v procentech (výchozí: 21) |

    **Příklad:**

    ```json theme={null}
        {
          "electricityBuyingSettings": {
            "buyingType": "FIX",
            "fixedBuyPriceCzkPerMWh": 2500.0,
            "fixedBuyPriceCzkPerMwhInLowTariff": 1800.0,
            "monthlyFeeCzk": 300.0
          }
        }
    ```
  </Tab>

  <Tab title="Spotový tarif (SPOT)">
    **Parametr:** `electricityBuyingSettings` (objekt, povinný)

    | Parametr           | Typ     | Povinný | Popis                          |
    | ------------------ | ------- | ------- | ------------------------------ |
    | `buyingType`       | string  | ✅       | Musí být `"SPOT"`              |
    | `feeType`          | string  | ✅       | `"PerMWh"` nebo `"Percentage"` |
    | `fee`              | number  | ✅       | Výše poplatku obchodníka       |
    | `spotPriceMinZero` | boolean | ✅       | Omezit minimální cenu na 0?    |
    | `monthlyFeeCzk`    | number  | ✅       | Měsíční paušál (Kč/měsíc)      |
    | `vat`              | number  | ❌       | DPH v procentech (výchozí: 21) |

    **Příklad:**

    ```json theme={null}
        {
          "electricityBuyingSettings": {
            "buyingType": "SPOT",
            "feeType": "PerMWh",
            "fee": 350.0,
            "spotPriceMinZero": true,
            "monthlyFeeCzk": 300.0
          }
        }
    ```
  </Tab>
</Tabs>

<Info>
  Při spotovém tarifu se k ceně na burze (OTE) **automaticky přičítají** distribuční poplatky, poplatek obchodníka, daň z elektřiny a DPH. Pokud parametr `vat` nezadáte, použije se výchozí hodnota **21 %**.
</Info>

***

### Prodejní cena elektřiny (volitelné)

Kalkulátor podporuje i prodej elektřiny do sítě. Pokud prodej nechcete zahrnout, tento parametr vynechte.

<Tabs>
  <Tab title="Fixní výkup (FIX)">
    **Parametr:** `electricitySellingSettings` (objekt, volitelný)

    | Parametr                  | Typ    | Povinný | Popis                      |
    | ------------------------- | ------ | ------- | -------------------------- |
    | `sellingType`             | string | ✅       | Musí být `"FIX"`           |
    | `fixedSellPriceCzkPerMWh` | number | ✅       | Pevná výkupní cena za MWh  |
    | `monthlyFeeCzk`           | number | ✅       | Měsíční paušál (typicky 0) |

    **Příklad:**

    ```json theme={null}
        {
          "electricitySellingSettings": {
            "sellingType": "FIX",
            "fixedSellPriceCzkPerMWh": 1500.0,
            "monthlyFeeCzk": 0.0
          }
        }
    ```
  </Tab>

  <Tab title="Spotový výkup (SPOT)">
    **Parametr:** `electricitySellingSettings` (objekt, volitelný)

    | Parametr           | Typ     | Povinný | Popis                          |
    | ------------------ | ------- | ------- | ------------------------------ |
    | `sellingType`      | string  | ✅       | Musí být `"SPOT"`              |
    | `feeType`          | string  | ✅       | `"PerMWh"` nebo `"Percentage"` |
    | `fee`              | number  | ✅       | Výše poplatku (často záporná)  |
    | `spotPriceMinZero` | boolean | ✅       | Omezit minimální cenu na 0?    |
    | `monthlyFeeCzk`    | number  | ✅       | Měsíční paušál (typicky 0)     |

    **Příklad:**

    ```json theme={null}
        {
          "electricitySellingSettings": {
            "sellingType": "SPOT",
            "feeType": "PerMWh",
            "fee": -200.0,
            "spotPriceMinZero": false,
            "monthlyFeeCzk": 0.0
          }
        }
    ```

    <Info>
      Pro spotový výkup je poplatek často **záporný** – obchodník si strhává část z vaší ceny.
    </Info>
  </Tab>
</Tabs>

***

## Výstupní data

Kalkulátor vrací detailní přehled pro každý ze tří scénářů:

### Struktura odpovědi

```json theme={null}
{
  "withoutPV": { /* EnergyDataSet */ },
  "basicPV": { /* EnergyDataSet */ },
  "smartPV": { /* EnergyDataSet */ },
  "savingsComparedToBasicPV": 15420.50,
  "months": [ /* pole měsíčních výsledků */ ]
}
```

### EnergyDataSet

Každý scénář obsahuje tyto údaje:

| Pole                                           | Typ    | Popis                                                |
| ---------------------------------------------- | ------ | ---------------------------------------------------- |
| `energyProducedKWh`                            | number | Celková vyrobená energie v kWh (0 u Without PV)      |
| `energyConsumedKWh`                            | number | Celková spotřebovaná energie v kWh                   |
| `energyPurchasedKWh`                           | number | Nakoupená energie ze sítě v kWh                      |
| `energySoldKWh`                                | number | Prodaná energie do sítě v kWh                        |
| `costOfPurchasedEnergy`                        | number | Náklady na nakoupenou elektřinu v Kč                 |
| `revenueFromSoldEnergy`                        | number | Výnosy z prodané elektřiny v Kč                      |
| `netEnergyCost`                                | number | **Čisté náklady** (náklady - výnosy) v Kč            |
| `averagePurchasePricePerMWh`                   | number | Průměrná nákupní cena za MWh v Kč                    |
| `averageSellPricePerMWh`                       | number | Průměrná prodejní cena za MWh v Kč                   |
| `energyNotSoldDueToNegativePriceLimitationKWh` | number | Energie neprodaná kvůli omezení záporných cen (kWh)  |
| `savingsFromNotSoldEnergyToNegativePrice`      | number | Úspora z neprodané energie při záporných cenách (Kč) |

<Info>
  **Klíčová hodnota:** `netEnergyCost` – čím nižší, tím lépe!

  Pole `netEnergyCost`, `averagePurchasePricePerMWh` a `averageSellPricePerMWh` jsou **vypočítané hodnoty** (read-only) – není potřeba je zadávat.
</Info>

### Hlavní výsledek

| Pole                       | Typ    | Popis                                                        |
| -------------------------- | ------ | ------------------------------------------------------------ |
| `savingsComparedToBasicPV` | number | **Úspora při použití Cubee oproti běžné FVE** v Kč za období |

### Měsíční rozpis

Pro období delší než měsíc kalkulátor poskytne také rozpis po měsících:

| Pole     | Typ   | Popis                             |
| -------- | ----- | --------------------------------- |
| `months` | array | Pole objektů s měsíčními výsledky |

Každý měsíční objekt obsahuje:

* `month` – datum měsíce (formát `YYYY-MM-DD`)
* `withoutPV`, `basicPV`, `smartPV` – EnergyDataSet pro daný měsíc
* `savingsComparedToBasicPV` – úspora v daném měsíci

***

## Praktický příklad

### Ukázkový požadavek

```json theme={null}
{
  "periodType": "2024",
  "yearlyConsumptionKWh": 6800,
  "totalKWp": 10.5,
  "battery": {
    "batterySizeKwh": 20.0,
    "reservedBatteryCapacityPercentage": 10,
    "maximumBatteryChargingPowerWatt": null,
    "maximumBatteryDischargingPowerWatt": null
  },
  "distribution": {
    "distributor": "CEZ",
    "distributionRate": "D57d",
    "lowTariffCommand": "EVV2",
    "distributorFeeHighPerMWh": 712.00,
    "distributorFeeLowPerMWh": 201.25,
    "renewableEnergyFeePerMWh": 495.0,
    "systemServicesFeePerMWh": 212.0,
    "circuitBreakerMonthlyFee": 150.0
  },
  "electricityBuyingSettings": {
    "buyingType": "SPOT",
    "feeType": "PerMWh",
    "fee": 250.0,
    "spotPriceMinZero": true,
    "monthlyFeeCzk": 80.0
  },
  "electricitySellingSettings": {
    "sellingType": "SPOT",
    "feeType": "PerMWh",
    "fee": 200.0,
    "spotPriceMinZero": false,
    "monthlyFeeCzk": 0.0
  }
}
```

### Ukázková odpověď

```json theme={null}
{
  "withoutPV": {
    "energyProducedKWh": 0.0,
    "energyConsumedKWh": 6800.0,
    "energyPurchasedKWh": 6800.0,
    "energySoldKWh": 0.0,
    "costOfPurchasedEnergy": 52000.0,
    "revenueFromSoldEnergy": 0.0,
    "netEnergyCost": 52000.0,
    "averagePurchasePricePerMWh": 7647.06,
    "averageSellPricePerMWh": 0.0,
    "energyNotSoldDueToNegativePriceLimitationKWh": 0.0,
    "savingsFromNotSoldEnergyToNegativePrice": 0.0
  },
  "basicPV": {
    "energyProducedKWh": 8500.0,
    "energyConsumedKWh": 6800.0,
    "energyPurchasedKWh": 2100.0,
    "energySoldKWh": 3800.0,
    "costOfPurchasedEnergy": 15300.0,
    "revenueFromSoldEnergy": 5700.0,
    "netEnergyCost": 9600.0,
    "averagePurchasePricePerMWh": 7285.71,
    "averageSellPricePerMWh": 1500.0,
    "energyNotSoldDueToNegativePriceLimitationKWh": 0.0,
    "savingsFromNotSoldEnergyToNegativePrice": 0.0
  },
  "smartPV": {
    "energyProducedKWh": 8500.0,
    "energyConsumedKWh": 6800.0,
    "energyPurchasedKWh": 2450.0,
    "energySoldKWh": 4150.0,
    "costOfPurchasedEnergy": 11250.0,
    "revenueFromSoldEnergy": 9750.0,
    "netEnergyCost": 1500.0,
    "averagePurchasePricePerMWh": 4591.84,
    "averageSellPricePerMWh": 2349.40,
    "energyNotSoldDueToNegativePriceLimitationKWh": 120.0,
    "savingsFromNotSoldEnergyToNegativePrice": 350.0
  },
  "savingsComparedToBasicPV": 8100.0
}
```

### Interpretace výsledků

<Steps>
  <Step title="Bez fotovoltaiky (Without PV)">
    Domácnost by zaplatila **52 000 Kč** ročně za elektřinu.
  </Step>

  <Step title="Běžná fotovoltaika (Basic PV)">
    S neoptimalizovanou FVE jsou roční náklady **9 600 Kč** (náklady 15 300 Kč minus výnosy 5 700 Kč).

    **Úspora oproti bez FVE: 42 400 Kč**
  </Step>

  <Step title="Chytrá fotovoltaika (Smart PV)">
    S optimalizací Cubee jsou roční náklady pouze **1 500 Kč** (náklady 11 250 Kč minus výnosy 9 750 Kč).

    **Úspora oproti Basic PV: 8 100 Kč**

    **Jak to Cubee dokázalo:**

    * Nakoupilo více (2 450 kWh vs. 2 100 kWh), ale za **nižší průměrnou cenu** (4 592 Kč/MWh vs. 7 286 Kč/MWh)
    * Prodalo více (4 150 kWh vs. 3 800 kWh) za **vyšší průměrnou cenu** (2 349 Kč/MWh vs. 1 500 Kč/MWh)
    * Strategické přednákupy v levných hodinách + prodej při cenových špičkách
    * Zabránilo prodejům za záporné ceny (ušetřilo 350 Kč)
  </Step>
</Steps>

### Srovnání

| Scénář               | Náklady   | Výnosy   | Čisté náklady | Úspora vs. bez FVE |
| -------------------- | --------- | -------- | ------------- | ------------------ |
| **Bez FVE**          | 52 000 Kč | 0 Kč     | 52 000 Kč     | –                  |
| **Basic PV**         | 15 300 Kč | 5 700 Kč | 9 600 Kč      | 42 400 Kč          |
| **Smart PV (Cubee)** | 11 250 Kč | 9 750 Kč | 1 500 Kč      | 50 500 Kč          |

<Info>
  **Závěr:** Použití Cubee oproti běžné fotovoltaice ušetří v tomto případě **8 100 Kč ročně** díky chytrému nákupu v levných hodinách a prodeji při cenových špičkách.
</Info>

## Co kalkulátor počítá a co ne

### Co kalkulátor POČÍTÁ

<CardGroup cols={2}>
  <Card title="Náklady na průtok" icon="plug">
    Všechny poplatky účtované za průtok elektřiny (Kč/MWh)
  </Card>

  <Card title="Distribuční poplatky" icon="tower-broadcast">
    VT/NT sazby a všechny související poplatky
  </Card>

  <Card title="Poplatek obchodníka" icon="handshake">
    Za zúčtování odchylky (nákup i prodej)
  </Card>

  <Card title="Systémové služby" icon="server">
    Poplatek za systémové služby
  </Card>

  <Card title="Obnovitelné zdroje" icon="wind">
    Poplatek za podporu OZE
  </Card>

  <Card title="Daň z elektřiny" icon="percent">
    Automaticky podle legislativy
  </Card>

  <Card title="DPH" icon="calculator">
    Automaticky ze všech složek ceny (výchozí 21 %)
  </Card>

  <Card title="Měsíční paušály" icon="calendar">
    V API verzi (v rámci parametrů)
  </Card>
</CardGroup>

### Co kalkulátor NEPOČÍTÁ

<Warning>
  **Omezení kalkulátoru:**

  * **Některé fixní měsíční poplatky** ve webové verzi (plná funkcionalita pouze v API)
  * **Poplatek za překročení rezervované kapacity**
  * **Mimořádné situace** (výpadky, poruchy, black-outy)
  * **Degradaci baterie** v čase
  * **Změny legislativy** během období
  * **Inflaci cen** elektřiny
</Warning>

<Info>
  Webová verze kalkulátoru na [cubee.cz](https://cubee.cz) momentálně nepodporuje všechny paušální měsíční poplatky. Plnou funkcionalitu získáte při použití **API**.
</Info>

***

## Často kladené otázky

<AccordionGroup>
  <Accordion title="Jak přesné jsou výsledky kalkulátoru?">
    Kalkulátor využívá stejný optimalizační model jako produkční verze Cubee. Přesnost závisí na kvalitě vstupních dat:

    **S vlastními daty** (spotřeba, výroba):

    * Přesnost velmi vysoká (±5 %)
    * Zahrnuje specifika vaší domácnosti

    **S odhadem roční spotřeby**:

    * Odchylka ±10-15 % kvůli zjednodušenému TDD profilu
    * Nezohledňuje neobvyklé spotřební vzory

    **Predikce cen elektřiny**:

    * Vychází z historických dat
    * Skutečné budoucí ceny se mohou lišit

    <Info>
      Nejpřesnější výsledky získáte použitím **vlastních historických dat** spotřeby a výroby.
    </Info>
  </Accordion>

  <Accordion title="Proč je rozdíl mezi Basic PV a Smart PV?">
    **Basic PV** (běžná fotovoltaika):

    * Funguje v hybridním režimu
    * Nabíjí baterii, když je přebytek
    * Vybíjí baterii, když je spotřeba
    * **Neprovádí žádnou optimalizaci** podle cen

    **Smart PV** (Cubee):

    * **Nakupuje v nejlevnějších hodinách** (využívá nízké ceny)
    * **Prodává v nejdražších hodinách** (maximalizuje výnosy)
    * **Šetří baterii** na cenově výhodnější časy
    * Využívá **předpovědi spotřeby a výroby**
    * Reaguje na **záporné ceny** (zakáže přetoky)

    **Konkrétní příklad:**

    Představte si den, kdy FVE vyrábí přebytek 5 kWh a:

    * V 10:00 je spotová cena 1 Kč/kWh
    * V 18:00 je spotová cena 5 Kč/kWh

    **Basic PV:**

    * V 10:00 uloží přebytek do baterie
    * V 18:00 vybije baterii pro vlastní spotřebu
    * Výsledek: Ušetří nákup 5 kWh × 5 Kč = **25 Kč**

    **Smart PV (Cubee):**

    * V 10:00 prodá přebytek do sítě za 1 Kč/kWh → výnos 5 Kč
    * Zároveň v 10:00 nakoupí levnou energii a nabije baterii
    * V 18:00 prodá z baterie za 5 Kč/kWh → výnos 25 Kč
    * V 18:00 pokryje spotřebu z další levné energie nakoupené dříve
    * Výsledek: Vydělá na rozdílu cen = **vyšší úspora**

    Cubee optimalizuje celý den najednou a využívá cenové rozdíly mezi hodinami.
  </Accordion>

  <Accordion title="Mohu zadat vlastní spotřební a výrobní data?">
    Ano, prostřednictvím parametru `customProductionConsumptionData` můžete zadat hodinové hodnoty pro celé období.

    **Výhody:**

    * Použití reálných historických dat
    * Zahrnutí specifických spotřebních návyků
    * Zohlednění neobvyklých orientací panelů
    * Maximální přesnost výpočtu

    **Formát dat:**

    ```json theme={null}
        {
          "customProductionConsumptionData": [
            {
              "time": "2024-01-01T00:00:00Z",
              "consumptionWh": 450,
              "productionWh": 0
            },
            {
              "time": "2024-01-01T01:00:00Z",
              "consumptionWh": 380,
              "productionWh": 0
            }
          ]
        }
    ```

    **Kde získat data:**

    * Export z vaší aplikace střídače
    * Data z Cubee aplikace (pokud už Cubee máte)
    * Monitoring z distributora (chytré elektroměry)
  </Accordion>

  <Accordion title="Jak kalkulátor pracuje s dvoutarifní sazbou?">
    Kalkulátor automaticky rozpozná nastavení nízkého tarifu podle:

    1. **Parametr `lowTariffCommand`** v distribuci
       * Definuje HDO kód (např. `"EVV2"`)
       * Určuje, kdy platí nízký tarif

    2. **Parametr `distributorFeeLowPerMWh`**
       * Nižší distribuční poplatek pro NT
       * Pokud není zadán, použije se `distributorFeeHighPerMWh`

    3. **Parametr `fixedBuyPriceCzkPerMwhInLowTariff`** (u fixního tarifu)
       * Nižší fixní cena pro NT
       * Pokud není zadána, použije se `fixedBuyPriceCzkPerMWh`

    **Výsledek:**

    * V hodinách NT se aplikují nižší poplatky
    * Optimalizace využívá levnější NT pro nákup
    * Přesný výpočet podle vašeho tarifu
  </Accordion>

  <Accordion title="Proč některé hodnoty (DPH, daň) nemusím zadávat?">
    Kalkulátor automaticky dopočítá:

    **Daň z elektřiny:**

    * Podle aktuální legislativy ČR
    * Automaticky se přičítá k nákupní ceně

    **DPH:**

    * Z celkové ceny včetně všech poplatků
    * Výchozí sazba 21 %
    * Můžete přepsat parametrem `vat` v `electricityBuyingSettings`

    <Info>
      Pokud parametr `vat` nezadáte, použije se automaticky **21 %**. Pokud ho zadáte, použije se vaše hodnota.
    </Info>
  </Accordion>

  <Accordion title="Liší se webová verze od API?">
    Ano, existují určité rozdíly v dostupné funkcionalitě:

    **Webová verze (cubee.cz):**

    * Základní výpočet úspor
    * Roční spotřeba nebo vlastní data
    * Spotové i fixní tarify
    * Grafické zobrazení výsledků
    * Některé měsíční paušály nejsou zahrnuty

    **API verze:**

    * Vše z webové verze
    * Všechny měsíční paušály
    * Měsíční rozpis výsledků
    * Možnost integrace do vlastních aplikací
    * Větší flexibilita v nastavení
  </Accordion>

  <Accordion title="Co když udělám chybu v zadání?">
    API vrátí chybovou odpověď s popisem problému:

    **HTTP 400 (Bad Request):**

    * Chybějící povinný parametr
    * Neplatná hodnota (např. záporná kapacita baterie)
    * Nesprávný formát dat

    **HTTP 401 (Unauthorized):**

    * Chybí autentizační token
    * Neplatný nebo expirovaný token

    **HTTP 500 (Internal Server Error):**

    * Chyba na straně serveru
    * Kontaktujte podporu

    <Info>
      Při vývoji doporučujeme **testovat s menšími daty** a postupně přidávat komplexnější parametry.
    </Info>
  </Accordion>
</AccordionGroup>

***

## Další zdroje

<CardGroup cols={2}>
  <Card title="Jak optimalizace funguje" icon="brain-circuit" href="/optimization-model/overview">
    Pochopte, jak Cubee vytváří optimalizační plány
  </Card>

  <Card title="Typy příkazů" icon="cubes" href="/optimization-model/commands/overview">
    Detailní popis všech režimů střídače
  </Card>

  <Card title="Průvodce cenami" icon="coins" href="/guides/prices/overview">
    Jak fungují ceny elektřiny a jak je nastavit
  </Card>

  <Card title="Partner API" icon="code" href="https://api.partner.cubee.cz">
    Kompletní dokumentace API
  </Card>
</CardGroup>