====== Watt Price Driver (.Net) ====== Watt Price Driver (.Net) poskytuje přístup k výsledkům denního trhu s elektřinou zveřejňovaným na adrese http://www.ote-cr.cz. Data jsou získávána z oficiálního SOAP API dostupného na adrese: https://www.ote-cr.cz/services/PublicDataService. > **Poznámka:** OTE zavedla v dubnu 2026 nový endpoint služby (''https://www.ote-cr.cz/pw-data/services/PublicDataService''). Podle nezávislého testování provedeného 31. srpna 2026 vracejí starý i nový endpoint shodné a funkční odpovědi. OTE neoznámila pevné datum přechodu, ale z důvodu dlouhodobé stability se stále doporučuje URI Price API na nový endpoint migrovat, jakmile to bude vhodné. ===== Nastavení driveru ===== * Přidejte do projektu PLC s běžícím .Net Server for Mervis RT, viz [[cs:mervis-ide:35-help:70-dotnet-server|Installation / update guide for .Net Server for Mervis RT]] * Povolte .Net drivery v konfiguraci PLC: ''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 Channel, Protocol: Watt Price (.Net) {{:en:mervis-ide:35-help:020-communication-protocols-description:watt_price_protocol.png?nolink&800}} * Do Channel přidejte Library Device: ''CzechRepublic\OTE\Watt Price 15-Minute Period (Array)'' {{:en:mervis-ide:35-help:020-communication-protocols-description:watt_price_add_device.png?nolink&800}} * Na přidaném zařízení jsou předkonfigurovány následující parametry: {{:en:mervis-ide:35-help:020-communication-protocols-description:watt_price_device_parameters.png?nolink&800}} ^ Parameter ^ Description ^ | Price API Type | Protokol používaný pro dotazování zdroje cen. Přednastaveno na ''SOAP'' a obvykle není nutné jej měnit. | | Price API URI | URL endpointu služby, na který driver odesílá dotazy na cenová data. Ve výchozím nastavení používá veřejný SOAP endpoint OTE. | | Price API Time Zone | Časové pásmo používané při interpretaci a zarovnávání cenových dat. Ve výchozím nastavení ''Europe/Prague''. | | Date Shift Days | Určuje, pro který den se mají ceny načíst relativně k dnešnímu dni. ''0'' vrátí ceny pro dnešek. ''-1'' vrátí ceny pro včerejšek, ''-2'' pro den před včerejškem atd. Kladné hodnoty posouvají datum dopředu (např. ''1'' vrátí ceny pro zítřek, jakmile budou zveřejněny). | * Mapování datových bodů se provádí pomocí ''Variable Identifier'': * PriceInQH_0xx (např. PriceInQH_001) – cena pro konkrétní čtvrthodinu * PriceInQH – pole cen pro jednotlivé čtvrthodiny dne * QuarterHoursInDay – počet čtvrthodin v daném dni * 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}} ===== Informace o čtvrthodinových cenách ===== OTE zveřejňuje ceny denního trhu s **hodinovou** granularitou. Watt Price Driver načítá tato hodinová data a odvozuje pro každou hodinu čtyři čtvrthodinové hodnoty (''PriceInQH'') tak, že hodinovou cenu rovnoměrně rozdělí mezi její čtyři 15minutová období. Jedná se o očekávané a správné chování — driver se OTE nedotazuje na samostatný dataset se skutečnou 15minutovou granularitou, protože denní trh OTE takto podrobná cenová data vůbec nezveřejňuje. ===== ENTSO-E Transparency Platform: Reference k přístupu k API ===== Watt Price Driver používá jako zdroj dat OTE. Týmy, které chtějí dotazovat data z trhu s elektřinou také přímo z ENTSO-E Transparency Platform (například pro trhy mimo Českou republiku nebo pro nezávislé ověření dat OTE), mohou využít veřejné REST API této platformy. Přístup vyžaduje bezplatný registrovaný účet a schválený bezpečnostní token. ==== Nastavení přístupu k API ==== - Zaregistrujte si bezplatný účet na Transparency Platform a poté odešlete e-mail na ''transparency@entsoe.eu'' s předmětem "Restful API access". Do těla e-mailu uveďte svou registrovanou e-mailovou adresu. {{: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 zároveň zašle odkaz na uživatelskou příručku k 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 do Transparency Platform a v nabídce účtu v pravém horním rohu otevřete **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 svůj bezpečnostní token. {{:en:mervis-ide:35-help:020-communication-protocols-description:transparency_platform_1.png?nolink&800}} ==== Reference formátů ==== Pro týmy porovnávající SOAP odpověď OTE s REST odpovědí ENTSO-E (například při vytváření vlastních integrací) se oba formáty liší následovně: ^ Feature ^ ENTSO-E REST (A44) ^ OTE SOAP ^ | Protocol | REST GET | SOAP POST | | Price field | '''' uvnitř '''' | '''' | | Time field | '''' + '''' (1–24) | '''' + '''' | | Resolution | PT60M (hodinová) pouze | Hodinová | | Error format | Acknowledgement_MarketDocument XML | SOAP Fault | | Auth | parametr dotazu ''securityToken'' (vyžaduje registraci + schválení) | Žádná | Oba zdroje zveřejňují ceny denního trhu pouze s hodinovou granularitou, což odpovídá způsobu, jakým Watt Price Driver odvozuje čtvrthodinové hodnoty z hodinových dat (viz část „Informace o čtvrthodinových cenách“ výše).