```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 PLC komunikační kanál s protokolem Watt Price (.Net).

  • Do kanálu přidejte zařízení z knihovny: CzechRepublic\OTE\Watt Price 15-Minute Period (Array)

  • Přidané zařízení má přednastavené následující parametry:

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.

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

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

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

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

  1. V části Web API Access klikněte na Generate Token a vytvořte bezpečnostní token.

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