FGSZ ZRT.
INFORMATIKAI PLATFORM SZERVER-SZERVER ILLESZKEDÉSI FELÜLET 8.5 VERZIÓ
Informatikai Platform illeszkedési felület
FGSZ Zrt.
2/178
TARTALOMJEGYZÉK 1. A dokumentum célja ............................................................................................................................ 6 2. Bevezetés.............................................................................................................................................. 7 3. Fogalomtár ........................................................................................................................................... 8 3.1. Hálózati infrastruktúra .................................................................................................................................. 8 3.2. Szereplők ...................................................................................................................................................... 9 3.3. Az FGSZ és partnerei viszonyát képviselő fogalmak ................................................................................... 10 3.4. Kapacitáskezelés ......................................................................................................................................... 11 3.5. Nominálás ................................................................................................................................................... 12 3.6. Operatív matching ...................................................................................................................................... 13 3.7. Rendszerirányítás ....................................................................................................................................... 14 3.8. Allokálás ...................................................................................................................................................... 14 3.9. Elszámolás .................................................................................................................................................. 15 3.10. Műszaki informatika ................................................................................................................................. 15 3.11. Szabályozás ............................................................................................................................................... 16
4. Alapelvek ............................................................................................................................................ 17 4.1. Koncepció ................................................................................................................................................... 17 4.2. Műszaki informatikai megvalósításra vonatkozó alapelvek ....................................................................... 18 4.2.1 Rendelkezésre állás ............................................................................................................................. 18 4.2.2 Az informatikai platform elérhetősége ............................................................................................... 18 4.2.3 Azonosítás, tanúsítványok .................................................................................................................. 18 4.2.4 Alkalmazott protokollok, kódolás........................................................................................................ 18 4.2.5 Üzenetek érvényessége – validálás ..................................................................................................... 19 4.2.6 Archíválás ............................................................................................................................................ 19 4.3. Általános érvényű blokkok, típusok, címkék............................................................................................... 19 4.3.1 Fejrész ................................................................................................................................................. 20 4.3.2 (Hálózati) pont azonosítója ................................................................................................................. 21 4.3.3 Tárgy gáznap ....................................................................................................................................... 21 4.3.4 Tárgy gázóra ....................................................................................................................................... 22 4.3.5 Mennyiség ........................................................................................................................................... 23 4.3.6 Gázipari szereplő, partner ................................................................................................................... 23 4.3.7 Ár ......................................................................................................................................................... 24 4.3.8 Az eredeti üzenet adatai ..................................................................................................................... 25 4.3.9 A feldolgozás sikeressége .................................................................................................................... 26
Informatikai Platform illeszkedési felület
FGSZ Zrt.
3/178 4.3.10 Hibakezelés ....................................................................................................................................... 26 4.3.11 Alkalmazott mértékegységek táblázata............................................................................................ 28
5. A fejlesztés támogatása: Echo ............................................................................................................ 29 6. Nominálás ........................................................................................................................................... 30 6.1. Nominálási adatok beküldése (SaveNominationInEdigas) ......................................................................... 30 6.1.1 A kérést tartalmazó üzenet ................................................................................................................. 36 6.1.2 A választ tartalmazó üzenet ................................................................................................................ 40 6.2. Nominálási adatok beküldése (SaveNomination) ....................................................................................... 44 6.2.1 A kérést tartalmazó üzenet ................................................................................................................. 51 6.2.2 A választ tartalmazó üzenet ................................................................................................................ 53 6.3. Trade ajánlatok beküldése (SaveTradeNomination) .................................................................................. 54 6.3.1 A kérést tartalmazó üzenet ................................................................................................................. 56 6.3.2 A választ tartalmazó üzenet ................................................................................................................ 57 6.4. Trade ajánlatok lekérdezése (GetTradeNomination) ................................................................................. 58 6.4.1 A kérést tartalmazó üzenet ................................................................................................................. 58 6.4.2 A választ tartalmazó üzenet ................................................................................................................ 59 6.5. Trade ajánlatok jóváhagyása (TradeNominationConfirmation) ................................................................. 60 6.5.1 A kérést tartalmazó üzenet ................................................................................................................. 63 6.5.2 A választ tartalmazó üzenet ................................................................................................................ 63 6.6. Beküldött nominálási adatok verziószámmal (GetNomination) ................................................................. 64 6.6.1 A kérést tartalmazó üzenet ................................................................................................................. 64 6.6.2 A választ tartalmazó üzenet ................................................................................................................ 65 6.7. Beküldött nominálások státusza (GetNominationInfo) .............................................................................. 75 6.7.1 A kérést tartalmazó üzenet ................................................................................................................. 75 6.7.2 A választ tartalmazó üzenet ................................................................................................................ 76 6.8. Nominálások felosztása (divideNomination) .............................................................................................. 77 6.8.1 A kérést tartalmazó üzenet ................................................................................................................. 77 6.8.2 A választ tartalmazó üzenet ................................................................................................................ 79
7. Napi operatív szállítórendszeri („14 órás”) adatszolgáltatás (OperativeTSODataService14H) .......... 83 7.1. A kérést tartalmazó üzenet ........................................................................................................................ 84 7.2. A választ tartalmazó üzenet........................................................................................................................ 84
8. Nap közbeni allokálások szállíttatóknak (GetAllocationsForShipper) ................................................ 90 8.1. A kérést tartalmazó üzenet ........................................................................................................................ 90 8.2. A választ tartalmazó üzenet........................................................................................................................ 91
9. 10 órás adatszolgáltatás (OperativeTSODataService10H) ................................................................. 94 9.1. A kérést tartalmazó üzenet ........................................................................................................................ 95
Informatikai Platform illeszkedési felület
FGSZ Zrt.
4/178 9.2. A választ tartalmazó üzenet........................................................................................................................ 95
10. Napi allokálási adatok rendszerüzemeltetők általi beküldése (AllocationService) .......................... 99 10.1. A kérést tartalmazó üzenet ....................................................................................................................100 10.2. A választ tartalmazó üzenet ...................................................................................................................103
11. Havi allokálási adatok rendszerüzemeltetők általi beküldése (AllocationService) ........................ 107 11.1. A kérést tartalmazó üzenet ....................................................................................................................108 11.2. A választ tartalmazó üzenet ...................................................................................................................108
12.
Allokált óracsúcs adatok rendszerüzemeltetők általi beküldése (AllocationHourlyPeakService) ...................................................................................................... 111
12.1. A kérést tartalmazó üzenet ....................................................................................................................112 12.2. A választ tartalmazó üzenet ...................................................................................................................113
13. Operatív matching .......................................................................................................................... 116 13.1. NNO matching adatok beküldése (NnoMatchingInputService) .............................................................116 13.1.1 A kérést tartalmazó üzenet ............................................................................................................. 117 13.1.2 A választ tartalmazó üzenet ............................................................................................................ 119 13.2. Operatív matching eredményének lekérdezése (OperativeMatchingResult) ........................................123 13.2.1 A kérést tartalmazó üzenet ............................................................................................................. 123 13.2.2 A választ tartalmazó üzenet ............................................................................................................ 124
14. Matching......................................................................................................................................... 128 14.1. NNO matching adatok beküldése (SaveDeliveryOrder) .........................................................................128 14.1.1 A kérést tartalmazó üzenet ............................................................................................................. 128 14.1.2 A választ tartalmazó üzenet ............................................................................................................ 132 14.2. Matching eredményének lekérdezése (GetDeliveryResponse) ..............................................................138 14.2.1 A kérést tartalmazó üzenet ............................................................................................................. 138 14.2.2 A választ tartalmazó üzenet ............................................................................................................ 139
15. Alapadatok lekérdezése ................................................................................................................. 145 15.1. Hálózati pontok lekérdezése (GetValidNetworkUnitCode) ....................................................................145 15.1.1 A kérést tartalmazó üzenet ............................................................................................................. 145 15.1.2 A választ tartalmazó üzenet ............................................................................................................ 145 15.2. Partnerek lekérdezése (GetValidPartnersCode) .....................................................................................147 15.2.1 A kérést tartalmazó üzenet ............................................................................................................. 147 15.2.2 A választ tartalmazó üzenet ............................................................................................................ 148
16. Kapacitás átadás/átvétel bejelentése (Fogyasztó vándorlás) ........................................................ 150
Informatikai Platform illeszkedési felület
FGSZ Zrt.
5/178 16.1. Kapacitás átadás (SaveCustomerMigration) ...........................................................................................150 16.1.1 A kérést tartalmazó üzenet ............................................................................................................. 151 16.1.2 A választ tartalmazó üzenet ............................................................................................................ 153
17. KP piaci információk ....................................................................................................................... 155 17.1. Beadott ajánlatok ...................................................................................................................................155 17.1.1 A kérést tartalmazó üzenet - Beadott ajánlatok ............................................................................. 155 17.1.2 A választ tartalmazó üzenet - Beadott ajánlatok ............................................................................ 156 17.2. Beadott ajánlatok V2 ..............................................................................................................................159 17.2.1 A kérést tartalmazó üzenet - Beadott ajánlatok ............................................................................. 159 17.2.2 A választ tartalmazó üzenet - Beadott ajánlatok ............................................................................ 159 17.3. Megkötött ügyletek ................................................................................................................................162 17.3.1 A kérést tartalmazó üzenet – Megkötött ügyletek.......................................................................... 162 17.3.2 A választ tartalmazó üzenet – Megkötött ügyletek ........................................................................ 163
18. Ajánlat fogadó interface ................................................................................................................. 165 18.1.1 A kérést tartalmazó üzenet – Ajánlat befogadás vagy módosítás kérés ........................................ 165 18.1.2 A választ tartalmazó üzenet - Beadott ajánlatok ............................................................................ 170 18.1.3 A kérést tartalmazó üzenet – Ajánlat visszavonáskérés.................................................................. 172 18.1.4 A választ tartalmazó üzenet – Ajánlat visszavonás válasz .............................................................. 173 18.1.5 Hibakódok, Hibaüzenetek ............................................................................................................... 175
Informatikai Platform illeszkedési felület
FGSZ Zrt.
6/178
1. A DOKUMENTUM CÉLJA Jelen dokumentumnak az a célja, hogy a rendszerirányítói engedélyes (FGSZ) és együttműködő partnerei, azaz a
földgáz-kereskedelmi engedélyesek,
feljogosított fogyasztók,
csatlakozó rendszerüzemeltetők
közötti, az operatív üzletmenet során alkalmazható, szerver-szerver kommunikáció alapelveit rögzítse, és üzenetformátumait definiálja.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
7/178
2. BEVEZETÉS A gáziparban a gyakorlati üzletmenet során intenzív, informatikai úton folytatott kommunikáció zajlik az egyes gázipari szereplők között. Jellegzetes példaként ide sorolható a nominálás, az allokálás, a mérési adatok szolgáltatásának területe – vonatkozzon az akár földgázszállítói, akár elosztói, akár tárolói rendszerre, és legyen az abban érintett akár rendszerhasználó, akár rendszerüzemeltető. Jelenleg az üzenetváltások jelentős része E-mail-en, illetve Excel állományok cseréje révén valósul meg, amely nagyobb adatmennyiségek esetén általában mind a küldő, mind a fogadó részére kevéssé hatékony megoldásnak bizonyul. Mind a rendszerüzemeltetők, mind a rendszerhasználók számára kedvezőbb, és számottevően hatékonyabb, ha a mindennapi üzletmenet során váltott üzenetek cseréje a partnerek informatikai platformjai között közvetlenül, önműködően, és érdemi emberi közreműködést nélkülöző módon valósul meg. Ezáltal sokkal nagyobb tömegű adat konzisztens, és akár sűrűbb cseréje válik lehetővé. Jelen leírás a földgázszállítási és rendszerirányítási engedélyes és partnerei közötti, szerver-szerver alapú kommunikáció formáját hivatott meghatározni. A kommunikáció kétoldalú jellege miatt a dokumentum is kettős, az FGSZ és Partnerei közötti üzenetváltások leképezése érdekében. A további fejezetekben előbb az alapfogalmak, majd a koncepció, az általános alapelvek, végül az egyes konkrét üzenetformátumok ismertetésére kerül sor.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
8/178
3. FOGALOMTÁR 3.1. HÁLÓZATI INFRASTRUKTÚRA Mérhető pont
A földgáz-szállító hálózatnak valóságban is fizikailag létező pontja. Tényleges földgáz-átadó állomást jelent. Pl.: Szentendre I. Az elemi mérési adatok mindig mérhető pontokra vonatkoznak.
Nominálható/allokálható („nomallok”) pont
Mérhető pontok logikai összevonásából származó absztrakt pont. A gyakorlatban az összevont gázátadót képviselő fogalom. Pl. Budapest, mely többek között a Szentendre I. pontot is magába foglalja. A nominálások és allokálások értelemszerűen csak nominálható/allokálható pontokra tehetők.
Kapacitáspont
Nominálható/allokálható pontok logikai összevonásából származó absztrakt pont. Kapacitáslekötések csak kapacitáspontokra vonatkozhatnak. A jelen gyakorlatban minden „nomallok” pont egyben kapacitáspont is.
Kereskedelmi virtuális pont
Olyan pont, amely a valóságban nem létezik, csak elszámolás szempontjából. Azt a célt szolgálja, hogy olyan szállíttatók is tudjanak egymás között földgáz-kereskedelmet folytatni, amelyeknek nincs ugyanazon fizikai ponton érvényes kapacitásfoglalásuk. A kereskedelmi virtuális pontra lehet nominálást adni, arra vonatkozóan van (állandóan zérus) mérési adat, és azon az allokálás is végbemegy. Csak TRADE típusú nominálási sorok adhatók rá, a NOM, BH, OPT_POS, OPT_NEG típusú sorok nem értelmezettek. A nominálási adat egyensúlyába a kereskedelmi pontra adott nominálási sorok is beszámítanak.
Kapacitás
Valamely földgáz-szállító hálózati (akár absztakt) elem földgázáteresztő képessége, azaz azon tulajdonsága, hogy egységnyi időtartam alatt milyen mennyiségű földgáz kibocsátására képes. Alkalmazott mértékegysége a m3/h, m3/nap (utóbbi a közüzemi nagykereskedő vonatkozásában). A szállíttatókkal kötött szerződésekben annak definiálásra is sor kerül, hogy melyik mértékegységben történik az elszámolás. A szerződésben minkét adat szerepel. A közüzemi nagykereskedő órai elszámolásának akkor van jelentősége, ha megszakítási hibát követ el.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
9/178
3.2. SZEREPLŐK Hozzáférésre jogosult (HFJ)
Az a gázipari szereplő, amely a földgáz-szállító vezetékhez való hozzáférésre jogosult. Ily módon:
Földgáz kereskedelmi engedélyes
Egyetemes szolgáltató
Szállítórendszeri fogyasztó
Rendszerirányítási engedélyes (a rendszerirányítási gázmennyiség mértékéig)
Földgáztermelő (ideértve a biogáz-termelőt is)
Kiemelendő a HFJ-knek azon részhalmaza, amelyek IPhozzáféréssel is rendelkeznek – ezek minősülnek szállíttatónak. Földgázkereskedő
Kizárólag gáz adásvételére jogosult szervezet, mely fizikai hálózati infrastruktúrával nem rendelkezhet. Részletes def.: 2008. évi GET 29. §
Egyetemes szolgáltató
A jogosult felhasználók földgázellátására vonatkozó szolgáltatások értékesítését végző szervezet. Lényegében a 2003. évi GET szerinti közüzemi szolgáltatási engedélyes fogalmát váltja fel. Részletes def.: 2008. évi GET 32.§
Felhasználó
Az a természetes vagy jogi személy, illetve jogi személyiség nélküli társaság, aki (amely) földgázt vagy vezetéken keresztül PB-gázt saját felhasználás céljára vásárol. (2008. évi GET 3.§ 17.)
Rendszerirányítási engedélyes
De jure a földgázszállítók egyike, amely az egész országra vonatkoztatott, teljes, ún. együttműködő földgázrendszer egyensúlyáért felel. Részletes def.: 2008. évi GET 4-7.§
Földgáztermelő (ideértve a biogáz-termelőt is)
Az a jogi személy, amely a Magyar Köztársaság területén földgáz bányászati tevékenységet végez, vagy biogáz és biomasszából származó gázok, valamint egyéb gázfajták előállítását üzletszerűen végzi. (2008. évi GET 3.§ 33.)
(PFO – Production Field Operator) Földgázszállító (TSO - Transmission System Operator) Földgáztároló (STO – Storage) Földgázelosztó (LDC - Local Distribution Company, vagy DSO: Distribution System Operator)
Az a szervezet, mely az engedélyével érintett szállítóvezetékek és berendezéseik üzemeltetésére jogosult és köteles. (Részletes def.: 2008. évi GET 8-13.§) Köteles és jogosult az engedélyével érintett tárolók és berendezéseik üzemeltetésére. Részletes def.: 2008. évi GET 26-27.§ Adott földrajzi területen a földgáz fizikai elosztásának felelőse, azon a területen a földgáz elosztóhálózat tulajdonosa, és annak üzemeltetésének, karbantartásának felelőse. Részletes def.: 2008. évi GET 14-19.§
Informatikai Platform illeszkedési felület
FGSZ Zrt.
10/178
LDC2 (LDC - Local Distribution Company)
Jellegzetesen ipari területen, vagy lakóparkok területén lévő helyi, kisebb területet ellátó elosztási engedélyes.
Partner
Olyan szervezet, amely az FGSZ-szel földgáz szállíttatása, vagy csatlakozó földgáz-rendszer üzemeltetése tárgyában kapcsolatba lép. Partner lehet szállíttató, trader, vagy csatlakozó rendszerüzemeltető.
Szállíttató (shipper)
Olyan partner, amely földgáz-mennyiséggel Kapacitást is leköt a földgáz-szállító hálózaton.
rendelkezik.
A hozzáférésre jogosult akkor válik szállíttatóvá, ha ténylegesen leköt kapacitást KFRI szerződés formájában. Szállíttató az a HFJ, amelynek IP-szerződése van. Trader
Olyan partner, amely valós szállítási feladatot képező nominálási sorokat nem ad a földgáz-szállító részére, hanem csak adott hálózati ponton földgáz-mennyiségek adásvételére szerződik (azaz csak TRADE típusú nominálási sorokat ad).
Csatlakozó („szomszédos”) rendszerüzemeltető
Olyan partner, amely kizárólagosan földgáz-hálózati infrastruktúrával rendelkezik saját tulajdonban, éspedig olyannal, amely a földgáz-szállító rendszerhez fizikailag csatlakozik. Földgáz-mennyiséggel legfeljebb csak saját felhasználásra rendelkezhet, kereskedelmi célú felhasználásra semmiképpen sem.
(NNO – Network Neighbourhood Operator)
Lehet földgázelosztó, földgáztároló, földgázszállítója, földgáztermelő. MOL KTD
szomszédos
ország
MOL Kutatás-Termelés Divízió. Lényegében a MOL PFO-ja. KNK (only acc. the GET issued in 2003)
Virtuális szállíttató
Két valós (jogi személyt képviselő) szállíttató kereskedelmi kapcsolatát egyetlen szállíttatóként reprezentáló egység. A virtuális szállíttató a teljes üzleti modellben ugyanúgy kezelendő, mint bármely valós szállíttató.
Rendszeren kívüli szállíttató
Olyan szállíttató, amelynek nincs érvényes szerződése az FGSZszel, de facto IP-hozzáféréssel nem rendelkezik.
FGSZ
Földgázszállító Zrt.
3.3. AZ FGSZ ÉS PARTNEREI VISZONYÁT KÉPVISELŐ FOGALMAK Kapacitásszerződés
Szinomíma: kapacitáslekötés, hivatalosan (hosszútávú, éves, havi, napi) kapacitás-lekötési, földgázszállítási és rendszerirányítási szerződés (KFRI). A földgázszállítóra nézve olyan szerződéses kötelezettség, mely szerint bizonyos betáplálási és kiadási pontokon meghatározott mértékű
Informatikai Platform illeszkedési felület
FGSZ Zrt.
11/178
kapacitást biztosít a hozzáférésre jogosult számára a szerződéses időszak alatt. Ennek keretében a hozzáférésre jogosult által a megadott betáplálási pontokon betáplált földgázt átveszi, és elszállítja azt a megfelelő kiadási pontokra, ahol azt átadja a hozzáférésre jogosultnak vagy annak képviselőjének. Szerződés
Partnerek között földgáz-szállíttatás vagy földgáz-kereskedelem tárgyában született, tisztán elektronikus formában testet öltő megállapodás.
IP
Informatikai Platform. Az FGSZ azon informatikai rendszere, melynek révén a 2008. évi GET 5.§-ának, a VHR 23.§ (7) pontjának ill. az ÜKSZ 4.9.1 fejezetének tesz eleget a partnereivel ill. a MEKH-hel való együttműködés érdekében.
3.4. KAPACITÁSKEZELÉS Kapacitás
Egy hálózati pont gázáteresztő képessége adott időegység alatt. (m3/nap, m3/óra)
Kapacitásigénylés
A szállíttató által igényelt kapacitás, amelyet az FGSZ még nem hagyott jóvá.
Szerződött kapacitás
A KFRI szerződésben rögzített hosszú távú, éves, havi, vagy napi kapacitás.
Bilaterális kapacitáskereskedelem
Szállíttatók kapacitáslekötésére vonatkozó, közöttük történő adásvétel.
Kapacitáskereskedelem Az FGSZ tulajdonában álló kapacitások értékesítése. Kapacitás allokáció
A kapacitás visszaigazolásának folyamata (az allokált kapacitás eltérhet az igényelt kapacitástól).
Elsődleges kapacitáskereskedelem
Az FGSZ által első körben értékesített kapacitások kereskedelme
Másodlagos kapacitáskereskedelem
A korábban FGSZ által értékesített kapacitások kereskedők egymás közötti értékesítése
Hátizsák-elv
Azon eseményhez kötődő fogalom, melynek során egy szállíttató egy fogyasztója más szállíttatóra tér át, és melynek következtében üzleti-jogi értelemben gázmennyiségét a továbbiakra nézve más szállíttatótól szerzi be. Jellegzetesen ez akkor jelenik meg, amikor adott fogyasztó közüzemi szerződését felmondva kilép a szabad piacra, azaz már nem közüzemi szolgáltatótól, hanem valamely szabadon választott gázkereskedőtől szerzi be a szükséges gázmennyiséget. Ez az áttérés a szállíttatók kapacitásfoglalásaiban is megnyilvánul – ez az ún. „hátizsák-elv”, melynek lényege, hogy az áttérő fogyasztó régi szállíttatójánál foglalt kapacitását fel kell szabadítani, és új szállíttatójánál le kell kötni. Megjegyzendő, hogy a gyakorlatban a felszabadított és lekötött kapacitás eltérő szokott lenni.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
12/178
3.5. NOMINÁLÁS Nominálás
Adott időszakra valamely szállíttató gázforgalom-igénylése (tehát csak szállíttató nominálhat). Az a tevékenység, melynek keretében a szállíttató adott időszakra nominálási adatát nyújtja be a földgázszállítónak.
Nominálási adat
Adott gáznapra valamely szállíttató által igényelt gázforgalom meghatározása. A nominálás nominálási sorokból tevődik össze.
Nominálási sor
Adott nomináláson belül adott ponton igényelt gázmennyiség. A nominálási sor típusai:
NOM: Tényleges, fizikailag is megvalósítandó szállítást képviselő tétel.
OPT_POS, OPT_NEG: Opció (Pozitív / negatív opció)
BH: Backhaul
TRADE: Trade
HEG_POS, HEG_NEG: HEG (Pozitív / negatív HEG)
Alapnominálás
NNO oldali NOM és BH típusú nominálás.
Opció
Valamely szállíttató által földgáz-mennyiség adott egységár melletti eladására, vagy megvásárlására az FGSZ-nek tett ajánlat. Válfajai a pozitív és a negatív opció. Csak NOM, BH, TRADE típusú nominálási sorokhoz kötötten jelenhet meg. (ÜKSZ: A hozzáférésre jogosultak által gáznapon a szállítórendszer beadási és kiadási pontjain felajánlott és a rendszerirányítási engedélyes által a rendszer egyensúly megtartása érdekében igénybe vehető forrás- és fogyasztásváltoztatási lehetőség.)
Pozitív opció
Szállíttató által földgáz-eladásra vonatkozó opció. Válfaja a kapacitás felett leadható opció. (ÜKSZ: A hozzáférésre jogosultak által gáznapon a szállítórendszer betáplálási pontjain felajánlott forrásnövelési és szállítórendszer kiadási pontjain felajánlott fogyasztáscsökkentési lehetőség, amelyet a rendszerirányítási engedélyes a forráshiányból eredő egyensúlytalanság esetén vehet igénybe.)
Negatív opció
Szállíttató által földgáz-vételre vonatkozó opció. (ÜKSZ: A hozzáférésre jogosultak által gáznapon a szállítórendszer betáplálási pontjain felajánlott forráscsökkentési és szállítórendszer kiadási pontjain felajánlott fogyasztásnövelési lehetőség, amelyet a rendszerirányítási engedélyes a forrástöbbletből eredő egyensúlytalanság esetén vehet igénybe.)
Backhaul
Olyan, két hálózati pont között logikai szinten értelmezett földgázforgalom, amely a két pontot összekötő vezetékben áramló gáz irányával ellentétes irányú. A backhaul egyik jellegzetes alkalmazási területe, amikor a HAG-on az osztrák fél Beregszászról rendel gázt – ekkor képződik egy NOM típusú nominálási sor a HAG-ról Magyarországra, és egy ellentétes
Informatikai Platform illeszkedési felület
FGSZ Zrt.
13/178
irányú backhaul típusú a Beregszászról rendelt gázmennyiségnek megfelelően. Ekkor fizikailag a NOM típusú sornak csak a BH sorban foglalt mennyiséggel csökkentett mennyiségének megfelelő gázforgalom lebonyolítására kerül sor. A backhaul egy másik alkalmazási területe az ún. „virtuális tároló”, amikor is gáztárolóba való betároláskor a mennyiség egy részének kitárolására kerül sor, és fordítva. Trade
Adott hálózati ponton belül adott földgáz-mennyiség eladására vagy megvételére vonatkozó ügylet, ahol a vagy kizárólagos értelmű. Egy adásvétel tehát egy eladási, és egy vételi trade-ből tevődik össze.
Trade csoport
Egymással összefüggésben álló, egyazon hálózati ponton belül érvényre jutó trade-ek összessége.
Szabad kapacitás
Valamely absztrakt pontra vonatkozóan a befoglalt elemi pontok összkapacitásának és a pontra (jellegzetesen nominálás keretében) szerződött összkapacitások különbsége.
HEG
Hidraulikai Egyensúlyozó Gáz. A napi piac tagjai által a szállítónak egyensúlyozási célokra a gáznap során felajánlott pótlólagos földgázforrás, vagy felhasználás.
Pozitív HEG
Olyan tényleges fizikai földgázszállítással járó HEG DA/WD ügylet, amely keretében a szállító vesz, és a szállíttató elad. Mindenképpen a szállítórendszerbe való betáplálást képvisel. (A HEG a KP szabályzatnak megfelelően órai termék.)
Negatív HEG
Olyan tényleges fizikai földgázszállítással járó HEG DA/WD ügylet, amely keretében a szállító elad, és a szállíttató vesz. Mindenképpen a szállítórendszerből való kiadást képvisel. (A HEG DA/WD a KP szabályzatnak megfelelően órai termék.)
3.6. OPERATÍV MATCHING (A trade-ek konzisztenciájára vonatkozó fogalommeghatározásoknál a szereplők feltüntetésekor az XY konvenció azt jelenti, hogy X a nomináló, és Y a nomináló pár függetlenül attól, hogy eladói, vagy vevői minőségben van-e jelen a trade-ben.) Páros trade
Az AB, BA trade típusú nominálási sor egyazon hálózati pontra ellentétes előjelű mennyiségekkel jelen van. Amennyiben a két mennyiség megegyezik, akkor match állapot áll fenn, ellenkező esetben mismatch: értékeltéréssel.
Törött trade
Több olyan trade együttese, melyekre egy „B” szereplőt tekintve:
B-nek nincs érvényes szerződése a FGSZ-szel („rendszeren kívüli”)
B-re legalább 1-1 másik, FGSZ-szel szerződésben álló szállíttató (pl. „A” és „C”) trade formájában hivatkozik ellentétes előjellel, azaz
Informatikai Platform illeszkedési felület
FGSZ Zrt.
14/178
pl. eladói ill. vevői minőségben. (Tehát a példát tekintve „A” elad „B”-nek, és „B” elad „C”-nek. Az az eset feltételezett, hogy „B” rendszeren kívüli, ill. hogy nem nominál, tehát, hogy csak az AB, és CB trade nominálások vannak meg, a BA, BC nominálások hiányoznak.) A törött trade esetén match akkor áll fenn, ha a rendszeren kívüli szállíttató eladásainak és vételeinek összmennyisége partnerei nominálási adatai alapján megegyezik, és mismatch áll fenn, ha nem. Páratlan trade
Az AB trade típusú nominálási sor megvan, de a BA nincs meg.
Match
Adott nominálási sorral mind szereplők, mind mennyiségek szempontjából egyeztethető nominálási sor(ok) jelenléte.
Mismatch
Match hiánya, azaz adott nominálási sorral szereplők és mennyiségek szempontjából egyeztethető (ellenoldali) nominálási sor(ok) hiánya.
Kisebb elv
Két, szereplőket, és előjeleket tekintve egymással egyeztethető, de eltérő mennyiséget képviselő nominálási sor közül a kisebb értékűnek érvényre jutattása.
Zéró elv
Azon elv, miszerint páratlan trade esetén a várható allokált értéket zérusnak kell tekinteni.
Pro ráta elv
Adott mennyiségnek v. eltérésnek az azt előidéző nominálások arányában történő felosztása.
3.7. RENDSZERIRÁNYÍTÁS Szállítási feladat
Az FGSZ számára adott szállíttatóra az összes nominálási sor előjelhelyes összege opciók nélkül (NOM+BH+HEG_POS+HEG_NEG).
Kiegyenlítő („rendszerirányítási”) gáz
Szinoníma: kiegyensúlyozó gáz. Adott gáznapon a hozzáférésre jogosultak betáplálása és vételezése közötti különbség kiegyenlítése és a rendszeregyensúly fenntartása érdekében felhasznált rendszerirányítói saját gázkészlet. (ÜKSZ)
3.8. ALLOKÁLÁS Allokálás
Mért mennyiség felosztása rendszerhasználókra (HFJ-kre). Az NNO határfelületi allokációt a csatlakozó rendszerüzemeltető végzi, a ponton belüli trade allokációt a földgázszállító.
Allokált fogyasztás
A földgáz-szállító rendszer adott pontján (adott időtartam alatt) ténylegesen átvett földgáz-mennyiség.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
15/178
Allokált forrás
A földgáz-szállító rendszer adott pontján (adott időtartam alatt) ténylegesen beadott földgáz-mennyiség.
Egyensúlytalanság
Forrás ponton átadott, allokált gázmennyiség, és fogyasztás ponton átvett, allokált gázmennyiség különbsége. (Allokált forrás – allokált fogyasztás.)
Héjmodell
Adott hálózati pontot egységként kezelő szemléletmód, miszerint csak és kizárólag az abból kifelé, illetve az abba befelé mutató, tényleges szállítási feladatot képező nominálási sorok jutnak érvényre – eltekintve attól, hogy a hálózati ponton belül milyen ügyletek (trade-ek) köttetnek.
Preallokáció
Az allokálás számítása során olyan eljárás, melynél ha egy hálózati ponton csak egy szállíttató (kereskedő) van jelen, ott a mérési adat egy az egyben történő hozzárendelésére kerül sor a szállíttatóhoz (mért adat allokáltként való feltüntetése). Ahol több szereplő van, ott a nominált adat allokáltként való feltüntetése történik. Azon hálózati pontok megjelölésére kerül továbbá sor, amelyek egyensúlytalanságban vannak. (Többszereplős esetben szinte biztos, hogy egyensúlytalanságban maradnak a hálózati pontok.)
Rule alloc
Az allokálás során olyan eljárás, miszerint mindazon hálózati pontok esetében, amelyek nincsenek egyensúlyban, a mért adatok opciók lehívása utáni részének a nominálások arányában történő felosztására kerül sor.
3.9. ELSZÁMOLÁS Számla
Földgázmennyiségek (-többletek és –hiányok) elszámolására szolgáló elszámolási egység. Válfaja az OBA számla (OBA – Operational Balancing Agreement). (A kifejezetten pénzügyi elszámolások jelen fogalmi körben a pénzügyi számlák útján történnek.)
OBA számla
Az IA (OBA) matching-hez kötődő olyan elszámolási mód, melynek keretében a gáznapi nominált és allokált mennyiségek eltérésének elszámolására nem gáznaphoz rendelten, hanem gázhónapra vonatkoztatva, a gáznapi eltérések eredője alapján kerül sor.
Gáztechnikai m3
normál Az a gázmennyiség, amely 288,15 K hımérsékleten és 101325 Pa nyomáson 1 köbméter (m3) térfogatot foglal el.
3.10. MŰSZAKI INFORMATIKA WEB felület
Nyílt vagy zárt számítógép-hálózatról, böngésző program segítségével (jelen esetben Internet Explorer használatával) elérhető, különböző szolgáltatásokat nyújtó, kiszolgáló program rendszer.
Form
Űrlap alapú webes felhasználói felület
Entitás
Egy egyed előfordulás, jelen esetben felhasználó egyed.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
16/178
3.11. SZABÁLYOZÁS GET
(GázEllátásról szóló Törvény) A földgázellátásról szóló, jelenleg érvényes (2008. évi XL.) törvény.
VHR
(VégreHajtási Rendelet) A GET végrehajtásáról szóló 19/2009. (I.30.) számú Kormányrendelet.
ÜKSZ
(Üzemi és Kereskedelmi Szabályzat) A magyar földgázrendszer üzemi és kereskedelmi szabályzata. Kiadva a MEKH 4267/2015. számú határozatával, módosítva a MEKH 4503/2015. számú határozatával javítva az FFEO_2015/72-4 ügyszámú MEKH végzéssel, hatályos: 2015. június 8-tól.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
17/178
4. ALAPELVEK 4.1. KONCEPCIÓ Jelen specifikáció két fél, mint gázipari szereplő informatikai platformja közötti kommunikáció formáját rögzíti. Mint az 1. ábra mutatja, ebből a szempontból a küldő és a fogadó szerepben levő informatikai platform közötti különbségtételre kerül sor.
Küldő informatikai platform
KÉRÉS
VÁLASZ
Fogadó informatikai platform
1. ÁBRA: A KÜLDŐ ÉS A FOGADÓ INFORMATIKAI PLATFORM EGYÜTTMŰKÖDÉSE
Azt, hogy melyik engedélyes informatikai platformja tölti be a küldő ill. fogadó szerepet, az adott üzleti tevékenység (pl. nominálás) határozza meg. Az egyes üzenetformátumok leírásánál található „Szereplők, szerepkörök” rovatban mindig egyértelműen rögzített, hogy a küldő ill. fogadó szerepét mely engedélyes informatikai rendszere tölti be. Jelen specifikáció alapkoncepciója, hogy minden esetben a küldő fél egy kérést tartalmazó üzenetet küld a másik, fogadó félnek. A fogadó fél a kapott üzenetet feldolgozza, majd annak eredményét a válaszban a küldőnek eljuttatja. Minden egyes üzleti tevékenység esetén meghatározott, hogy a kérésnek és a válasznak milyen struktúrában milyen adatokat kell tartalmaznia.
Műszaki megvalósítást tekintve a specifikáció alapkoncepcióját a 2. ábra mutatja.
Küldő informatikai platform
XML, SOAP, HTTPS
Web service felület VISSZATÉRÉSI ÉRTÉK
Fogadó informatikai platform
2. ÁBRA: A SPECIFIKÁCIÓ MŰSZAKI INFORMATIKAI ALAPKONCEPCIÓJA
A fogadó informatikai platformnak tehát egy HTTPS-en keresztül elérendő web service-es felületet kell biztosítania. Az üzenetváltások SOAP-on keresztül, XML üzenetek formájában valósulnak meg. A fogadó a küldő számára a választ minden esetben a web service visszatérési értékében nyújtja. Mind az idevágó szabványokat, mind a web service-ek leírását, mind az alkalmazandó XML üzenetstruktúrákat jelen dokumentum rögzíti.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
18/178
4.2. MŰSZAKI INFORMATIKAI MEGVALÓSÍTÁSRA VONATKOZÓ ALAPELVEK 4.2.1 RENDELKEZÉSRE ÁLLÁS Valamennyi engedélyesnek 7x24 órás rendelkezésre állású szervert kell üzemeltetnie a kölcsönös kommunikáció folytatása érdekében. Ezen a szerveren kell elérhetőnek lennie azon webszolgáltatásnak, amely a kommunikációt lehetővé teszi.
4.2.2 AZ INFORMATIKAI PLATFORM ELÉRHETŐSÉGE A szolgáltatás igénybevételének alapfeltétele, hogy az engedélyes megküldje a rendszerirányítónak azon kiszolgálója címét, amelyen a rendszerirányító által elvárt SOAP interfész elérhető. A teszt szerver SOAP interfészének elérhetősége: https://app.test.fgsz.hu/KWHIP/services/FGSZService A teszt szerveren elérhető szolgálatások leírása: https://app.test.fgsz.hu/KWHIP/services/FGSZService?wsdl Az éles – produktív – szerver SOAP interfészének elérhetősége: https://app.fgsz.hu/KWHIP/services/FGSZService Az éles szerveren elérhető szolgálatások leírása: https://app.fgsz.hu/KWHIP/services/FGSZService?wsdl Amennyiben az éles környezet a fenti címen nem elérhető, mert az EIP a tartalék környezetben üzemel, akkor a következő címen érhető el: https://app.standby.fgsz.hu/KWHIP/services/FGSZService A hozzá tartozó descriptor: https://app.standby.fgsz.hu/KWHIP/services/FGSZService?wsdl Javasoljuk a kliens oldali program elkészítését úgy, hogy paraméterezhetően, vagy akár automatikusan át tudjon állni a tartalék IP (app.standby.fgsz.hu/KWHIP) hívására, ha az éles környezet (app.fgsz.hu/KWHIP) nem elérhető.
4.2.3 AZONOSÍTÁS, TANÚSÍTVÁNYOK
A web service-ek alkalmazása során tanúsítvány-alapú azonosítás történik, azaz:
az FGSZ informatikai platformjára minden partner csak az azon alkalmazott tanúsítvánnyal küldhet üzenetet
4.2.4 ALKALMAZOTT PROTOKOLLOK, KÓDOLÁS
A kommunikáció HTTPS protokollon zajlik, melyen keresztül XML (1.0 – negyedik kiadás, http://www.w3.org/TR/xml/ )üzenetek cseréjére kerül sor
A web szolgáltatások hívása minden esetben szinkron módon történik
Szabványok:
Informatikai Platform illeszkedési felület
FGSZ Zrt.
19/178
o
UTF-8 : http://www.ietf.org/rfc/rfc2279.txt
o
HTTPS: http://tools.ietf.org/html/rfc2818
o
SOAP: http://tools.ietf.org/html/rfc3288
XML Séma leírók elérhetősége o
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
o
xmlns:xsd=”http://www.w3.org/2001/XMLSchema”
o
xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
4.2.5 ÜZENETEK ÉRVÉNYESSÉGE – VALIDÁLÁS
Egy üzenet minden esetben akkor, és csak akkor minősül érvényesnek, ha a jelen specifikációban rögzített formai és tartalmi követelményeknek eleget tesz. (Amennyiben tehát egy üzenet nem felel meg a formai és tartalmi követelményeknek, a fogadó visszautasítja azt.) Formai követelmény pl., hogy a tárgy gáznap formátum az xsd:DateTime-nak feleljen meg. Ez azt jelenti, hogy az engedélyesek informatikai platformjai kölcsönösen akkor és csak akkor fogadják el a tárgy gáznapot tartalmazó mezőket (és ily módon üzeneteket), ha ennek a formátumnak eleget tesznek. Tartalmi követelményt tekintve bizonyos mezők csak bizonyos értékeket vehetnek fel. Jellegzetesen a gázmennyiségek meghatározásánál jelen specifikáció csak a kWh-ban megadott mennyiségeket tartja elfogadottnak – más mértékegység használata jelenleg tehát nem értelmezett. Megjegyzendő, hogy az ilyen jellegű tartalmi megkötések a jelen specifikációhoz tartozó XML sémákban is megjelennek, amelyeknek az üzeneteknek eleget kell tenniük.
4.2.6 ARCHÍVÁLÁS
Minden engedélyesnek 1 évre visszamenőleg meg kell őriznie a küldött üzeneteket, és lehetőséget kell biztosítania a címzett v. az illetékes hatóság számára az azokba való betekintésre.
4.3. ÁLTALÁNOS ÉRVÉNYŰ BLOKKOK, TÍPUSOK, CÍMKÉK Az alábbiakban azon üzenetrészek definiálására kerül sor, amely valamennyi üzenettípus esetében azonos rendeltetéssel, és azonos felépítéssel bír. Jellegzetesen ilyen a tárgy gáznap, a hálózati pont kódja, stb. Megjegyzés: implementációs szinten az üzenet típusát implicite az határozza meg, hogy mely sémának felel meg.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
20/178
4.3.1 FEJRÉSZ LEÍRÁS Minden egyes üzenetnek van egy fejrésze, mely az alábbi táblázat szerinti elemekből áll.
XML-BLOKK AZONOSÍTÓJA MessageHeader
MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Létrehozás időpontja
Az üzenet időpontja pontossággal
creationDate
xsd:dateTime időzóna)
Az üzenet egyedi azonosítója
A küldő által előállított olyan azonosító, mely az általa valaha is küldött üzenetek közül pontosan egyet azonosít.
MessageID
xsd:Number
Küldő azonosítója
A küldő, vagy azon partner FGSZ IP-beli azonosítója, amely a tényleges küldőt az üzenet küldésével megbízta. A jelenleg egyedül elfogadott „ZZZ” szerinti kódolás annyit jelent, hogy a partner IP-beli azonosítójáról van szó.
sender
Party
létrehozásának másodperc
(„Z”
ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK
Az üzenet egyedi azonosítója: Nem lehet olyan azonosító, amelyhez tartozó üzenetre a fogadó fél már válaszolt, függetlenül annak tartalmától.
Küldő azonosítója: Csak azt a gázipari szereplőt azonosíthatja, amelyiknek a tanúsítványával az üzenetet küldték, vagy amely részéről a tényleges küldőnek már adtak megbízást az üzenet típusának megfelelő művelet végrehajtására. Értelemszerűen alapfeltétel, hogy ennek a megbízatásnak a papíralapú rögzítésén túlmenően az FGSZ IP jogosultsági rendszerében is jelen legyen a megfelelő beállítás. Szállíttatók esetén ez a mező határozza meg a tárgy szállíttatót (tekintettel arra, hogy rendszerüzemeltetők esetén megbízói jogosultság nem értelmezett).
Informatikai Platform illeszkedési felület
FGSZ Zrt.
21/178
PÉLDA
<messageHeader>
2008-04-28T16:31:00Z <messageId>1234567890 <sender codingScheme="ZZZ"> TESTSENDER
4.3.2 (HÁLÓZATI) PONT AZONOSÍTÓJA LEÍRÁS Szinte minden üzenettípus esetén szükség van hálózati (továbbá szabad, elemi) pontok megadására. E pontok azonosítása kizárólag azok FGSZ IP-beli kódja alapján történik. Erre szolgál a „Location” objektumtípus. Azt, hogy konkrétan hálózati, szabad, vagy elemi pontról van-e szó, azt a konkrét sémában v. üzenetben levő név egyértelműen kifejezi (networkPoint, freePoint, elementaryPoint).
MEZŐK
Megnevezés
Leírás
Pont azonosítója
A (jellegzetesen nominálható/allokálható) pont FGSZ IP-beli azonosítója (ezt jelöli a „ZZZ” kódolás)
XML típusnév
Formátum / típus FGSZ IP-beli azonosító
ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK
Pont azonosítója: Csak az FGSZ által előzetesen közzétett pontlista egyik elemét tartalmazhatja.
PÉLDA
KAMOSONM1IIN
4.3.3 TÁRGY GÁZNAP LEÍRÁS Az üzenettípusok többsége esetén szükség van a tárgy gáznapnak, azaz azon gáznapnak megadására, amelyre az üzenetben foglalt (pl. nominálási, allokálási) adatok vonatkoznak – e célra szolgál ez a mező. A tárgy gáznap minden esetben a Magyarország területén érvényes gáznapot jelenti. (ÜKSZ: Gáznap: Az adott nap reggel 06:00-tól a következő nap reggel 06:00-ig tartó időszak. (A GTE ajánlásával egyezően))
Informatikai Platform illeszkedési felület
FGSZ Zrt.
22/178
MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Tágy gáznap
Tágy gáznap
subjectGasDay
xsd:date (ÉÉÉÉ-HH-NN)
PÉLDA
<subjectGasDay>2008-04-28
4.3.4 TÁRGY GÁZÓRA LEÍRÁS Az üzenettípusok egy részében szükség van a tárgy gázórának megadására, amelyre az üzenetben foglalt (pl. nominálási, allokálási) adatok vonatkoznak – e célra szolgál ez a mező. A tárgy gázóra az egy gáznap órájának sorszámát jelenti. Ez 1 és 25 közötti értéket vehet fel, attól függően, hogy normál vagy téli-nyári időszámítás váltás van az adott gáznapon.
MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Tágy gázóra
Tágy gázóra
subjectGasHour
xsd:integer
PÉLDA
<subjectGasHour>8
Informatikai Platform illeszkedési felület
FGSZ Zrt.
23/178
4.3.5 MENNYISÉG LEÍRÁS Minden mennyiség – jellegzetesen a földgáz-mennyiség – erre a címkére van leképezve. Földgáz-mennyiségek terén csak a kWh-ban kifejezett hőmennyiség értelmezett.
XML-TÍPUS AZONOSÍTÓJA Quantity
MEZŐK
Megnevezés
Leírás
XML címkenév
Tag hossza
Formátum / típus
(karakter) Mennyiség
Az adott mennyiség egyben, tehát ezres tagolás nélkül.
a node értéke
max 19 számjegy
Mértékegység
Az alkalmazott mértékegység. Földgáz-mennyiségek terén jelenleg csak kWh elfogadott, melyet az KWH konstans jelöl.
measureUnit
3
xsd:double
PÉLDA
8000
4.3.6 GÁZIPARI SZEREPLŐ, PARTNER LEÍRÁS Szinte valamennyi üzenettípus esetén szükség van valamely engedélyes valamilyen szerepkörben való azonosítására, úgymint valamely csatlakozó rendszerüzemeltető, szállíttató, szállíttató pár meghatározására. E célt szolgálja a „Party” objektumtípus.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
24/178 Azt, hogy konkrétan milyen értéket vehet fel, az a konkrét címkenévből egyértelműen kiderül. Pl. nominálás esetén a „Party” típusú „shipperPair” elem csak valamely kereskedelmi engedélyes, vagy feljogosított fogyasztó lehet. Az erre vonatkozó ellenőrzés mindig a fogadó oldalán történik.
XML-TÍPUS AZONOSÍTÓJA Party
MEZŐK
Megnevezés
Leírás
XML címkenév
Tag hossza
Formátum / típus
(karakter) A gázipari szereplő azonosítója
A gázipari szereplő FGSZ IP-beli azonosítója
a node értéke
Kódolás
Annak meghatározása, hogy az adott szereplő azonosítója milyen kód szerint állt elő. Jelenleg csak az FGSZ IP-beli kód az értelmezett, melyet a „ZZZ” konstans jelöl.
codingScheme
3
PÉLDA
<shipperPair codingScheme="ZZZ">TESTSHIPPERPAIR
4.3.7 ÁR LEÍRÁS Jellegzetesen az opciók esetén értelmezett az egységár – e célra szolgál ez az objektumtípus.
XML-TÍPUS AZONOSÍTÓJA Price
Informatikai Platform illeszkedési felület
FGSZ Zrt.
25/178
MEZŐK
Megnevezés
Leírás
XML címkenév
Tag hossza
Formátum / típus
(karakter) Ár
Az egységár számértéke tizedesjegy pontossággal.
4
a node értéke
xsd:double
Egység
Az a mértékegység, amelyre az egységár vonatkozik. Csak kWh-ra adható meg, amelyet a KWH konstans jelöl.
measureUnit
3
Devizanem
Az a devizanem, amelyben az ár meg van adva. Jelenleg csak a magyar forint, azaz a „HUF” konstans a megengedett.
currency
3
PÉLDA
12.1234
4.3.8 AZ EREDETI ÜZENET ADATAI LEÍRÁS Minden válaszüzenet tartalmazza az eredeti (kérés) üzenet fejrészét. Ld. 4.3.1 pont. XML-TÍPUS AZONOSÍTÓJA originalMessageHeader MEZŐK A 4.3.1 pont szerint. PÉLDA A 4.3.1 pont szerint.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
26/178
4.3.9 A FELDOLGOZÁS SIKERESSÉGE LEÍRÁS Minden válaszüzenet tartalmazza, hogy a feldolgozás sikeres vagy sikertelen volt.
XML-TÍPUS AZONOSÍTÓJA xs:boolean
MEZŐK Megnevezés
Leírás
Sikeresség
Az eredeti feldolgozásának mutató bit.
üzenet sikerességét
XML címkenév
Formátum / típus
success
true / false, xs:boolean
PÉLDA
<success>true
4.3.10 HIBAKEZELÉS LEÍRÁS Ha egy kérés feldolgozása során hiba történik, akkor a válaszüzenet tartalmazza a hiba leírását és részleteit.
XML-TÍPUS AZONOSÍTÓJA ErrorLine
MEZŐK Megnevezés
Leírás
XML címkenév
Formátum / típus
Figyelmeztetés / hiba
Annak meghatározása, hogy figyelmeztető vagy hibaüzenetről van-e szó?
warning
true / false
Informatikai Platform illeszkedési felület
FGSZ Zrt.
27/178 Sorszám
Az eredetileg fogadott üzenet azon nominálási sorának száma, amelyre a hibasor vonatkozik. Csak akkor van jelen, ha kifejezetten valamely nominálási sorhoz köthető.
lineNumber
Pozitív egész, xs:int
Hibakód
A figyelmeztetés / hibaüzenet kódja.
errorCode
xs:string
Üzenet szövege
A figyelmeztetés / hibaüzenet szövege. Nyelve annak függvénye, hogy a bejelentkezés során alkalmazott tanúsítvány felhasználói azonosítójához milyen alapértelmezett nyelv van rendelve.
errorText
xs:string
További tájékoztatás
A hibaüzenethez tartozó, esetleges, további tájékoztatás. Jellegzetes alkalmazási területe, amikor egy szabad pont hálózati pontjaira adott össznominálás meghaladja a kapacitáskorlátot; ekkor az érintett hálózati pontok felsorolása ebben a mezőben jelenik meg.
metaInfo
xs:string
A hibaüzenet felépítése metódusonként változhat. Pl. a nominálás hibaüzenete kiegészül két node-dal, úgymint networkPoint, shipperPair. PÉLDA <errorLine> <warning>false
1 <errorCode>Nomination.Error.Business.100 <errorText>Erre a hálózati pontra nem rendelkezik kapacitásszerződéssel! <metaInfo>2010-03-03 metaInfo>
KAOSI00011GN <shipperPair codingScheme="ZZZ"/>
Informatikai Platform illeszkedési felület
FGSZ Zrt.
28/178 ÁLTALÁNOS HIBAÜZENETEK Az alábbi hibaüzenetek a továbbiakban tárgyalt eljárások hívásánál általánosan előforduló hibák lehetnek: Hibakód
Üzenet szövege
Application.Error.AccessDenied
Ehhez a művelethez nincs joga!
WebService.Error.AccessRight
Nincs megfelelő jogosultság a művelet végrehajtásához!
WebService.Error.InvalidHeader
Nem megfelelő/hiányzó fejléc!
WebService.Error.NotValidPartner
Nem létező partner kód!
4.3.11 ALKALMAZOTT MÉRTÉKEGYSÉGEK TÁBLÁZATA Dimenzió / alkalmazás Térfogat Energiamennyiség Órai energiamennyiség Napi energiamennyiség Égéshő vagy fűtőérték
Mértékegység 3 Gáztechnikai normál m kWh kWh / h kWh / nap
Ár Energiamennyiség Órai energiamennyiség Napi energiamennyiség Égéshő vagy Fűtőérték
HUF MJ MJ / h MJ / nap
Sűrűség
mol% numerikus tényező
kWh/ m
MJ/m3 kg/m3 mol% 1
Informatikai Platform illeszkedési felület
3
Kód MQ5 KWH KW1 KW2 KW3 HUF _3B JM1 JM2 JM
KMQ MOL Z99
FGSZ Zrt.
29/178
5. A FEJLESZTÉS TÁMOGATÁSA: ECHO LEÍRÁS A webservice kliensének fejelesztéséhez nyújt segítséget az Echo metódus, mely visszaadja a híváskor beküldött szöveget. A metódus következmények nélkül hívható, így a kliens és szerver közti kommunikáció kialakítására biztonsággal használható.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
30/178
6. NOMINÁLÁS 6.1. NOMINÁLÁSI ADATOK BEKÜLDÉSE (SAVENOMINATIONINEDIGAS) A
FEJEZETBEN DEFINIÁLT SZOLGÁLTATÁS CSAK
2016/2017
ÉS AZ EZT KÖVETŐ GÁZÉVEK NOMINÁLÁS
ADATAINAK BETÖLTÉSÉRE HASZNÁLHATÓAK!
ÜZLETI CÉL, KÖRNYEZET A földgázszállító rendszerre vonatkozó nominálás célja a hozzáférésre jogosult által igényelt gázforgalom bejelentése a földgázszállító engedélyes számára. LEÍRÁS A nominálás során egy szállíttató (hozzáférésre jogosult) tekintetében az órai szállítandó gázmennyiség-igények bejelentése történik adott gáznapra vonatkozóan, hálózati pontonként, a szállíttató párt megjelölve. Ezt határozza meg a nominálási adat, mely nominálási sorokból tevődik össze, és blokkos kezelésű. Egy nominálási sor azt határozza meg, hogy az adott gáznapon adott hálózati ponton az adott szállíttató adott szállítattó párt megjelölve milyen mennyiségben milyen típusú gázforgalmat igényel. A blokkos kezelés annyit jelent, hogy a nominálási adat egy szállíttató részéről mindig egy gáznapra vonatkozik, és a rendszerirányító vagy teljes mértékben elfogadja, vagy teljes mértékben visszautasítja (még akkor is, ha csak egy nominálási sor nem felelt meg a követelményeknek). A blokkos kezelés azt is jelenti, hogy a szállíttatónak a nominálási adatban minden hálózati pontra a lekötött kapacitások irányainak megfelelően legalább egy nominálási sort meg kell adnia. A nominálást szolgáló üzenet szintén blokkos kezelésű, és mindig csak és kizárólag pontosan egy gáznapra vonatkozik. Heti előrejelzés megadásakor tehát az adott gázhét gáznapjaira vonatkozó egyenkénti nominálás történik. A nominálási adatok megadásának formátuma megegyezik az EDIG@S 5.1 verzió NOMINT dokumentum ajánlásainak. SZEREPLŐK , SZEREPKÖRÖK
A kérés küldője: a szállíttató A kérés fogadója: a rendszerirányítási engedélyes (FGSZ) A válasz küldője: a rendszerirányítási engedélyes (FGSZ) A válasz fogadója: a szállíttató
ÜTEMEZÉS , HATÁRIDŐK A nominálásra vonatkozó határidők a nominálásra szolgáló üzenet küldésére is érvényesek, azaz az aktuális és az azt követő 60 gáznapra fogad be a rendszer nominálást. Az aktuális gáznapon beküldött nominálásnak csak a betöltés időpontját követő harmadik órától kezdődő és a gáznap végéig tartó tárgyidőszakra eső órai mennyiségei lesznek figyelembe véve. ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK A nominálásra szolgáló üzenet kapcsán ugyanazok az üzleti feltételek érvényesek, mint általában nominálás megadásakor. Ezeket a feltételeket az alábbi táblázat foglalja össze – feltüntetve azt is, hogy ha az adott szabályt a beküldött nominálási adat megszegi, akkor milyen hibaüzenettel válaszol az IP.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
31/178
Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás
Ha egy szállíttató adott gáznapra adott hálózati pontra nominál, akkor arra a gáznapra és arra a hálózati pontra érvényes kapacitásszerződéssel kell rendelkeznie.
Nomination.Error.Business.100
Erre a hálózati pontra nem rendelkezik kapacitásszerződéssel!
A nominálási sorban csak olyan hálózati pontot adjon meg, amelyre rendelkezik érvényes kapacitásfoglalással! Vegye fel a kapcsolatot az FGSZszel kapacitásszerződés kötése céljából!
Csak az adott gáznapra és az azt követő 60 nap valamelyikére adható ben nominálás.
Nomination.Error.Business.101
A kiválasztott gáznapra nem lehet nominálni!
A múltra és 60 naptól későbbi dőpontra ne adjon be nominálást!
Betáplálási ponton adott gáznapra adott szállíttatóra nézve a szállítási feladat értékének bele kell férnie a rendelkezésre álló szerződött órai kapacitásba.
Nomination.Error.Business.107
Betáplálási ponton a szállítási feladat értékének bele kell férnie a rendelkezésre álló szerződött órai kapacitásba!
Módosítsa az adott hálózati ponton a nominálási sorait úgy, hogy azok összmennyisége legfeljebb a szerződött napi kapacitást érje el! Utóbbit az IP felületén az órai nominálási sorra kattintva, majd az ,,Info" gomb megnyomásával tudhatja meg ("Órai mennyiség" oszlop).
Kiadási ponton adott gáznapra adott szállíttatóra nézve a szállítási feladatnak bele kell férnie a rendelkezésre álló szerződött órai
Nomination.Error.Business.108
Kiadási ponton a szállítási feladatnak bele kell férnie a rendelkezésre álló szerződött órai kapacitásba!
Módosítsa az adott hálózati ponton a nominálási sorait úgy, hogy azok összmennyisége legfeljebb a szerződött napi kapacitást érje el! Utóbbit az IP felületén az órai
Informatikai Platform illeszkedési felület
FGSZ Zrt.
32/178 Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás nominálási sorra kattintva, majd az ,,Info" gomb megnyomásával tudhatja meg ("Órai mennyiség" oszlop).
kapacitásba.
Hálózati pontonként és szállíttató páronként csak egy betáplási irányú nominálási sor adható.
Nomination.Error.Business.114
Hálózati pontonként és szállíttató páronként csak egy betáplási irányú nominálási sor adható!
Ha tényleg ugyanazon hálózati ponton ugyanazon szállíttatót akarja betáplási irányú nominálási sorában szállíttató párként megjelölni, összegezze a szállítandó mennyiségeket, és azokat adja meg a nominálási adatban! Lehetséges, hogy valójában más hálózati pontot vagy szállíttatót akart megjelölni. Módosítsa ennek jegyében a rendszer által megadott hálózati ponton nominálási sorait úgy, hogy szállíttató páronként csak egy betáplási irányú sora legyen egyazon hálózati ponton!
Hálózati pontonként és szállíttató páronként csak egy kiadási irányú nominálási sor adható.
Nomination.Error.Business.118
Hálózati pontonként és szállíttató páronként csak egy kiadási irányú nominálási sor adható!
Ha tényleg ugyanazon hálózati ponton ugyanazon szállíttatót akarja kiadási irányú nominálási sorában szállíttató párként megjelölni, összegezze a szállítandó mennyiségeket, és azokat adja meg a nominálási adatban!
Informatikai Platform illeszkedési felület
FGSZ Zrt.
33/178 Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás Lehetséges, hogy valójában más hálózati pontot vagy szállíttatót akart megjelölni. Módosítsa ennek jegyében a rendszer által megadott hálózati ponton nominálási sorait úgy, hogy szállíttató páronként csak egy kiadási irányú legyen egyazon hálózati ponton!
Minden kapacitással rendelkező hálózati pontra kötelező nominálni a lekötött kapacitás irányainak megfelelően.
Nomination.Error.Business.119
Kapacitás szerződésben szereplő hálózati ponthoz a lekötött kapacitás irányának megfelelő nominálási sor(ok) hiányoznak!
Amennyiben nem kíván szállítást kezdeményezni egy szerződöt hálózati ponton, vegyen fel 0 mennyiséggel egy-egy nominálást minden szerződött irányra.
Betáplálási irányú nominálások mennyiségének előjele cask pozitív lehet!
Nomination.Error.Business.127
Betáplálási irányú nominálás esetén nominált mennyiség nem lehet negatív!
a
Módosítsa az adott nominálási sorban foglalt mennyiséget előjelét!
Kiadási irányú nominálások mennyiségének előjele cask pozitív lehet!
Nomination.Error.Business.128
Kiadási irányú nominálás esetén a nominált mennyiség nem lehet pozitív!
Módosítsa az adott nominálási sorban foglalt mennyiséget előjelét!
Adott gáznapra adott szállíttatóra nézve kiadási hálózati ponton a szállítási feladat ha pozitív, annak bele kell férnie a szerződött backhaul kapacitásba. (Ha a szállíttatónak nincs backhaul
Nomination.Error.Business.134
Kiadási ponton a szállítási feladat ha pozitív, annak bele kell férnie a szerződött backhaul kapacitásba! (Ha nincs backhaul kapacitás, az zérusnak számít.)
Az adott hálózati ponton növelje a kiadási irányú sorokban foglalt mennyiséget, csökkentse a betáplálási irányú sorokban foglalt mennyiséget!
Informatikai Platform illeszkedési felület
FGSZ Zrt.
34/178 Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás
Betáplálási ponton a kiadási irányú nominálási sorokban foglalt összmennyiség legfeljebb a szerződött backhaul kapacitásmennyiséget érheti el.
Nomination.Error.Business.139
Betáplálási ponton a kiadási irányú nominálási sorokban foglalt összmennyiség legfeljebb a szerződött backhaul kapacitásmennyiséget érheti el.
Csökkentse a kiadási irányú mennyiséget úgy, hogy az beleférjen a szerződött backhaul kapacitásmennyiségbe! (A rendszer ugyanezt a hibaüzenetet adja, ha nincs backhaul kapacitásszerződése.)
Kiadási ponton a betáplálási irányú nominálási sorokban foglalt összmennyiség legfeljebb a szerződött backhaul kapacitásmennyiséget érheti el.
Nomination.Error.Business.140
Kiadási ponton a betáplálási irányú nominálási sorokban foglalt összmennyiség legfeljebb a szerződött backhaul kapacitásmennyiséget érheti el.
Csökkentse a betáplálási irányú mennyiséget úgy, hogy az beleférjen a szerződött backhaul kapacitásmennyiségbe! (A rendszer ugyanezt a hibaüzenetet adja, ha nincs backhaul kapacitásszerződése.)
Ha egy szállíttatónak adott gáznapra adott kiadási ponton (jellegzetesen bilat értékesítés útján) a rendelkezésre álló kapacitása zérus (v. negatív), akkor azon a ponton és gáznapon a szállítási feladata csak zérus v. pozitív (backhaul) lehet.
Nomination.Error.Business.214
Betáplálási ponton zérus rendelkezésre álló kapacitás esetén a szállítási feladat csak zérus v. negatív lehet!
Az adott ponton módosítsa nominálási sorait úgy, hogy szállítási feladata pontosan zérus legyen! Negatív csak akkor lehet, ha van backhaul kapacitása.
Ha egy szállíttatónak adott gáznapra adott kiadási ponton (jellegzetesen
Nomination.Error.Business.215
Kiadási ponton zérus rendelkezésre álló kapacitás esetén a szállítási feladat csak zérus
Az adott nominálási
kapacitása, akkor azt zérusnak kell tekinteni.)
Informatikai Platform illeszkedési felület
FGSZ Zrt.
ponton módosítsa sorait úgy, hogy
35/178 Ellenőrzés
Hibaüzenet azonosítója
bilat értékesítés útján) a rendelkezésre álló kapacitása zérus (v. negatív), akkor azon a ponton és gáznapon a szállítási feladata csak zérus v. pozitív (backhaul) lehet. Ha egy szállíttató adott gáznapra adott hálózati pontra nominál, akkor arra a gáznapra az adott hálózati pontnak hozzárendelésre kell kerülnie egy nominálás folyamat csoporthoz.
Nomination.Error.Business.322
Informatikai Platform illeszkedési felület
Hibaüzenet szövege
Megoldás
v. pozitív lehet!
szállítási feladata pontosan zérus legyen! Pozitív csak akkor lehet, ha van backhaul kapacitása.
A hálózati pontra nem adható be nominálás!
Értesítse a rendszergazdát!
FGSZ Zrt.
6.1.1 A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS SaveNominationInEdigas STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
EDIG@S fejrész
Hálózati pont o
Nominálás típusa
Nominálási sor
Nominált mennyiség
Fejrészből csak egy lehet, de Hálózati pont blokkból több is. A hálózati pont alatt lévő egymásba ágyazott struktúra is ismétlődhet. AZ EDIG@S FEJRÉSZ MEZŐI
Megnevezés
Leírás
XML címkenév
Formátum / típus
Sorszám
Sorszám, mely a beküldött nominálás egyedi azonosítója. Ez az azonosító az adott időszakra érvényes állandó érték.
identification
Pozitív egész
Verzió
Az adott benyújtott verziója.
version
xsd:integer
Dokumentum típus
A nominálás benyújtásra vonatkozó típus azonosító. Értéke minden esetben 01G.
type
xsd:string
Időbélyeg
A beküldött nominálás létrehozásának időpontja UTC-ben megadva.
creationDateTime
yyyy-mmddThh:mm:ssZ
Tárgyidőszak
A beadott nominálás vonatkozási időszaka. Ez
validityPeriod
yyyy-mmddThh:mmZ/ yyyy-
időszakra nominálás
Informatikai Platform illeszkedési felület
max. 3 karakter
FGSZ Zrt.
37/178 egy gáznap lehet, a kezdeti időpontjával (óra és perc) és a záró időpontjával megadva UTC-ben.
mm-ddThh:mmZ
Szerződés azonosító
A kereskedő és az FGSZ közötti szolgáltatási szerződés azonosítója. Kitöltése nem kötelező.
contractReference
xsd:string
A beküldő partner
A beküldő partner IP-beli kódja. A kódolási séma azonosítója ZSO.
issuer_MarketParticipant.identification
xsd:string
A beküldő partner típusa
A partner típusának EDIG@S azonosítója. Ennek értéke mindig ZSH.
issuer_MarketParticipant.role.code
xsd:string
A fogadó partner
A fogadó partner EIC kódja. A kódolási séma azonosítója 305.
recipient_MarketParticipant.identification
xsd:string
A fogadó partner típusa
A partner típusának EDIG@S azonosítója. Ennek értéke mindig ZSO.
recipient_MarketParticipant.role.code
xsd:string
max. 3 karakter
max. 3 karakter
PÉLDA
1234ABCD 999 01G 2001-12-17T09:30:47Z 2016-07-30T04:00Z/2016-07-31T04:00Z HUFSHP1 ZSH 21X-HU-A-A0A0A8 ZSO A HÁLÓZATI PONT XML-BLOKKJÁNAK AZONOSÍTÓJA ConnectionPoint MEZŐK
Informatikai Platform illeszkedési felület
FGSZ Zrt.
38/178 Megnevezés
Leírás
XML címkenév
Formátum / típus
Hálózati pont azonosító
A hálózati pont EIC kódja. A kódolási séma azonosítója 305.
identification
xsd:string
Mértékegység
A nominált mennység mértékegysége. Értéke mindig KW1, ami kWh/h kódja.
measureUnit.code
xsd:string max. 3 karakter
A NOMINÁLÁS TÍPUSA XML-BLOKKJÁNAK AZONOSÍTÓJA NominationType MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Típus
A nominálás lehet
type
xsd:string
egyoldalú – A01
kétoldalú – A02
max. 3 karakter
A NOMINÁLÁSI SOR XML-BLOKKJÁNAK AZONOSÍTÓJA Account MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Szállíttató
A nominálás szállíttatójának IP-beli kódja. A kódolási séma azonosítója ZSO.
internalAccount
xsd:string
Szállíttató pár
A nominálás szállíttató párjának IPbeli kódja. A kódolási séma azonosítója ZSO.
externalAccount
xsd:string
A NOMINÁLT MENNYISÉG XML-BLOKKJÁNAK AZONOSÍTÓJA Period MEZŐK
Informatikai Platform illeszkedési felület
FGSZ Zrt.
39/178 Megnevezés
Leírás
XML címkenév
Formátum / típus
Időszak
Az órai mennyiség vonatkozási időszaka. Ez mindig csak egy órás időszak lehet. Megadása UTC idővel.
timeInterval
yyyy-mm-ddThh:mmZ/ yyyy-mm-ddThh:mmZ
Nominálás iránya
A nominált mennyiség iránya:
direction.code
xsd:string
Mennyiség
kiadási irány – Z03
betáplálási irány – Z02
A nominált mennyiség kWh/h-ban kifejezve. Értéke pozitív egész szám lehet.
max. 3 karakter quantity.amount
xsd:integer
PÉLDA
21Z000000000003C <measureUnit.code>KW1 A02 HUFSHP_A <externalAccount codingScheme="ZSO">HUFSHP_B 2016-07-30T04:00Z/2016-07-30T05:00Z Z02 234000 … 2016-07-31T03:00Z/2016-07-31T04:00Z Z02 245300
Informatikai Platform illeszkedési felület
FGSZ Zrt.
40/178
6.1.2 A VÁLASZT TARTALMAZÓ ÜZENET LEÍRÁS A nominálási üzenetre a fogadó szinkron módon minden esetben ad válaszüzenetet a web service visszatérési értékeként. Ebben a válaszban megjelenik az eredeti üzenetre való hivatkozás, és a feldolgozás eredménye. Sikertelen feldolgozás esetén a részletes hibaüzeneteket is magába foglalja a válasz.
LOGIKAI SZERKEZET A nominálásra való válaszüzenet logikai felépítése az alábbi:
Feldolgozás sikeres / sikertelen. Ld. 4.3.9 pont.
Hibaüzenet-sorok az alábbiak szerint: o
Adatstruktúrára vonatkozó hibakód
o
Adatstruktúrára vonatkozó hibaleírás
o
Hálózati pont kód
Nominálási adatra vonatkozó hibakód
Nominálási adatra vonatkozó hibaleírás
MEZŐK Megnevezés
Leírás
XML címkenév
Formátum / típus
Adatstruktúrára vonatkozó hibakód
A beküldött adatstruktúrára vonatkozó, de nem nominálási sorhoz köthető hibakód.
generalErrorCode
xs:string
Adatstruktúrára vonatkozó hibaleírás
A beküldött adatstruktúrára vonatkozó, de nem nominálási sorhoz köthető hibaleírás.
generalErrorText
xs:string
Hálózati kód
A hibás nominálási sor hálzati pontjának azonosítója.
networkPoint
xs:string
Nominálási adatra vonatkozó hibakód
A hálózati pont kóddal azonosított nominálási sorokra vonakozó hibakód.
errorText
xs:string
Nominálási adatra vonatkozó hibaleírás
A hálózati pont kóddal azonosított nominálási sorokra vonakozó hibaleírás.
errorText
xs:string
pont
Informatikai Platform illeszkedési felület
FGSZ Zrt.
41/178 PÉLDA
<success>true
Nomination.Error.ExistingDocumentVersion A megadott dokumentum azonosítóval és verzióval már létezik a rendszerben nominálási adat 21Z000000000003C <error> Nomination.Error.Business.100
Erre a hálózati pontra nem rendelkezik kapacitásszerződéssel!
Informatikai Platform illeszkedési felület
FGSZ Zrt.
HIBAÜZENETEK Ellenőrzés A dokumentum ellenőrzése
Hibaüzenet azonosítója verziójának
Hibaüzenet szövege
Megoldás
Nomination.Error.ExistingDocumentVersion
A megadott dokumentum azonosítóval és verzióval már létezik a rendszerben nominálási adat
Növelje a verzió számát!
A nominálási sorban megadott szállíttató nem létezik.
Nomination.Error.InvalidShipper
Nem létező szállíttató!
Adjon meg érvényes partner kódot.
A nominálási sorban megadott szállíttató pár nem létezik.
Nomination.Error.InvalidShipperPair
Nem létező szállíttató pár!
Adjon meg érvényes partner kódot.
A megadott hálózati pont kód nem létezik.
Nomination.Error.InvalidConnectionPoint
Nem létező hálózati pont!
Adjon meg érvényes hálózati pont kódot.
A nominált mennyiség időszakának ellenőrzése a megadott tárgyidőszakhoz.
Nomination.Error.InvalidGasHour
A nominált mennyiséghez megadott időszaknak bele kell esnie a megadott tárgyidőszakba!
Korrigálja a nominált mennyiség időszakát vagy a tárgyidőszakot!
Ugyanabban a nominálási sorban azonos órára csak egyszer szerepelhet órai mennyiség.
Nomination.Error.MultipleQuantities
Adott gázórához a mennyiség egynél többször megadva!
Törölje a mennyiséget.
A nominált mennyiség pozitív egész szám lehet.
Nomination.Error.QuantityValidation
A nominált mennyiség csak pozitív egész szám lehet!
Csak a betöltés pillanatában meghatározott tárgyidőszakra fogad be nominálási adatot a
Nomination.Error.IgnoredHourlyItems
A {0} hálózati pontra csak a(z) {1}. órától kezdődően fogadta be a rendszer a mennyiségeket. Az ezt
Informatikai Platform illeszkedési felület
FGSZ Zrt.
duplikált
órai
43/178 Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás
megelőző időszak mennyiségei már nem módosíthatóak!
rendszer.
Az aktuális gáznapon nem törölhetőek a korábban megadott nominálási sorok.
Nomination.Error.DeletionNotAllowed
A {0} hálózati pontra rögzített nominálás már nem törölhető!
Az aktuális gáznapra korábban rögzített nominálási sorok nem törölhetőek csak a mennyiség módosulhat.
Nomination.Error.UnacceptedChangesOnActualGasday
Aktuális gáznapon a mennyiségen kívül más már nem módosítható!
A tárgyidőszak minden órájára kötelező megadni a nominálást.
Nomination.Error.MissingHourlyValueInTargetPeriod
A megadott tárgyidőszak alapján meghatározott gáznapok még nominálható óráira kötelező az órai nominálás megadása a lekötött kapacitás irányainak megfelelően!
Informatikai Platform illeszkedési felület
FGSZ Zrt.
Minden korábban megadott nominálási sort szerepeltessen az adatszolgáltatásban.
Pótolja a hiányzó nominálási sort.
6.2. NOMINÁLÁSI ADATOK BEKÜLDÉSE (SAVENOMINATION) A
FEJEZETBEN DEFINIÁLT SZOLGÁLTATÁS CSAK
2015/2016
GÁZÉV NOMINÁLÁSAINAK BETÖLTÉSÉRE
HASZNÁLHATÓ!
ÜZLETI CÉL, KÖRNYEZET A földgázszállító rendszerre vonatkozó nominálás célja a hozzáférésre jogosult által igényelt gázforgalom bejelentése a földgázszállító engedélyes számára. LEÍRÁS A nominálás során egy szállíttató (hozzáférésre jogosult) tekintetében az órai szállítandó gázmennyiség-igények bejelentése történik adott gáznapra vonatkozóan, hálózati pontonként, a szállíttató párt megjelölve. Ezt határozza meg a nominálási adat, mely nominálási sorokból tevődik össze, és blokkos kezelésű. Egy nominálási sor azt határozza meg, hogy az adott gáznapon adott hálózati ponton az adott szállíttató adott szállítattó párt megjelölve milyen mennyiségben milyen típusú gázforgalmat igényel. A blokkos kezelés annyit jelent, hogy a nominálási adat egy szállíttató részéről mindig egy gáznapra vonatkozik, és a rendszerirányító vagy teljes mértékben elfogadja, vagy teljes mértékben visszautasítja (még akkor is, ha csak egy nominálási sor nem felelt meg a követelményeknek). A blokkos kezelés azt is jelenti, hogy a szállíttatónak a nominálási adatban minden olyan hálózati pontra legalább egy nominálási sort meg kell adnia, amelyre kapacitás-lekötéssel rendelkezik. A nominálást szolgáló üzenet szintén blokkos kezelésű, és mindig csak és kizárólag pontosan egy gáznapra vonatkozik. Heti előrejelzés megadásakor tehát az adott gázhét gáznapjaira vonatkozó egyenkénti nominálás történik. A nominálási sortípusoknak (NOM, BH) megfelelően külön-külön XML-blokkok kialakítására került sor (nominationLine, backhaulLine) biztosítva ezzel azt, hogy eleve már sémaszinten is csak azon attribútumok kezelésére kerüljön sor, amelyekre az adott nominálási sortípusnál ténylegesen is szükség van. SZEREPLŐK , SZEREPKÖRÖK
A kérés küldője: a szállíttató A kérés fogadója: a rendszerirányítási engedélyes (FGSZ) A válasz küldője: a rendszerirányítási engedélyes (FGSZ) A válasz fogadója: a szállíttató
ÜTEMEZÉS , HATÁRIDŐK A nominálásra vonatkozó határidők a nominálásra szolgáló üzenet küldésére is érvényesek, azaz az aktuális és az azt követő 60 gáznapra fogad be a rendszer nominálást. Az aktuális gáznapon beküldött nominálásnak csak a betöltés időpontját követő harmadik órától kezdődő és a gáznap végéig tartó tárgyidőszakra eső órai mennyiségei lesznek figyelembe véve. ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK A nominálásra szolgáló üzenet kapcsán ugyanazok az üzleti feltételek érvényesek, mint általában nominálás megadásakor. Ezeket a feltételeket az alábbi táblázat foglalja össze – feltüntetve azt is, hogy ha az adott szabályt a beküldött nominálási adat megszegi, akkor milyen hibaüzenettel válaszol az IP.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
45/178
Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás
Ha egy szállíttató adott gáznapra adott hálózati pontra nominál, akkor arra a gáznapra és arra a hálózati pontra érvényes kapacitásszerződéssel kell rendelkeznie.
Nomination.Error.Business.100
Erre a hálózati pontra nem rendelkezik kapacitásszerződéssel!
A nominálási sorban csak olyan hálózati pontot adjon meg, amelyre rendelkezik érvényes kapacitásfoglalással! Vegye fel a kapcsolatot az FGSZszel kapacitásszerződés kötése céljából!
Csak az adott gáznapra és az azt követő 60 nap valamelyikére adható ben nominálás.
Nomination.Error.Business.101
A kiválasztott gáznapra nem lehet nominálni!
A múltra és 60 naptól későbbi dőpontra ne adjon be nominálást!
Betáplálási ponton adott gáznapra adott szállíttatóra nézve a szállítási feladat pozitív opcióval növelt értékének (NOM + BH + HEG_POS + HEG_NEG + OPT_POS) bele kell férnie a rendelkezésre álló szerződött órai kapacitásba.
Nomination.Error.Business.107
Betáplálási ponton a szállítási feladat pozitív opcióval növelt értékének (NOM + BH + HEG_POS + HEG_NEG + OPT_POS) bele kell férnie a rendelkezésre álló szerződött órai kapacitásba!
Módosítsa az adott hálózati ponton NOM, BH, OPT_POS típusú nominálási sorait úgy, hogy azok összmennyisége legfeljebb a szerződött napi kapacitást érje el! Utóbbit az IP felületén az órai nominálási sorra kattintva, majd az ,,Info" gomb megnyomásával tudhatja meg ("Órai mennyiség" oszlop).
Kiadási ponton adott gáznapra adott szállíttatóra nézve a negatív opcióval együtt vett szállítási feladatnak (NOM + BH + HEG_POS + HEG_NEG +
Nomination.Error.Business.108
Kiadási ponton a negatív opcióval együtt vett szállítási feladatnak (NOM + BH + HEG_POS + HEG_NEG + OPT_NEG) bele kell férnie a rendelkezésre álló szerződött órai
Módosítsa az adott hálózati ponton NOM, BH, OPT_POS típusú nominálási sorait úgy, hogy azok összmennyisége legfeljebb a
Informatikai Platform illeszkedési felület
FGSZ Zrt.
46/178 Ellenőrzés
Hibaüzenet azonosítója
OPT_NEG) bele kell férnie a rendelkezésre álló szerződött órai kapacitásba.
Hibaüzenet szövege
Megoldás
kapacitásba!
szerződött napi kapacitást érje el! Utóbbit az IP felületén az órai nominálási sorra kattintva, majd az ,,Info" gomb megnyomásával tudhatja meg ("Órai mennyiség" oszlop).
Adott gáznapra adott szállíttatóra nézve betáplálási hálózati ponton a negatív opcióval együtt vett szállítási feladat ha negatív, annak bele kell férnie a szerződött backhaul kapacitásba. (Ha a szállíttatónak nincs backhaul kapacitása, akkor azt zérusnak kell tekinteni.)
Nomination.Error.Business.113
Betáplálási ponton a negatív opcióval együtt vett szállítási feladat ha negatív, annak bele kell férnie a szerződött backhaul kapacitásba! (Ha nincs backhaul kapacitás, az zérusnak számít.)
Az adott hálózati ponton növelje a NOM típusú sorokban foglalt mennyiséget, csökkentse a BH típusú sorokban foglalt mennyiséget!
Hálózati pontonként és szállíttató páronként csak egy NOM típusú nominálási sor adható.
Nomination.Error.Business.114
Hálózati pontonként és szállíttató páronként csak egy NOM típusú nominálási sor adható!
Ha tényleg ugyanazon hálózati ponton ugyanazon szállíttatót akarja NOM típusú nominálási sorában szállíttató párként megjelölni, összegezze a szállítandó mennyiségeket, és azokat adja meg a nominálási adatban! Lehetséges, hogy valójában más hálózati pontot vagy szállíttatót akart megjelölni. Módosítsa ennek jegyében a rendszer által megadott hálózati ponton nominálási sorait
Informatikai Platform illeszkedési felület
FGSZ Zrt.
47/178 Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás úgy, hogy szállíttató páronként csak egy NOM sora legyen egyazon hálózati ponton!
Hálózati pontonként és szállíttató páronként csak egy BH típusú nominálási sor adható.
Nomination.Error.Business.118
Hálózati pontonként és szállíttató páronként csak egy BH típusú nominálási sor adható!
Ha tényleg ugyanazon hálózati ponton ugyanazon szállíttatót akarja BH típusú nominálási sorában szállíttató párként megjelölni, összegezze a szállítandó mennyiségeket, és azokat adja meg a nominálási adatban! Lehetséges, hogy valójában más hálózati pontot vagy szállíttatót akart megjelölni. Módosítsa ennek jegyében a rendszer által megadott hálózati ponton nominálási sorait úgy, hogy szállíttató páronként csak egy BH sora legyen egyazon hálózati ponton!
Minden kapacitással rendelkező hálózati pontra kötelező nominálni.
Nomination.Error.Business.119
Kapacitás szerződésben szereplő hálózati ponthoz nincs rögzítve nominálási sor!
Amennyiben nem kíván szállítást kezdeményezni egy szerződöt hálózati ponton, vegyen fel 0 mennyiséggel egy NOM típusú nominálást.
Betáplálási hálózati ponton NOM típusú nominálási sorban a mennyiségnek zérusnak vagy
Nomination.Error.Business.120
Betáplálási hálózati ponton NOM típusú nominálási sorban a mennyiségnek zérusnak
Módosítsa az adott NOM típusú nominálási sorban foglalt mennyiséget úgy, hogy zérus, vagy
Informatikai Platform illeszkedési felület
FGSZ Zrt.
48/178 Ellenőrzés
Hibaüzenet azonosítója
pozitívnak kell lennie.
Hibaüzenet szövege
Megoldás
vagy pozitívnak kell lennie!
pozitív legyen (betartva az adott hálózati ponton érvényben lévő kapacitásfoglalásokat)!
Betáplálási hálózati ponton BH típusú nominálási sorban a mennyiségnek zérusnak vagy negatívnak kell lennie.
Nomination.Error.Business.122
Betáplálási hálózati ponton BH típusú nominálási sorban a mennyiségnek zérusnak vagy negatívnak kell lennie!
Módosítsa az adott BH típusú nominálási sorban foglalt mennyiséget úgy, hogy zérus, vagy negatív legyen (betartva a backhaul kapacitásfoglalásokat)!
Kiadási hálózati ponton NOM típusú nominálási sorban a mennyiségnek zérusnak vagy negatívnak kell lennie.
Nomination.Error.Business.124
Kiadási hálózati ponton NOM típusú nominálási sorban a mennyiségnek zérusnak vagy negatívnak kell lennie!
Módosítsa az adott NOM típusú nominálási sorban foglalt mennyiséget úgy, hogy zérus, vagy negatív legyen (betartva az adott hálózati ponton érvényben lévő kapacitásfoglalásokat)!
Kiadási hálózati ponton BH típusú nominálási sorban a mennyiségnek zérusnak vagy pozitívnak kell lennie.
Nomination.Error.Business.126
Kiadási hálózati ponton BH típusú nominálási sorban a mennyiségnek zérusnak vagy pozitívnak kell lennie!
Módosítsa az adott BH típusú nominálási sorban foglalt mennyiséget úgy, hogy zérus, vagy pozitív legyen (betartva a backhaul kapacitásfoglalásokat)!
Adott gáznapra adott szállíttatóra nézve kiadási hálózati ponton a pozitív opcióval együtt vett szállítási feladat ha pozitív, annak bele kell férnie a szerződött backhaul kapacitásba.
Nomination.Error.Business.134
Kiadási ponton a pozitív opcióval együtt vett szállítási feladat ha pozitív, annak bele kell férnie a szerződött backhaul kapacitásba! (Ha nincs backhaul kapacitás, az zérusnak számít.)
Az adott hálózati ponton növelje a NOM típusú sorokban foglalt mennyiséget, csökkentse a BH típusú sorokban foglalt mennyiséget!
Informatikai Platform illeszkedési felület
FGSZ Zrt.
49/178 Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás
Betáplálási ponton a BH nominálási sorokban foglalt összmennyiség legfeljebb a szerződött backhaul kapacitásmennyiséget érheti el.
Nomination.Error.Business.139
Betáplálási ponton a BH nominálási sorokban foglalt összmennyiség legfeljebb a szerződött backhaul kapacitásmennyiséget érheti el.
Csökkentse a BH mennyiséget úgy, hogy az beleférjen a szerződött backhaul kapacitásmennyiségbe! (A rendszer ugyanezt a hibaüzenetet adja, ha nincs backhaul kapacitásszerződése.)
Kiadási ponton a BH nominálási sorokban foglalt összmennyiség legfeljebb a szerződött backhaul kapacitásmennyiséget érheti el.
Nomination.Error.Business.140
Kiadási ponton a BH nominálási sorokban foglalt összmennyiség legfeljebb a szerződött backhaul kapacitásmennyiséget érheti el.
Csökkentse a BH mennyiséget úgy, hogy az beleférjen a szerződött backhaul kapacitásmennyiségbe! (A rendszer ugyanezt a hibaüzenetet adja, ha nincs backhaul kapacitásszerződése.)
Ha egy szállíttatónak adott gáznapra adott kiadási ponton (jellegzetesen bilat értékesítés útján) a rendelkezésre álló kapacitása zérus (v. negatív), akkor azon a ponton és gáznapon a negatív opcióval együtt vett szállítási feladata csak zérus v. pozitív (backhaul) lehet.
Nomination.Error.Business.214
Betáplálási ponton zérus rendelkezésre álló kapacitás esetén a pozitív opcióval együtt vett szállítási feladat csak zérus v. negatív (backhaul) lehet!
Az adott ponton módosítsa nominálási sorait úgy, hogy szállítási feladata pontosan zérus legyen! Negatív csak akkor lehet, ha van backhaul kapacitása.
Ha egy szállíttatónak adott gáznapra adott kiadási ponton (jellegzetesen
Nomination.Error.Business.215
Kiadási ponton zérus rendelkezésre álló kapacitás esetén a negatív opcióval együtt
Az adott nominálási
(Ha a szállíttatónak nincs backhaul kapacitása, akkor azt zérusnak kell tekinteni.)
Informatikai Platform illeszkedési felület
FGSZ Zrt.
ponton módosítsa sorait úgy, hogy
50/178 Ellenőrzés
Hibaüzenet azonosítója
bilat értékesítés útján) a rendelkezésre álló kapacitása zérus (v. negatív), akkor azon a ponton és gáznapon a negatív opcióval együtt vett szállítási feladata csak zérus v. pozitív (backhaul) lehet.
Hibaüzenet szövege
Megoldás
vett szállítási feladat csak zérus v. pozitív (backhaul) lehet!
szállítási feladata pontosan zérus legyen! Pozitív csak akkor lehet, ha van backhaul kapacitása.
Interkonnektor pontra beadott nominálásnál az interkonnektor pontot kell megjelölni.
Nomination.Error.Business.313
Interkonnektor társ pontra nem adható be nominálás. Nominálását az interkonnektor pontra adja be!
Nominálását az pontra adja be!
Kapcsolt kapacitással rendelkező hálózati ponton csak NOM típusú nominálás értelmezett.
Nomination.Error.Business.320
Kapcsolt kapacitással rendelkező hálózati pontra csak NOM típusú nominálás adható be!
Kapcsolt kapacitással rendelkező hálózati ponton törölje a BH típusú nominálási sort.
Kapcsolt kapacitással rendelkező hálózati ponton a szállíttató pár csak a szállíttató önmaga lehet.
Nomination.Error.Business.321
Kapcsolt kapacitással rendelkező hálózati pont estén a szállíttatópár nem különbözhet a szállíttatótól!
Ha egy szállíttató adott gáznapra adott hálózati pontra nominál, akkor arra a gáznapra az adott hálózati pontnak hozzárendelésre kell kerülnie egy nominálás folyamat csoporthoz.
Nomination.Error.Business.322
A hálózati pontra nem adható be nominálás!
Informatikai Platform illeszkedési felület
FGSZ Zrt.
interkonnektor
Értesítse a rendszergazdát!
6.2.1 A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS SaveNomination STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész
Tárgy gáznap
NOM sorok
Backhaul sorok
A fejrész a korábban már definiált, általános érvényű fejrészt jelenti.
A NOM TÍPUSÚ NOMINÁLÁSI SOROK XML-BLOKKJÁNAK AZONOSÍTÓJA nominationLine
MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Sorszám
Sorszám, mely a nominálási sor azonosítására szolgál – amennyiben egy nominálási sor valamely üzleti ellenőrzésen fennakad, a válaszban ezzel a sorszámmal történik az arra való hivatkozás.
lineNumber
Pozitív egész
Hálózati pont
Hálózati pont (ld. 4.3.2)
networkPoint
Location
Nominált órai mennyiség
A nominált mennyiség kWh-ban. Egész szám.
hourlyQuantity
Quantity
Szállíttató pár
A szállíttató pár IP-beli azonosítója. (A szállíttató mindig a fejrészben megjelölt sender tag.)
shipperPair
Party
Informatikai Platform illeszkedési felület
FGSZ Zrt.
52/178
PÉLDA
<nominationLine>
1 KAMOSONM1IIN <shipperPair codingScheme="ZZZ">TESTSHIPPERPAIR
1 2000 …
24 3200 A BH TÍPUSÚ NOMINÁLÁSI SOROK XML-BLOKKJÁNAK AZONOSÍTÓJA backhaulLine
MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Sorszám
Sorszám, mely a nominálási sor azonosítására szolgál – amennyiben egy nominálási sor valamely üzleti ellenőrzésen fennakad, a válaszban ezzel a sorszámmal történik az arra való hivatkozás.
lineNumber
Pozitív egész
Hálózati pont
Hálózati pont (ld. 4.3.2)
networkPoint
Location
Nominált órai mennyiség
A nominált mennyiség kWh-ban. Egész szám.
hourlyQuantity
Quantity
Szállíttató pár
A szállíttató pár IP-beli azonosítója. (A szállíttató mindig a fejrészben megjelölt sender tag.)
shipperPair
Party
Informatikai Platform illeszkedési felület
FGSZ Zrt.
53/178
PÉLDA
2 KAMOSONM1IIN <shipperPair codingScheme="ZZZ">TESTSHIPPERPAIR 1 2000 … 24 3200
6.2.2 A VÁLASZT TARTALMAZÓ ÜZENET LEÍRÁS A nominálási üzenetre a fogadó szinkron módon minden esetben ad válaszüzenetet a web service visszatérési értékeként. Ebben a válaszban megjelenik az eredeti üzenetre való hivatkozás, és a feldolgozás eredménye. Sikertelen feldolgozás esetén a részletes hibaüzeneteket is magába foglalja a válasz.
LOGIKAI SZERKEZET A nominálásra való válaszüzenet logikai felépítése az alábbi:
Válaszüzenet azonosítója, létrehozásának dátuma, a válasz küldője. Ld. 4.3.1 pont.
Feldolgozás sikeres / sikertelen. Ld. 4.3.9 pont.
Eredeti üzenet fejrésze (azonosító, küldő, létrehozás dátuma) Ld. 4.3.8 pont.
Hibaüzenet-sorok az alábbiak szerint (ld. 4.3.10 pont): o
Figyelmeztetés / hiba
o
Hivatkozott nominálási sor száma
o
Hibakód
o
Hibaüzenet (az azonosított-bejelentkezett felhasználóhoz az IP-ben beállított nyelven)
o
A hibaüzenethez tartozó további tájékoztatás (opcionális)
Informatikai Platform illeszkedési felület
FGSZ Zrt.
54/178 o
Vonatkozó hálózati pont
o
Szállíttató pár
6.3. TRADE AJÁNLATOK BEKÜLDÉSE (SAVETRADENOMINATION) ÜZLETI CÉL, KÖRNYEZET A földgázszállító rendszerre vonatkozó nominálás célja a hozzáférésre jogosult által igényelt gázforgalom bejelentése a földgázszállító engedélyes számára. A nominálás típusok közzül a TRADE a kereskedelmi ügyletek bejelentését szolgálja.
LEÍRÁS A napi nominálás során egy szállíttató (hozzáférésre jogosult) tekintetében a szállítandó gázmennyiség-igények bejelentése történik adott gáznapra vonatkozóan, hálózati pontonként, a szállíttató párt megjelölve. Ide tartozik az egyes hálózati pontokon zajló kereskedelmi ügyletek bejelentése. Ehhez az átvevőnek jóvá kell hagyni az átadó által megadott mennyiséget. Csak olyan hálózati ponton jöhet létre kereskedelmi ügylet, amelyen mindkét félnek van lekötött kapacitása és kereskedési joga. A szolgáltatás feladata, a kereskedelmi ügyletek bejelentése az átadó részéről.
SZEREPLŐK , SZEREPKÖRÖK
A kérés küldője: a szállíttató
A kérés fogadója: a rendszerirányítási engedélyes (FGSZ)
A válasz küldője: a rendszerirányítási engedélyes (FGSZ)
A válasz fogadója: a szállíttató
ÜTEMEZÉS , HATÁRIDŐK A nominálásra vonatkozó határidők a TRADE ajánlat beadásra szolgáló üzenet küldésére is érvényesek. Tehát a normál nominálási ciklusban a tárgy gáznap előtt 60 nappal 06:00 órától a tárgy gáznap előtti nap maximum 00:00 óráig lehet a nominálási üzenetet beküldeni. Újranominálás elrendelése esetén természetesen az FGSZ diszpécsere által egyedileg megadott időtartományban a tárgy gáznapot megelőzően, illetve azon belül lehet a TRADE ajánlatot elküldeni. ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK A TRADE ajánlat beküldésére szolgáló üzenet kapcsán az alábbi üzleti feltételek érvényesek:
Informatikai Platform illeszkedési felület
FGSZ Zrt.
55/178
Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás
Ha a nominálást beküldi a szállíttató, akkor az az aktuálisan nyitva lévő nominálás időablakban megadott napokra fogadható be.
Nomination.Error.Business.101
A kiválasztott gáznapra nem lehet nominálni!
Csak olyan napra adjon be nominálást, amelyre az FGSZ lehetőséget biztosított.
TRADE típusú nominálási sornál szállíttató nem adhatja meg saját magát szállíttató párként.
Nomination.Error.Business.135
TRADE típusú nominálási sornál a szállíttató párnak másnak kell lennie, mint a szállíttatónak!
Adjon meg más szállíttató párt!
Vételi TRADE típusú nominálási sort tekintve az adott gáznapra az adott szállíttatónak az adott hálózati ponton legyen vételi trade jogosultsága.
Nomination.Error.Business.316
A megadott vételi TRADE típusú nomináláshoz nincs jogosultsága az adott ponton.
Vegye fel a kapcsolatot az FGSZszel trade jogosultságigénylés céljából!
Eladási TRADE típusú nominálási sort tekintve az adott gáznapra az adott szállíttatónak az adott hálózati ponton legyen eladási trade jogosultsága.
Nomination.Error.Business.317
A megadott eladási TRADE típusú nomináláshoz nincs jogosultsága az adott ponton.
Vegye fel a kapcsolatot az FGSZszel trade jogosultságigénylés céljából!
Informatikai Platform illeszkedési felület
FGSZ Zrt.
6.3.1 A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS SaveTradeNomination
STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész – ld. 4.3.1
Gáznap – aktuális gáznap
Trade ajánlat adatai
TRADE AJÁNLAT ADATAI XML-BLOKKJÁNAK AZONOSÍTÓJA tradeAgreement
MEZŐK
Megnevezés
Leírás
XML címkenév
Tag hossza
Formátum / típus
(karakter) Hálózati kódja
Átvevő kódja
pont
Azon hálózati pont kódja, amelyre a földgáz kereskedelmi ügylet vonatkozik
location
Location
szállíttató
Átvevő szállíttató IPbeli kódja
location
Party
Átadandó gázmennyiség (kWh/nap).
dailyCapacity::v
max 19 számjegy
xsd:integer
dailyCapacity:: measureUnit
3
KW2
Napi mennyiség
Megjegyzés
napi
Megjegyzés
Informatikai Platform illeszkedési felület
comment
FGSZ Zrt.
57/178 PÉLDA
1 lineNumber > VETELJCS17EN HUFSHP 2400000 Budapest tradeAgreement >
6.3.2 A VÁLASZT TARTALMAZÓ ÜZENET LEÍRÁS A nominálási üzenetre a fogadó szinkron módon minden esetben ad válaszüzenetet a web service visszatérési értékeként. Ebben a válaszban megjelenik az eredeti üzenetre való hivatkozás, és a feldolgozás eredménye. Sikertelen feldolgozás esetén a részletes hibaüzeneteket is magába foglalja a válasz.
LOGIKAI SZERKEZET A nominálásra való válaszüzenet logikai felépítése az alábbi:
Válaszüzenet azonosítója, létrehozásának dátuma, a válasz küldője. Ld. 4.3.1 pont.
Feldolgozás sikeres / sikertelen. Ld. 4.3.9 pont.
Eredeti üzenet fejrésze (azonosító, küldő, létrehozás dátuma) Ld. 4.3.8 pont.
Hibaüzenet-sorok az alábbiak szerint (ld. 4.3.10 pont):
o
Figyelmeztetés / hiba
o
Hivatkozott TRADE sor száma
o
Hibakód
o
Hibaüzenet (az azonosított-bejelentkezett felhasználóhoz az IP-ben beállított nyelven)
o
A hibaüzenethez tartozó további tájékoztatás (opcionális)
o
Vonatkozó hálózati pont
o
Szállíttató pár
Sikeres mentés eredménye o
Hivatkozott TRADE sor száma
o
A mentett TRADE ajánlat azonosítója
Informatikai Platform illeszkedési felület
FGSZ Zrt.
58/178
6.4. TRADE AJÁNLATOK LEKÉRDEZÉSE (GETTRADENOMINATION) ÜZLETI CÉL, KÖRNYEZET A földgázszállító rendszerre vonatkozó nominálás célja a hozzáférésre jogosult által igényelt gázforgalom bejelentése a földgázszállító engedélyes számára. A nominálás típusok közzül a TRADE a kereskedelmi ügyletek bejelentését szolgálja.
LEÍRÁS A napi nominálás során egy szállíttató (hozzáférésre jogosult) tekintetében a szállítandó gázmennyiség-igények bejelentése történik adott gáznapra vonatkozóan, hálózati pontonként, a szállíttató párt megjelölve. Ide tartozik az egyes hálózati pontokon zajló kereskedelmi ügyletek bejelentése. Ehhez az átvevőnek jóvá kell hagyni az átadó által megadott mennyiséget. Csak olyan hálózati ponton jöhet létre kereskedelmi ügylet, amelyen mindkét félnek van lekötött kapacitása és kereskedési joga. A szolgáltatás feladata, a rendszerben lévő földgáz kereskedelmi ajánlatok lekérdezése.
SZEREPLŐK , SZEREPKÖRÖK
A kérés küldője: a szállíttató
A kérés fogadója: a rendszerirányítási engedélyes (FGSZ)
A válasz küldője: a rendszerirányítási engedélyes (FGSZ)
A válasz fogadója: a szállíttató
ÜTEMEZÉS , HATÁRIDŐK A szolgáltatás minden időpontban elérhető.
6.4.1 A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS GetTradeNomination STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész – ld. 4.3.1
Gáznap – aktuális gáznap
Informatikai Platform illeszkedési felület
FGSZ Zrt.
59/178
6.4.2 A VÁLASZT TARTALMAZÓ ÜZENET LEÍRÁS A nominálási üzenetre a fogadó szinkron módon minden esetben ad válaszüzenetet a web service visszatérési értékeként. Ebben a válaszban megjelenik az eredeti üzenetre való hivatkozás, és a feldolgozás eredménye. Sikertelen feldolgozás esetén a részletes hibaüzeneteket is magába foglalja a válasz.
LOGIKAI SZERKEZET A nominálásra való válaszüzenet logikai felépítése az alábbi:
Válaszüzenet azonosítója, létrehozásának dátuma, a válasz küldője. Ld. 4.3.1 pont.
Feldolgozás sikeres / sikertelen. Ld. 4.3.9 pont.
Eredeti üzenet fejrésze (azonosító, küldő, létrehozás dátuma) Ld. 4.3.8 pont.
Hibaüzenet-sorok az alábbiak szerint (ld. 4.3.10 pont):
o
Hibakód
o
Hibaüzenet (az azonosított-bejelentkezett felhasználóhoz az IP-ben beállított nyelven)
A lekérdezés eredménye o
Ajánlat azonosítója
o
Gáznap
o
Ajánlat státusza
o
Átadás helye
o
Átadó kódja
o
Átvevő kódja
o
Átadott napi mennyiség
o
Megjegyzés szövege
PÉLDA 10011587 aggreementID > 10011587 gasDay >
Informatikai Platform illeszkedési felület
FGSZ Zrt.
60/178 <status>RECEIVED status > VETELJCS17EN <seller codingScheme="ZZZ">HUFSHP1 HUFSHP2 2400000 Budapest Agreement >
6.5. TRADE AJÁNLATOK JÓVÁHAGYÁSA (TRADENOMINATIONCONFIRMATION) ÜZLETI CÉL, KÖRNYEZET A földgázszállító rendszerre vonatkozó nominálás célja a hozzáférésre jogosult által igényelt gázforgalom bejelentése a földgázszállító engedélyes számára. A nominálás típusok közzül a TRADE a kereskedelmi ügyletek bejelentését szolgálja.
LEÍRÁS A napi nominálás során egy szállíttató (hozzáférésre jogosult) tekintetében a szállítandó gázmennyiség-igények bejelentése történik adott gáznapra vonatkozóan, hálózati pontonként, a szállíttató párt megjelölve. Ide tartozik az egyes hálózati pontokon zajló kereskedelmi ügyletek bejelentése. Ehhez az átvevőnek jóvá kell hagyni az átadó által megadott mennyiséget. Csak olyan hálózati ponton jöhet létre kereskedelmi ügylet, amelyen mindkét félnek van lekötött kapacitása és kereskedési joga. A szolgáltatás feladata, a rendszerben lévő földgáz kereskedelmi ajánlatok jóváhagyása, visszautasítása vagy törlése. Törölni csak a RECEIVED státuszú ajánlatokat lehet és csak az átadónak. SZEREPLŐK , SZEREPKÖRÖK
A kérés küldője: a szállíttató
A kérés fogadója: a rendszerirányítási engedélyes (FGSZ)
A válasz küldője: a rendszerirányítási engedélyes (FGSZ)
A válasz fogadója: a szállíttató
ÜTEMEZÉS , HATÁRIDŐK A nominálásra vonatkozó határidők a TRADE ajánlat beadásra szolgáló üzenet küldésére is érvényesek. Tehát a normál nominálási ciklusban a tárgy gáznap előtt 60 nappal 06:00 órától a tárgy gáznap előtti nap maximum 00:00 óráig lehet a TRADE ajánlat elfogadást, visszautasítást vagy törlést beküldeni.
ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK A TRADE ajánlat beküldésére szolgáló üzenet kapcsán az alábbi üzleti feltételek érvényesek:
Informatikai Platform illeszkedési felület
FGSZ Zrt.
61/178
Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Jóváhagyott ajánlaton már nem végezhető művelet.
TradeAgreementApproval.Error.Already_Approved
A megadott ajánlat már jóváhagyásra került!
Törölt ajánlaton végezhető művelet.
nem
TradeAgreementApproval.Error.Already_Canceled
A megadott ajánlat már törlésre került!
nem
TradeAgreementApproval.Error.Already_Rejected
A megadott ajánlat már elutasításra került!
Csak olyan ajánlatok kezelhetőek, amelyekben a felhasználó parnere érintett.
TradeAgreementApproval.Error.Access_denied
A megadott ajánlat kezeléséhez nincs jogosultsága!
Csak létező ajánlatokon műveleteket végezni.
TradeAgreementApproval.Error.Invalid_ID
A megadott ajánlat nem létezik!
Ha a nominálást beküldi a szállíttató, akkor az az aktuálisan nyitva lévő nominálás időablakban megadott napokra fogadható be.
Nomination.Error.Business.101
A kiválasztott nominálni!
TRADE típusú nominálási sornál szállíttató nem adhatja meg saját magát szállíttató párként.
Nomination.Error.Business.135
TRADE típusú nominálási sornál a szállíttató párnak másnak kell lennie, mint a szállíttatónak!
Adjon meg más szállíttató párt!
Vételi TRADE típusú nominálási
Nomination.Error.Business.316
A
Vegye fel a kapcsolatot az FGSZ-
Elutasított ajánlaton végezhető művelet.
már
már
lehet
Informatikai Platform illeszkedési felület
megadott
Megoldás
gáznapra
vételi
FGSZ Zrt.
nem
TRADE
Kérje le a rendszerből az érintett ajánlatokat és ellenőrizzze a megadott azonosítót! lehet
típusú
Csak olyan napra adjon be nominálást, amelyre az FGSZ lehetőséget biztosított.
62/178 Ellenőrzés
Hibaüzenet azonosítója
sort tekintve az adott gáznapra az adott szállíttatónak az adott hálózati ponton legyen vételi trade jogosultsága. Eladási TRADE típusú nominálási sort tekintve az adott gáznapra az adott szállíttatónak az adott hálózati ponton legyen eladási trade jogosultsága.
Nomination.Error.Business.317
Informatikai Platform illeszkedési felület
Hibaüzenet szövege
Megoldás
nomináláshoz nincs jogosultsága az adott ponton.
szel trade céljából!
A megadott eladási TRADE típusú nomináláshoz nincs jogosultsága az adott ponton.
Vegye fel a kapcsolatot az FGSZszel trade jogosultságigénylés céljából!
FGSZ Zrt.
jogosultságigénylés
6.5.1 A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS SaveTradeNomination STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész – ld. 4.3.1
Gáznap – aktuális gáznap
Ajánlat azonosító
Műveleti azonosító o
APPROVE – a megadott azonosítójú ajánlat elfogadása
o
REJECT - a megadott azonosítójú ajánlat visszautasítása
o
CANCEL - a megadott azonosítójú ajánlat törlése
6.5.2 A VÁLASZT TARTALMAZÓ ÜZENET LEÍRÁS A Trade kezelési üzenetre a fogadó szinkron módon minden esetben ad válaszüzenetet a web service visszatérési értékeként. Ebben a válaszban megjelenik az eredeti üzenetre való hivatkozás, és a feldolgozás eredménye. Sikertelen feldolgozás esetén a részletes hibaüzeneteket is magába foglalja a válasz. LOGIKAI SZERKEZET A Trade kezelésre való válaszüzenet logikai felépítése az alábbi:
Válaszüzenet azonosítója, létrehozásának dátuma, a válasz küldője. Ld. 4.3.1 pont.
Feldolgozás sikeres / sikertelen. Ld. 4.3.9 pont.
Eredeti üzenet fejrésze (azonosító, küldő, létrehozás dátuma) Ld. 4.3.8 pont.
Hibaüzenet-sorok az alábbiak szerint (ld. 4.3.10 pont): o
Hibakód
o
Hibaüzenet (az azonosított-bejelentkezett felhasználóhoz az IP-ben beállított nyelven)
Ajánlat azonosítója
Elvégzett művelet
Informatikai Platform illeszkedési felület
FGSZ Zrt.
64/178
6.6. BEKÜLDÖTT NOMINÁLÁSI ADATOK VERZIÓSZÁMMAL (GETNOMINATION) ÜZLETI CÉL, KÖRNYEZET Bizonyos esetekben szükség lehet a már beküldött nominálási adatok lekérdezésére – adott verziószám szerint. Jelen üzenet ezt a célt szolgálja.
LEÍRÁS A szállíttató kérés formájában a tárgy gáznapot és a nominálás verzióját adja meg, melyre válaszüzenetben a rendszer a nominálási adatokat adja vissza a nominálás beadásának időpontjával, státuszával és verziószámával. SZEREPLŐK , SZEREPKÖRÖK
A kérés küldője: a szállíttató
A kérés fogadója: a rendszerirányítási engedélyes (FGSZ)
A válasz küldője: a rendszerirányítási engedélyes (FGSZ)
A válasz fogadója: a szállíttató
ÜTEMEZÉS , HATÁRIDŐK A korábban már beküldött nominálási adatok tetszőleges időpontban lekérdezhetők.
6.6.1 A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS GetNomination
STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész (ld. 4.3.1) – megbízotti státuszban a tárgy szállíttatót a „sender” tagban kell megadni
Tárgy gáznap (ld. 4.3.3)
Verziószám
Informatikai Platform illeszkedési felület
FGSZ Zrt.
65/178
6.6.2 A VÁLASZT TARTALMAZÓ ÜZENET STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész
Tárgy gáznap
NOM sorok
Trade sorok
Backhaul sorok
Opciós (HEGO) sorok
KFRE sorok
HEG sorok
Verziószám
Beküldés ideje
Státusz
A NOM TÍPUSÚ NOMINÁLÁSI SOROK XML-BLOKKJÁNAK AZONOSÍTÓJA nominationLine MEZŐK Megnevezés
Leírás
XML címkenév
Formátum / típus
Sorszám
Sorszám, mely a nominálási sor azonosítására szolgál – amennyiben egy nominálási sor valamely üzleti ellenőrzésen fennakad, a válaszban ezzel a sorszámmal történik az arra való hivatkozás.
lineNumber
Pozitív egész
Hálózati pont
Hálózati pont (ld. 4.3.2)
networkPoint
Location
Nominált mennyiség
A nominált mennyiség kWh-ban. Egész szám.
hourlyQuantity
Quantity
Szállíttató pár
A szállíttató pár IP-beli azonosítója. (A szállíttató mindig a fejrészben megjelölt sender tag.)
shipperPair
Party
Informatikai Platform illeszkedési felület
FGSZ Zrt.
66/178
PÉLDA
<nominationLine> 1 KAMOSONM1IIN <shipperPair codingScheme="ZZZ">TESTSHIPPERPAIR 1 2000 … 24 3200 A BH TÍPUSÚ NOMINÁLÁSI SOROK XML-BLOKKJÁNAK AZONOSÍTÓJA backhaulLine
MEZŐK Megnevezés
Leírás
XML címkenév
Formátum / típus
Sorszám
Sorszám, mely a nominálási sor azonosítására szolgál – amennyiben egy nominálási sor valamely üzleti ellenőrzésen fennakad, a válaszban ezzel a sorszámmal történik az arra való hivatkozás.
lineNumber
Pozitív egész
Hálózati pont
Hálózati pont (ld. 4.3.2)
networkPoint
Location
Nominált napi mennyiség
A nominált napi mennyiség kWhban. Egész szám.
hourlyQuantity
Quantity
Szállíttató pár
A szállíttató pár IP-beli azonosítója. (A szállíttató mindig a fejrészben megjelölt sender tag.)
shipperPair
Party
Informatikai Platform illeszkedési felület
FGSZ Zrt.
67/178 PÉLDA
2 KAMOSONM1IIN <shipperPair codingScheme="ZZZ">TESTSHIPPERPAIR 1 2000 … 24 3200 A TRADE TÍPUSÚ NOMINÁLÁSI SOROK XML-BLOKKJÁNAK AZONOSÍTÓJA tradeLine
MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Sorszám
Sorszám, mely a nominálási sor azonosítására szolgál – amennyiben egy nominálási sor valamely üzleti ellenőrzésen fennakad, a válaszban ezzel a sorszámmal történik az arra való hivatkozás.
lineNumber
Pozitív egész
Hálózati pont
Hálózati pont (ld. 4.3.2)
networkPoint
Location
Nominált napi mennyiség
A nominált mennyiség kWh-ban. Egész szám.
hourlyQuantity
Quantity
Szállíttató pár
A szállíttató pár IP-beli azonosítója. (A szállíttató mindig a fejrészben megjelölt sender tag.)
shipperPair
Party
Informatikai Platform illeszkedési felület
FGSZ Zrt.
68/178 PÉLDA
3 KAMOSONM1IIN <shipperPair codingScheme="ZZZ">TESTSHIPPERPAIR 1 2000 … 24 3200 AZ OPT_POS TÍPUSÚ NOMINÁLÁSI SOROK XML-BLOKKJÁNAK AZONOSÍTÓJA optionPositiveLine MEZŐK Megnevezés
Leírás
XML címkenév
Formátum / típus
Sorszám
Sorszám, a nominálási sor azonosítására szolgál – amennyiben egy nominálási sor valamely üzleti ellenőrzésen fennakad, a válaszban ezzel a sorszámmal történik az arra való hivatkozás.
lineNumber
Pozitív egész
Hálózati pont
Hálózati pont (ld. 4.3.2)
networkPoint
Location
Nominált napi mennyiség
Az opciós mennyiség kWh-ban. Nemnegatív egész szám.
hourlyQuantity
Quantity
Szállíttató pár
A szállíttató pár IP-beli azonosítója. (A szállíttató mindig a fejrészben megjelölt sender tag.)
shipperPair
Party
Opciós ár
Opciós ár pontossággal.
optionPrice
Price
Opciós ár mértékegysége
Az a mértékegység, amelyre az opciós ár vonatkozik. Jelenleg csak a kWh értelmezett, melyet a „KWH” konstans jelöl.
4
tizedesjegy
Informatikai Platform illeszkedési felület
measureUnit
FGSZ Zrt.
69/178
PÉLDA
4 KAMOSONM1IIN <shipperPair codingScheme="ZZZ">TESTSHIPPERPAIR 1,1234 1 2000 … 24 3200 AZ OPT_NEG TÍPUSÚ NOMINÁLÁSI SOROK XML-BLOKKJÁNAK AZONOSÍTÓJA optionNegativeLine MEZŐK Megnevezés
Leírás
XML címkenév
Formátum / típus
Sorszám
Sorszám, mely a nominálási sor azonosítására szolgál – amennyiben egy nominálási sor valamely üzleti ellenőrzésen fennakad, a válaszban ezzel a sorszámmal történik az arra való hivatkozás.
lineNumber
Pozitív egész
Hálózati pont
Hálózati pont (ld. 4.3.2)
networkPoint
Location
Nominált napi mennyiség
Az opciós mennyiség kWh-ban. Negatív egész szám, vagy zérus.
hourlyQuantity
Quantity
Szállíttató pár
A szállíttató pár IP-beli azonosítója. (A szállíttató mindig a fejrészben megjelölt sender tag.)
shipperPair
Party
Opciós ár
Opciós ár 4 tizedesjegy pontossággal.
optionPrice
Price
Opciós ár mértékegysége
Az a mértékegység, amelyre az opciós ár vonatkozik. Jelenleg csak a kWh értelmezett, melyet a „KWH” konstans jelöl.
measureUnit
Informatikai Platform illeszkedési felület
FGSZ Zrt.
70/178
PÉLDA
4 KAMOSONM1IIN <shipperPair codingScheme="ZZZ">TESTSHIPPERPAIR 1,1234 1 2000 … 24 3200 A KFRE (KAPACITÁSFÜGGETLEN RUGALMASSÁGI ESZKÖZ ) TÍPUSÚ NOMINÁLÁSI SOROK XML-BLOKKJÁNAK AZONOSÍTÓJA kfreLine
MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Sorszám
Sorszám, a nominálási sor azonosítására szolgál – amennyiben egy nominálási sor valamely üzleti ellenőrzésen fennakad, a válaszban ezzel a sorszámmal történik az arra való hivatkozás.
lineNumber
Pozitív egész
Hálózati pont
Hálózati pont (ld. 4.3.2)
networkPoint
Location
Nominált napi mennyiség
A KFRE mennyiség kWh-ban. Nemnegatív egész szám.
hourlyQuantity
Quantity
Szállíttató pár
A szállíttató pár IP-beli azonosítója. (A szállíttató mindig a fejrészben megjelölt sender tag.)
shipperPair
Party
Opciós ár
Opciós
optionPrice
Price
ár
4
tizedesjegy
Informatikai Platform illeszkedési felület
FGSZ Zrt.
71/178 pontossággal. Opciós ár mértékegysége
Az a mértékegység, amelyre az opciós ár vonatkozik. Jelenleg csak a kWh értelmezett, melyet a „KWH” konstans jelöl.
measureUnit
PÉLDA
4 KAMOSONM1IIN <shipperPair codingScheme="ZZZ">TESTSHIPPERPAIR 1,1234 1 2000 … 24 3200 A HEG_POS TÍPUSÚ NOMINÁLÁSI SOROK XML-BLOKKJÁNAK AZONOSÍTÓJA hegPositiveLine Figyelem! A HEG_POS sorok az IP-n csak-olvashatók, ily módon az IP nem a SaveNomination-ben megadott, hanem az KP által megküldött adatokat veszi alapul!
MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Sorszám
Sorszám, mely a nominálási sor azonosítására szolgál – amennyiben egy nominálási sor valamely üzleti ellenőrzésen fennakad, a válaszban ezzel a sorszámmal történik az arra való
lineNumber
Pozitív egész
Informatikai Platform illeszkedési felület
FGSZ Zrt.
72/178 hivatkozás. Hálózati pont
Hálózati pont (ld. 4.3.2)
networkPoint
Location
Nominált napi mennyiség
Az adott ponton az eladási HEG DA/WD ügyletek napi összege kWh-ban.
hourlyQuantity
Quantity
Szállíttató pár
A szállíttató pár IP-beli azonosítója. (A szállíttató mindig a fejrészben megjelölt sender tag.)
shipperPair
Party
PÉLDA
4 KAMOSONM1IIN <shipperPair codingScheme="ZZZ">TESTSHIPPERPAIR 1 2000 … 24 3200 A HEG_NEG TÍPUSÚ NOMINÁLÁSI SOROK XML-BLOKKJÁNAK AZONOSÍTÓJA hegNegativeLine Figyelem! A HEG_NEG sorok az IP-n csak-olvashatók, ily módon az IP nem a SaveNomination-ben megadott, hanem az KP által megküldött adatokat veszi alapul!
MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Sorszám
Sorszám, mely a nominálási sor azonosítására szolgál –
lineNumber
Pozitív egész
Informatikai Platform illeszkedési felület
FGSZ Zrt.
73/178 amennyiben egy nominálási sor valamely üzleti ellenőrzésen fennakad, a válaszban ezzel a sorszámmal történik az arra való hivatkozás. Hálózati pont
Hálózati pont (ld. 4.3.2)
networkPoint
Location
Nominált napi mennyiség
Az adott ponton a vételi HEG DA/WD ügyletek napi összege kWh-ban.
hourlyQuantity
Quantity
Szállíttató pár
A szállíttató pár IP-beli azonosítója. (A szállíttató mindig a fejrészben megjelölt sender tag.)
shipperPair
Party
PÉLDA
4 KAMOSONM1IIN <shipperPair codingScheme="ZZZ">TESTSHIPPERPAIR 1 2000 … 24 3200 KIEGÉSZÍTŐ ADATOK version creationTime status MEZŐK
Informatikai Platform illeszkedési felület
FGSZ Zrt.
74/178 Megnevezés
Leírás
XML címkenév
Formátum / típus
Verzió
A beadott nominálás verziószáma
version
Pozitív egész
Beküldés ideje
A nominálás időpontja
creationTime
xsd:dateTime időzóna)
Státusz
A beküldött nominálás állapota.
dailyQuantity
xs:string
befogadásának
(„Z”
PÉLDA
<ns3:version>4 <ns3:creationTime>2010-08-30T10:46:27.414+02:00 <ns3:status>REFUSED
Informatikai Platform illeszkedési felület
FGSZ Zrt.
75/178
6.7. BEKÜLDÖTT NOMINÁLÁSOK STÁTUSZA (GETNOMINATIONINFO) ÜZLETI CÉL, KÖRNYEZET Bizonyos esetekben szükség lehet a már beküldött nominálások státuszának lekérdezésére. Jelen üzenet ezt a célt szolgálja.
LEÍRÁS A szállíttató kérés formájában a tárgy gáznapot adja meg, melyre válaszüzenetben a rendszer a már beküldött nominálások befogadásának időpontját, státuszát és verziószámát adja vissza.
SZEREPLŐK , SZEREPKÖRÖK
A kérés küldője: a szállíttató
A kérés fogadója: a rendszerirányítási engedélyes (FGSZ)
A válasz küldője: a rendszerirányítási engedélyes (FGSZ)
A válasz fogadója: a szállíttató
ÜTEMEZÉS , HATÁRIDŐK A korábban már beküldött nominálások státuszai tetszőleges időpontban lekérdezhetők.
6.7.1 A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS GetNominationInfo
STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész (ld. 4.3.1) – megbízotti státuszban a tárgy szállíttatót a „sender” tagban kell megadni
Tárgy gáznap (ld. 4.3.3)
Informatikai Platform illeszkedési felület
FGSZ Zrt.
76/178
6.7.2 A VÁLASZT TARTALMAZÓ ÜZENET STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész
Tárgy gáznap
Státusz sorok
A STÁTUSZ SOROK XML-BLOKKJÁNAK AZONOSÍTÓJA nominationInfo
MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Verzió
A beadott nominálás verziószáma
version
Pozitív egész
Beküldés ideje
A nominálás időpontja
creationTime
xsd:dateTime időzóna)
Státusz
A beküldött nominálás állapota.
dailyQuantity
xs:string
befogadásának
(„Z”
PÉLDA
<ns3:nominationInfo> <ns3:version>2 <ns3:creationTime>2010-08-05T11:07:02.473+02:00 <ns3:status>APPROVED
Informatikai Platform illeszkedési felület
FGSZ Zrt.
77/178
6.8. NOMINÁLÁSOK FELOSZTÁSA (DIVIDENOMINATION) ÜZLETI CÉL, KÖRNYEZET A kialakított interfész célja a rendszerüzemeltetők összevont hálózati pontjaira beadott nominálások összegének elemi pontokra bontása.
LEÍRÁS Jelen illeszkedési felület azt biztosítja, hogy a csatlakozó rendszerüzemeltetők adott gáznapra az összevont hálózati pontjaik vonatkozásában megadhassák az elemi pontra felosztott nominálási adatokat. A rögzítésénél napi mennyiségeket és órai maximumokat kell megadni. Az összevont pontokra az össz nominált mennyiséget a NOM + BH + HEG_POS + HEG_NEG sorok napi mennyiségeinek összegeként kell értelmezni. Az órai maximum arra az órára értelmezendő, amelyben a HEG_POS és HEG_NEG órai mennyiségek a legnagyobb, pont jellegének megfelelő szállítási feladatot eredményezik. Ebben az órában az IP ezt a HEG szállítási feladatot veszi alapul – hozzáadva természetesen a NOM+BH sorok órai maximumát. Amennyiben a nominálások felosztását követően az összevont pontra vonatkozó nominálások változnak, az IP a felosztási mennyiségeket mint arányokat kezeli.
SZEREPLŐK , SZEREPKÖRÖK
A kérés küldője: NNO
A kérés fogadója: a rendszerirányítási engedélyes (FGSZ)
A válasz küldője: a rendszerirányítási engedélyes (FGSZ)
A válasz fogadója: NNO
ÜTEMEZÉS , HATÁRIDŐK A nominálások felosztását a pillanatnyi, és az azt követő 60 gáznappal bezárólag terjedő gáznapokra lehet megadni.
6.8.1 A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS
divideNomination
Informatikai Platform illeszkedési felület
FGSZ Zrt.
78/178 STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész (ld. 4.3.1) – megbízotti státuszban a tárgy szállíttatót a „sender” tagban kell megadni
Tárgy gáznap (ld. 4.3.3)
Összevont pont felosztási adat (hálózati pont 1) o
o
o
Elemi pont 1 adatai
Elemi pont nominálása
Elemi pont órai maximuma
Elemi pont 2 adatai
Elemi pont nominálása
Elemi pont órai maximuma
...
Összevont pont felosztási adat (hálózati pont 2) o
Elemi pont n. adatai
o
...
ÖSSZEVONT PONTHOZ KÖTHETŐ ADATOK XML-BLOKKJÁNAK AZONOSÍTÓJA nominationDivideData MEZŐK
Megnevezés
Leírás
XML címkenév
Pont kódja
Összevont hálózati pont kódja
locationCode
Formátum / típus
ELEMI PONTHOZ KÖTHETŐ ADATOK XML-BLOKKJÁNAK AZONOSÍTÓJA nominationDivideDataItem
MEZŐK
Informatikai Platform illeszkedési felület
FGSZ Zrt.
79/178 Megnevezés
Leírás
XML címkenév
Pont kódja
Elemi pont kódja
locationCode
Az elemi pontja jutó nominált mennyiség kWh-ban
nomination
Elemi pontja jutó nominált mennyiséghez tartozó órai maximum kWh-ban
hourlyPeak
Nominált mennyiség
napi
Órai maximum
Formátum / típus
PÉLDA
<nominationDivideData codingScheme="ZZZ" locationCode="POINTCODE1"> <nominationDivideDataItem codingScheme="ZZZ" locationCode="POINTCODE2"> <nomination>100 < hourlyPeak >10 <nominationDivideDataItem codingScheme="ZZZ" locationCode="POINTCODE3"> <nomination>480 < hourlyPeak >20 <nominationDivideData codingScheme="ZZZ" locationCode="POINTCODE5"> ...
6.8.2 A VÁLASZT TARTALMAZÓ ÜZENET LEÍRÁS A nominálás felosztására a fogadó szinkron módon minden esetben ad válaszüzenetet a web service visszatérési értékeként. Ebben a válaszban megjelenik az eredeti üzenetre való hivatkozás, és a feldolgozás eredménye. Sikertelen feldolgozás esetén a részletes hibaüzeneteket is magába foglalja a válasz.
LOGIKAI SZERKEZET A válaszüzenet logikai felépítése az alábbi:
Válaszüzenet azonosítója, létrehozásának dátuma, a válasz küldője. Ld. 4.3.1 pont.
Feldolgozás sikeres / sikertelen. Ld. 4.3.9 pont.
Eredeti üzenet fejrésze (azonosító, küldő, létrehozás dátuma) Ld. 4.3.8 pont.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
80/178
Hibaüzenet-sorok az alábbiak szerint (ld. 4.3.10 pont): o
Hibakód
o
Hibaüzenet (az azonosított-bejelentkezett felhasználóhoz az IP-ben beállított nyelven)
o
A hibaüzenethez tartozó további tájékoztatás (opcionális)
Informatikai Platform illeszkedési felület
FGSZ Zrt.
81/178 HIBAÜZENETEK
Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás
A nominálás felosztást beküldő rendszerüzemeltető a saját hálózati pontjait adta meg.
NominationDivide.Error.User_Deny
Nincs joga a megadott hálózati ponthoz!
Csak olyan hálózati pontra adjon be nominálás felosztást, aminek a megadott partner a rendszerüzemeltetője.
A megadott nominálható hálózati pont érvényes a madott napon.
NominationDivide.Error.NomAlloc_NetworkUnit_Data
A megadott pont adatai hibásak!
Adjon meg érvényes hálózati pontot.
A nominálás felosztást beküldő rendszerüzemeltető a saját összevont hálózati pontját adta meg.
NominationDivide.Error.NomAlloc_NetworkUnit_Operator
A megadott öszevont pont nem az adott NNO-hoz tartozik!
Csak olyan hálózati pontra adjon be nominálás felosztást, aminek a megadott partner a rendszerüzemeltetője!
A nominálás felosztást beküldő rendszerüzemeltető a saját hálózati pontjait adta meg.
NominationDivide.Error.Measure_NetworkUnit_Operator
A megadott mérési pont nem az adott NNO-hoz tartozik!
Csak olyan hálózati pontra adjon be nominálás felosztást, aminek a megadott partner a rendszerüzemeltetője!
A nominált menyiség és az óracsúcs megadása minden pont esetén kötelező.
NominationDivide.Error.Required
A ‘Nominált érték’ és az ‘óracsúcs’ megadása kötelező!
Adja meg a hiányzó mennyiségeket.
A nominált mennyiség és az óracsúcs mennyiség előjele
NominationDivide.Error.Quantity_Per_HourlyPeak_Sign
A ‘Nominált érték’ és az ‘óracsúcs’ előjele meg kell egyezzen!
Javítsa az előjel hibát!
Informatikai Platform illeszkedési felület
FGSZ Zrt.
nominálható
82/178 Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás
Az óracsúcs értéke nem lehet kisebb, mint a napi nominált mennyiség és a gáznap óráinak hányadosa.
NominationDivide.Error.Quantity_Per_HourlyPeak
Az ‘óracsúcs’ nem lehet kisebb, mint a ‘Nominált mennyiség’ / gáznap órái!
Javítsa az óracsúcs mennyiségét!
Az óracsúcs mennyisége nem lehet nagyobb, mint a nominált mennyiség.
NominationDivide.Error.Quantity_Bigger_HourlyPeak
Az ‘óracsúcs’ nem lehet nagyobb, mint a ‘Nominált mennyiség’!
Javítsa az óracsúcs mennyiségét!
Betáplálási ponton csak pozitív mennyiségek adhatóak meg.
NominationDivide.Error.Quantity_Direction_IN
Betáplálási ponton csak pozitív ‘Nominált érték’ fogadható be!
Javítsa az előjel hibát!
Kiadási ponton csak negatív előjelű mennyiségek adhatóak meg.
NominationDivide.Error.Quantity_Direction_OUT
Kitáplálási ponton cask negatív ‘Nominált érték’ fogadható be!
Javítsa az előjel hibát!
A megadott nominált értékek összegének meg kell egyezni az összevont pontra leadott napi nominált mennyiséggel.
NominationDivide.Warning.QuantitySum
A ‘Nominált érték’-ek összege nem egyezik meg az összevont pontra leadott nominálással!
Korrigálja a nominált értékeket.
A megadott óracsúcs értékek összegének meg kell egyezni az összevont pontra leadott napi nominált mennyiséggel.
NominationDivide.Warning. HourlyPeakSum
Az ‘óracsúcs’-ok összege nem egyezik meg az összevont pontra leadott óracsúccsal!
Korrigálja az óracsúcs értékeket.
csak azonos lehet.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
7. NAPI OPERATÍV SZÁLLÍTÓRENDSZERI („14 ÓRÁS”) ADATSZOLGÁLTATÁS (OPERATIVETSODATASERVICE14H) ÜZLETI CÉL, KÖRNYEZET Az ÜKSZ 9.2.1 pontja alapján a rendszerirányítási engedélyes napi operatív adatszolgáltatást készít az előző napról, melyet a gáznapot követően 14 óráig a hozzáférésre jogosultak számára az informatikai platformon elérhetővé tesz. Ez az adatszolgáltatás a különböző mérési adatok mellett lényegében az allokálás eredményének közlésére szolgál. Megjegyzendő, hogy a gyakorlatban a rendszerirányítási engedélyes azonos struktúrában azonos jellegű adatokat a rendszerüzemeltetők részére is szolgáltat – az általuk üzemeltetett rendszerek csatlakoztatását képező hálózati pontokra vonatkozóan.
LEÍRÁS Az adatszolgáltatás mind a rendszerüzemeltetők, mind a hozzáférésre jogosultak esetében azonos módon és azonos üzenetformátumban történik. A rendszerüzemeltetők esetében csak azon hálózati pontok jelennek meg, amelyek rendszerüknek a földgázszállítási rendszerrel való csatlakozását biztosítják. A hozzáférésre jogosultak csak azon adatokat kapják meg, amelyekben szállíttatóként vagy szállíttató párként vannak jelen.
SZEREPLŐK , SZEREPKÖRÖK
A kérés küldője: a szállíttató v. NNO
A kérés fogadója: a rendszerirányítási engedélyes (FGSZ)
A válasz küldője: a rendszerirányítási engedélyes (FGSZ)
A válasz fogadója: a szállíttató v. NNO
ÜTEMEZÉS , HATÁRIDŐK Az ÜKSZ 9.2.1 (b) pontja alapján a rendszerirányítási engedélyes a tárgy gáznapot követően 14 óráig szolgáltatja a szóbanforgó adatokat.
ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK A továbbiakban – miután az adatokat a rendszerüzemeltetők ill. hozzáférésre jogosultak kérik – a kérésre adott, az FGSZ által küldött válaszüzenet szerkezete olvasható.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
84/178
7.1. A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS OperativeTSODataService14H
STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész – ld. 4.3.1
Tárgy gáznap – ld. 4.3.3
7.2. A VÁLASZT TARTALMAZÓ ÜZENET STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész – ld. 4.3.1
Tárgy gáznap – ld. 4.3.3
Kromatográf adatok
Allokálási adat 1 (hálózati pont 1)
o
Hálózati pont 1 adatai
o
Allokálási sor 1
o
Allokálási sor 2
Allokálási adat 2 (hálózati pont 2) o
Hálózati pont 2 adatai
o
Allokálási sor 3
o
Allokálási sor 4
o
…
Informatikai Platform illeszkedési felület
FGSZ Zrt.
85/178 KROMATOGRÁFOKON MÉRT ADATOK XML-BLOKKJÁNAK AZONOSÍTÓJA chromatographData allocationData locationData allocationLine
MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum típus
Kromatográf azonosítója
Kromatográf azonosítója
chromatographCode
xs:string
Mérési adat
A kromatográfot tekintve az adott gáznapra vonatkozó mérési adat. A mérési adat kategóriája (úgymint Wobbeszám, hexán mol%, stb.) az alábbi táblázat szerint kódolt módon jelenik meg. Maga a mért mennyiség az alábbi táblázat szerinti mértékegységben értelmezett.
measurement
Quantity
/
Kromatográfon mért adatok kategóriái és mértékegységei, és azok kódolása Kategória megnevezése
Kategória kódja (dimension címke)
Mértékegység
Mértékegység kódja (measureUnit címke)
Relatív sűrűség (0°C) Relatív sűrűség (15°C) Égéshő (25/0°C) Égéshő (15/15°C) Heptán Hexán Izobután Izopentán
DN2 DN1 GCV GCV
(nincs mértékegység) (nincs mértékegység) 3 kWh/m
Z99 Z99 KW3 JM MOL MOL MOL MOL
HHP HHX HIB HIP
Informatikai Platform illeszkedési felület
MJ/m3 mol% mol% mol% mol%
FGSZ Zrt.
86/178
Neopentán Oktán Pentán Normál pentán Fűtőérték (25/0°C) Fűtőérték (15/15°C) Nitrogén Szén-dioxid Propán Etán Metán Normál bután C6+ Wobbe-szám (25/0°C) Wobbe-szám (15/15°C) Szén tartalom (0°C) Szén tartalom (15°C)
HNP HOK HPE HPN
LCV LCV ZN ZQD ZQF ZQG ZQH ZQI ZQJ
ZWI ZWI C00 C15
mol% mol% mol% mol% kWh/m3 MJ/m3 mol% mol% mol% mol% mol% mol% mol% kWh/m3 MJ/m3 mol% mol%
MOL MOL MOL MOL KW3 JM MOL MOL MOL MOL MOL MOL MOL KW3 JM MOL MOL
PÉLDA
K-18-1 <measurement dimension="DN1" measureUnit="Z99">0,5678 ... <measurement dimension="ZWI" measureUnit="JM">50,1234
HÁLÓZATI PONTHOZ KÖTHETŐ ADATOK XML-BLOKKJÁNAK AZONOSÍTÓJA allocationData::locationData Kifejezetten az allocationData blokkon belül csak az allokálási adat verziószáma szerepel a version mezőben.
MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Hálózati pont jellege (betáplálás / kiadás)
direction
xs:string
Hálózati pont kódja
Hálózati pont kódja
location
Location
Hálózati pont neve
Hálózati pont neve
description
xs:string
Hálózati jellege
pont
Informatikai Platform illeszkedési felület
FGSZ Zrt.
87/178 Csatlakozó rendszerüzemeltető
Azon rendszer üzemeltetőjének kódja, amelyhez a földgázszállítási rendszer az adott hálózati pont révén csatlakozik
operator
Party
Mért mennyiség
A hálózati ponton a tárgy gáznapon mért mennyiség. A mérési adat kategóriája az alábbi táblázat szerint kódolt módon jelenik meg. Maga a mért mennyiség az alábbi táblázat szerinti mértékegységben értelmezett.
measuredQuantity
Quantity
Kromatográf
A hálózati ponthoz rendelt kromatográf azonosítója
chromatographCode
xs:string
Hálózati ponton mért adatok kategóriái és mértékegységei, és azok kódolása Kategória megnevezése
Kategória kódja (dimension címke)
Mértékegység
Mértékegység kódja (measureUnit címke)
Térfogat (0°C) Térfogat (15°C) Energiamennyiség (25/0°C) Energiamennyiség (15/15°C)
V00 V15 E25 E15
m3 m3
MQ5 MQ5 KWH _3B
kWh
MJ
PÉLDA
VEKOBANY12GN <description>Kőbánya 2 OPERATORCODE <measuredQuantity dimension= "E25" measureUnit="KWH">300 <measuredQuantity dimension= "E15" measureUnit="_3B">9700 <measuredQuantity dimension= "V15" measureUnit="MQ5">278 <measuredQuantity dimension= "V00" measureUnit="MQ5">254
Informatikai Platform illeszkedési felület
FGSZ Zrt.
88/178
K-18-2
ALLOKÁLÁSI SOROK XML-BLOKKJÁNAK AZONOSÍTÓJA chromatographData allocationData locationData allocationLine
MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum típus
Szállíttató
Szállíttató kódja
shipper
Party
Szállíttató pár
Szállíttató pár kódja
shipperPair
Party
Nominálási sor típusa
Nominálási sor típusa (NOM / BH / HEG_POS / HEG_NEG / TRADE / OPT_POS / OPT_NEG / KFRE) – csak az OBA számlát képvisel TRADE sorok jelennek meg.
nominationKind
NominationKind
Opciós ár
Opciós (OPT_POS / OPT_NEG / KFRE) sor esetén az opciós ár FT/kWhban, 4 tizedesjegy pontossággal. Ld. OPT_POS, OPT_NEG, KFRE típusú nominálási sorok
optionPrice
Price
Nominált mennyiség
Az adott nominálási sorban foglalt nominálási
dailyNominationQuantity
Quantity
Informatikai Platform illeszkedési felület
/
FGSZ Zrt.
89/178 mennyiség ban Allokált mennyiség
kWh-
Az adott nominálási sornak megfelelő allokált mennyiség kWh-ban. Az allokált adat kategóriája az alábbi táblázat szerint kódolt módon jelenik meg. Maga az allokált mennyiség az alábbi táblázat szerinti mértékegységben értelmezett.
dailyAllocationQuantity
Quantity
Hálózati ponton allokált mennyiségek kategóriái és mértékegységei, és azok kódolása Kategória megnevezése
Kategória kódja (dimension címke)
Mértékegység
Mértékegység kódja (measureUnit címke)
Térfogat (0°C) Térfogat (15°C) Energiamennyiség (25/0°C) Energiamennyiség (15/15°C)
V00 V15 E25 E15
m3 m3
MQ5 MQ5 KWH _3B
kWh
MJ
PÉLDA <shipper codingScheme="ZZZ">SHIPPERCODE1 <shipperPair codingScheme="ZZZ">SHIPPERCODE2 <nominationKind>OPT_POS 12.1234 -452000 -468000 -1436292 -42120 -41600
Informatikai Platform illeszkedési felület
FGSZ Zrt.
90/178
8. NAP KÖZBENI ALLOKÁLÁSOK SZÁLLÍTTATÓKNAK (GETALLOCATIONSFORSHIPPER) ÜZLETI CÉL, KÖRNYEZET A szállíttatók tájékoztatása a gáznap közben allokált mennyiségekről, ezzel segítve a pontosabb nominálás megadását újranominálás esetén. LEÍRÁS Az adatszolgáltatást csak a szállíttatók érhetik el, és csak azon adatokat kapják meg, amelyekben szállíttatóként vannak jelen.
SZEREPLŐK , SZEREPKÖRÖK
A kérés küldője: a szállíttató
A kérés fogadója: a rendszerirányítási engedélyes (FGSZ)
A válasz küldője: a rendszerirányítási engedélyes (FGSZ)
A válasz fogadója: a szállíttató
ÜTEMEZÉS , HATÁRIDŐK A szolgáltatás bármikor elérhető, a lekérés pillanatáig rendelkezésre álló allokált mennyiségeket tartalmazza. ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK A továbbiakban – miután az adatokat a szállíttatók kérik – a kérésre adott, az FGSZ által küldött válaszüzenet szerkezete olvasható.
8.1. A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS GetAllocationsForShipper STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész – ld. 4.3.1
Tárgy gáznap – ld. 4.3.3
Informatikai Platform illeszkedési felület
FGSZ Zrt.
91/178
8.2. A VÁLASZT TARTALMAZÓ ÜZENET STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész – ld. 4.3.1
Tárgy gáznap – ld. 4.3.3
Allokálási adat 1 (hálózati pont 1)
o
Allokálási sor 1
o
Allokálási sor 2
o
…
o
Státusz, intervallum
Allokálási adat 2 (hálózati pont 2) o
Allokálási sor 1
o
Allokálási sor 2
o
…
o
Státusz, intervallum
HÁLÓZATI PONTHOZ KÖTHETŐ ADATOK XML-BLOKKJÁNAK AZONOSÍTÓJA allocations Kifejezetten az allocations blokkon belül a hálózati pont kódja (networkUnit), az allokálási adat státusza (state) és az allokálás intervalluma (interval) található. MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Hálózati pont kódja
Hálózati pont kódja
networkUnit
Location
Státusz
Az allokálás státusza
state
xs:string
Intervallum
Az allokált időszak
interval
xs:string
Informatikai Platform illeszkedési felület
FGSZ Zrt.
92/178 PÉLDA
SIFORRASFSEN . . . <state>GENERATED 6 - 12
ALLOKÁLÁSI SOROK XML-BLOKKJÁNAK AZONOSÍTÓJA allocationLine
MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Szállíttató pár
Szállíttató pár kódja
shipperPair
Party
Nominálási sor típusa
Nominálási sor típusa (NOM / BH / HEG_POS / HEG_NEG / TRADE / OPT_POS / OPT_NEG / KFRE) – csak az OBA számlát képvisel TRADE sorok jelennek meg.
nominationKind
NominationKind
Opciós, KFRE ár
Opciós (OPT_POS / OPT_NEG / KFRE) sor esetén az opciós ár FT/kWh-ban, 4 tizedesjegy pontossággal. Ld. OPT_POS, OPT_NEG, KFRE típusú nominálási sorok
optionPrice
Price
Nominált mennyiség
Az adott nominálási sorban foglalt nominálási mennyiség kWh-ban
nominationQuantity
Quantity
Allokált mennyiség
Az adott nominálási sornak megfelelő allokált mennyiség kWhban
allocationQuantity
Quantity
Informatikai Platform illeszkedési felület
FGSZ Zrt.
93/178 PÉLDA
<shipperPair codingScheme="ZZZ">SHIPPERCODE <nominationKind>OPT_POS 12.1234 <nominationQuantity measureUnit="KWH">-452000 -200000
Informatikai Platform illeszkedési felület
FGSZ Zrt.
94/178
9. 10 ÓRÁS ADATSZOLGÁLTATÁS (OPERATIVETSODATASERVICE10H) ÜZLETI CÉL, KÖRNYEZET A földgázellátásról szóló, 2008. évi XL. törvény az alábbi kötelezettségeket írja elő a rendszerirányítási engedélyes részére:
5.1.3.10 (i) vi.: A földgázszállítási engedélyes az Informatikai Platformon minden gáznap után 10: 00-ig publikálja az összevonásban szereplő gázátadó állomásokon átadott gázmennyiség adatokat különkülön.
8.4.2 (a): A rendszerirányítási engedélyes naponta megküldi a kilépési ponthoz csatlakozó rendszer üzemeltetőjének az elszámolási mérés alapjául szolgáló mérőeszközről kapott napi összesített gázmennyiség és gázminőség értékeit 10: 00 óráig.
9.2.2 (b): A tárolói mérleg elkészítéséhez a földgázszállítási engedélyes a gáznapot követő nap 10:00 óráig átadja a földgáztárolási engedélyesnek a tárolói „0” pont mérések gáznapra vonatkozó napi összegzett mennyiségeit. Ugyanígy átadja a „0” ponti minőségmérő berendezéseken rögzített, gáznapra vonatkozó átlagos fűtőértéket, és a többi minőségi paramétert 8.5.3. szerint.
9.2.7.1 (b): A rendszerirányítási engedélyes a gázátadó állomás kilépési pontjaira (az elosztóhálózat betáplálási pontjaira) vonatkozó napi összesített mennyiségmérési adatait, a gáznap lezárását követően 10:00-ig átadja a földgázelosztási engedélyesnek.
Jelen adatszolgáltatás célja e kötelezettségek teljesítése szerver-szerver kommunikáció révén.
LEÍRÁS A csatlakozó rendszerüzemeltetők esetében csak azon („mérés típusú”) pontok jelennek meg, amelyek rendszerüknek a földgázszállítási rendszerrel való csatlakozását biztosítják.
SZEREPLŐK , SZEREPKÖRÖK
A kérés küldője: NNO
A kérés fogadója: a rendszerirányítási engedélyes (FGSZ)
A válasz küldője: a rendszerirányítási engedélyes (FGSZ)
A válasz fogadója: NNO
Informatikai Platform illeszkedési felület
FGSZ Zrt.
95/178
ÜTEMEZÉS , HATÁRIDŐK Az ÜKSZ fenti pontjai alapján a rendszerirányítási engedélyes a tárgy gáznapot követően 10 óráig szolgáltatja a szóbanforgó adatokat.
ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK A továbbiakban – miután az adatokat a rendszerüzemeltetők kérik – a kérésre adott, az FGSZ által küldött válaszüzenet szerkezete olvasható.
9.1. A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS OperativeTSODataService10H STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész – ld. 4.3.1
Tárgy gáznap – ld. 4.3.3
9.2. A VÁLASZT TARTALMAZÓ ÜZENET STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész – ld. 4.3.1
Tárgy gáznap – ld. 4.3.3
Kromatográf adatok
Hálózati pont adatok
KROMATOGRÁFOKON MÉRT ADATOK XML-BLOKKJÁNAK AZONOSÍTÓJA chromatographData allocationData
Informatikai Platform illeszkedési felület
FGSZ Zrt.
96/178 MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum típus
Kromatográf azonosítója
Kromatográf azonosítója
chromatographCode
xs:string
Mérési adat
A kromatográfot tekintve az adott gáznapra vonatkozó mérési adat. A mérési adat kategóriája (úgymint Wobbeszám, hexán mol%, stb.) az alábbi táblázat szerint kódolt módon jelenik meg. Maga a mért mennyiség az alábbi táblázat szerinti mértékegységben értelmezett.
measurement
Quantity
/
Kromatográfon mért adatok kategóriái és mértékegységei, és azok kódolása Kategória megnevezése
Kategória kódja (dimension címke)
Mértékegység
Mértékegység kódja (measureUnit címke)
Relatív sűrűség (0°C) Relatív sűrűség (15°C) Égéshő (25/0°C) Égéshő (15/15°C) Heptán Hexán Izobután Izopentán Neopentán Oktán Pentán Normál pentán Fűtőérték (25/0°C) Fűtőérték (15/15°C) Nitrogén Szén-dioxid
DN2 DN1 GCV GCV
(nincs mértékegység) (nincs mértékegység) 3 kWh/m
Z99 Z99 KW3 JM MOL MOL MOL MOL MOL MOL MOL MOL KW3 JM MOL MOL
HHP HHX HIB HIP HNP HOK HPE HPN
LCV LCV ZN ZQD
Informatikai Platform illeszkedési felület
MJ/m3 mol% mol% mol% mol% mol% mol% mol% mol% kWh/m3 MJ/m3 mol% mol%
FGSZ Zrt.
97/178
Propán Etán Metán Normál bután C6+ Wobbe-szám (25/0°C) Wobbe-szám (15/15°C) Szén tartalom (0°C) Szén tartalom (15°C)
ZQF ZQG ZQH ZQI ZQJ
ZWI ZWI C00 C15
mol% mol% mol% mol% mol% kWh/m3 MJ/m3 mol% mol%
MOL MOL MOL MOL MOL KW3 JM MOL MOL
PÉLDA
K-18-1 <measurement dimension="DN1" measureUnit="Z99">0,5678 ... <measurement dimension="ZWI" measureUnit="JM">50,1234 HÁLÓZATI PONTHOZ KÖTHETŐ ADATOK XML-BLOKKJÁNAK AZONOSÍTÓJA chromatographData allocationData
MEZŐK
Megnevezés
Leírás
XML címkenév
Pont kódja
Pont kódja
location
Pont megnevezése
Pont megnevezése
description
Csatlakozó rendszerüzemeltető kódja
A ponton csatlakozó rendszerüzemeltető kódja
operator
Mért mennyiség energiában
A ponton a tárgy gáznapon mért mennyiség kWh-ban. A mérési adat kategóriája az alábbi táblázat szerint kódolt módon jelenik meg. Maga a mért mennyiség az alábbi táblázat szerinti
measuredQuantity
Informatikai Platform illeszkedési felület
Formátum / típus
Quantity
FGSZ Zrt.
98/178 mértékegységben értelmezett. Kromatográf
A ponthoz rendelt kromatográf azonosítója
chromatograph
Hálózati ponton mért adatok kategóriái és mértékegységei, és azok kódolása Kategória megnevezése
Kategória kódja (dimension címke)
Mértékegység
Mértékegység kódja (measureUnit címke)
Térfogat (0°C) Térfogat (15°C) Energiamennyiség (25/0°C) Energiamennyiség (15/15°C)
V00 V15 E25 E15
m3 m3
MQ5 MQ5 KWH _3B
kWh
MJ
PÉLDA
VEKOBANY12GN <description>Kőbánya 2 OPERATORCODE <measuredQuantity dimension= "E25" measureUnit="KWH">300 <measuredQuantity dimension= "E15" measureUnit="_3B">9700 <measuredQuantity dimension= "V15" measureUnit="MQ5">278 <measuredQuantity dimension= "V00" measureUnit="MQ5">254 K-18-2
Informatikai Platform illeszkedési felület
FGSZ Zrt.
99/178
10. NAPI ALLOKÁLÁSI ADATOK RENDSZERÜZEMELTETŐK ÁLTALI BEKÜLDÉSE (ALLOCATIONSERVICE) ÜZLETI CÉL, KÖRNYEZET A napi operatív szállítórendszeri („14 órás”) adatszolgáltatás keretében az FGSZ a napi allokálás eredményét adja át a csatlakozó rendszerüzemeltetőknek. A rendszerüzemeltetők eme adatokból kiindulva adják vissza saját tényadataik alapján a tényleges allokálási adatokat. Cél, hogy ez utóbbi esetben a rendszerüzemeltetők allokálási adataikat szerver-szerver kapcsolat révén megadhassák. Vonatkozó jogszabályok:
ÜKSZ 10.3 (c) : A földgázszállítói engedélyes napon belüli allokált adatszolgáltatást nyújt a hozzáférésre jogosult számára kiegészítő szolgáltatásként az Üzletszabályzatban rögzített feltételekkel. Ennek az adatszolgáltatásnak az alapja a csatlakozó rendszerüzemeltetők által biztosított allokált adatok, vagy amennyiben ezeket a csatlakozó rendszerüzemeltető nem tudja biztosítani a földgázszállítói engedélyes számára, az adatszolgáltatás a leadott nominálások arányában felosztott órás méréseket tartalmazza.
ÜKSZ 8.4.1 (a) : A szállítórendszerhez csatlakozó rendszerüzemeltetők kötelesek minden gáznapot követő nap 12:00-ig allokálni a betáplálási pontokon mért mennyiségeket az egyes rendszerhasználókra.
ÜKSZ 8.4.2 (c) (iii) : amennyiben a csatlakozó rendszer üzemeltetője nem küldi meg az allokálást 12: 00 óráig a rendszerirányítási engedélyes részére, akkor az jogosult a gáznapra vonatkozó nominálás arányában felosztani a hozzáférésre jogosultak között a mennyiséget.
LEÍRÁS Jelen illeszkedési felület azt biztosítja, hogy a csatlakozó rendszerüzemeltetők adott gáznapra azon hálózati pontok vonatkozásában adhassák meg allokálási adataikat, amelyek rendszerüknek a földgázszállítási rendszerrel való csatlakozását biztosítják.
SZEREPLŐK , SZEREPKÖRÖK
A kérés küldője: NNO
A kérés fogadója: a rendszerirányítási engedélyes (FGSZ)
A válasz küldője: a rendszerirányítási engedélyes (FGSZ)
A válasz fogadója: NNO
Informatikai Platform illeszkedési felület
FGSZ Zrt.
100/178 ÜTEMEZÉS , HATÁRIDŐK Az ÜKSZ fenti pontjai alapján a rendszerirányítási engedélyes a tárgy gáznapot követően 12 óráig szolgáltatja a szóbanforgó adatokat.
ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK
10.1. A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS AllocationService STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész – ld. 4.3.1
Tárgy gáznap – ld. 4.3.3
Allokálási adat 1 (hálózati pont 1)
o
Hálózati pont 1-hez köthető adatok
o
Allokálási sor 1
o
Allokálási sor 2
Allokálási adat 2 (hálózati pont 2) o
Hálózati pont 2-höz köthető adatok
o
Allokálási sor 1
o
Allokálási sor 2
o
…
HÁLÓZATI PONTHOZ KÖTHETŐ ADATOK XML-BLOKKJÁNAK AZONOSÍTÓJA allocationData allocationLine allocationLine
Informatikai Platform illeszkedési felület
FGSZ Zrt.
101/178 MEZŐK
Megnevezés
Leírás
XML címkenév
Hálózati pont kódja
Hálózati pont kódja
location
Mért mennyiség
A hálózati ponton a tárgy gáznapon mért mennyiség kWh-ban (érdektelen; az IP mindenképpen a tárolt mért mennyiséget veszi alapul)
measuredQuantity
Formátum / típus
Quantity
PÉLDA
VEKOBANY12GN <measuredQuantity measureUnit="KWH">300 ... ...
ALLOKÁLÁSI SOROK XML-BLOKKJÁNAK AZONOSÍTÓJA allocationData allocationLine allocationLine
Informatikai Platform illeszkedési felület
FGSZ Zrt.
102/178 MEZŐK Megnevezés
Leírás
XML címkenév
Sorszám
Sorszám, az allokálási sor azonosítására szolgál – amennyiben egy allokálási sor valamely üzleti ellenőrzésen fennakad, a válaszban ezzel a sorszámmal történik az arra való hivatkozás.
lineNumber
Szállíttató
Szállíttató kódja
shipper
Party
Szállíttató pár
Szállíttató pár kódja
shipperPair
Party
Nominálási sor típusa
Nominálási sor típusa (NOM / BH / TRADE / OPT_POS / OPT_NEG / HEG_POS / HEG_NEG) – Csak az OBA számlaként szolgáló TRADE sorokra adható allokált érték. A HEG-ek csakolvashatók, az abban foglalt mennyiségeket a rendszer figyelmen kívül hagyja.
nominationKind
Opciós ár
Opciós (OPT_POS / OPT_NEG) sor esetén az opciós ár FT/kWh-ban, 4 tizedesjegy pontossággal. Ld. OPT_POS, OPT_NEG típusú nominálási
optionPrice
Informatikai Platform illeszkedési felület
Formátum típus
/
FGSZ Zrt.
103/178 sorok Nominált mennyiség
Az adott nominálási sorban foglalt nominálási mennyiség kWhban
dailyNominationQuantity
Quantity
Allokált mennyiség kWhban
Az adott nominálási sornak megfelelő allokált mennyiség kWh-ban
dailyAllocationQuantity
Quantity
PÉLDA
<shipper codingScheme="ZZZ">SHIPPERCODE1 <shipperPair codingScheme="ZZZ=">SHIPPERCODE2 5 12.1234 -452000 -200
10.2. A VÁLASZT TARTALMAZÓ ÜZENET LEÍRÁS Az allokálásra a fogadó szinkron módon minden esetben ad válaszüzenetet a web service visszatérési értékeként. Ebben a válaszban megjelenik az eredeti üzenetre való hivatkozás, és a feldolgozás eredménye. Sikertelen feldolgozás esetén a részletes hibaüzeneteket is magába foglalja a válasz. Az AllocationService első verziójától abban különbözik, hogy a hálózati pontra megadott mérést is összehasonlítja a rendszer által elvárttól. Csak ennek egyezése után ellenőrzi a megadott allokálási sorok egyensúlyának meglétét.
LOGIKAI SZERKEZET Az allokálásra való válaszüzenet logikai felépítése az alábbi:
Válaszüzenet azonosítója, létrehozásának dátuma, a válasz küldője. Ld. 4.3.1 pont.
Feldolgozás sikeres / sikertelen. Ld. 4.3.9 pont.
Eredeti üzenet fejrésze (azonosító, küldő, létrehozás dátuma) Ld. 4.3.8 pont.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
104/178
Hibaüzenet-sorok az alábbiak szerint (ld. 4.3.10 pont): o
Hivatkozott allokálási sor száma
o
Hibakód
o
Hibaüzenet (az azonosított-bejelentkezett felhasználóhoz az IP-ben beállított nyelven)
o
A hibaüzenethez tartozó további tájékoztatás (opcionális)
o
Vonatkozó hálózati pont
o
Szállíttató pár
Informatikai Platform illeszkedési felület
FGSZ Zrt.
HIBAÜZENETEK Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás Az opciós és KFRE tételek allokált mennyiségét állítsa az eredeti értékre.
Az opciós és KFRE tételek allokált mennyiségét nem lehet változtatni.
ERRORCODE_OPTION_SAVING
Opció és KFRE sorokat csak az FGSZ allokálhat!
Múltbeli gáznapra nem napközbeni allokálást.
ERRORCODE_INTERVAL_ON_GAS_DAY
Múltbeli gáznapon csak napi allokáláson engedhető meg művelet!
Az allokált mennyiségek csak egész számok lehetnek.
ERRORCODE_FLOATINGPOINT
Nem egész érték!
Az allokált mennyiségek összegének és a pont mért mennyiségének meg kell egyeznie.
ERRORCODE_UNBALANCED
Egyensúlytalan pont!
Korrigálja az mennyiségeket.
Az allokált különbözhet előjelétől.
ERRORCODE_SIGN_VIOLATION
Előjel hiba!
Módosítsa a hibás előjelet.
A megadott mért mennyiségnek egyeznie kell a hálózati pont mért mennyiségével.
ERRORCODE_WRONG_MEASURED_QUANTITY
Az import során megadott, hálózati ponton mért mennyiség nem egyezik meg a rendszerben lévő mért mennyiséggel!
Korrigálja a mért mennyiséget.
Csak az engedélyezett gáznapra adhat be allokálást.
ERRORCODE_INVALIDDATE
Érvénytelen dátum!
Módosítsa a értesítésben gáznapra.
adhat
meg
mennyiség előjele nem a nominált mennyiség
Informatikai Platform illeszkedési felület
FGSZ Zrt.
allokált
gáznapot az megadott
106/178 Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás
A beküldött allokálási soroknak meg kell egyezni a rendszerben lévő allokálási sorokkal az adott hálózati ponton.
ERRORCODE_INVALIDALLOCATIONLINE
Nem létező allokálási sor!
Csak a rendszerben lévő allokálási sorok mennyisége változtatható meg. Törölje a nem létező sort.
Csak az engedélyezett hálózati pontra adhat be allokálást.
ERRORCODE_INVALIDNETWORKPOINT
Nem a rendszerüzemeltetőhöz tartozó hálózati pont!
Módosítsa a hálózati pont kódot az értesítésben megadott hálózati pontok valamelyikére.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
11. HAVI ALLOKÁLÁSI ADATOK RENDSZERÜZEMELTETŐK ÁLTALI BEKÜLDÉSE (ALLOCATIONSERVICE)
ÜZLETI CÉL, KÖRNYEZET A havi allokálás keretében a szállítórendszerre csatlakozó üzemeltető köteles a havi allokálási adatokat megadni. A havi allokálás lényegében nem más, mint a gázhónap egyes napjaira történő újraallokálás. Vonatkozó jogszabályok:
ÜKSZ 8.4.2 (d): Csatlakozó vezetékrendszer üzemeltetője köteles legkésőbb a gázhónapot követő hónap 10-ig a rendszerirányítási engedélyes informatikai platformján és az általa kiadott formában cégszerűen aláírva, írásban a hozzáférésre jogosult allokált havi végleges mennyiséget megküldeni rendszerirányítási engedélyesnek.
LEÍRÁS Jelen illeszkedési felület egy az egyben azt biztosítja, mint a napi allokálást végző – azzal az eltéréssel, hogy egyetlen üzeneten belül a gázhónap összes gáznapjára vonatkozó allokálási adat megadható.
SZEREPLŐK , SZEREPKÖRÖK
A kérés küldője: NNO
A kérés fogadója: a rendszerirányítási engedélyes (FGSZ)
A válasz küldője: a rendszerirányítási engedélyes (FGSZ)
A válasz fogadója: NNO
ÜTEMEZÉS , HATÁRIDŐK Az ÜKSZ fenti pontja alapján a csatlakozó rendszerüzemeltető tárgy gázhónapot követő hónap 10-ig köteles a havi allokálási adatot megadni.
ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK A tárgy gázhónap valamennyi gáznapjára szükséges allokálási adatot megadni.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
108/178
11.1. A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS AllocationService (a napi allokálást kell hívni a hónap napjaira)
STRUKTÚRA, CÍMKÉK LEÍRÁSA Ld. Hiba! A hivatkozási forrás nem található. pont.
11.2. A VÁLASZT TARTALMAZÓ ÜZENET LEÍRÁS A havi allokálásra a fogadó szinkron módon minden esetben ad válaszüzenetet a web service visszatérési értékeként. Ebben a válaszban megjelenik az eredeti üzenetre való hivatkozás, és a feldolgozás eredménye. Sikertelen feldolgozás esetén a részletes hibaüzeneteket is magába foglalja a válasz. A havi allokálásra adott válaszüzenet szerkezete egy az egyben megegyezik a napi allokálásra adott válaszéval (ld. Hiba! A hivatkozási forrás nem található. alfejezet).
LOGIKAI SZERKEZET Az allokálásra való válaszüzenet logikai felépítése az alábbi:
Válaszüzenet azonosítója, létrehozásának dátuma, a válasz küldője. Ld. 4.3.1 pont.
Feldolgozás sikeres / sikertelen. Ld. 4.3.9 pont.
Eredeti üzenet fejrésze (azonosító, küldő, létrehozás dátuma) Ld. 4.3.8 pont.
Hibaüzenet-sorok az alábbiak szerint (ld. 4.3.10 pont): o
Hivatkozott allokálási sor száma
o
Hibakód
o
Hibaüzenet (az azonosított-bejelentkezett felhasználóhoz az IP-ben beállított nyelven)
o
A hibaüzenethez tartozó további tájékoztatás (opcionális)
o
Vonatkozó hálózati pont
o
Szállíttató pár
Informatikai Platform illeszkedési felület
FGSZ Zrt.
109/178 HIBAÜZENETEK Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás
Az opciós és KFRE tételek allokált mennyiségét nem lehet változtatni.
ERRORCODE_OPTION_SAVING
Opció és KFRE sorokat csak az FGSZ allokálhat!
Múltbeli gáznapra nem adhat meg napközbeni allokálást.
ERRORCODE_INTERVAL_ON_GAS_DAY
Múltbeli gáznapon csak engedhető meg művelet!
Az allokált mennyiségek csak egész számok lehetnek.
ERRORCODE_FLOATINGPOINT
Nem egész érték!
Az allokált mennyiségek összegének és a pont mért mennyiségének meg kell egyeznie.
ERRORCODE_UNBALANCED
Egyensúlytalan pont!
Korrigálja az mennyiségeket.
Az allokált mennyiség előjele nem különbözhet a nominált mennyiség előjelétől.
ERRORCODE_SIGN_VIOLATION
Előjel hiba!
Módosítsa a hibás előjelet.
A megadott mért mennyiségnek egyeznie kell a hálózati pont mért mennyiségével.
ERRORCODE_WRONG_MEASURED_QUANTITY
Az import során megadott, hálózati ponton mért mennyiség nem egyezik meg a rendszerben lévő mért mennyiséggel!
Korrigálja a mért mennyiséget.
Csak az engedélyezett gáznapra adhat be allokálást.
ERRORCODE_INVALIDDATE
Érvénytelen dátum!
Módosítsa a gáznapot az értesítésben megadott gáznapra.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
napi
Az opciós és KFRE tételek allokált mennyiségét állítsa az eredeti értékre.
allokáláson
allokált
110/178 Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás
A beküldött allokálási soroknak meg kell egyezni a rendszerben lévő allokálási sorokkal az adott hálózati ponton.
ERRORCODE_INVALIDALLOCATIONLINE
Nem létező allokálási sor!
Csak a rendszerben lévő allokálási sorok mennyisége változtatható meg. Törölje a nem létező sort.
Csak az engedélyezett hálózati pontra adhat be allokálást.
ERRORCODE_INVALIDNETWORKPOINT
Nem a rendszerüzemeltetőhöz tartozó hálózati pont!
Módosítsa a hálózati pont kódot az értesítésben megadott hálózati pontok valamelyikére.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
12. ALLOKÁLT ÓRACSÚCS ADATOK RENDSZERÜZEMELTETŐK ÁLTALI BEKÜLDÉSE (ALLOCATIONHOURLYPEAKSERVICE) ÜZLETI CÉL, KÖRNYEZET Ezen felülethez az FGSZ munkatársain kívül a csatlakozó rendszerüzemeltetők férhetnek hozzá, úgy hogy csak a saját hálózati pontjaikhoz adhatnak meg értékeket. A rendszerüzemeltetőknek az előző hónapra óracsúcs adatot kell szolgáltatniuk. Az óracsúcs adatszolgáltatás a havi allokációval egy időpontban indul. Vonatkozó jogszabályok: ÜKSZ 8.4.2.: A földgázszállító rendszerre órai lekötéssel rendelkező hozzáférésre jogosultak tekintetében a kapcsolódó rendszerüzemeltető köteles legalább a hó végi újraallokálása során, az Informatikai Platformon, valamint az írásos megerősítés során is a napi allokált mennyiségek mellett az egyes napokon a hozzáférésre jogosultakra vonatkozó óracsúcsot időpont megjelöléssel megadni a rendszerirányítási engedélyesnek. A hozzáférésre jogosult által ellátott fogyasztók számától függetlenül, hozzáférésre jogosultanként egy összesített adatként kell az óracsúcs megjelölést megadni.
LEÍRÁS Jelen illeszkedési felület azt biztosítja, hogy a csatlakozó rendszerüzemeltetők hálózati pontok, gáznapok és szállíttatók vonatkozásában adhassák meg allokálási adataik alapján, a gáznapon adott órában kapott legnagyobb allokált mennyiséget és magát az órai időpontot.
SZEREPLŐK , SZEREPKÖRÖK
A kérés küldője: NNO
A kérés fogadója: a rendszerirányítási engedélyes (FGSZ)
A válasz küldője: a rendszerirányítási engedélyes (FGSZ)
A válasz fogadója: NNO
ÜTEMEZÉS , HATÁRIDŐK Az ÜKSZ fenti pontjai alapján a rendszerirányítási engedélyes a hó végi újraallokálási ciklust megelőzően, minden hónap 5-én 00 órától 10-én 24 óráig biztosít lehetőséget a megelőző hónap óracsúcsainak allokálásra a rendszerüzemeltetők számára.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
112/178 ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK
12.1. A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS AllocationHourlyPeakService STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész – ld. 4.3.1
Allokált óracsúcs adat o
Allokált óracsúcs adatsor 1
o
Allokált óracsúcs adatsor 2
ÓRACSÚCS ADATOK XML-BLOKKJÁNAK AZONOSÍTÓJA allocationHourlyPeakData allocationHourlyPeakDataLine allocationHourlyPeakDataLine
MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum típus
Sorszám
Sorszám, mely az allokált óracsúcs adatsorok azonosítására szolgál – amennyiben egy adatsor valamely üzleti ellenőrzésen fennakad, a válaszban ezzel a sorszámmal történik az arra való hivatkozás.
lineNumber
Pozitív egész
Azon hálózati pont azonosítója, amellyel az adott hibaüzenet közvetlenül összefüggésbe hozható.
networkPoint
Location
Tágy gáznap
gasDay
xsd:date HH-NN)
Hálózati azonosítója
Tágy gáznap
pont
Informatikai Platform illeszkedési felület
/
(ÉÉÉÉ-
FGSZ Zrt.
113/178 Óracsúcs órája
Az adott napon kapott legnagyobb allokált mennyiség órája. Átlagos napon értéke 0 – 23 lehet. 25 órás napon 0 – 24. 23 órás napon 0 – 22. Értékét a gáznap kezdetétől (6:00) számítjuk.
peakHourOfGasDay
Pozitív egész
Allokált kWh-ban
Az adott óracsúcson kapott allokált mennyiség kWh-ban
hourlyPeakQuantity
Quantity
Szállíttató kódja
shipper
Party
mennyiség
Szállíttató PÉLDA
351 VETELJCS17EN 2009-02-01 9 peakHourOfGasDay> -37.0 <shipper codingScheme="ZZZ">TESTSHIPPER
12.2. A VÁLASZT TARTALMAZÓ ÜZENET LEÍRÁS Az allokált óracsúcs adatok elküldésére a fogadó szinkron módon minden esetben ad válaszüzenetet a web service visszatérési értékeként. Ebben a válaszban megjelenik az eredeti üzenetre való hivatkozás, és a feldolgozás eredménye. Sikertelen feldolgozás esetén a részletes hibaüzeneteket is magába foglalja a válasz. LOGIKAI SZERKEZET Az adatok küldésére érkező válaszüzenet logikai felépítése az alábbi:
Válaszüzenet azonosítója, létrehozásának dátuma, a válasz küldője. Ld. 4.3.1 pont.
Feldolgozás sikeres / sikertelen. Ld. 4.3.9 pont.
Eredeti üzenet fejrésze (azonosító, küldő, létrehozás dátuma) Ld. 4.3.8 pont.
Hibaüzenet-sorok az alábbiak szerint (ld. 4.3.10 pont): o
Hivatkozott sor száma
o
Hibakód
o
Hibaüzenet (az azonosított-bejelentkezett felhasználóhoz az IP-ben beállított nyelven)
Informatikai Platform illeszkedési felület
FGSZ Zrt.
114/178 Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás
A megadott adatszolgáltatás hiányosan lett beküldve.
AllocationHourlyPeak.Save.Error.MissingValue
Hiányzó érték!
Adj meg a hiányzó adatokat.
Csak az gáznapokra adatokat.
AllocationHourlyPeak.Save.Error.InvalidGasDay
Nem tölthet fel adatokat a megadott gáznapra!
Az értesítésben megadott időszakra adja meg az allokált óracsúcsokat.
A gáznap órájnak sorszámát 025 közötti számmal fogadja el a rendszer.
AllocationHourlyPeak.Save.Error.WrongHourValue
Az óra értéke nem megfelelő!
Korrigálja az órák sorszámát.
Az allokált óracsúcs mennyiségnek a napi allokált mennyiség és a napi mennyiség és a gáznap óráinak számából képzett hányados közzé kell esni.
AllocationHourlyPeak.Save.Error.WrongPeakValue
Az óracsúcs nem lehet nagyobb a napi allokált értéknél és kisebb annak 24ed (téli, nyári időszámítás váltásnál 25, 23-ad) részénél!
Korrigálja az allokált óracsúcs értékét.
Csak olyan szállíttató adható meg, akire történt allokáció is.
AllocationHourlyPeak.Save.Error.WrongShipper
Nem megfelelő szállíttató!
Javítsa a szállíttató kódját!
Csak az engedélyezett hálózati pontokra adhat meg adatokat.
AllocationHourlyPeak.Save.Error.InvalidNetworkUnit
Nem tölthet fel adatokat a megadott Hálózati ponthoz!
Az értesítésben megadott hálózati pontokra adja meg az allokált óracsúcsokat.
Az allokált mennyiségnek megfelelő előjellel kell megadni az óracsúcsot is.
AllocationHourlyPeak.Save.Error.WrongPeakValueForNU
Az óracsúcs érétke betáp ponton pozitív, kitáp ponton negatív kell legyen!
A pont irányának megfelelő előjelellel adja meg az allokált óracsúcsot.
engedélyezett adhat meg
Informatikai Platform illeszkedési felület
FGSZ Zrt.
115/178 Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás
Csak pozitív egész szám adjható meg méréssel igazolt mennyiségként.
AllocationHourlyPeak.Save.Error.WrongMeasureValueForNU
A méréssel igazolható mennyiség érétke pozitív egész szám kell legyen!
Korrigálja a mérési adat előjelét.
A méréssel igazolható mennyiség nem lehet nagyobb, mint az allokált óracsúcs.
AllocationHourlyPeak.Save.Error.MeasuredPeakValue
A méréssel igazolható mennyiség nem lehet nagyobb, mint az óracsúcs mennyisége!
Korrigálja a mérési adatot.
Csak a NOM típusú allokált óracsúcsok kerülenek letárolásra.
AllocationHourlyPeak.Save.Warning.NotSavedBH
A BH óracsúcsok mentésre!
Csak olyan allokált óracsúcs adható meg, amely szállíttatóra az adott ponton történt allokáció is.
AllocationHourlyPeak.Save.Error.WrongKey
Az adathoz nem tartozik allokálás!
Informatikai Platform illeszkedési felület
FGSZ Zrt.
nem
kerülnek
Törölje az adatszolgáltatásból az adott sort.
13. OPERATÍV MATCHING A
FEJEZETBEN DEFINIÁLT SZOLGÁLTATÁSOK CSAK
2015/2016
GÁZÉV ADATAINAK LEKÉRDEZÉSÉRE ÉS
BETÖLTÉSÉRE HASZNÁLHATÓAK!
13.1. NNO MATCHING ADATOK BEKÜLDÉSE (NNOMATCHINGINPUTSERVICE) ÜZLETI CÉL, KÖRNYEZET
A helyes és alkalmazható operatív matching adatok előállításához a csatlakozó rendszerüzemeltetőknek is biztosítaniuk kell mindazon nominálási adatot, amelyet a rendszerükön jelenlévő szállíttatók számukra nomináltak. Ezáltal válik lehetővé az, hogy az FGSZ-nél ill. a rendszerüzemeltetőknél nominált mennyiségek összevethetők legyenek. Az IP az NNO matching adatok beküldése révén teszi lehetővé a rendszerüzemeltetőknél nominált mennyiségek megadását.
LEÍRÁS
Jelen szolgáltatás lényegében az IP „Nominálás > Operatív matching adatok karbantartása” menüpontot biztosítja szerver-szerver kapcsolat formájában. Ez tehát azt jelenti, hogy a csatlakozó rendszerüzemeltető az „Operativ_matching” XLS-t XML üzenetformátumban, webservice hívása révén adja meg.
SZEREPLŐK , SZEREPKÖRÖK
A kérés küldője: NNO
A kérés fogadója: a rendszerirányítási engedélyes (FGSZ)
A válasz küldője: a rendszerirányítási engedélyes (FGSZ)
A válasz fogadója: NNO
ÜTEMEZÉS , HATÁRIDŐK A nominálásra vonatkozó határidők az NNO matching adatok beküldésére is érvényesek, azaz az aktuális és az azt követő 60 gáznapra fogad be a rendszer NNO nominálást. Az aktuális gáznapon beküldött nominálásnak csak a betöltés időpontját követő harmadik órától kezdődő és a gáznap végéig tartó tárgyidőszakra eső órai mennyiségei lesznek figyelembe véve.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
117/178 ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK A rendszerüzemeltető csak azon hálózati pontokra vonatkozóan küldhet be NNO matching adatot, amelyekkel a szállítórendszerhez a tárgy gáznapon csatlakozik. Az NNO matching adatokban foglalt mennyiségek előjeleire az alábbi táblázat érvényes: Hálózati pont jellege az FGSZ szemszögéből
Nominálási sor típusa - FGSZ
Előjel az NNO matching adatban
betáplálás
NOM BH OPT_POS OPT_NEG NOM BH OPT_POS
+ + + -
OPT_NEG
+
kiadás
Az NNO matching adatban minden soron meg kell adni szállíttató párt. Amennyiben az elküldött NNO matching adat valamilyen (pl. formátum szerinti) szempontból helytelen, úgy erről az IP válaszüzenetben ad tájékoztatást.
13.1.1 A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS NnoMatchingInputService STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész – ld. 4.3.1
Tárgy gáznap – ld. 4.3.3
1. NNO matching sor
2. NNO matching sor
…
AZ NNO MATCHING SOROK XML-BLOKKJÁNAK AZONOSÍTÓJA nnoMatchingLines
Informatikai Platform illeszkedési felület
FGSZ Zrt.
118/178
MEZŐK Megnevezés
Leírás
XML címkenév
Formátum / típus
Sorszám
Sorszám, mely az NNO matching sor azonosítására szolgál – amennyiben egy nominálási sor valamely üzleti ellenőrzésen fennakad, a válaszban ezzel a sorszámmal történik az arra való hivatkozás.
lineNumber
Pozitív egész
Hálózati pont
Hálózati pont (ld. 4.3.2)
networkPoint
Location
Szállíttató
A rendszerüzemeltető oldalán lévő szállíttató IP-beli azonosítója.
shipper
Party
Szállíttató pár
Az FGSZ oldalán lévő szállíttató IPbeli azonosítója. A teljes NNO matching adatban vagy minden sorban megjelenik, vagy egyikben sem.
shipperPair
Party
Nominálási sor típusa
Nominálási sor típusa (NOM / BH / OPT_POS / OPT_NEG)
nominationKind
Nominált órai mennyiség
A nominált órai mennyiség kWhban. Egész szám.
hourlyQuantity
Quantity
PÉLDA
1 VEKOBANY12GN <shipper codingScheme="ZZZ">SHIPPER <shipperPair codingScheme="ZZZ">SHIPPERPAIR 1 2000 … 24 3200
Informatikai Platform illeszkedési felület
FGSZ Zrt.
119/178
13.1.2 A VÁLASZT TARTALMAZÓ ÜZENET LEÍRÁS Az NNO matching adatok feltöltésére a fogadó szinkron módon minden esetben ad válaszüzenetet a web service visszatérési értékeként. Ebben a válaszban megjelenik az eredeti üzenetre való hivatkozás, és a feldolgozás eredménye. Sikertelen feldolgozás esetén a részletes hibaüzeneteket is magába foglalja a válasz.
LOGIKAI SZERKEZET Az NNO matching adat feltöltésére való válaszüzenet logikai felépítése az alábbi:
Válaszüzenet azonosítója, létrehozásának dátuma, a válasz küldője. Ld. 4.3.1 pont.
Feldolgozás sikeres / sikertelen. Ld. 4.3.9 pont.
Eredeti üzenet fejrésze (azonosító, küldő, létrehozás dátuma) Ld. 4.3.8 pont.
Hibaüzenet-sorok az alábbiak szerint (ld. 4.3.10 pont): o
Hivatkozott sor száma
o
Hibakód
o
Hibaüzenet (az azonosított-bejelentkezett felhasználóhoz az IP-ben beállított nyelven)
o
A hibaüzenethez tartozó további tájékoztatás (opcionális)
Informatikai Platform illeszkedési felület
FGSZ Zrt.
HIBAÜZENETEK Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás
A nominált mennyiségeket kWh/h mértékegységben kell megadni.
NnoNomination.Error.Wrong.MeasureUnit
Hibás mértékegység! Csak kWh/h-t fogad el a rendszer.
A gázóra 1 és 25 közzé eső egész szám lehet.
NnoNomination.Error.Invalid.GasHour
Hibás gázóra!
Ugyanabban a nominálási sorban azonos órára csak egyszer szerepelhet órai mennyiség.
NnoNomination.Error.Multiple.Quantities
Adott gázórához a mennyiség egynél többször megadva!
Törölje a mennyiséget.
Csak olyan hálózati pontra adható be nominálás, amely a nominálás folyamatban részt vesz.
NnoNomination.Error.InvalidNetworkUnit
A hálózati pontra nem adható be nominálás!
Amennyiben elírta a pont kódját, javítsa ki azt, különben értesítse a rendszeradmnisztrátort.
A nominálási sorban megadott szállíttató nem létezik.
NnoNomination.Error.InvalidShipper
Nem létező szállíttató!
Adjon meg érvényes partner kódot.
A nominálási sorban megadott szállíttató pár nem létezik.
NnoNomination.Error.InvalidShipperPair
Nem létező szállíttató pár!
Adjon meg érvényes partner kódot.
Kiadási ponton a NOM és OPT_NEG típusoknál pozitív, a BH és OPT_POS típusoknál negatív mennyiség adható meg.
NnoNomination.Error.InvalidSign.OutFlow
Az adott ponton a NOM típusú nominálásnál pozitív, OPT_NEG esetén pozitív, OPT_POS és BH nominálásnál csak negatív érték szerepelhet!
Informatikai Platform illeszkedési felület
FGSZ Zrt.
Javítsa a mértékegységet.
duplikált
órai
121/178 Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás
Betáplálási ponton a NOM és OPT_NEG típusoknál negatív, a BH és OPT_POS típusoknál pozitív mennyiség adható meg.
NnoNomination.Error.InvalidSign.InFlow
Az adott ponton a NOM típusú nominálásnál negatív, OPT_NEG és BH nominálásnál pozitív, OPT_POS esetén csak negatív érték szerepelhet!
Csak a betöltés pillanatában meghatározott tárgyidőszakra fogad be nominálási adatot a rendszer.
NnoNomination.Error.IgnoredHourlyItems
A {0} hálózati pontra csak a(z) {1}. órától kezdődően fogadta be a rendszer a mennyiségeket. Az ezt megelőző időszak mennyiségei már nem módosíthatóak!
A tárgyidőszak kezdetét megelőző gáznapra nem adható be nominálás.
NnoNomination.Error.AllHourlyItemsAreIgnore
A {0} hálózati pontra eltérő tárgyidőszak miatt a rendszer nem tudott befogani nominálást.
A rendszerüzemeltető csak a hozzárendelt hálózati pontokra adhat meg nominálásokat.
NnoNomination.Error.InvalidNetworkUnitForNno
A hálózati pontra nem adható be nominálás ezzel a rendszerüzemeltetővel!
A nominálási egyedinek kell lennie.
NnoNomination.Error.DuplicatedRow
Duplikált sor!
Csak NOM, BH, OPT_NEG és OPT_POS nominálás típus adható meg.
NnoNomination.Error.InvalidNominationType
Érvénytelen nominálás típus!
Az aktuális törölhetőek
NnoNomination.Error.DeletionNotAllowed
A
soroknak
gáznapon nem a korábban
Informatikai Platform illeszkedési felület
{0}
hálózati
FGSZ Zrt.
Adjon meg jövőbeli időszakot.
Törölje a felesleges sort.
pontra
rögzített
Minden korábban megadott nominálási sort szerepeltessen
122/178 Ellenőrzés
Hibaüzenet azonosítója
megadott nominálási sorok.
Hibaüzenet szövege nominálás már nem törölhető!
az adatszolgáltatásban. Adja meg az óra azonosítóját.
Az órai mennyiségek megadása kötelező.
NnoNomination.Error.EmptyNominationItem
Nominálási sor nem rögzíthető órai érték nélkül!
Az aktuális gáznapra korábban rögzített nominálási sorok nem törölhetőek csak a mennyiség módosulhat.
NnoNomination.Error.UnacceptedChangesOnActualGasday
Aktuális gáznapon a mennyiségen kívül más már nem módosítható!
A tárgyidőszak minden órájára kötelező megadni a nominálást.
NnoNomination.Error.MissingHourlyValueInTargetPeriod
A tárgyidőszak minden órájára kötelező az órai nominálás megadása!
Informatikai Platform illeszkedési felület
Megoldás
FGSZ Zrt.
Pótolja a hiányzó nominálási sort.
13.2. OPERATÍV MATCHING EREDMÉNYÉNEK LEKÉRDEZÉSE (OPERATIVEMATCHINGRESULT) ÜZLETI CÉL, KÖRNYEZET
Miután az operatív matching feldolgozás lefutott, a csatlakozó rendszerüzemeltető lekérdezheti annak eredményét.
LEÍRÁS
A lekérdezés operatív matching eljárással ellenőrzött hálózati pontok rendszerüzemeltetői részére került kialakításra, a matching eljárás eredményének lekérdezésére. A szolgáltatás jelenleg csak a rendszerhasználók által már nem módosítható, tény nominálások egyeztetésének eredményét adja vissza, azaz az aktuális időpontot követő teljes órára vonatkozót. Amennyiben a lekérdezést egy megbízott szállíttató kezdeményezi, úgy az üzenet fejrészének „sender” tagjában kell meghatároznia a tárgy szállíttatót (a jogosultságot a rendszer a webservice hívásakor alkalmazott tanúsítvány alapján határozza meg).
SZEREPLŐK , SZEREPKÖRÖK
A kérés küldője: a szállíttató v. NNO
A kérés fogadója: a rendszerirányítási engedélyes (FGSZ)
A válasz küldője: a rendszerirányítási engedélyes (FGSZ)
A válasz fogadója: a szállíttató v. NNO
ÜTEMEZÉS , HATÁRIDŐK A partner az operatív matching eredményét bármikor lekérdezheti. Az operatív matching feldolgozás előre ütemezett módon óránként történik, illeszkedve az órai nominálás folyamatába, mindig az aktuális és a következő gáznapra vonatkozóan.
ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK A továbbiakban – miután az adatokat a rendszerüzemeltetők ill. hozzáférésre jogosultak kérik – a kérésre adott, az FGSZ által küldött válaszüzenet szerkezete olvasható.
13.2.1 A KÉRÉST TARTALMAZÓ ÜZENET
Informatikai Platform illeszkedési felület
FGSZ Zrt.
124/178 METÓDUS OperativeMatchingResult STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész – ld. 4.3.1
Tárgy gáznap – ld. 4.3.3
Tárgy gázóra - ld. 4.3.44.3.3
13.2.2 A VÁLASZT TARTALMAZÓ ÜZENET STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész – ld. 4.3.1
A feldolgozás sikeressége – ld. 4.3.9
Eredeti üzenet adatai – ld. 4.3.8
Hibakezelés – ld. 4.3.10
Hálózati pont 1-re vonatkozó NNO matching adatok
o
Hálózati pont 1-hez köthető adatok
o
NNO matching sor 1
o
NNO matching sor 2
Hálózati pont 2-re vonatkozó NNO matching adatok o
Hálózati pont 2-höz köthető adatok
o
NNO matching sor 3
o
NNO matching sor 4
...
HÁLÓZATI PONTHOZ KÖTHETŐ ADATOK XML-BLOKKJÁNAK AZONOSÍTÓJA networkUnitData
Informatikai Platform illeszkedési felület
FGSZ Zrt.
125/178 MEZŐK
Megnevezés
Leírás
XML címkenév
Hálózati pont kódja
Hálózati pont kódja
value
Csatlakozó rendszerüzemeltető kódja
Azon rendszer üzemeltetőjének kódja, amelyhez a földgázszállítási rendszer az adott hálózati pont révén csatlakozik (az NNO matching adatok csatlakozó rendszerüzemeltető általi lekérdezése esetén ennek a mezőnek az értéke minden sorban azonos)
operator
Formátum / típus
Party
PÉLDA
KAABA00011GN TESTNNO <nominationLine> …
NNO MATCHING SOR XML-BLOKKJÁNAK AZONOSÍTÓJA nominationLine
MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Átadó kódja
Azon szállíttató kódja, amely az adott hálózati ponton a földgázt átadja.
deliverer
Party
Informatikai Platform illeszkedési felület
FGSZ Zrt.
126/178 Átvevő kódja
Azon szállíttató kódja, amely az adott hálózati ponton a földgázt átveszi.
recipient
Nominálási sor típusa (NOM / BH / OPT_POS / OPT_NEG / HEG_POS / HEG_NEG)
nominationKind
Gázóra
A lekérdezett gázóra (1 25)
gasHour
Matching eredmény státusza
A lekérdezett eredmény véglegességét jelző mező. A jövőre vonatkozó adatok még változhatnak. (UNALTERABLE / ALTERABLE)
nominationLineState
FGSZ-nél nominált mennyiség
A hálózati ponton jelenlévő FGSZ oldali szállíttató által az FGSZnél nominált mennyiség.
nominatedFGSZQuantity
Quantity
Csatlakozó rendszerüzemeltető nominált mennyiség
A csatlakozó rendszerüzemeltető által az NNO matching adatban megadott mennyiség kWh-ban.
nominatedNNOQuantity
Quantity
A matching erdménye
A matching eljárás eredménye. Az eljárás, a beállításoknak megfelelően, lehet kisebb elv, FGSZ elsőbbség vagy NNO elsőbbség.
matchingResultQuantity
Quantity
Állapot
Matching állapot. Match / mismatch : egyezés / eltérés. Ha a csatlakozó rendszerüzemeltető az NNO matching adatban üresen hagyta a szállíttató párt, akkor ez a mező csak összegző
matchingState
MATCH / QUANTITY_MISMATCH / NO_FRI_DATA / NO_NNO_MATCHING_D ATA
Nominálási típusa
sor
által
Informatikai Platform illeszkedési felület
Party
xsd:integer
FGSZ Zrt.
127/178 sorban jelenik meg.
MATCH: Egyezés
QUANTITY_MISMAT CH: Mennyiségi eltérés
NO_FRI_DATA: Az adott NNO matching sorral nincs egyeztethető FGSZ oldali nominálási sor
NO_NNO_MATCHIN G_DATA: Az adott FGSZ oldali nominálási sorhoz nincs egyeztethető NNO matching sor
PÉLDA
<nominationLine> <deliverer codingScheme="ZZZ">HUFTEST1 HUFTEST2 <nominationKind>NOM 3 <nominationLineState>UNALTERABLE <nominatedFGSZQuantity codingScheme="KW1">-213450 <nominatedNNOQuantity codingScheme="KW1">-245360 <matchingResultQuantity codingScheme="KW1">-213450 <matchingState>QUANTITY_MISMATCH
Informatikai Platform illeszkedési felület
FGSZ Zrt.
128/178
14. MATCHING A
FEJEZETBEN DEFINIÁLT SZOLGÁLTATÁSOK CSAK
2016/2017
ÉS AZ EZT KÖVETŐ GÁZÉVEK ADATAINAK
LEKÉRDEZÉSÉRE ÉS BETÖLTÉSÉRE HASZNÁLHATÓAK!
14.1. NNO MATCHING ADATOK BEKÜLDÉSE (SAVEDELIVERYORDER) ÜZLETI CÉL, KÖRNYEZET
A helyes és alkalmazható matching adatok előállításához a csatlakozó rendszerüzemeltetőknek is biztosítaniuk kell mindazon nominálási adatot, amelyet a rendszerükön jelenlévő szállíttatók számukra nomináltak. Ezáltal válik lehetővé az, hogy az FGSZ-nél ill. a rendszerüzemeltetőknél nominált mennyiségek összevethetők legyenek. Az IP az NNO matching adatok beküldése révén teszi lehetővé a rendszerüzemeltetőknél nominált mennyiségek megadását.
LEÍRÁS
Jelen szolgáltatás lényegében az IP „Nominálás > Matching adatok karbantartása” menüpontot biztosítja szerver-szerver kapcsolat formájában.
SZEREPLŐK , SZEREPKÖRÖK
A kérés küldője: NNO
A kérés fogadója: a rendszerirányítási engedélyes (FGSZ)
A válasz küldője: a rendszerirányítási engedélyes (FGSZ)
A válasz fogadója: NNO
ÜTEMEZÉS , HATÁRIDŐK A nominálásra vonatkozó határidők az NNO matching adatok beküldésére is érvényesek, azaz az aktuális és az azt követő 60 gáznapra fogad be a rendszer NNO nominálást. Az aktuális gáznapon beküldött nominálásnak csak a betöltés időpontját követő harmadik órától kezdődő és a gáznap végéig tartó tárgyidőszakra eső órai mennyiségei lesznek figyelembe véve.
14.1.1 A KÉRÉST TARTALMAZÓ ÜZENET
Informatikai Platform illeszkedési felület
FGSZ Zrt.
129/178 METÓDUS SaveDeliveryOrder STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
EDIG@S fejrész
Hálózati pont o
Nominálási sor
Adat eredete
Nominált mennyiség
Fejrészből csak egy lehet, de Hálózati pont blokkból több is. A hálózati pont alatt lévő egymásba ágyazott struktúra is ismétlődhet. AZ EDIG@S FEJRÉSZ MEZŐI
Megnevezés
Leírás
XML címkenév
Formátum / típus
Sorszám
Sorszám, mely a beküldött nominálás egyedi azonosítója. Ez az azonosító az adott időszakra érvényes állandó érték.
identification
xsd:string
Verzió
Az adott időszakra benyújtott nominálás verziója.
version
xsd:integer
Dokumentum típus
A nominálás benyújtásra vonatkozó típus azonosító. Értéke minden esetben 26G.
type
xsd:string
Időbélyeg
A beküldött nominálás létrehozásának időpontja UTCben megadva.
creationDateTime
yyyy-mmddThh:mm:ssZ
Tárgyidőszak
A beadott nominálás vonatkozási időszaka. Ez egy gáznap lehet, a kezdeti időpontjával (óra és perc) és a záró időpontjával megadva UTC-ben.
validityPeriod
yyyy-mm-ddThh:mmZ/ yyyy-mm-ddThh:mmZ
A
A beküldő partner EIC kódja. A
issuer
xsd:string
beküldő
Informatikai Platform illeszkedési felület
max. 3 karakter
FGSZ Zrt.
130/178 partner
kódolási séma azonosítója 305.
_MarketParticipant.identification
A beküldő partner típusa
A partner típusának EDIG@S azonosítója. Ennek értéke mindig ZSO.
issuer _MarketParticipant.role.code
A fogadó partner
A fogadó partner EIC kódja. A kódolási séma azonosítója 305.
recipient _MarketParticipant.identification
xsd:string
A fogadó partner típusa
A partner típusának EDIG@S azonosítója. Ennek értéke mindig ZSO.
recipient _MarketParticipant.role.code
xsd:string
xsd:string max. 3 karakter
max. 3 karakter
PÉLDA
1234ABCD 999 26G 2001-12-17T09:30:47Z 2016-07-30T04:00Z/2016-07-31T04:00Z NNOEIC ZSO 21X-HU-A-A0A0A-8 ZSO A HÁLÓZATI PONT XML-BLOKKJÁNAK AZONOSÍTÓJA ConnectionPoint MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Hálózati pont azonosító
A hálózati pont EIC kódja. A kódolási séma azonosítója 305.
identification
xsd:string
Mértékegység
A nominált mennység mértékegysége. Értéke mindig KW1, ami kWh/h kódja.
measureUnit.code
xsd:string
Informatikai Platform illeszkedési felület
max. 3 karakter
FGSZ Zrt.
131/178 A NOMINÁLÁSI SOR XML-BLOKKJÁNAK AZONOSÍTÓJA Account MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Szállíttató
A nominálás szállíttatójának IP-beli kódja. A kódolási séma azonosítója ZSO.
internalAccount
xsd:string
Szállíttató pár
A nominálás szállíttató párjának IPbeli kódja. A kódolási séma azonosítója ZSO.
externalAccount
xsd:string
AZ ADAT EREDETE XML-BLOKKJÁNAK AZONOSÍTÓJA InformationOrigin_TimeSeries MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Típus
Az adat feldolgozottságának státusza a nominálás folyamatában.
type
xsd:string max. 3 karakter
A rendszerüzemeltető által feldolgozott, megszakítás eredményével módosított nominálás – 14G
A NOMINÁLT MENNYISÉG XML-BLOKKJÁNAK AZONOSÍTÓJA Period MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Időszak
Az órai mennyiség vonatkozási időszaka. Ez mindig csak egy órás időszak lehet. Megadása UTC idővel.
timeInterval
yyyy-mm-ddThh:mmZ/ yyyy-mm-ddThh:mmZ
Informatikai Platform illeszkedési felület
FGSZ Zrt.
132/178 Nominálás iránya
Mennyiség
A nominált mennyiség iránya:
kiadási irány – Z03
betáplálási irány – Z02
A nominált mennyiség kWh/h-ban kifejezve. Értéke pozitív egész szám lehet.
direction.code
xsd:string max. 3 karakter
quantity.amount
xsd:integer
PÉLDA
21Z000000000003C <measureUnit.code>KW1 HUFSHP_A <externalAccount codingScheme="ZSO">HUFSHP_B 14G 2016-07-30T04:00Z/2016-07-30T05:00Z Z02 234000 … 2016-07-31T03:00Z/2016-07-31T04:00Z Z02 245300
14.1.2 A VÁLASZT TARTALMAZÓ ÜZENET LEÍRÁS Az NNO matching adatok feltöltésére a fogadó szinkron módon minden esetben ad válaszüzenetet a web service visszatérési értékeként. Ebben a válaszban megjelenik az eredeti üzenetre való hivatkozás, és a feldolgozás eredménye. Sikertelen feldolgozás esetén a részletes hibaüzeneteket is magába foglalja a válasz. LOGIKAI SZERKEZET A nominálásra való válaszüzenet logikai felépítése az alábbi:
Feldolgozás sikeres / sikertelen. Ld. 4.3.9 pont.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
133/178
Hibaüzenet-sorok az alábbiak szerint: o
Adatstruktúrára vonatkozó hibakód
o
Adatstruktúrára vonatkozó hibaleírás
o
Hálózati pont kód
Nominálási adatra vonatkozó hibakód
Nominálási adatra vonatkozó hibaleírás
MEZŐK Megnevezés
Leírás
XML címkenév
Formátum / típus
Adatstruktúrára vonatkozó hibakód
A beküldött adatstruktúrára vonatkozó, de nem nominálási sorhoz köthető hibakód.
generalErrorCode
xs:string
Adatstruktúrára vonatkozó hibaleírás
A beküldött adatstruktúrára vonatkozó, de nem nominálási sorhoz köthető hibaleírás.
generalErrorText
xs:string
Hálózati kód
A hibás nominálási sor hálzati pontjának azonosítója.
connctionPointError.connectionPoint
xs:string
Nominálási adatra vonatkozó hibakód
A hálózati pont kóddal azonosított nominálási sorokra vonakozó hibakód.
connctionPointError.error.Code
xs:string
Nominálási adatra vonatkozó hibaleírás
A hálózati pont kóddal azonosított nominálási sorokra vonakozó hibaleírás.
connctionPointError.error.Text
xs:string
pont
PÉLDA
<success>true Nomination.Error.ExistingDocumentVersion A megadott dokumentum azonosítóval és verzióval már létezik a rendszerben nominálási adat 21Z000000000003C <error> Nomination.Error.Business.100
Informatikai Platform illeszkedési felület
FGSZ Zrt.
134/178 Erre a hálózati pontra nem rendelkezik kapacitásszerződéssel!
Informatikai Platform illeszkedési felület
FGSZ Zrt.
HIBAÜZENETEK Ellenőrzés A dokumentum ellenőrzése
Hibaüzenet azonosítója verziójának
Hibaüzenet szövege
Megoldás
NnoNomination.Error.ExistingDocumentVersion
A megadott dokumentum azonosítóval és verzióval már létezik a rendszerben nominálási adat
Növelje a verzió számát!
A nominálási sorban megadott szállíttató nem létezik.
NnoNomination.Error.InvalidShipper
Nem létező szállíttató!
Adjon meg érvényes partner kódot.
A nominálási sorban megadott szállíttató pár nem létezik.
NnoNomination.Error.InvalidShipperPair
Nem létező szállíttató pár!
Adjon meg érvényes partner kódot.
A megadott hálózati pont kód nem létezik.
NnoNomination.Error.InvalidConnectionPoint
Nem létező hálózati pont!
Adjon meg érvényes hálózati pont kódot.
A nominálás folyamatában meghatározott tárgyidőszak kezdetét megelőző gáznapra nem adható be nominálás.
NnoNomination.Error.AllHourlyItemsAreIgnore
A {0} hálózati pontra eltérő tárgyidőszak miatt a rendszer nem tudott befogani nominálást.
Adjon meg jövőbeli időszakot.
A rendszerüzemeltető csak a hozzárendelt hálózati pontokra adhat meg nominálásokat.
NnoNomination.Error.InvalidNetworkUnitForNno
A hálózati pontra nem adható be nominálás ezzel a rendszerüzemeltetővel!
Csak olyan hálózati pontra adható be nominálás, amely a nominálás folyamatban részt vesz.
NnoNomination.Error.InvalidNetworkUnit
A hálózati pontra nem adható be nominálás!
Informatikai Platform illeszkedési felület
FGSZ Zrt.
Amennyiben elírta a pont kódját, javítsa ki azt, különben értesítse a rendszeradmnisztrátort.
136/178 Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás
A nominált mennyiség időszakának ellenőrzése a megadott tárgyidőszakhoz.
NnoNomination.Error.InvalidGasHour
A nominált mennyiséghez megadott időszaknak bele kell esnie a megadott tárgyidőszakba!
Korrigálja a nominált mennyiség időszakát vagy a tárgyidőszakot!
Ugyanabban a nominálási sorban azonos órára csak egyszer szerepelhet órai mennyiség.
NnoNomination.Error.MultipleQuantities
Adott gázórához a mennyiség egynél többször megadva!
Törölje a mennyiséget.
A nominált mennyiség pozitív egész szám lehet.
NnoNomination.Error.QuantityValidation
A nominált mennyiség csak pozitív egész szám lehet!
Csak a betöltés pillanatában meghatározott tárgyidőszakra fogad be nominálási adatot a rendszer.
NnoNomination.Error.IgnoredHourlyItems
A {0} hálózati pontra csak a(z) {1}. órától kezdődően fogadta be a rendszer a mennyiségeket. Az ezt megelőző időszak mennyiségei már nem módosíthatóak!
A nominálási egyedinek kell lennie.
NnoNomination.Error.DuplicatedRow
Duplikált sor!
Törölje a felesleges sort.
Az aktuális gáznapon nem törölhetőek a korábban megadott nominálási sorok.
NnoNomination.Error.DeletionNotAllowed
A {0} hálózati pontra rögzített nominálás már nem törölhető!
Minden korábban megadott nominálási sort szerepeltessen az adatszolgáltatásban.
Az aktuális gáznapra korábban rögzített nominálási sorok nem törölhetőek csak a mennyiség módosulhat.
NnoNomination.Error.UnacceptedChangesOnActualGasday
Aktuális gáznapon a mennyiségen kívül más már nem módosítható!
soroknak
Informatikai Platform illeszkedési felület
FGSZ Zrt.
duplikált
órai
137/178 Ellenőrzés A tárgyidőszak minden órájára kötelező megadni a nominálást.
Hibaüzenet azonosítója NnoNomination.Error.MissingHourlyValueInTargetPeriod
Informatikai Platform illeszkedési felület
Hibaüzenet szövege
Megoldás
A megadott tárgyidőszak alapján meghatározott gáznapok még nominálható óráira kötelező az órai nominálás megadása a lekötött kapacitás irányainak megfelelően!
Pótolja a hiányzó nominálási sort.
FGSZ Zrt.
14.2. MATCHING EREDMÉNYÉNEK LEKÉRDEZÉSE (GETDELIVERYRESPONSE) ÜZLETI CÉL, KÖRNYEZET
Miután a matching feldolgozás lefutott, a csatlakozó rendszerüzemeltető lekérdezheti annak eredményét.
LEÍRÁS
A lekérdezés a matching eljárással ellenőrzött hálózati pontok rendszerüzemeltetői részére került kialakításra, a matching eljárás eredményének lekérdezésére. A szolgáltatás a megadott gáznapra, a megadott rendszerüzemeltető hálózati pontjaira adja vissza a matching eredményét az EDIG@S által definiált DELRES dokumentum formátumában. Amennyiben a lekérdezést egy megbízott szállíttató kezdeményezi, úgy az üzenet fejrészének „sender” tagjában kell meghatároznia a tárgy szállíttatót (a jogosultságot a rendszer a webservice hívásakor alkalmazott tanúsítvány alapján határozza meg).
SZEREPLŐK , SZEREPKÖRÖK
A kérés küldője: a szállíttató v. NNO
A kérés fogadója: a rendszerirányítási engedélyes (FGSZ)
A válasz küldője: a rendszerirányítási engedélyes (FGSZ)
A válasz fogadója: a szállíttató v. NNO
ÜTEMEZÉS , HATÁRIDŐK A partner az operatív matching eredményét bármikor lekérdezheti. Az operatív matching feldolgozás előre ütemezett módon óránként történik, illeszkedve az órai nominálás folyamatába, mindig az aktuális és a következő gáznapra vonatkozóan.
ÜZLETI FELTÉTELRENDSZER , MEGSZORÍTÁSOK A továbbiakban – miután az adatokat a rendszerüzemeltetők ill. hozzáférésre jogosultak kérik – a kérésre adott, az FGSZ által küldött válaszüzenet szerkezete olvasható.
14.2.1 A KÉRÉST TARTALMAZÓ ÜZENET
Informatikai Platform illeszkedési felület
FGSZ Zrt.
139/178 METÓDUS GetDeliveryResponse STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Tárgy gáznap – ld. 4.3.3
A korábban feltöltött rendszerüzemeltetői nominálás azonosítója
A korábban feltöltött rendszerüzemeltetői nominálás verziója
PÉLDA
<subjectGasDay>2016-07-15 <matching_Document. identification>1234ABCD <matching_Document. version>999
14.2.2 A VÁLASZT TARTALMAZÓ ÜZENET STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
A feldolgozás sikeressége – ld. 4.3.9
Hibaüzenet-sorok az alábbiak szerint:
o
Adatstruktúrára vonatkozó hibakód
o
Adatstruktúrára vonatkozó hibaleírás
Matching eredmények
A HIBAÜZENET ADATOK XML-BLOKKJÁNAK MEZŐI Megnevezés
Leírás
XML címkenév
Formátum / típus
Adatstruktúrára vonatkozó hibakód
A beküldött adatstruktúrára vonatkozó, de nem nominálási sorhoz köthető hibakód.
generalErrorCode
xs:string
Adatstruktúrára vonatkozó hibaleírás
A beküldött adatstruktúrára vonatkozó, de nem nominálási sorhoz köthető hibaleírás.
generalErrorText
xs:string
Informatikai Platform illeszkedési felület
FGSZ Zrt.
140/178 PÉLDA
<success>true Application.Error.AccessDenied Ehhez a művelethez nincs joga! A MATCHING EREDMÉNYEKHEZ KÖTHETŐ ADATOK XML-BLOKKJÁNAK AZONOSÍTÓJA DeliveryResponseDocument STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
EDIG@S fejrész
Hálózati pont o
Nominálási sor
Adat eredete
Nominált mennyiség o
Matching státusz
Fejrészből csak egy lehet, de Hálózati pont blokkból több is. A hálózati pont alatt lévő egymásba ágyazott struktúra is ismétlődhet. AZ EDIG@S FEJRÉSZ MEZŐI
Megnevezés
Leírás
XML címkenév
Formátum / típus
Sorszám
Sorszám, mely a beküldött nominálás egyedi azonosítója. Ez az azonosító az adott időszakra érvényes állandó érték.
identification
xsd:string
Verzió
Az adott időszakra nominálás verziója.
version
xsd:integer
Dokumentum típus
A nominálás benyújtásra vonatkozó típus azonosító. Értéke minden esetben 27G.
type
xsd:string
Időbélyeg
A beküldött nominálás létrehozásának időpontja UTC-ben megadva.
creationDateTime
yyyy-mm-ddThh:mm:ssZ
Tárgyidőszak
A beadott nominálás vonatkozási
validityPeriod
yyyy-mm-ddThh:mmZ/
benyújtott
Informatikai Platform illeszkedési felület
max. 3 karakter
FGSZ Zrt.
141/178 időszaka. Ez egy gáznap lehet, a kezdeti időpontjával (óra és perc) és a záró időpontjával megadva UTC-ben.
yyyy-mm-ddThh:mmZ
A beküldő partner
A beküldő partner EIC kódja. A kódolási séma azonosítója 305.
issuer.identification
xsd:string
A beküldő partner típusa
A partner típusának EDIG@S azonosítója. Ennek értéke mindig ZSO.
issuer.role.code
xsd:string
A fogadó partner
A fogadó partner EIC kódja. A kódolási séma azonosítója 305.
recipient.identification
xsd:string
A fogadó partner típusa
A partner típusának EDIG@S azonosítója. Ennek értéke mindig ZSO.
recipient.role.code
xsd:string
NNO nominálás
A matching alapját képező NNO nominálás azonosítója.
delord.identification
xsd:string
NNO nominálás verzió
A matching alapját képező NNO nominálás verziója.
delord.version
xsd:integer
max. 3 karakter
max. 3 karakter
PÉLDA
1234ABCD 999 27G 2001-12-17T09:30:47Z 2016-07-30T04:00Z/2016-07-31T04:00Z 21X-HU-A-A0A0A-8 ZSO NNOEIC ZSO <matching_Document.identification>1234ABCD <matching_Document.version>999 A HÁLÓZATI PONT XML-BLOKKJÁNAK AZONOSÍTÓJA ConnectionPoint MEZŐK
Informatikai Platform illeszkedési felület
FGSZ Zrt.
142/178 Megnevezés
Leírás
XML címkenév
Formátum / típus
Hálózati pont azonosító
A hálózati pont EIC kódja. A kódolási séma azonosítója 305.
identification
xsd:string
Mértékegység
A nominált mennység mértékegysége. Értéke mindig KW1, ami kWh/h kódja.
measureUnit.code
xsd:string max. 3 karakter
A NOMINÁLÁSI SOR XML-BLOKKJÁNAK AZONOSÍTÓJA Account MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Szállíttató
A nominálás szállíttatójának IP-beli kódja. A kódolási séma azonosítója ZSO.
internalAccount
xsd:string
Szállíttató pár
A nominálás szállíttató párjának IPbeli kódja. A kódolási séma azonosítója ZSO.
externalAccount
xsd:string
AZ ADAT EREDETE XML-BLOKKJÁNAK AZONOSÍTÓJA InformationOrigin_TimeSeries MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Típus
Az adat feldolgozottságának státusza a nominálás folyamatában. Visszaigazolt – 16G
type
xsd:string max. 3 karakter
A NOMINÁLT MENNYISÉG XML-BLOKKJÁNAK AZONOSÍTÓJA Period MEZŐK
Informatikai Platform illeszkedési felület
FGSZ Zrt.
143/178 Megnevezés
Leírás
XML címkenév
Formátum / típus
Időszak
Az órai mennyiség vonatkozási időszaka. Ez mindig csak egy órás időszak lehet. Megadása UTC idővel.
timeInterval
yyyy-mm-ddThh:mmZ/ yyyy-mm-ddThh:mmZ
Nominálás iránya
A nominált mennyiség iránya:
direction.code
xsd:string
Mennyiség
kiadási irány – Z03
betáplálási irány – Z02
A nominált mennyiség kWh/h-ban kifejezve. Értéke pozitív egész szám lehet.
max. 3 karakter total_Quantity.amount
xsd:integer
A MATCHING STÁTUSZ XML-BLOKKJÁNAK AZONOSÍTÓJA Status MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Státusz kód
A matching eredményének státusza az adott mennyiségre vonatkozóan.
code
xsd:string
A matching kiegészítése
reason.text
Szöveges kiegészítés
státusz
szöveges
max. 3 karakter xsd:string max. 512 karakter
PÉLDA
21Z000000000003C <measureUnit.code>KW1 HUFSHP_A <externalAccount codingScheme="ZSO">HUFSHP_B 16G 2016-07-30T04:00Z/2016-07-30T05:00Z Z02 234000
Informatikai Platform illeszkedési felület
FGSZ Zrt.
144/178
<Status> 06G
Quantity mismatch … 2016-07-31T03:00Z/2016-07-31T04:00Z Z02 245300 <Status> 06G
Quantity mismatch
Informatikai Platform illeszkedési felület
FGSZ Zrt.
145/178
15. ALAPADATOK LEKÉRDEZÉSE 15.1. HÁLÓZATI PONTOK LEKÉRDEZÉSE (GETVALIDNETWORKUNITCODE) ÜZLETI CÉL, KÖRNYEZET A partnerek lekérhetik az adott gáznapra érvényes hálózati pontok listáját.
SZEREPLŐK , SZEREPKÖRÖK
A kérés küldője: a szállíttató v. NNO
A kérés fogadója: a rendszerirányítási engedélyes (FGSZ)
A válasz küldője: a rendszerirányítási engedélyes (FGSZ)
A válasz fogadója: a szállíttató v. NNO
ÜTEMEZÉS , HATÁRIDŐK A partner a hálózati pontok listáját bármikor lekérdezheti.
15.1.1 A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS GetValidNetworkUnitCode
STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész (ld. 4.3.1)
Tárgy gáznap (ld. 4.3.3)
15.1.2 A VÁLASZT TARTALMAZÓ ÜZENET
Informatikai Platform illeszkedési felület
FGSZ Zrt.
146/178 STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész
Feldolgozás sikeres / sikertelen. Ld. 4.3.9 pont.
Hálózati pont 1
o
Hálózati pont neve
o
Hálózati pont kódja
o
Hálózati pont EIC kódja
o
Hálózati pont iránya
o
Hálózati pont típusa
o
Hálózati pont érvényességének kezdete
o
Hálózati pont érvényességének vége
Hálózati pont 2 o
....
AZ XML-BLOKK AZONOSÍTÓJA validNetworkUnit MEZŐK Megnevezés
Leírás
XML címkenév
Hálózati neve
pont
Hálózati pont neve
networkUnitName
Hálózati kódja
pont
Hálózati pont kódja
networkUnitCode
EIC kód
Hálózati pont EIC kódja
networkUnitEICCode
Hálózati pont jellege (IN/OUT)
Hálózati pont jellege (IN/OUT)
networkUnitDirection
Hálózati típusa
pont
Hálózati pont típusa: E – Elemi pont, A – Összevont pont
networkUnitType
Hálózati pont érvényességének
Hálózati pont érvényességének
validFrom
Informatikai Platform illeszkedési felület
Formátum / típus
FGSZ Zrt.
147/178 kezdete
kezdete
Hálózati pont érvényességének vége
Hálózati pont érvényességének vége
validTo
PÉLDA
Aba KAABA00011GN 39ZKAABA00011GNE OUT E 2008-07-01T00:00:00+02:00 2010-12-31T00:00:00+01:00
15.2. PARTNEREK LEKÉRDEZÉSE (GETVALIDPARTNERSCODE) ÜZLETI CÉL, KÖRNYEZET A partnerek lekérhetik az adott gáznapon érvényes partnerek listáját. SZEREPLŐK , SZEREPKÖRÖK
A kérés küldője: a szállíttató v. NNO
A kérés fogadója: a rendszerirányítási engedélyes (FGSZ)
A válasz küldője: a rendszerirányítási engedélyes (FGSZ)
A válasz fogadója: a szállíttató v. NNO
ÜTEMEZÉS , HATÁRIDŐK A partnerek listája bármikor lekérdezhető.
15.2.1 A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS GetValidPartnersCode
Informatikai Platform illeszkedési felület
FGSZ Zrt.
148/178 STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész (ld. 4.3.1)
Tárgy gáznap (ld. 4.3.3)
15.2.2 A VÁLASZT TARTALMAZÓ ÜZENET STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész
Feldolgozás sikeres / sikertelen. Ld. 4.3.9 pont.
Partner 1
o
Partner neve
o
Partner kódja
o
Partner EIC
o
Partner típusa
o
Partner érvényességének kezdete
o
Partner érvényességének vége
Partner 2 o
....
AZ XML-BLOKK AZONOSÍTÓJA validPartner MEZŐK Megnevezés
Leírás
XML címkenév
Partner neve
Partner neve
partnerName
Partner kódja
Partner kódja
partnerCode
Partner EIC
Partner EIC
partnerEICode
Informatikai Platform illeszkedési felület
Formátum / típus
FGSZ Zrt.
149/178 Partner típus
Partner típusa:
partnerType
SHP – Szállíttató
LDC – Elosztó
TSO – Szállító
STO – Tároló
PFO – Termelő
RU – FGSZ üzem
FRI – Rendszerirányító
SHPNNO – Szállíttató + rendszerüzemeltető
REC – Szállítórendszeri fogyasztó
LDC2 – engedélyes
Telephelyi
Partner érvényességének kezdete
Partner kezdete
érvényességének
Partner érvényességének vége
Partner érvényességének vége
validFrom
validTo
PÉLDA
<partnerName>Földgázszállító ZRt. partnerName> <partnerCode>HUFFGSZALL partnerCode> <partnerEICCode>21X60FGSZ000000V partnerEICCode> <partnerType>FRI partnerType> 2003-12-12T00:00:00+02:00 9999-12-31T00:00:00+01:00
Informatikai Platform illeszkedési felület
FGSZ Zrt.
150/178
16. KAPACITÁS ÁTADÁS/ÁTVÉTEL BEJELENTÉSE (FOGYASZTÓ VÁNDORLÁS) 16.1. KAPACITÁS ÁTADÁS (SAVECUSTOMERMIGRATION) ÜZLETI CÉL, KÖRNYEZET A fogyasztóvándorlás kezelésének keretén belül a szállíttatók egymás között a kereskedőt váltott fogyasztóhoz rendelhető kapacitásaikat átadják-átveszik. E célra az IP-nek külön felülete szolgál (fogyasztóvándorlás kezelése). Az e szolgáltatás alkalmazása kapcsán kialakított gyakorlat alapján a szerver-szerver kommunikáció terén az alábbi üzleti folyamat valósul meg: 1.
A kapacitást átadó kereskedő szerver-szerver kapcsolaton keresztül rögzíti az átadni kívánt kapacitáscsomagot a benne lévő kapacitások pontjával, típusával és mennyiségével, az átvevő partner kódját és az érvényességi dátumot.
2.
Az IP visszaigazolást ad az átadónak feltüntetve a kapacitáscsomagnak adott egyedi azonosítót.
3.
Az IP e-mail-ben értesítést küld az átvevőnek feltüntetve a kapacitáscsomag egyedi azonosítóját.
4.
Az átvevő a kapott azonosító alapján megkeresi a csomagot az IP Fogyasztóvándorlás kezelése felületén és elfogadhatja vagy visszautasíthatja azt.
5.
Elfogadás esetén az FGSZ jóváhagyhatja, illetve elutasíthatja az átadás-átvételt.
LEÍRÁS
Jelen szolgáltatás egy az egyben az IP Fogyasztóvándorlás kezelése felületén elérhető kapacitáscsomag beadási és véglegesítési funkciót teszi elérhetővé szerver-szerver kapcsolaton keresztül.
ÜTEMEZÉS , HATÁRIDŐK Az ütemezésre és a határidőkre vonatkozóan mindaz érvényes, ami a fogyasztóvándorlás kezelésre általánosságban véve. ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK Az átadó csak a saját rendelkezésre álló kapacitásának mértékéig kínálhat fel kapacitást.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
151/178
16.1.1 A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS SaveCustomerMigration
STRUKTÚRA , CÍMKÉK LEÍRÁSA Az XML üzenet logikai szerkezete az alábbi struktúra szerint épül fel.
Fejrész – ld. 4.3.1
1. Kapacitáscsomag adatai o
Átadandó kapacitás 1.
o
Átadandó kapacitás n.
KAPACITÁSCSOMAG ADATAI XML-BLOKKJÁNAK AZONOSÍTÓJA Packet
MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Átvevő kódja
Átvevő szállíttató IP-beli kódja
recipient
Party
Kezdő gáznap
A átadás vonatkoztatási időintervallumának kezdete
startDate
xsd:date (ÉÉÉÉ-HH-NN)
Megjegyzés
Megjegyzés
reason
Csomag sorszám
A beadandó csomag sorszáma – a módosítandó csomag azonosítója, új csomag létrehozásakor nem kell megadni
packetId
szállíttató
Informatikai Platform illeszkedési felület
FV_nnnnnn
FGSZ Zrt.
152/178 PÉLDA <Packet> HUFSHP <startDate>2010-07-01 xy fogyasztó átadása < packetId >FV_1 packetId >
ÁTADANDÓ KAPACITÁS ADATAI XML-BLOKKJÁNAK AZONOSÍTÓJA PacketLine
MEZŐK
Megnevezés
Leírás
XML címkenév
Tag hossza
Formátum / típus
(karakter) Hálózati kódja
pont
A kapacitás pontja
átadási
Kapacitástípus időtartamának jellege
Hosszútávú / éves
Kapacitástípus
Alapdíjas megszakítható) megszakítható szezonális
Megszakítás típusa
Órai kapacitás
networkPoint
periodType
LONGTERM / YEARLY
capacityType
NON_INTERRUPTIBLE / INTERRUPTIBLE / SEASONAL
Nem megszakítható és szezonális kapacitástípus esetén: NONE. A megszakítható kapacitástípus esetén : Y99
interruptionType
NONE / Y99
Átadott órai kapacitás (kWh/h).
hourlyCapacity::v
max 19 számjegy
xsd:integer
hourlyCapacity:: measureUnit
3
KW1
(nem / /
Informatikai Platform illeszkedési felület
FGSZ Zrt.
153/178
PÉLDA <PacketLine> VETELJCS15EN YEARLY NON_INTERRUPTIBLE NONE 1000 <PacketLine>
16.1.2 A VÁLASZT TARTALMAZÓ ÜZENET ÜZLETI CÉL, KÖRNYEZET Cél, hogy az átadó a kapacitáscsomag beadását követően visszaigazolást kapjon – ideértve a rögzített csomag azonosítóját is.
LOGIKAI SZERKEZET A válaszüzenet logikai felépítése az alábbi:
Válaszüzenet azonosítója, létrehozásának dátuma, a válasz küldője. Ld. 4.3.1 pont.
Feldolgozás sikeres / sikertelen. Ld. 4.3.9 pont.
Eredeti üzenet fejrésze (azonosító, küldő, létrehozás dátuma) Ld. 4.3.8 pont.
Kapacitáscsomag IP-ben rögzített azonosítója.
KAPACITÁSCSOMAG IP-BEN RÖGZÍTETT AZONOSÍTÓJA Megnevezés
Leírás
XML címkenév
Formátum / típus
Azonosító
A kapacitás átadására vonatkozó ajánlattétel IP-ben rögzített azonosítója
packetID
FV_nnnnnn
HIBAÜZENET Blokknév: BusinessError
Informatikai Platform illeszkedési felület
FGSZ Zrt.
Hibaüzenet azonosítója CustomerMigrationManagement.Error.DeniedModification CustomerMigrationManagement.Error.DuplicatedCapacityError CustomerMigrationManagement.Error.HandoverStartMustBeTheFirstDayOfaMonth CustomerMigrationManagement.Error.HourlyCapacityMinusError CustomerMigrationManagement.Error.Import_Id CustomerMigrationManagement.Error.Import_Lack CustomerMigrationManagement.Error.Import_Open CustomerMigrationManagement.Error.InvalidCapacityType CustomerMigrationManagement.Error.InvalidHandoverStart CustomerMigrationManagement.Error.InvalidHourlyMeasureUnit CustomerMigrationManagement.Error.InvalidMeasureUnit CustomerMigrationManagement.Error.InvalidNetworkUnit CustomerMigrationManagement.Error.InvalidPacket CustomerMigrationManagement.Error.InvalidRecipient CustomerMigrationManagement.Error.InvalidSender CustomerMigrationManagement.Error.InvalidStatusCode CustomerMigrationManagement.Error.MissingCapacities CustomerMigrationManagement.Error.MissingFgszRefuseCommment CustomerMigrationManagement.Error.MissingHourlyCapacityError CustomerMigrationManagement.Error.MissingRecipientRefuseCommment CustomerMigrationManagement.Error.NotAllowedOperation CustomerMigrationManagement.Error.OnlyOnePacket CustomerMigrationManagement.Error.RequiredField CustomerMigrationManagement.Error.SameShipper CustomerMigrationManagement.Error.ThereIsNoContractForCapacityType
Informatikai Platform illeszkedési felület
Hibaüzenet szövege Nem engedélyezett módosítás! A hálózati ponthoz többször is szerepel az adott kapacitástípus Az átadás kezdete csak hónap első napja lehet! Az órai kapacitásérték csak 0-nál nagyobb lehet! Érvénytelen fájl típus azonosító Adat nem található File hiba Nem megfelelő kapacitás típus! Az átadás kezdete kívülesik az aktuális gázév hátralévő részén! Hibás órai mennyiségi egység! Hibás mennyiségi egység! Nem létező hálózati pont! Nem létező csomag! A kiválasztott átvevő a gázév hátralévő részében nem érvényes a rendszerben! Kérem keresse a rendszerüzemeltetőt! Nem megfelelő átadó! Nem megfelelő státusz! A csomaghoz nincsenek megadva kapacitásadatok! Hiányzik az FGSZ megjegyzése az elutasításhoz! Hiányzó órai kapacitásérték! Hiányzik az átvevő megjegyzése az elutasításhoz! Nem engedélyezett művelet! Kérésenként egy csomag beadása lehetséges! A csomag minden mezője kitöltendő! Azonos átadó és átvevő szállíttató! Nincs ilyen típusú szerződése!
FGSZ Zrt.
17. KP PIACI INFORMÁCIÓK ÜZLETI CÉL, KÖRNYEZET
A KP napi használata során felmerült az igény az adattartalom esetleges server-server kapcsolaton keresztül való elérésére. Ez két ablak adattartalma kapcsán valósult meg. Mindkét ablak a "Riportok" menüpont alatt érhető el, "Beadott ajánlatok" illetve "Megkötött ügyletek" néven. Az adattartalmak a felületen jelenleg is hozzáférhetőek illetve excel export funkcióval támogatottak. Lényegében az eddig is szolgáltatott adatok SOAP interface-en való elérhetőségéről van szó.
LEÍRÁS
Jelen szolgáltatás adattartalma megegyezik a felületen megjelenítéskor a buboréksúgó adattartalmával, azonban egyszerre szerepelnek a saját ajánlatok/ügyletek teljes adattartalommal és a többi partner által beadott/megkötött ajánlatok/ügyletek anonim módon.
ÜTEMEZÉS , HATÁRIDŐK
A piaci információkat a partner bármikor lekérdezheti. A rendszer bejövő hívások esetén ellenőrzi, hogy a hívó partner mikor hívta utoljára a webservice-t, és amennyiben nem telt még el a megadott idő az előző hívás óta, akkor a hívást visszautasítja. Két hívás közt eltelt időt a rendszergazda állítja be. WEB SERVICE KP MarketInfoService
17.1. BEADOTT AJÁNLATOK 17.1.1 A KÉRÉST TARTALMAZÓ ÜZENET - BEADOTT AJÁNLATOK METÓDUS getBids XML-BLOKKJÁNAK AZONOSÍTÓJA GetBidsRequest
Informatikai Platform illeszkedési felület
FGSZ Zrt.
156/178 MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Lekérdezés kezdő napja
Ettől a dátumtól kezdve kéri a partner az adatokat.
fromGasDay
xs:dateTime
Lekérdezés utolsó napja
Eddig a dátumig kéri a partner az adatokat.
toGasDay
xs:dateTime
PÉLDA 2011-07-01 2011-07-30
17.1.2 A VÁLASZT TARTALMAZÓ ÜZENET - BEADOTT AJÁNLATOK METÓDUS getBids XML-BLOKKJÁNAK AZONOSÍTÓJA GetBidsResponse AJÁNLAT LISTA ELEMEI Megnevezés
Leírás
XML címkenév
Formátum / típus
Azonosító
Az ajánlat azonosítója
id
xs:long
Termék
A KP-n értelmezett termék.
product
tns:Product
gasDay
<xs:simpleType name="Product"> <xs:restriction base="xs:string"> <xs:enumeration value="MGP"/> <xs:enumeration value="HEG"/> <xs:enumeration value="KAP"/> <xs:enumeration value="HEGO"/> <xs:enumeration value="KFRE"/> <xs:enumeration value="EGY"/> <xs:enumeration value="REPO"/> xs:string
Gáznap
Informatikai Platform illeszkedési felület
FGSZ Zrt.
157/178 Dátum
bidDate
xs:dateTime
Kereskedő cég
Az ajánlatot beadó Partner (cég).
traderMember
xs:string
Kereskedő
Az ajánlatot beadó személy.
trader
xs:string
Mennyiség
Az ajánlatban megjelölt menyiség (kWh).
quantity
xs:long
Maradék
Részteljesülés esetén a fenmaradó ajánlati mennyiség
avilableQuantity
xs:long
Ár
Az ajánlat ára 1 kWh-ra vonatkoztatva.
price
xs:double
Irány
Vétel eladás.
isBuy
xs:boolean
Típus
Az ajánlat típusa.
bidType
tns:BidType
status
<xs:simpleType name="BidType"> <xs:restriction base="xs:string"> <xs:enumeration value="MVS"/> <xs:enumeration value="RTM"/> <xs:enumeration value="TET"/> <xs:enumeration value="TVT"/> tns:Status
Státusz
vagy
xs:simpleType name="Status"> <xs:restriction base="xs:string"> <xs:enumeration value="UNDER_VALIDATION"/> <xs:enumeration value="CANCELLED"/> <xs:enumeration value="REALISABLE"/> <xs:enumeration value="REALISED"/> <xs:enumeration value="HEGO_WAITING_FOR_STRIKE"/> <xs:enumeration value="EXPIRED"/> <xs:enumeration value="ERROR"/> <xs:enumeration value="ERASED"/>
Informatikai Platform illeszkedési felület
FGSZ Zrt.
158/178 Kapacitás típus
capacityType
tns:CapacityType
Hálózati pont kód
networkUnit
<xs:simpleType name="CapacityType"> <xs:restriction base="xs:string"> <xs:enumeration value="FIRM"/> <xs:enumeration value="INTERRUPTIBLE"/> <xs:enumeration value="BACKHAUL"/> <xs:enumeration value="NA"/> xs:string
Érvényesség
validityDate
xs:dateTime
errorMsg
xs:string
Hiba
Esetleges hibás ajánlat hibaleírása.
PÉLDA 10106763 <product>HEGO 2011.07.28 2011-07-28T13:35:09.298+02:00 test 1 1 <price>1.0E-4 false RTM <status>EXPIRED HABEREGD1IIN 9999-12-31T23:59:59+01:00 HIBAÜZENETEK
"Parameters may not be null" – ha valamelyik paraméter üres
"Invalid date interval" – ha kezdő dátum későbbi a végdátumnál
"Date interval may not be longer than XXX" – ha a lekérdezendő intervallum XXX napnál hosszabb, XXX = adminisztrátor által beállított érték
„There must be at least XXX seconds between webservice calls, your last call was at YYY" – ha az utolsó hívás óta nem telt el XXX másodperc, XXX = adminisztrátor által beállított érték
Informatikai Platform illeszkedési felület
FGSZ Zrt.
159/178 WEB SERVICE KP MarketInfoService
17.2. BEADOTT AJÁNLATOK V2 17.2.1 A KÉRÉST TARTALMAZÓ ÜZENET - BEADOTT AJÁNLATOK METÓDUS getBidsV2 XML-BLOKKJÁNAK AZONOSÍTÓJA GetBidsRequest
MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Lekérdezés kezdő napja
Ettől a dátumtól kezdve kéri a partner az adatokat.
fromGasDay
xs:dateTime
Lekérdezés utolsó napja
Eddig a dátumig kéri a partner az adatokat.
toGasDay
xs:dateTime
PÉLDA 2011-07-01 2011-07-30
17.2.2 A VÁLASZT TARTALMAZÓ ÜZENET - BEADOTT AJÁNLATOK METÓDUS getBidsV2 XML-BLOKKJÁNAK AZONOSÍTÓJA getBidsV2Response
Informatikai Platform illeszkedési felület
FGSZ Zrt.
160/178 AJÁNLAT LISTA ELEMEI Megnevezés
Leírás
XML címkenév
Formátum / típus
Azonosító
Az ajánlat azonosítója
id
xs:long
Termék
A KP-n értelmezett termék.
product
tns:Product
Gáznap
gasDay
<xs:simpleType name="Product"> <xs:restriction base="xs:string"> <xs:enumeration value="MGP"/> <xs:enumeration value="HEG"/> <xs:enumeration value="KAP"/> <xs:enumeration value="HEGO"/> <xs:enumeration value="KFRE"/> <xs:enumeration value="EGY"/> <xs:enumeration value="REPO"/> xs:string
Dátum
bidDate
xs:dateTime
Kereskedő cég
Az ajánlatot beadó Partner (cég).
traderMember
xs:string
Kereskedő
Az ajánlatot beadó személy.
trader
xs:string
Mennyiség
Az ajánlatban megjelölt menyiség (kWh).
quantity
xs:long
Maradék
Részteljesülés esetén a fenmaradó ajánlati mennyiség
avilableQuantity
xs:long
Ár
Az ajánlat ára 1 kWh-ra vonatkoztatva.
price
xs:double
Irány
Vétel eladás.
isBuy
xs:boolean
Típus
Az ajánlat típusa.
bidType
tns:BidType
vagy
Informatikai Platform illeszkedési felület
<xs:simpleType name="BidType">
FGSZ Zrt.
161/178
status
<xs:restriction base="xs:string"> <xs:enumeration value="MVS"/> <xs:enumeration value="RTM"/> <xs:enumeration value="TET"/> <xs:enumeration value="TVT"/> tns:Status
Kapacitás típus
capacityType
xs:simpleType name="Status"> <xs:restriction base="xs:string"> <xs:enumeration value="UNDER_VALIDATION"/> <xs:enumeration value="CANCELLED"/> <xs:enumeration value="REALISABLE"/> <xs:enumeration value="REALISED"/> <xs:enumeration value="HEGO_WAITING_FOR_STRIKE"/> <xs:enumeration value="EXPIRED"/> <xs:enumeration value="ERROR"/> <xs:enumeration value="ERASED"/> tns:CapacityType
Hálózati pont kód
networkUnit
<xs:simpleType name="CapacityType"> <xs:restriction base="xs:string"> <xs:enumeration value="FIRM"/> <xs:enumeration value="INTERRUPTIBLE"/> <xs:enumeration value="BACKHAUL"/> <xs:enumeration value="NA"/> xs:string
Érvényesség
validityDate
xs:dateTime
Gázóra
gasHour
xs:integer
errorMsg
xs:string
Státusz
Hiba
Esetleges hibás ajánlat hibaleírása.
PÉLDA <product>HEG 2015.12.10 2015-12-08T13:33:44.700+01:00 4 0 <price>3.4568 false PRA
Informatikai Platform illeszkedési felület
FGSZ Zrt.
162/178 NA KAABA00011GN 2015-12-10T05:00:00+01:00 3 HIBAÜZENETEK
"Parameters may not be null" – ha valamelyik paraméter üres
"Invalid date interval" – ha kezdő dátum későbbi a végdátumnál
"Date interval may not be longer than XXX" – ha a lekérdezendő intervallum XXX napnál hosszabb, XXX = adminisztrátor által beállított érték
„There must be at least XXX seconds between webservice calls, your last call was at YYY" – ha az utolsó hívás óta nem telt el XXX másodperc, XXX = adminisztrátor által beállított érték
17.3. MEGKÖTÖTT ÜGYLETEK 17.3.1 A KÉRÉST TARTALMAZÓ ÜZENET – MEGKÖTÖTT ÜGYLETEK METÓDUS getTrades
XML-BLOKK AZONOSÍTÓJA GetTradesRequest
MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Lekérdezés kezdő napja
Ettől a dátumtól kezdve kéri a partner az adatokat.
fromGasDay
xs:dateTime
Lekérdezés utolsó napja
Eddig a dátumig kéri a partner az adatokat.
toGasDay
xs:dateTime
PÉLDA
Informatikai Platform illeszkedési felület
FGSZ Zrt.
163/178 2011-07-01 2011-07-30
17.3.2 A VÁLASZT TARTALMAZÓ ÜZENET – MEGKÖTÖTT ÜGYLETEK METÓDUS getTrades XML-BLOKKJÁNAK AZONOSÍTÓJA GetTradesResponse
ÜGYLET LISTA ELEMEI Megnevezés
Leírás
XML címkenév
Formátum / típus
Azonosító
Az ügylet azonosítója
id
xs:long
Termék
Az KP-n értelmezett termék.
product
tns:Product
gasDay
<xs:simpleType name="Product"> <xs:restriction base="xs:string"> <xs:enumeration value="MGP"/> <xs:enumeration value="HEG"/> <xs:enumeration value="KAP"/> <xs:enumeration value="HEGO"/> <xs:enumeration value="KFRE"/> <xs:enumeration value="EGY"/> <xs:enumeration value="REPO"/> xs:string
Gáznap Ár
Az ajánlat ára 1 kWhra vonatkoztatva.
price
xs:double
Mennyiség
Az ügyletben megkötött menyiség (KE).
quantity
xs:long
Mennyiség kWh-ban
Az ügyletben megkötött menyiség (kWh).
quantityinEnergy
xs:long
capacityType
tns:CapacityType
Kapacitás
<xs:simpleType name="CapacityType">
Informatikai Platform illeszkedési felület
FGSZ Zrt.
164/178
networkUnit
<xs:restriction base="xs:string"> <xs:enumeration value="FIRM"/> <xs:enumeration value="INTERRUPTIBLE"/> <xs:enumeration value="BACKHAUL"/> xs:string
típus
Hálózati pont kód Vevő
Vevő partner kódja
buyerMember
xs:string
Eladó
Eladó partner
sellerMember
xs:string
tradeTime
xs:dateTime
kódja Ügyletkötés ideje
PÉLDA 10106172 <product>KAP 2011.07.22 <price>2.0E-4 1 43200 FIRM HABEREGD1IIN TESTBUYER <seller>TESTSELLER 2011-07-21T10:20:36.676+02:00 HIBAÜZENET
"Parameters may not be null" – ha valamelyik paraméter üres
"Invalid date interval" – ha kezdő dátum későbbi a végdátumnál
"Date interval may not be longer than XXX" – ha a lekérdezendő intervallum XXX napnál hosszabb, XXX = adminisztrátor által beállított érték
„There must be at least XXX seconds between webservice calls, your last call was at YYY" – ha az utolsó hívás óta nem telt el XXX másodperc, XXX = adminisztrátor által beállított érték
Informatikai Platform illeszkedési felület
FGSZ Zrt.
165/178
18. AJÁNLAT FOGADÓ INTERFACE ÜZLETI CÉL, KÖRNYEZET
A KP, mint informatikai rendszer üzleti célja a gáznapi rugalmassági piac működésének támogatása, a gázpiaci kereskedelmi egyensúlyozásának elősegítése. E piactérnek az ügyletek megkötésén túl biztosítania kell, hogy a beadott ajánlatok és a megkötött ügyletek a fizikai földgázszállítás szempontjából is teljesíthetők legyenek. LEÍRÁS
A szállíttatók számára a standard protokollt használó interface a megszokott módon, tanúsítvány alapú autentikációval azonosítja a kéréseket küldő felhasználókat, és ellenőrzi, hogy a partner nevében elvégezhető-e az adott műveletet. A modulban keletkezett hívások naplózásra kerülnek, a befogadás vagy az elutasítás tényét a rendszer válaszüzenetben jelzi. Elutasítás esetén a válaszüzenet hibalistát tartalmaz, az összes olyan üzleti ellenőrzés által talált problémáról, amelyek párhuzamosan felderíthetőek egy üzenetváltás során. ÜTEMEZÉS , HATÁRIDŐK
Az egyes termékekre vonatkozó ajánlatok beadásának feltételei nem különböznek a KP felületén elérhető funkcióktól. WEB SERVICE Bidding service
18.1.1 A KÉRÉST TARTALMAZÓ ÜZENET – AJÁNLAT BEFOGADÁS VAGY MÓDOSÍTÁS KÉRÉS METÓDUS createOrUpdateBid XML-BLOKKJÁNAK AZONOSÍTÓJA CreateOrUpdateBidRequest MEZŐK Minden mező kitöltése kötelező. Megnevezés
Leírás
XML címkenév
Formátum / típus
Azonosító
Az azonosító értéke negatív szám vagy nulla kell legyen új ajánlat beadása esetén, illetve módosítás, visszavonás esetén a módosítani vagy törölni kívánt ajánlat ID-ja
bidId
xs:long
Informatikai Platform illeszkedési felület
FGSZ Zrt.
166/178 Megnevezés
Leírás
XML címkenév
Formátum / típus
product
xs:string
gasDay
xs:date
gasHourStart
xs:int
networkUnitCode
xs:string
capacityType
xs:string
A termékek megnevezésének lehetséges értékei: Termék MGP; HEG; KAP; HEGO; KFRE Gáznap
Kezdeti gázóra
Releváns gáznap 0 és 23 közötti egész számot vehet fel értékként, mely a releváns gáznapra értelmezett (23/25 órás gáznap esetén: 022/0-24)
Hálózati pont kódja
A beadott ajánlat csak érvényes hálózati pontra vonatkozhat A kapacitás típus mező a következő értékeket veheti fel
Kapacitás típus FIRM; INTERRUPTIBLE; BACKHAUL; NA
Mennyiség
Az ajánlat mennyiségeként pozitív egész szám adható meg.
quantity
xs:long
Ár
Az ajánlat áraként pozitív szám adható meg 4 tizedes jegyig.
price
xs:double
marketPrice
xs:Boolean
Piaci ár
A piaci ár mező Igaz és Hamis értéket vehet fel. True; False
Informatikai Platform illeszkedési felület
FGSZ Zrt.
167/178 Megnevezés
Érvényesség dátuma
Leírás
XML címkenév
Formátum / típus
Az ajánlat érvényességének dátuma a jelenlegi dátumnál maximum egy nappal lehet korábbi, egyébként azonos, vagy későbbi.
validityDate
xs:date
validityHour
xs:int
bidType
xs:string
direction
xs:string
shipperPair
xs:string
(HEGO és KFRE esetén megadandó érték: 9999-12-31)
Érvényesség óra
0 és 23 közötti egész számot vehet fel értékként, mely az érvényesség dátumára értelmezett Az ajánlat típusa a következő értékeket veheti fel (érték, majd a magyar megfelelője):
Ajánlat típusa
Ajánlat iránya
AON (MVS: Mindent Vagy Semmit) PRA (RTM: RészTeljesítés Megengedett) FAK (TÉT: Teljesítsd És Töröld) FOK (TVT: Teljesítsd, Vagy Töröld) Az ajánlat iránya két értéket vehet fel: BUY; SELL
Szállíttató-pár kódja
Érvényes szállíttató kódot kell tartalmazzon
AZ EGYES TERMÉKEKRE VONATKOZÓAN A KÖVETKEZŐ MEZŐK ÉRTÉKE ÉRTELMEZETT XML címkenév bidId product gasDay
Értelmezett mezők
Nem értelmezett mezők
összes terméktípusra értelmezett: MGP; KAP; HEG; HEGO; KFRE összes terméktípusra értelmezett: MGP; KAP; HEG; HEGO; KFRE összes terméktípusra értelmezett: MGP; KAP; HEG; HEGO; KFRE
Informatikai Platform illeszkedési felület
FGSZ Zrt.
168/178 XML címkenév
Értelmezett mezők
Nem értelmezett mezők
HEG
MGP; KAP; HEGO; KFRE
összes terméktípusra értelmezett: MGP; KAP; HEG; HEGO; KFRE KAP
MGP; HEG; HEGO; KFRE
marketPrice
összes terméktípusra értelmezett: MGP; KAP; HEG; HEGO; KFRE összes terméktípusra értelmezett: MGP; KAP; HEG; HEGO; KFRE MGP; KAP; HEG
KFRE; HEGO
validityDate
MGP; KAP; HEG
HEGO; KFRE
validityHour
MGP; KAP; HEG
HEGO; KFRE
direction
MGP; KAP (csak PRA és FAK); HEG; HEGO (PRA) MGP; KAP; HEG; HEGO
KFRE
shipperPair
HEG; HEGO; KFRE
MGP; KAP
gasHourStart networkUnitCode capacityType quantity price
bidType
PÉLDA Request(sikeres ajánlat beadás): <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:hu="hu.fgsz.nfkp.service"> <soapenv:Header/> <soapenv:Body> -1 <product>MGP 2013-04-04 MGP NA 1 <price>1.1234 <marketPrice>false 2013-04-05 10 PRA SELL <shipperPair>TESTSHIPPERPAIR
Informatikai Platform illeszkedési felület
FGSZ Zrt.
169/178 Request(hibás ajánlat beadás): <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:hu="hu.fgsz.nfkp.service"> <soapenv:Header/> <soapenv:Body> -1 <product>MGP 2013-04-04 MGP NA -1 <price>1.1234 <marketPrice>false 2013-04-05 26 PRA SELL <shipperPair>TESTSHIPPERPAIR
Request(sikeres ajánlat módosítása): <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:hu="hu.fgsz.nfkp.service"> <soapenv:Header/> <soapenv:Body> 553941 <product>MGP 2013-04-04 MGP NA 1 <price>1.1234 <marketPrice>false 2013-04-05 8 PRA
Informatikai Platform illeszkedési felület
FGSZ Zrt.
170/178 SELL <shipperPair>TESTSHIPPERPAIR Request(nem létező ajánlat módosítása): <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:hu="hu.fgsz.nfkp.service"> <soapenv:Header/> <soapenv:Body> 553946 <product>MGP 2013-04-04 MGP NA 1 <price>1.1234 <marketPrice>false 2013-04-05 8 PRA SELL <shipperPair>TESTSHIPPERPAIR
18.1.2 A VÁLASZT TARTALMAZÓ ÜZENET - BEADOTT AJÁNLATOK METÓDUS createOrUpdateBid XML-BLOKKJÁNAK AZONOSÍTÓJA createOrUpdateBidResponse VÁLASZ ELEMEI Megnevezés
Leírás
XML címkenév
Formátum / típus
Státusz
Az ajánlat befogadásának státusza a következő értékeket veheti fel:
status
xs:string
Informatikai Platform illeszkedési felület
FGSZ Zrt.
171/178 OK; ERROR
Hibaüzenet
Az ajánlat befogadásának sikertelensége esetén a nem teljesült üzleti ellenőrzésnek megfelelő hibaüzenet és hibakód a következő (tns:BiddingServiceErrorParam)
errors
tns:BidServiceErrors
bidId
xs:long
errorCode (xs:string) errorMessage (xs:string) Azonosító
A befogadott ajánlat azonosítója
PÉLDA Sikeres ajánlat beadás válasz <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:createOrUpdateBidResponse xmlns:ns2="hu.fgsz.nfkp.service"> <status>OK 553941 Sikertelen ajánlat beadás válasz <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:createOrUpdateBidResponse xmlns:ns2="hu.fgsz.nfkp.service"> <status>ERROR <errors> <error> <errorCode>INVALID_VOLUME <errorMessage>Volume of order must be above or equal 0! <error> <errorCode>INVALID_EXPIRY_DATE <errorMessage>Date of expiry is invalid! <error> <errorCode>INVALID_HOUR
Informatikai Platform illeszkedési felület
FGSZ Zrt.
172/178 <errorMessage>Invalid validity hour! Sikeres ajánlat módosítás válasz <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:createOrUpdateBidResponse xmlns:ns2="hu.fgsz.nfkp.service"> <status>OK 553941
Sikertelen ajánlat módosítás válasz <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:createOrUpdateBidResponse xmlns:ns2="hu.fgsz.nfkp.service"> <status>ERROR <errors> <error> <errorCode>ORDER_MISSING <errorMessage>Order does not exist.
18.1.3 A KÉRÉST TARTALMAZÓ ÜZENET – AJÁNLAT VISSZAVONÁSKÉRÉS METÓDUS withdrawBid XML-BLOKKJÁNAK AZONOSÍTÓJA withdrawBidRequest
Informatikai Platform illeszkedési felület
FGSZ Zrt.
173/178 MEZŐK Megnevezés
Leírás
XML címkenév
Formátum / típus
Azonosító
Az azonosító értéke negatív szám vagy nulla kell legyen új ajánlat beadása esetén, illetve módosítás, visszavonás esetén a módosítani vagy törölni kívánt ajánlat ID-ja
bidId
xs:long
PÉLDA Request(sikeres ajánlat visszavonás): <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:hu="hu.fgsz.nfkp.service"> <soapenv:Header/> <soapenv:Body> <WithdrawBidRequest> 64160
Request(hibás ajánlat visszavonás): <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:hu="hu.fgsz.nfkp.service"> <soapenv:Header/> <soapenv:Body> <WithdrawBidRequest> 33
18.1.4 A VÁLASZT TARTALMAZÓ ÜZENET – AJÁNLAT VISSZAVONÁS VÁLASZ METÓDUS withdrawBid XML-BLOKKJÁNAK AZONOSÍTÓJA withdrawBidResponse
Informatikai Platform illeszkedési felület
FGSZ Zrt.
174/178 MEZŐK Megnevezés
Leírás
XML címkenév
Formátum / típus
Státusz
A visszavonás befogadásának státusza a következő értékeket veheti fel:
status
xs:string
errors
tns:BidServiceErrors
OK; ERROR
Hibaüzenet
A visszavonás befogadásának sikertelensége esetén a nem teljesült üzleti ellenőrzésnek megfelelő hibaüzenet és hibakód a következő (tns:BiddingServiceErrorParam ) errorCode (xs:string) errorMessage (xs:string)
PÉLDA Sikeres ajánlat visszavonás válasz <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:withdrawBidResponse xmlns:ns2="hu.fgsz.nfkp.service"> <status>OK Sikertelen ajánlat visszavonás válasz <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns2:withdrawBidResponse xmlns:ns2="hu.fgsz.nfkp.service"> <status>ERROR <errors> <error> <errorCode>ORDER_MISSING <errorMessage>Order does not exist.
Informatikai Platform illeszkedési felület
FGSZ Zrt.
175/178
18.1.5 HIBAKÓDOK, HIBAÜZENETEK
Hibakód
Hibaüzenet
CANNOT_MODIFY_CAPACITY_TYPE
Not allowed to modify networkunit point!
CANNOT_MODIFY_DIRECTION
Not allowed to modify direction!
CANNOT_MODIFY_GASDAY
Not allowed to modify gasday!
CANNOT_MODIFY_NETWORK_UNIT
Not allowed to modify networkunit point!
CANNOT_MODIFY_ORDER
Not allowed to modify order!
CANNOT_MODIFY_PRODUCT
Not allowed to modify product!
CANNOT_MODIFY_SHIPPER
Not allowed to modify shipper!
CAPACITY_UNCOVERED
Uncovered capacity!
EXISTING_HEGO_KFRE_ORDER
Existing HEGO/KFRE order!
FINANCE_UNCOVERED
Not enough financial deposit!
INVALID_BID_TYPE
Invalid bid type!
INVALID_CAPACITY_TYPE
Capacity type is invalid or have not been set.
INVALID_DIRECTION
Invalid direction!
INVALID_EXPIRY_DATE
Date of expiry is invalid!
INVALID_GASDAY
Gasday must be refer at least one day before current date!
INVALID_HEG_GASHOUR
Invalid HEG order!
INVALID_HOUR
Invalid validity hour!
INVALID_INSTRUMENT
Invalid instrument!
INVALID_NETWORK_UNIT
Invalid network point.
INVALID_ORDER_TYPE
Invalid order type!
INVALID_PARTNER
Invalid partner!
INVALID_PRICE
Offered price is invalid!
INVALID_PRODUCT
Invalid product!
INVALID_PRODUCT_ON_UNIT
This product cannot be traded on this network point.
INVALID_SHIPPER_PAIR
Invalid shipper pair!
INVALID_VOLUME
Volume of order must be above or equal 0!
MARKET_CLOSED
Closed market.
NOMINATION_ERROR
Nomination error.
OPPOSITE_ORDER_MISSING
Opposite sided order does not exist!
ORDER_CANNOT_WITHDRAWN
Order can not be withdraw.
ORDER_MISSING
Order does not exist.
PAST_MARKET
You have tried to input order into an already closed market.
SERVER_ERROR
Server error!
SUSPENDED_PARTNER
Suspended member!
SUSPENDED_USER
WHOLE_GASDAY_NOT_AVAILABLE
Suspended trader! HEGO/KFRE offer may be modified only to be more favorable for FGSZ during re-nomination! Not allowed to select whole gasday!
Nomination.Error.Business.100
No valid capacity contract on the network point!
TSO_UNFAVOURABLE_MODIFICATION
Informatikai Platform illeszkedési felület
FGSZ Zrt.
176/178 Hibakód Nomination.Error.Business.101 Nomination.Error.Business.102 Nomination.Error.Business.103 Nomination.Error.Business.104 Nomination.Error.Business.105 Nomination.Error.Business.106 Nomination.Error.Business.107
Nomination.Error.Business.108
Nomination.Error.Business.109 Nomination.Error.Business.110 Nomination.Error.Business.111 Nomination.Error.Business.112 Nomination.Error.Business.113 Nomination.Error.Business.114 Nomination.Error.Business.115
Nomination.Error.Business.116 Nomination.Error.Business.117 Nomination.Error.Business.118 Nomination.Error.Business.119 Nomination.Error.Business.120 Nomination.Error.Business.121 Nomination.Error.Business.122 Nomination.Error.Business.123
Informatikai Platform illeszkedési felület
Hibaüzenet Incorrect date! On entry network point nomination row of type NOM shoud have a zero or positive quantity! On exit network point nomination row of type NOM should have a zero or negative quantity! Imbalance! The hourly maximum should not exceed the daily nominated quantity and should not be less than the integer part of the daily nominated quantity/24. Only integer value is allowed! On entry network point the transmission task increased by the positive option (NOM + TRADE + BH + OPT_POS) should have the maximum value of the available daily contracted capacity! On exit network point the transmission task together with the negative option (NOM + TRADE + BH + OPT_NEG) should have the maximum value of the available daily contracted capacity! On entry network point the total sum of the absolute OPT_NEG quantities should have the maximum absolute value of the transmission task! On exit network point the total sum of the OPT_POS quantities should have the maximum amount of the transmission task! The hourly peak in NOM nomination row should have at least the rounded up value of daily quantity / 24 --- (or /23 or /25). On a point the total BH quantity is bounded by the contracted backhaul capacity! If at an entry point the sum of the transport duty plus the negative options is negative it should fit in the contracted backhaul capacity. (Missing backhaul capacity means zero.) Per network point and per shipper pair only one single NOM nomination row is allowed! Per network point and per shipper pair multiple OPT_POS nomination rows are only allowed when their option prices differ! Per network point and per shipper pair multiple OPT_NEG nomination rows are only allowed when their option prices differ! Per network point and per shipper pair only one single TRADE nomination row is allowed! Per network point and per shipper pair only one single BH nomination row is allowed! Nomination row is missing to the network point! On entry network point nomination row of type NOM should have a zero or positive quantity! OPT_NEG nomination row should have a zero or negative quantity! On entry network point nomination row of type BH should have a zero or negative quantity! OPT_POS nomination row should have a zero or positive quantity!
FGSZ Zrt.
177/178 Hibakód
Nomination.Error.Business.138
Hibaüzenet On exit network point nomination row of type NOM should have a zero or negative quantity! On exit network point nomination row of type BH should have a zero or positive quantity! Sum of network point transmission tasks can have the maximum value of the daily contracted capacity of the free point. The hourly peak in BH nomination row should have at least the rounded up value of daily quantity / 24 --- (or /23 or /25). On entry network point the hourly peak of NOM nomination row can only have a zero or positive value! On exit network point the hourly peak of NOM nomination row can only have a zero or negative value! On entry network point the hourly peak of BH nomination row can only have a zero or negative value! On exit network point the hourly peak of BH nomination row can only have a zero or positive value! If at an exit point the sum of the transport duty plus the positive options is positive, it should fit in the contracted backhaul capacity. (Missing backhaul capacity means zero.) At TRADE nomination rows the shipper pair should be different than the shipper! There is MGP nomination row this day.
Nomination.Error.Business.200
The maximum length of remark is 2000.
Nomination.Error.Business.201
Option price at OPT_POS nomination row is mandatory!
Nomination.Error.Business.202
Option price at OPT_NEG nomination row is mandatory! In case of OPT_POS nomination rows the hourly peak is not interpreted! In case of OPT_NEG nomination rows the hourly peak is not interpreted! Too high sum hourly peak. If the signed sum of the hourly peak of NOM, BH rows, and the 1/24th (1/23th or 1/25th) part of the daily nominated quantities of TRADE, OPT_POS, OPT_NEG rows corresponds to point flow direction or is equal to zero, it should fulfill the contracted hourly capacity limit with a tolerance of +1m3/h. Missing trade permission on the network point.
Nomination.Error.Business.124 Nomination.Error.Business.126 Nomination.Error.Business.128 Nomination.Error.Business.129 Nomination.Error.Business.130 Nomination.Error.Business.131 Nomination.Error.Business.132 Nomination.Error.Business.133 Nomination.Error.Business.134 Nomination.Error.Business.135
Nomination.Error.Business.203 Nomination.Error.Business.204
Nomination.Error.Business.205
Nomination.Error.Business.206 Nomination.Error.Business.207
Nomination.Error.Business.210
Missing option permission on the network point. In case of TRADE nomination rows the hourly peak is not interpreted! Option price at NOM nomination row is not interpreted!
Nomination.Error.Business.211
Option price at BH nomination row is not interpreted!
Nomination.Error.Business.212
Option price at TRADE nomination row is not interpreted! Too high sum backhaul hourly peak. If the signed sum of the hourly peak at NOM, BH rows, and the 1/24th (1/23th or 1/25th) part of the daily nominated quantities of TRADE, OPT_POS, OPT_NEG rows is reverse to point flow direction, it should fulfill the contracted backhaul hourly capacity limit with a tolerance of +1m3/h.
Nomination.Error.Business.208
Nomination.Error.Business.213
Informatikai Platform illeszkedési felület
FGSZ Zrt.
178/178 Hibakód Nomination.Error.Business.214 Nomination.Error.Business.215 Nomination.Error.Business.216 Nomination.Error.Business.217 Nomination.Error.Business.300 Nomination.Error.Business.303
Informatikai Platform illeszkedési felület
Hibaüzenet On entry points at zero available capacity the shipping duty plus the positive options should only be zero or negative (backhaul). On exit points at zero available capacity the shipping duty plus the negative options should only be zero or positive (backhaul). Cannot import read-only nomination item! OPT_POS, OPT_NEG row requires presence of NOM row with the same point and shipper pair. On a trade virtual point only TRADE nomination rows are interpreted! KFRE nomination is only interpreted on physical entry points.
FGSZ Zrt.