Přílha č. 1 Obchdních pdmínek OTE, a.s. pr plynárenství Revize 11 červenec 2016 Frmáty zpráv XML
OBSAH 1. POUŽITÉ ZKRATKY... 3 2. ÚVOD... 4 3. PRINCIPY KOMUNIKACE... 5 4. FORMÁTY ZPRÁV XML DLE STANDARDU EDIGAS... 9 5. FORMÁTY ZPRÁV XML DLE SPECIFIKACE OTE... 11 2
1. POUŽITÉ ZKRATKY Pr tent dkument platí stejné zkratky a pjmy, které jsu uvedeny v Obchdních pdmínkách OTE, a.s. pr plynárenství. Krmě nich jsu pužity tyt další zkratky: Zkratka ČEPS ČHMÚ Význam Splečnst ČEPS, a.s., prvzvatel přensvé sustavyčr Český hydrmeterlgický ústav EDI ENTSO GMT IDE ISO IS-U LČ/ZČ MV PKI POF PPS PZP SFVOT VDT, VDP XSD ZD ZMV ZO Mezinárdní frmát pr elektrnicku výměnu dat (Electrnic Data Interchange) Eurpean Netwrk Transmissin System Operatrs Greenwich Mean Time Mdul SAP: Pskytvání dat nad rámec pdniku (Intercmpany Data Exchange) Organizace pr mezinárdní standardizaci Odvětvvé řešení infrmačníh systému SAP pr utility Letní/zimní čas Měsíční vypřádání Infrastruktura veřejnéh klíče (Public Key Infrastructure) Dplňující údaje pr fakturaci distribuce plynu Prvzvatel přepravní sustavy Prvzvatel zásbníku plynu Mdul CS OTE pr finanční jištění a vypřádání účastníků trhu s plynem a s elektřinu Vnitrdenní trh s plynem rganizvaný perátrem trhu Schéma struktury XML dkumentů (XML Schema Definitin) Závazek ddat Závěrečné měsíční vypřádání Závazek debrat 3
2. ÚVOD Účelem tht dkumentu je ppsat pravidla, kterými se řídí všichni uživatelé CS OTE. Tat pravidla jsu závazná pr všechny uživatele CS OTE. Kmunikační server CS OTE zajišťuje centrálně kmunikaci s statními částmi centrálníh systému a pskytuje pdpru prcesů trhu s plynem v následujících blastech: registrace účastníků trhu s plynem registrace OPM registrace dpvědnsti za dchylku a změna ddavatele nminace a renminace vnitrdenní trh s plynem trh s nevyužitu flexibilitu sběr denních, měsíčních a pravných měsíčních dat a agregace výpčet náhradních hdnt s využitím TDD výpčet dchylek (denní, měsíční a závěrečné měsíční) finanční vypřádání (denní, měsíční a závěrečné měsíční) finanční zajištění reklamace a pskytvání infrmací evidence a pskytvání bchdních údajů znamvání bchdních údajů V celé infrastruktuře CS OTE jsu aplikvány principy bezpečnéh přístupu k datům s využitím technlgie PKI a elektrnickéh pdpisu. Na veřejných webvých stránkách OTE lze nalézt následující dkumenty ppisující kmunikaci účastníků trhu s plynem s CS OTE: D1.4.2G Frmáty zpráv XML - plyn a šablny XSD Dkumenty specifikují strukturu XML zpráv a definují příslušné služby neb perace přím pdle charakteru předávaných dat; šablna XSD ppisuje přípustný bsah zprávy a umžňuje tím kntrlu správnsti dat. D1.4.3G Rzhraní webvých služeb CS OTE a WSDL šablna První dkument je manuálem rzhraní webvých služeb OTE pr plyn; WSDL šablna je standardní frmát pr ppis rzhraní webvé služby zajišťující autmaticku kmunikaci mezi CS OTE a platfrmami externích účastníků trhu. D1.4.4 Rzhraní autmatické kmunikace CS OTE Dkument je manuálem rzhraní autmatické kmunikace a ppisuje kncepci zabezpečení CS OTE, kmunikační scénáře v blasti VTP a způsby autmatizvané výměny infrmací externích subjektů s CS OTE (kmunikace prtklem SOAP v 1.1, typu SOAP-Dcument pr výměnu XML strukturvaných dat a SMTP kmunikace s pužitím S/MIME zpráv využít pr XML i jiné typy dkumentů). Využití kmunikačních kanálů je mžné pr jednh účastníka kmbinvat (s respektváním jistých mezení). Výše uvedené dkumenty jsu měněny na základě změny právních předpisů a na základě aktuálních ptřeb účastníků trhu. V případě aktualizace každéh výše ppsanéh dkumentu OTE zveřejňuje změny na webu OTE jeden měsíc před účinnstí změny na dbu minimálně 10 pracvních dnů k připmínkám účastníků trhu a infrmuje tét skutečnsti všechny účastníky trhu a ERÚ. Finální verze dkumentu je k dispzici účastníkům trhu rvněž v délce 10 pracvních dnů před termínem nasazení změn v systému OTE. 4
3. PRINCIPY KOMUNIKACE OTE, a.s., v rli perátra trhu s plynem kmunikuje s účastníky trhu v těcht blastech: Účastník trhu Prvzvatel sustavy Prvzvatel sustavy Prvzvatel plynu přepravní distribuční zásbníku Předávané infrmace Nminace přepravy Alkace na vstupních a výstupních bdech přepravní sustavy Rezervvané kapacity na OPM s typem měření A Data sptřeby v dběrných místech připjených k přepravní sustavě Registrace dběrných míst Vstupy (schvalvání) v prcesu změny ddavatele Nminace distribuce Alkace na přeshraničních plynvdech Data sptřeby a výrby zemníh plynu v příslušené dmácí zóně Registrace dběrných míst Rezervvané kapacity na OPM s typem měření A a B Vstupy (schvalvání) v prcesu změny ddavatele Nminace uskladňvání Subjekt zúčtvání Nminace závazků ddat / debrat Nminace přepravy Nminace distribuce Nminace uskladňvání Získávání infrmací výsledcích zúčtvání plynu Nabídky na rganizvané krátkdbé trhy Získávání infrmací výsledcích bchdvání na rganizvaných krátkdbých trzích Nabídky na trhu s nevyužitu flexibilitu a získávání infrmací výsledcích bchdvání na tmt trhu Vstupy (schvalvání) v prcesu změny ddavatele Registrace dpvědnsti za dchylku Získávání pdkladů finančníh vypřádání OTE Evidence a pskytvání bchdních údajů Oznamvání bchdních údajů Registrvaný účastník trhu Iniciace a vstupy d prcesu změny ddavatele ddavatel plynu Získávání dat pr fakturaci plynu knečným zákazníkům Registrace dpvědnsti za dchylku Dále CS OTE kmunikuje s dalšími subjekty: Správce TDD Předávání aktualizvaných hdnt TDD Získávání statistických údajů aplikaci TDD ČHMU Předávání hdnt tepltách vzduchu (pr aplikaci TDD) Agentura ACER Oznamvání bchdních údajů Data mezi OTE a účastníky trhu jsu předávána prstřednictvím: 5
webvéh interaktivníh rzhraní, kdy účastníci přistupují k zabezpečeným stránkám OTE, pmcí kterých je mžné zasílat údaje a získávat výsledky prcesů pdprvaných CS OTE, a autmatické kmunikace, kdy účastníci předávají a získávají data pmcí systému autmatické kmunikace, která umžňuje prpjení systému účastníka trhu s kmunikačním serverem CS OTE; data jsu předávána v dhdnutých standardizvaných frmátech. Seznam všech zpráv, které prchází přes externí rzhraní systému CS OTE, je uveden v dkumentu D1.4.2G Frmáty zpráv XML - plyn. Pr pužívání zpráv ve frmátech specifikvaných tímt dkumentem platí následující principy: registrvaní účastníci trhu jsu značvání pmcí kódvání ENTSO EIC (16) - kód přiděluje ČEPS, OPM jsu značvána pmcí kódvání ENTSO EIC (16), kód přiděluje OTE neb prvzvatel přepravní sustavy a prvzvatelé distribučních sustav na základě jim přidělené pdřady, zprávy, bsahující průběhvá data, musí pkrývat jeden celý den (24 hdin - krmě přechdu LČ na ZČ a zpět), pkud je třeba zaslat pravená data znvu, nvá zpráva musí bsahvat všechna data půvdní zprávy (při zpracvání dat se nebere hled na předchzí zprávu jak celek), jedna výměna dat (datvý subr se zprávu) musí bsahvat puze jednen typ zprávy, všem vstupním zprávám, kterými se zadávají prstřednictvím WAS prtálu pkyny prvádějící manipulaci s bchdními daty, se přiděluje časvá známka, vůči které se prvádí vyhdncvání platnsti pžadavku (kamžik přidělení systémvéh času serveru WAS záleží na druhu kanálu, kterým byla zpráva zaslána kanál HTTPs neb SMTP neb kanál webvéh rzhraní pr interaktivní práci prstřednictvím uživatelskéh rzhraní a webvéh prhlížeče). Frmáty autmatické kmunikace jsu pstaveny na kmunikačním prtklu XML s využitím standardu EDIGAS v4.0 a XML dle OTE. Frmát EDIGAS v4.0 (XML) je v externím rzhraní autmatické kmunikace využíván pr následující prcesy: předávání nminací (zprávy NOMINT, NOMRES, SHPCDS), předávání alkací (zpráva ALOCAT), pskytvání skutečných dat prvzvateli distribučních sustav a prvzvatelem přepravní sustavy (zpráva GASDAT), pskytvání výsledků zúčtvání dchylek (zpráva IMBNOT), předání infrmace přijetí neb dmítnutí zasílaných dat (zpráva APERAK), předávání infrmací vyrvnávacích akcích (BALACT). Využití frmátů v prcesech je navržen v suladu se standardy EDIGAS, případně s aplikací těcht standardů na kmunikační scénáře, které dpvídají situaci perátra trhu (standard EDIGAS primárně v ppisvaných scénářích nepracuje aktuálně s rlí nezávisléh perátra trhu). Předpkládá se, že frmát EDIGAS (XML) bude nadále pdprván jak kmunikační standard pr trh plynem rganizací ENTSO-G. Zprávy ve frmátu XML dle OTE jsu pužívány pr kmunikaci v blastech, které nejsu pdprvány standardem EDIGAS, tzn. pr následující prcesy: registrace OPM, změna ddavatele, bchdvání na krátkdbém rganizvaném trhu s plynem, pdklady finančníh vypřádání OTE, zadávání reklamací, 6
dtazy na data CDS, předávání pdkladů pr fakturaci distribuce plynu. Kmunikační standardy navrhvané a spravvané splečnstí OTE, a.s. (frmát XML dle OTE) vychází ze standardů OTE pr trh s elektřinu, pr blast plynu jsu pužívány zvláštní šablny. LDAP server IS OTE Aplikační server CDS Aplikace desílatele Zpráva Chybvá zpráva Kmunikační server idc Obsah zprávy idc Výsledek zpracvání aplikací Zprávy bch. dat VDT Výsledek zpracvání aplikací Výsledek zpracvání Interní kmunikace Aplikace IS OTE PKI server IS OTE Obr. Základní princip výměny zpráv Výměna zpráv mezi systémy účastníků trhu prbíhá autmatizvaně v těcht krcích: 1. účastník trhu zašle zprávu d CDS; zprávu mhu být buď nějaká data určená ke zpracvání v CS OTE neb napak žádst pskytnutí dat z CDS, 2. zpráva je přijata kmunikačním serverem CS OTE, prti LDAP serveru CS OTE je věřen elektrnický pdpis desílatele a s pmcí PKI serveru je prveden její rzšifrvání, 3. kmunikační server CS OTE prvede kntrlu syntaxe zprávy; v případě že byla v předchzích krcích zjištěna chyba, dešle zpět systémvé chybvé hlášení, 4. pkud je vše v přádku, v případě asynchrnníh zpracvání kmunikační server CS OTE předá zprávu k dalšímu zpracvání aplikačnímu serveru CDS, 5. v případě asynchrnníh zpracvání aplikační server CDS data zpracuje a výsledek zpracvání vrátí kmunikačnímu serveru CS OTE k deslání zpět; výsledkem může být ptvrzení přijetí dat d CDS, vyžádaná data z CDS neb chybvé hlášení, 6. kmunikační server CS OTE dpvěď zašifruje a pdepíše a dešle zpět vybraným kanálem na definvanu adresu. Pužívání a specifikace časvých zón se řídí pdle nrmy ISO 8601. V důvdněných případech byla šablna standardu EDIGAS pzměněna, aby pkryla prcesní pžadavky nárdníh prstředí. 7
Pr frmát DATA platí, že datum a čas je uváděn v lkálním čase peridy jsu značeny časem pčátku a knce peridy V hlavičce XML zprávy frmátu DATA je vždy uveden v atributu date-time datum a čas zprávy ve tvaru YYYY-MM-DDTHH:MM:SS, neb ve frmátu YYYY-MM-DDTHH:MM:SS+HH:MM, tj. včetně ff-setu, který vyjadřuje psun datumu a času zprávy prti GMT (pr data uvedená v LČ platí timeffset=+02:00, pr data uvedená v ZČ platí time-ffset=+01:00); pkud není ff-set uveden, je hdnta interpretvána jak vyjádření v GMT. Začátek dne je definván jak 06:00:00 hdin, knec dne jak 06:00:00 hdin následujícíh dne. Časvý interval platnsti hdnt dpvídá celému bdbí, za které jsu data zasílána, tj. datum d je první plynárenský den v příslušnéh bdbí, včetně uvedení času a ff-setu; a datum d je psledním plynárenským dnem v příslušném bdbí, včetně uvedení času a ff-setu (význam datumvých plžek je datum d/d VČETNĚ). Např. data za leden 2011 jsu zaslána z datem d = 2011-01-01T06:00+01:00, a datem d = 2011-02-01T06:00+01:00. 8
4. FORMÁTY ZPRÁV XML DLE STANDARDU EDIGAS Ve vybraných blastech se pr kmunikaci s CS OTE pužívají zprávy dle standardu EDIGAS v4.0 (krmě frmátu SHPCDS a BALACT, které nejsu sučástí standardních frmátů EDIGAS). Jedná se tyt frmáty: GASDAT pr předávání předběžných a skutečných dat měření, spalnéh tepla, vlastních ztrát, změny akumulace ALOCAT pr předávání alkací NOMINT pr zasílání a přepsílání nminací všech typů a pr zasílání nabídek na trhu s nevyužitu flexibilitu NOMRES pr zasílání a přepsílání ptvrzení nminací všech typů a pr ptvrzení nabídek na trhu s nevyužitu flexibilitu IMBNOT pr předávání všech typů dchylek subjektům zúčtvání (dané verze) a nevyužité flexibility (pdle msg_cde dtazu je předána dpvídající sada dat) APERAK pr známení výsledku validace a přijetí zprávy příjemcem (přijat neb chyba) SHPCDS pr zasílání čísleníku shipper kódů jedntlivými prvzvateli směrem k OTE, číselník definuje přípustné páry shipper kódů pr vybraná OPM, SZ a směr, v šablbně jsu pužity výhradně datvé typy, které jsu pužívány ve standartních zprávách BALACT pr zasílání údajů chystaném pdání pkynu a prvedení vyrvnávací akce prvzvatelem přepravní sustavy. V dkumentu D1.4.2G Frmáty zpráv XML - plyn jsu uvedeny činnsti, v nichž se zprávy v příslušných frmátech pužívají, včetně číselníku pužitých ve vybraných zprávách u některých plžek pr mezení pvlených hdnt. Pr každu blast jsu uvedeny kmunikační scénáře, které připadají v úvahu a mapvání údajů na plžky (atributy) zprávy. U každéh frmátu je uveden dkaz na XSD šablnu (pvinnst plí a výčet pvlených hdnt se mhu prti standardu lišit) včetně příkladů. Ve vybraných zprávách jsu u některých plžek pužity dplňující číselníky pr mezení pvlených hdnt. Číselníky a změněné datvé typy jsu ulženy v XSD šablně. Šablna bsahuje rvněž subry CODE-LISTS-CDS a CORE-CMPTS-CDS ve frmátu.xsd a pvlené kmbinace prduktů při zasílání d CS OTE dat z měření (intervalvá i neintervalvá měření ddávky a dběru) a dalších dat (změna akumulace, plánvaná měsíční a rční sptřeba, plánvané a skutečné vlastní ztráty, distribuční a přepravní kapacita a spalné tepl). V rámci OTE jsu zpracvávány nminace přepravy, distribuce a uskladňvání a nminace závazku ddat (ZD) a závazku debrat (ZO) a registrace bchdu s nevyužitu tlerancí (jak specifický pdtyp nminace ZD/ZO). Kmunikační scénáře jsu určeny pr zasílání dat z měření za pužití zprávy GASDAT (Gasdata) pr zasílání alkací za pužití zprávy ALOCAT (Allcatin) -schéma předávání dat PDS a PPS z měření - pdle typu měření, a schéma předávání statních dat, nminace přepravy, distribuce a uskladňvání nminace závazku ddat (ZD) a závazku debrat (ZO) pdtyp nminace bilaterálních kntraktů SZ, pdtyp nminace z vnitrdenníh trhu OTE, pdtyp nminace vyrvnávací služby mezi PPS a SZ, pdtyp nminace denníh vyrvnávacíh mnžství SZ mezi SZ a OTE, pdtyp nminace salda denních vyrvnávacích mnžství SZ mezi OTE a PPS, pdtyp nminace vyrvnání bilančníh účtu dchylek SZ při stavu nuze mezi SZ a OTE, pdtyp nminace vyrvnání bilančních účtů dchylek SZ při stavu nuze mezi OTE a PPS, pdtyp nminace z trhu s nevyužitu flexibilitu, číselník shipper kódů. 9
Pravidla pr zasílání a příjem nminací nminvat mhu puze RÚT, kteří mají registrvanu činnst Nminace pr plyn (typicky SZ), OTE přijímá nminace ZD/ZO, přepravy, distribuce a uskladňvání d těcht RÚT, OTE přijímá nminace přepravy, distribuce a uskladňvání d jedntlivých prvzvatelů, kteří přijali tyt nminace přím d těcht RÚT, pkud tent RÚT pšle stejnu nminaci přepravy, distribuce neb uskladnění na OTE i na prvzvatele, pr zpracvání se pužije pslední přijatá nminace d systému OTE dle časvé značky přijetí nminace, OTE ptvrzuje jen nminace těch RÚT, kteří pslali svje nminaci přím na OTE. Data v systému CS OTE ptřebná pr výpčet dchylek jsu pskytvána s mžným značením verze, pdle th pr jaku verzi zúčtvání jsu tat data pužita (denní, měsíční a pravné měsíční hdnty). Při zaslání dat prvzvatelem DS a PS není nutné verzi dat specifikvat, ta je stanvena až v CDS. Pžadavek na zaslání dat knkrétní verze se specifikuje v dtazu na data. Číselník značení (identifikace / specifikace) verzí pr jedntlivé zprávy (GASDAT, ALOCAT) je uveden v dkumentu D1.4.2G Frmáty zpráv XML - plyn. Pr EDIGAS platí pr číselné údaje, že se uvádí bez mezer a ddělvačů tisíců, např.: 25000000 nejsu pvleny úvdní nuly, např.: 02 hdnty jsu uváděny bez znaménka, pr určení směru (+ / -) služí jiné atributy než znaménk Rle v EDIGAS přeprava, distribuce a uskladňvání: SZ - ZSH = Shipper PPS, PDS, PZP - ZSO = System Operatr PDS - ZRO = Reginal grid Operatr (puze zprávy GASDAT a ALOCAT) OTE - ZSX = Balance Area Operatr externí dběratel/ddavatel, smluva na uskladnění, rezervvaná skladvací kapacita -ZES = External Shipper Rle v EDIGAS závazky ddat a debrat SZ - ZHC = Exchange Trader OTE - ZSX = Balance Area Operatr 10
5. FORMÁTY ZPRÁV XML DLE SPECIFIKACE OTE Ppis jedntlivých frmátů zpráv je uveden v dkumentu D1.4.2G Frmáty zpráv XML - plyn. U každéh frmátu je uvedena stručná charakteristika, přehled pužití frmátu, způsb plnění jedntlivých plžek zprávy - plnění jedntlivých atributů a dkazy na XML schéma (*.XSD) včetně příkladů. Každý druh zprávy je jednznačně identifikván pmcí msg_cde, který určuje pvahu zprávy a pstup jejíh zpracvání. Při kmunikaci s CS OTE v blasti plynu se pužívají zprávy v těcht frmátech: CDSGASCLAIM - pr zasílání dat reklamacích a zpráv OTE (vývěska zpráv) pr účastníky trhu, CDSGASPOF - pr zasílání dplňujících údajů pr faktutraci za distribuční služby prvzvatelem DS bchdníkvi s plynem, CDSGASREQ - k vyžádání dkumentu / zprávy z CDS, CDSEDIGREQ - k vyžádání dkumentu / zprávy z CDS, které jsu zasílány ve frmátu dle standardu EDIGAS, COMMONGASREQ - k vyžádání dat asynchrně zpracvávaných zpráv, pr kntrlu spjení s CDS a pr zaslání pžadavku na předání nedeslaných zpráv, CDSGASMASTERDATA - k výměně infrmací OPM mezi účastníky trhu a CDS, plní různé funkce, které jsu vymezeny kódem funkce v záhlaví zpráv, GASRESPONSE - k ptvrzení datvé výměny mezi účastníky trhu a CDS resp. CS OTE, CDSGASTEMPERATURE - k zaslání průměrné denní teplty a predikvané denní teplty d ČHMU d CDS, ISOTEDATA - k výměně dat týkajících se transakcí CS OTE na rganizvaném trhu s plynem mezi SZ a CS OTE, ISOTEMASTERDATA - pr zasílání struktury kmenvých dat bjektů CS OTE, ISOTEREQ - k vyžádání dkumentu / zprávy týkajících se transakcí CS OTE na rganizvaném krátkdbém trhu s plynem mezi SZ a OTE, SFVOTGASBILLING - pr zasílání finančních reprtů z mdulu SFVOT Pdklady pr fakturaci, SFVOTGASBILLINGSUM - pr zasílání finančních reprtů z mdulu SFVOT Pdklady pr fakturaci se suhrnými infrmacemi za dtazvané bdbí - suhrn MV, SFVOTGASCLAIM - pr zasílání finančních reprtů z mdulu SFVOT Přehled plateb a reklamací, SFVOTGASCLAIMSUM - pr zasílání finančních reprtů z mdulu SFVOT Přehled plateb a reklamací se suhrnnými infrmacemi za ZMV za dtazvané bdbí, SFVOTGASTDD - pr zasílání finančních reprtů z mdulu SFVOT Zúčtvání rzdílů z aplikace metdiky TDD, SFVOTGASTDDNETT - pr zasílání finančních reprtů z mdulu SFVOT část Netting, SFVOTLIMITS - pr zasílání infrmace celkvém stavu finančníh limitu SZ, SFVOTGASREQ - k vyžádání zaslání finančních reprtů z mdulů SFVOT část plyn, SFVOTREQ - k vyžádání zaslání finančních reprtů z mdulů SFVOT splečná část pr elektřinu a plyn. Některé frmáty (např. ISOTEDATA, ISOTEMASTERDATA, ISOTEREQ, RESPONSE) jsu zárveň využívány pr kmditu elektřina, prt bsahují i prvky (msg_cdy), které pr kmditu plyn nemají využití. 11
Glbální XSD šablny bsahují datvé typy, které by se při definici v jedntlivých frmátech zrpráv pakvaly. Vyčleněním se redukuje délka definice a usňadňuje údržba. V jedntlivých frmátech se na tyt datvé typy dkazuje. Tyt typy jsu splečné pr kmdity plyn a elektřina. OTE_GLOBALS - bsahuje datvé typy splečné pr všechny, resp. většinu frmátů XMLDSIG-CORE-SCHEMA - bsahuje definici elektrnickéh pdpisu Pr frmáty XML dle OTE platí pr číselné údaje, že se uvádí bez mezer a ddělvačů tisíců, např.: 25000000 ddělvačem desetinné části je tečka (.), např.: 3.14 není pvlena neúplná ntace, např.:.5 neb 2. nejsu pvleny úvdní nuly, např.: 02 kladné hdnty jsu uváděny bez znaménka, např.: 112 záprné údaje jsu uváděny se znaménkem mínus (-) bezprstředně před první číslicí, např.: -112 nulvá hdnta nesmí mít žádné znaménk, např.: 0 12