FGSZ ZRT.
INFORMATIKAI PLATFORM SZERVER-SZERVER ILLESZKEDÉSI FELÜLET 8.1 VERZIÓ
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
2/140
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 .................................................................................................................... 25
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
3/140 4.3.10 Hibakezelés ....................................................................................................................................... 26 4.3.11 Alkalmazott mértékegységek táblázata............................................................................................ 27
5. A fejlesztés támogatása: Echo ............................................................................................................ 29 6. Nominálás ........................................................................................................................................... 30 6.1. Nominálási adatok beküldése (SaveNomination) ....................................................................................... 30 6.1.1 A kérést tartalmazó üzenet ................................................................................................................. 38 6.1.2 A választ tartalmazó üzenet ................................................................................................................ 40 6.2. Trade ajánlatok beküldése (SaveTradeNomination) .................................................................................. 41 6.2.1 A kérést tartalmazó üzenet ................................................................................................................. 44 6.2.2 A választ tartalmazó üzenet ................................................................................................................ 45 6.3. Trade ajánlatok lekérdezése (GetTradeNomination) ................................................................................. 46 6.3.1 A kérést tartalmazó üzenet ................................................................................................................. 46 6.3.2 A választ tartalmazó üzenet ................................................................................................................ 47 6.4. Trade ajánlatok jóváhagyása (TradeNominationConfirmation) ................................................................. 48 6.4.1 A kérést tartalmazó üzenet ................................................................................................................. 51 6.4.2 A választ tartalmazó üzenet ................................................................................................................ 51 6.5. Beküldött nominálási adatok verziószámmal (GetNomination) ................................................................. 52 6.5.1 A kérést tartalmazó üzenet ................................................................................................................. 52 6.5.2 A választ tartalmazó üzenet ................................................................................................................ 53 6.6. Beküldött nominálások státusza (GetNominationInfo) .............................................................................. 63 6.6.1 A kérést tartalmazó üzenet ................................................................................................................. 63 6.6.2 A választ tartalmazó üzenet ................................................................................................................ 64 6.7. Nominálások felosztása (divideNomination) .............................................................................................. 65 6.7.1 A kérést tartalmazó üzenet ................................................................................................................. 65 6.7.2 A választ tartalmazó üzenet ................................................................................................................ 67
7. Opciók közzététele (OptionReportService) ........................................................................................ 69 7.1. A kérést tartalmazó üzenet ........................................................................................................................ 69 7.2. A választ tartalmazó üzenet........................................................................................................................ 69
8. Napi operatív szállítórendszeri („14 órás”) adatszolgáltatás (OperativeTSODataService14H) .......... 73 8.1. A kérést tartalmazó üzenet ........................................................................................................................ 74 8.2. A választ tartalmazó üzenet........................................................................................................................ 74
9. Nap közbeni allokálások szállíttatóknak (GetAllocationsForShipper) ................................................ 80 9.1. A kérést tartalmazó üzenet ........................................................................................................................ 80 9.2. A választ tartalmazó üzenet........................................................................................................................ 81
10. 10 órás adatszolgáltatás (OperativeTSODataService10H) ............................................................... 84 Gázipari Kommunikációs Szabvány
FGSZ Zrt.
4/140 10.1. A kérést tartalmazó üzenet ...................................................................................................................... 85 10.2. A választ tartalmazó üzenet ..................................................................................................................... 85
11. Napi allokálási adatok rendszerüzemeltetők általi beküldése (AllocationService) .......................... 89 11.1. A kérést tartalmazó üzenet ...................................................................................................................... 90 11.2. A választ tartalmazó üzenet ..................................................................................................................... 93
12. Havi allokálási adatok rendszerüzemeltetők általi beküldése (AllocationService) .......................... 95 12.1. A kérést tartalmazó üzenet ...................................................................................................................... 96 12.2. A választ tartalmazó üzenet ..................................................................................................................... 96
13.
Allokált óracsúcs adatok rendszerüzemeltetők általi beküldése (AllocationHourlyPeakService) ........................................................................................................ 97
13.1. A kérést tartalmazó üzenet ...................................................................................................................... 98 13.2. A választ tartalmazó üzenet ..................................................................................................................... 99
14. Operatív matching .......................................................................................................................... 101 14.1. NNO matching adatok beküldése (NnoMatchingInputService) .............................................................101 14.1.1 A kérést tartalmazó üzenet ............................................................................................................. 102 14.1.2 A választ tartalmazó üzenet ............................................................................................................ 104 14.2. Operatív matching eredményének lekérdezése (OperativeMatchingResult) ........................................104 14.2.1 A kérést tartalmazó üzenet ............................................................................................................. 105 14.2.2 A választ tartalmazó üzenet ............................................................................................................ 105
15. Alapadatok lekérdezése ................................................................................................................. 110 15.1. Hálózati pontok lekérdezése (GetValidNetworkUnitCode) ....................................................................110 15.1.1 A kérést tartalmazó üzenet ............................................................................................................. 110 15.1.2 A választ tartalmazó üzenet ............................................................................................................ 110 15.2. Partnerek lekérdezése (GetValidPartnersCode) .....................................................................................112 15.2.1 A kérést tartalmazó üzenet ............................................................................................................. 112 15.2.2 A választ tartalmazó üzenet ............................................................................................................ 113
16. Kapacitás átadás/átvétel bejelentése (Fogyasztó vándorlás) ........................................................ 115 16.1. Kapacitás átadás (SaveCustomerMigration) ...........................................................................................115 16.1.1 A kérést tartalmazó üzenet ............................................................................................................. 115 16.1.2 A választ tartalmazó üzenet ............................................................................................................ 118
17. KP piaci információk ....................................................................................................................... 120 17.1. Beadott ajánlatok ...................................................................................................................................120 17.1.1 A kérést tartalmazó üzenet - Beadott ajánlatok ............................................................................. 120
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
5/140 17.1.2 A választ tartalmazó üzenet - Beadott ajánlatok ............................................................................ 121 17.2. Megkötött ügyletek ................................................................................................................................124 17.2.1 A kérést tartalmazó üzenet – Megkötött ügyletek.......................................................................... 124 17.2.2 A választ tartalmazó üzenet – Megkötött ügyletek ........................................................................ 124
18. Ajánlat fogadó interface ................................................................................................................. 127 18.1.1 A kérést tartalmazó üzenet – Ajánlat befogadás vagy módosítás kérés ........................................ 127 18.1.2 A választ tartalmazó üzenet - Beadott ajánlatok ............................................................................ 132 18.1.3 A kérést tartalmazó üzenet – Ajánlat visszavonáskérés.................................................................. 134 18.1.4 A választ tartalmazó üzenet – Ajánlat visszavonás válasz .............................................................. 135 18.1.5 Hibakódok, Hibaüzenetek ............................................................................................................... 137
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
6/140
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.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
7/140
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 Email-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.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
8/140
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.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
9/140
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ó
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.§
(LDC - Local Distribution Company, vagy DSO: Distribution System Operator)
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.§
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
10/140
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ű
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
11/140
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.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
12/140
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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
13/140
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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
14/140
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.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
15/140
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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
16/140
Entitás
Egy egyed előfordulás, jelen esetben felhasználó egyed.
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.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
17/140
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.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
18/140
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:
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
19/140
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.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
20/140
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).
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
21/140
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.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
22/140 (Ü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))
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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
23/140
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.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
24/140 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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
25/140
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.
4.3.9 A FELDOLGOZÁS SIKERESSÉGE
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
26/140 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
Sorszám
Az eredetileg fogadott üzenet azon nominálási sorának száma, amelyre a hibasor vonatkozik. Csak akkor van jelen, ha
lineNumber
Pozitív egész, xs:int
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
27/140 kifejezetten valamely nominálási sorhoz köthető. 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"/>
4.3.11 ALKALMAZOTT MÉRTÉKEGYSÉGEK TÁBLÁZATA Dimenzió / alkalmazás Térfogat Energiamennyiség Órai energiamennyiség
Mértékegység 3 Gáztechnikai normál m kWh kWh / h
Gázipari Kommunikációs Szabvány
Kód MQ5 KWH KW1
FGSZ Zrt.
28/140 Napi energiamennyiség Égéshő vagy fűtőérték
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
Gázipari Kommunikációs Szabvány
3
KW2 KW3 HUF _3B JM1 JM2 JM
KMQ MOL Z99
FGSZ Zrt.
29/140
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ó.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
30/140
6. NOMINÁLÁS 6.1. NOMINÁLÁSI ADATOK BEKÜLDÉSE (SAVENOMINATION) Ü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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
31/140 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.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
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 FGSz-szel 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 + OPT_NEG) bele kell férnie a
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 szerződött napi kapacitást érje el!
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
33/140 Ellenőrzés
Hibaüzenet azonosítója
rendelkezésre álló szerződött órai kapacitásba.
Hibaüzenet szövege
Megoldás
kapacitásba!
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 úgy, hogy szállíttató páronként csak
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
34/140 Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás 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 vagy pozitívnak kell lennie!
Módosítsa az adott NOM típusú nominálási sorban foglalt mennyiséget úgy, hogy zérus, vagy pozitív legyen (betartva az adott
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
35/140 Ellenőrzés
Hibaüzenet azonosítója
Hibaüzenet szövege
Megoldás hálózati ponton érvényben lévő kapacitásfoglalásokat)!
pozitívnak kell lennie.
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. (Ha a szállíttatónak nincs backhaul
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!
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
36/140 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 bilat értékesítés útján) a
Nomination.Error.Business.215
Kiadási ponton zérus rendelkezésre álló kapacitás esetén a negatív opcióval együtt vett szállítási feladat csak zérus v. pozitív
Az adott ponton módosítsa nominálási sorait úgy, hogy szállítási feladata pontosan zérus
kapacitása, akkor azt zérusnak kell tekinteni.)
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
37/140 Ellenőrzés
Hibaüzenet azonosítója
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
(backhaul) lehet!
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!
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
interkonnektor
Értesítse a rendszergazdát!
6.1.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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
39/140
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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
40/140
PÉLDA
2 KAMOSONM1IIN <shipperPair codingScheme="ZZZ">TESTSHIPPERPAIR 1 2000 … 24 3200
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:
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)
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
41/140 o
Vonatkozó hálózati pont
o
Szállíttató pár
6.2. 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.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
42/140 Ü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:
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
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!
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 trade jogosultsága.
Nomination.Error.Business.206
Trade jogosultság hiányzik a hálózati ponton.
Vegye fel a kapcsolatot az FGSzszel!
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 FGSz-szel 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 FGSz-szel trade jogosultságigénylés céljából!
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
6.2.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
Megjegyzés
Gázipari Kommunikációs Szabvány
napi
comment
FGSZ Zrt.
45/140 PÉLDA
1 lineNumber > VETELJCS17EN HUFSHP 2400000 Budapest tradeAgreement >
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 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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
46/140
6.3. 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.3.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ázipari Kommunikációs Szabvány
FGSZ Zrt.
47/140
Gáznap – aktuális gáznap
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
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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
48/140 PÉLDA 10011587 aggreementID > 10011587 gasDay > <status>RECEIVED status > VETELJCS17EN <seller codingScheme="ZZZ">HUFSHP1 HUFSHP2 2400000 Budapest Agreement >
6.4. 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.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
49/140 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:
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
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!
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 trade jogosultsága.
Nomination.Error.Business.206
Trade jogosultság hiányzik a hálózati ponton.
Vegye fel a kapcsolatot az FGSzszel!
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 FGSz-szel 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 FGSz-szel trade jogosultságigénylés céljából!
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
6.4.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.4.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)
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
52/140
Ajánlat azonosítója
Elvégzett művelet
6.5. 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.5.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)
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
53/140
Verziószám
6.5.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
lineNumber
Pozitív egész
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
54/140 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 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
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ó
lineNumber
Pozitív egész
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
55/140 hivatkozás. 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
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ó
lineNumber
Pozitív egész
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
56/140 hivatkozás. 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
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
lineNumber
Pozitív egész
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
57/140 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 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
measureUnit
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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
58/140 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 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
measureUnit
PÉLDA
4 KAMOSONM1IIN <shipperPair codingScheme="ZZZ">TESTSHIPPERPAIR 1,1234 1 2000 … 24 3200
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
59/140
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 á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
measureUnit
PÉLDA
4 KAMOSONM1IIN <shipperPair codingScheme="ZZZ">TESTSHIPPERPAIR 1,1234 1
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
60/140
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ó 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 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 Gázipari Kommunikációs Szabvány
FGSZ Zrt.
61/140
<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 – 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 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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
62/140 PÉLDA
4 KAMOSONM1IIN <shipperPair codingScheme="ZZZ">TESTSHIPPERPAIR 1 2000 … 24 3200 KIEGÉSZÍTŐ ADATOK version creationTime status 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:version>4 <ns3:creationTime>2010-08-30T10:46:27.414+02:00 <ns3:status>REFUSED
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
63/140
6.6. 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.6.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)
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
64/140
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
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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
65/140
6.7. 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.7.1 A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS
divideNomination
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
66/140 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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
67/140 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.7.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.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
68/140
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)
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
69/140
7. OPCIÓK KÖZZÉTÉTELE (OPTIONREPORTSERVICE) ÜZLETI CÉL, KÖRNYEZET A cél a szállíttatók által tett opciók közzététele, az IP-n az Adatszolgáltatások > Kimutatások > Opciók közzététele menüpontban elérhető adatok web service-en keresztül történő letöltése adott gáznapra.
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 partner az opciókat és KFRE ajánlatokat bármikor lekérdezheti.
7.1. A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS OptionReportService
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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
70/140 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
1. opciós sor
2. opciós sor
…
1. KFRE sor
2. KFRE sor
…
AZ OPT_POS TÍPUSÚ NOMINÁLÁSI SOROK XML-BLOKKJÁNAK AZONOSÍTÓJA optionPositiveInfoLine
MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Hálózati pont
Hálózati pont (ld. 4.3.2)
networkPoint
Location
Nominált mennyiség
Az opciós mennyiség kWh-ban. Nemnegatív egész szám.
dailyQuantity
Quantity
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
measureUnit
PÉLDA
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
71/140
KAMOSONM1IIN 2000 1,1234 AZ OPT_NEG TÍPUSÚ NOMINÁLÁSI SOROK XML-BLOKKJÁNAK AZONOSÍTÓJA optionNegativeInfoLine
MEZŐK
Megnevezés
Leírás
XML címkenév
Formátum / típus
Hálózati pont
Hálózati pont (ld. 4.3.2)
networkPoint
Location
Nominált mennyiség
Az opciós mennyiség kWh-ban. Negatív egész szám, vagy zérus.
dailyQuantity
Quantity
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
measureUnit
PÉLDA
KAMOSONM1IIN 2000 1,1234 A KFRE TÍPUSÚ NOMINÁLÁSI SOROK XML-BLOKKJÁNAK AZONOSÍTÓJA kfreInfoLine
MEZŐK
Megnevezés
Leírás
Gázipari Kommunikációs Szabvány
XML címkenév
Formátum / típus
FGSZ Zrt.
72/140 Hálózati pont
Hálózati pont (ld. 4.3.2)
networkPoint
Location
Nominált mennyiség
Az opciós mennyiség kWh-ban. Nemnegatív egész szám.
dailyQuantity
Quantity
KFRE ár
KFRE ár pontossággal.
optionPrice
Price
KFRE ár mértékegysége
Az a mértékegység, amelyre a KFRE ár vonatkozik. Jelenleg csak a kWh értelmezett, melyet a „KWH” konstans jelöl.
4
tizedesjegy
measureUnit
PÉLDA
KAMOSONM1IIN 2000 1,1234
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
73/140
8. 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ó.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
74/140
8.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
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
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
…
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
75/140 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
Gázipari Kommunikációs Szabvány
MJ/m3 mol% mol% mol% mol%
FGSZ Zrt.
76/140
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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
77/140 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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
78/140
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
Gázipari Kommunikációs Szabvány
/
FGSZ Zrt.
79/140 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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
80/140
9. 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ó.
9.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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
81/140
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
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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
82/140 Intervallum
Az allokált időszak
interval
xs:string
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)
optionPrice
Price
Gázipari Kommunikációs Szabvány
/
FGSZ Zrt.
83/140 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 Nominált mennyiség
Az adott nominálási sorban foglalt nominálási mennyiség kWhban
nominationQuantity
Quantity
Allokált mennyiség
Az adott nominálási sornak megfelelő allokált mennyiség kWh-ban
allocationQuantity
Quantity
PÉLDA
<shipperPair codingScheme="ZZZ">SHIPPERCODE <nominationKind>OPT_POS 12.1234 <nominationQuantity measureUnit="KWH">-452000 -200000
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
84/140
10. 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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
85/140
Ü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ó.
10.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
10.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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
86/140 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
Gázipari Kommunikációs Szabvány
MJ/m3 mol% mol% mol% mol% mol% mol% mol% mol% kWh/m3 MJ/m3 mol% mol%
FGSZ Zrt.
87/140
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
Gázipari Kommunikációs Szabvány
Formátum / típus
Quantity
FGSZ Zrt.
88/140 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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
89/140
11. 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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
90/140 Ü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
11.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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
91/140 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
MEZŐK
Megnevezés
Leírás
Gázipari Kommunikációs Szabvány
XML címkenév
Formátum
/
FGSZ Zrt.
92/140 típus 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 sorok
optionPrice
Nominált mennyiség
Az adott nominálási
dailyNominationQuantity
Gázipari Kommunikációs Szabvány
Quantity
FGSZ Zrt.
93/140 sorban nominálási mennyiség ban Allokált mennyiség kWhban
foglalt kWh-
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
11.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.
Hibaüzenet-sorok az alábbiak szerint (ld. 4.3.10 pont):
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
94/140 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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
95/140
12. 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.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
96/140
12.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.
12.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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
97/140
13. 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.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
98/140 ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK
13.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
Gázipari Kommunikációs Szabvány
/
(ÉÉÉÉ-
FGSZ Zrt.
99/140 Ó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
13.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.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
100/140
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)
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
101/140
14. OPERATÍV MATCHING 14.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.
Ü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.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
102/140 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 vagy, minden soron meg kell adni szállíttató párt, vagy mindegyiknél el kell hagyni. 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.
14.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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
103/140 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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
104/140
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 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)
14.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.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
105/140
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 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
14.2.2 A VÁLASZT TARTALMAZÓ ÜZENET
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
106/140 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
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
operator
Gázipari Kommunikációs Szabvány
Formátum / típus
Party
FGSZ Zrt.
107/140 matching adatok csatlakozó rendszerüzemeltető általi lekérdezése esetén ennek a mezőnek az értéke minden sorban azonos)
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
Átvevő kódja
Azon szállíttató kódja, amely az adott hálózati ponton a földgázt átveszi.
recipient
Party
Nominálási sor típusa (NOM / BH / OPT_POS / OPT_NEG / HEG_POS / HEG_NEG)
nominationKind
A lekérdezett gázóra (1 25)
gasHour
Nominálási típusa
Gázóra
sor
Gázipari Kommunikációs Szabvány
xsd:integer
FGSZ Zrt.
108/140 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ő sorban jelenik meg.
matchingState
MATCH / QUANTITY_MISMATCH / NO_FRI_DATA / NO_NNO_MATCHING_D ATA
által
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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
109/140
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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
110/140
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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
111/140 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
Gázipari Kommunikációs Szabvány
Formátum / típus
FGSZ Zrt.
112/140 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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
113/140 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
Gázipari Kommunikációs Szabvány
Formátum / típus
FGSZ Zrt.
114/140 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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
115/140
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.
16.1.1 A KÉRÉST TARTALMAZÓ ÜZENET
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
116/140 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ó
FV_nnnnnn
PÉLDA
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
117/140 <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
Gázipari Kommunikációs Szabvány
(nem / /
FGSZ Zrt.
118/140 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
Gázipari Kommunikációs Szabvány
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
Gázipari Kommunikációs Szabvány
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
MEZŐK
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
121/140 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
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
traderMember
xs:string
Kereskedő
Az ajánlatot beadó Partner
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
122/140 cég
(cég).
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
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
Státusz
Kapacitás típus
vagy
Gázipari Kommunikációs Szabvány
<xs:simpleType name="CapacityType"> <xs:restriction base="xs:string"> <xs:enumeration value="FIRM"/> <xs:enumeration value="INTERRUPTIBLE"/>
FGSZ Zrt.
123/140
Hálózati pont kód
networkUnit
<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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
124/140
17.2. MEGKÖTÖTT ÜGYLETEK 17.2.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 2011-07-01 2011-07-30
17.2.2 A VÁLASZT TARTALMAZÓ ÜZENET – MEGKÖTÖTT ÜGYLETEK METÓDUS getTrades XML-BLOKKJÁNAK AZONOSÍTÓJA GetTradesResponse
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
125/140 Ü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 kWh-ra 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
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:string
Vevő
Vevő partner kódja
buyerMember
xs:string
Eladó
Eladó partner
sellerMember
xs:string
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
126/140 kódja Ügyletkötés ideje
tradeTime
xs:dateTime
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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
127/140
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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
128/140 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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
129/140 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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
130/140 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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
131/140 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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
132/140 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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
133/140 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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
134/140 <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 MEZŐK Megnevezés
Leírás
Gázipari Kommunikációs Szabvány
XML címkenév
Formátum / típus
FGSZ Zrt.
135/140 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
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
136/140 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.
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
137/140
18.1.5 HIBAKÓDOK, HIBAÜZENETEK
Hibakód
Hibaüzenet
INVALID_PRODUCT
Invalid product!
INVALID_VOLUME
Volume of order must be above or equal 0!
INVALID_PRICE
Offered price is invalid!
INVALID_EXPIRY_DATE
Date of expiry is invalid!
INVALID_PARTNER
Invalid partner!
INVALID_ORDER_TYPE
Invalid order type!
SUSPENDED_PARTNER
Suspended member!
SUSPENDED_USER
Suspended trader!
CAPACITY_UNCOVERED
Uncovered capacity!
FINANCE_UNCOVERED
Not enough financial deposit!
OPPOSITE_ORDER_MISSING
Opposite sided order does not exist!
EXISTING_HEGO_KFRE_ORDER
Existing HEGO/KFRE order!
PAST_MARKET
You have tried to input order into an already closed market.
INVALID_HEG_GASHOUR
Invalid HEG order!
MARKET_CLOSED
Closed market.
SERVER_ERROR
INVALID_NETWORK_UNIT
Server error! HEGO/KFRE offer may be modified only to be more favorable for FGSZ during re-nomination! Invalid network point.
INVALID_PRODUCT_ON_UNIT
This product cannot be traded on this network point.
ORDER_MISSING
Order does not exist.
ORDER_CANNOT_WITHDRAWN
Order can not be withdraw.
INVALID_CAPACITY_TYPE
Capacity type is invalid or have not been set.
INVALID_INSTRUMENT
Invalid instrument!
INVALID_SHIPPER_PAIR
Invalid shipper pair!
INVALID_HOUR
Invalid validity hour!
INVALID_GASDAY
Gasday must be refer at least one day before current date!
CANNOT_MODIFY_PRODUCT
Not allowed to modify product!
CANNOT_MODIFY_GASDAY
Not allowed to modify gasday!
CANNOT_MODIFY_DIRECTION
Not allowed to modify direction!
CANNOT_MODIFY_NETWORK_UNIT
Not allowed to modify networkunit point!
CANNOT_MODIFY_CAPACITY_TYPE
Not allowed to modify networkunit point!
CANNOT_MODIFY_SHIPPER
Not allowed to modify shipper!
WHOLE_GASDAY_NOT_AVAILABLE
Not allowed to select whole gasday!
INVALID_BID_TYPE
Invalid bid type!
INVALID_DIRECTION
Invalid direction!
CANNOT_MODIFY_ORDER
Not allowed to modify order!
NOMINATION_ERROR
Nomination error.
Nomination.Error.Business.100
No valid capacity contract on the network point!
TSO_UNFAVOURABLE_MODIFICATION
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
138/140 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 Nomination.Error.Business.124 Nomination.Error.Business.126
Gázipari Kommunikációs Szabvány
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! 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!
FGSZ Zrt.
139/140 Hibakód
Nomination.Error.Business.138
Hibaüzenet 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.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. 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!
Nomination.Error.Business.208
Nomination.Error.Business.213
Nomination.Error.Business.214 Nomination.Error.Business.215 Nomination.Error.Business.216
Gázipari Kommunikációs Szabvány
FGSZ Zrt.
140/140 Hibakód Nomination.Error.Business.217 Nomination.Error.Business.300 Nomination.Error.Business.303
Gázipari Kommunikációs Szabvány
Hibaüzenet 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.