```text
====== Ovladač cen elektřiny Watt Price (.Net) ======

Ovladač Watt Price (.Net) umožňuje přístup k denním výsledkům obchodování s elektřinou zveřejňovaným na adrese http://www.ote-cr.cz. Data jsou získávána prostřednictvím oficiálního rozhraní SOAP API dostupného na adrese: https://www.ote-cr.cz/services/PublicDataService.

> **Poznámka:** Od verze Mervis **2.7.22** je ovladač Watt Price součástí instalačního balíčku Mervis a není nutné jej instalovat samostatně. To platí i pro všechny novější verze.

> **Poznámka:** V dubnu 2026 zavedl OTE nový koncový bod služby (''https://www.ote-cr.cz/pw-data/services/PublicDataService''). Podle nezávislého testování provedeného dne 31. srpna 2026 vracejí původní i nový koncový bod totožné, funkční odpovědi. OTE zatím neoznámil závazný termín přechodu na nový koncový bod. Z dlouhodobého hlediska je však doporučeno změnit URI cenového API na nový koncový bod, až to bude vhodné.

===== Nastavení ovladače =====
  * Přidejte do projektu PLC se spuštěným .Net Serverem pro Mervis RT, viz [[en:mervis-ide:35-help:70-dotnet-server|Průvodce instalací / aktualizací .Net Serveru pro Mervis RT]].
  * V konfiguraci PLC povolte .Net ovladače: ''PLC\Configuration => Common\Enable .NET Drivers: true''
{{:en:mervis-ide:35-help:020-communication-protocols-description:enable_net_drivers.png?nolink&800}}
  * Přidejte do PLC komunikační kanál s protokolem Watt Price (.Net).
{{:en:mervis-ide:35-help:020-communication-protocols-description:watt_price_protocol.png?nolink&800}}
  * Do kanálu přidejte zařízení z knihovny: ''CzechRepublic\OTE\Watt Price 15-Minute Period (Array)''
{{:en:mervis-ide:35-help:020-communication-protocols-description:watt_price_add_device.png?nolink&800}}
  * Přidané zařízení má přednastavené následující parametry:
{{:en:mervis-ide:35-help:020-communication-protocols-description:watt_price_device_parameters.png?nolink&800}}

^ Parametr ^ Popis ^
| Price API Type | Protokol používaný pro dotazování zdroje cen. Přednastavená hodnota je ''SOAP'' a obvykle ji není nutné měnit. |
| Price API URI | URL koncového bodu služby, ze kterého ovladač získává cenová data. Výchozí hodnota odpovídá veřejnému koncovému bodu SOAP služby OTE. |
| Price API Time Zone | Časové pásmo používané při interpretaci a zarovnávání cenových dat. Výchozí hodnota je ''Europe/Prague''. |
| Date Shift Days | Určuje, pro který den se mají načíst ceny vzhledem k aktuálnímu dni. Hodnota ''0'' načte ceny pro dnešní den, ''-1'' pro včerejší den, ''-2'' pro předchozí den atd. Kladné hodnoty posouvají datum do budoucnosti (např. ''1'' načte ceny pro zítřejší den, jakmile budou zveřejněny). |

===== Proměnné PLC =====

Mapování datových bodů se provádí prostřednictvím položky ''Variable Identifier'':

^ Variable Identifier ^ Popis ^
| PriceInQH_0xx | Cena pro konkrétní čtvrthodinu (např. ''PriceInQH_001''). |
| PriceInQH | Pole cen pro jednotlivé čtvrthodiny daného dne. |
| QuarterHoursInDay | Počet čtvrthodin v daném dni. |
| QuarterHoursAvailable | Počet platných čtvrthodinových položek dostupných od začátku dne. |
| PriceMinimum | Minimální cena. |
| PriceMaximum | Maximální cena. |
| PriceAverage | Průměrná cena. |
| PriceCurrent | Aktuální cena. |

Proměnné lze vytvořit a propojit ručně nebo pomocí funkce Set Autogen.

{{:en:mervis-ide:35-help:020-communication-protocols-description:watt_price_demo.png?nolink&800}}

==== Kontrola úplnosti dat ====

V některých případech může ovladač získat data pouze pro část dne, například jen pro jeho první polovinu. V takovém případě obsahuje proměnná ''QuarterHoursAvailable'' počet platných položek od začátku dne.

  * Pokud se ''QuarterHoursAvailable'' rovná ''QuarterHoursInDay'', jsou data pro daný den **úplná**.
  * Pokud je ''QuarterHoursAvailable'' menší než ''QuarterHoursInDay'', jsou data **neúplná**. Platných je pouze prvních ''QuarterHoursAvailable'' položek pole ''PriceInQH''.

> **Tip:** Před použitím cen pro účely regulace zkontrolujte v programu PLC hodnotu ''QuarterHoursAvailable'', aby neúplná data nebyla považována za kompletní data za celý den.

===== Informace o čtvrthodinových cenách =====

OTE zveřejňuje ceny na denním trhu s dodávkou na následující den v **hodinovém** rozlišení. Ovladač Watt Price tato hodinová data načítá a pro každou hodinu vypočítává čtyři čtvrthodinové hodnoty (''PriceInQH'') tak, že hodinovou cenu rovnoměrně rozdělí mezi čtyři patnáctiminutové intervaly. Jedná se o očekávané a správné chování. Ovladač nepožaduje od OTE samostatnou datovou sadu se skutečným patnáctiminutovým rozlišením, protože denní trh OTE ceny v takovém rozlišení vůbec nezveřejňuje.

===== Platforma ENTSO-E Transparency Platform: Referenční informace k přístupu k API =====

Ovladač Watt Price používá jako zdroj dat OTE. Týmy, které chtějí získávat data z trhu s elektřinou také přímo z platformy ENTSO-E Transparency Platform (například pro trhy mimo Českou republiku nebo pro nezávislé ověření údajů OTE), mohou využít veřejné REST API této platformy. Přístup vyžaduje bezplatnou registraci účtu a schválený bezpečnostní token.

==== Nastavení přístupu k API ====

  - Zaregistrujte si bezplatný účet na platformě Transparency Platform a poté odešlete e-mail na adresu ''transparency@entsoe.eu'' s předmětem „Restful API access“. Do těla zprávy uveďte e-mailovou adresu použitou při registraci.
{{:en:mervis-ide:35-help:020-communication-protocols-description:transparency_email_1.png?nolink&800}}
  - Podpora ENTSO-E potvrdí udělení přístupu, obvykle během několika pracovních dnů, a zašle odkaz na uživatelskou příručku REST API.
{{:en:mervis-ide:35-help:020-communication-protocols-description:transparency_email_2.png?nolink&800}}
  - Po udělení přístupu se přihlaste na platformu Transparency Platform a v nabídce účtu v pravém horním rohu otevřete položku **My Account**.
{{:en:mervis-ide:35-help:020-communication-protocols-description:transparency_platform_2.png?nolink&800}}
  - V části **Web API Access** klikněte na **Generate Token** a vytvořte bezpečnostní token.
{{:en:mervis-ide:35-help:020-communication-protocols-description:transparency_platform_1.png?nolink&800}}

==== Referenční přehled formátů ====

Pokud týmy porovnávají odpovědi SOAP služby OTE s odpověďmi REST API ENTSO-E (například při vývoji vlastních integrací), liší se oba formáty následovně:

^ Vlastnost ^ ENTSO-E REST (A44) ^ OTE SOAP ^
| Protokol | REST GET | SOAP POST |
| Cenové pole | ''<price.amount>'' uvnitř ''<Point>'' | ''<PriceCZ>'' |
| Časové údaje | ''<timeInterval><start>'' + ''<position>'' (1–24) | ''<Date>'' + ''<Hour>'' |
| Rozlišení | Pouze PT60M (hodinové) | Hodinové |
| Formát chyby | XML Acknowledgement_MarketDocument | SOAP Fault |
| Autentizace | Parametr ''securityToken'' v URL dotazu (vyžaduje registraci a schválení) | Žádná |

Oba zdroje zveřejňují ceny na denním trhu s dodávkou na následující den pouze v hodinovém rozlišení. To odpovídá způsobu, jakým ovladač Watt Price odvozuje čtvrthodinové hodnoty z hodinových dat (viz část „Informace o čtvrthodinových cenách“ výše).
```