Reginal Bking Platfrm Webservice szlgáltatás illeszkedési felület dkumentáció 4.4 verzió Készítette: IP Rendszerintegrátr Kft.
Tartalmjegyzék 1. A dkumentum célja... 5 2. Bevezetés... 6 3. Fgalmtár... 7 3.1. Hálózati infrastruktúra... 7 3.2. Szereplők... 8 4. Alapelvek... 9 4.1. Kncepció... 9 4.2. Műszaki infrmatikai megvalósításra vnatkzó alapelvek... 10 4.2.1 Rendelkezésre állás... 10 4.2.2 A reginal bking platfrm elérhetősége... 10 4.2.3 Aznsítás, tanúsítványk... 10 4.2.4 Alkalmaztt prtkllk, kódlás... 10 4.2.5 Üzenetek érvényessége validálás... 11 4.2.6 Archiválás... 11 5. Ajánlatadás... 12 5.1. Aukció adatk lekérdezése (getauctins)... 12 5.1.1 A kérést tartalmazó üzenet... 13 5.1.2 A választ tartalmazó üzenet... 13 5.2. Tömeges ajánlat beadás (bulkmakebids)... 18 5.2.1 A kérést tartalmazó üzenet... 22 5.2.2 A választ tartalmazó üzenet... 23 5.3. UPTA ajánlatk törlése (bulkremveuptabids)... 24 5.3.1 A kérést tartalmazó üzenet... 27 5.3.2 A választ tartalmazó üzenet... 27 6. Web service kmmunikáció az RBP és a TSO Tag között... 29 6.1. Tarifa és áradatk küldése IP-ből RBP-be... 29 6.2. RBP aukciók eredményeinek imprtja... 34 6.3. RBP aukciók eredményeinek imprtja v2... 40 7. Bilaterális kapacitás átadás... 48 7.1. Bilaterális ajánlat beadás (OfferBilateralCapacity)... 48 7.1.1 A kérést tartalmazó üzenet... 51 7.1.2 A választ tartalmazó üzenet... 52
7.2. Bilaterális kapacitás átadásk lekérdezése üzemeltetők számára (GetBilateralOffersByTs)... 53 7.2.1 A kérést tartalmazó üzenet... 54 7.2.2 A választ tartalmazó üzenet... 55 7.3. Bilaterális kapacitás átadásk lekérdezése az átadó számára (GetBilateralOffersBySeller)... 58 7.3.1 A kérést tartalmazó üzenet... 59 7.3.2 A választ tartalmazó üzenet... 60 7.4. Bilaterális kapacitás átadásk lekérdezése az átvevő számára (GetBilateralOffersByBuyer)... 63 7.4.1 A kérést tartalmazó üzenet... 64 7.4.2 A választ tartalmazó üzenet... 65 7.5. Bilaterális kapacitás átadás elutasítása üzemeltetők számára (RefuseBilateralOfferByTs)... 68 7.5.1 A kérést tartalmazó üzenet... 71 7.5.2 A választ tartalmazó üzenet... 71 7.6. Bilaterális kapacitás átadás jóváhagyása üzemeltetők számára (ApprveBilateralOfferByTs) 72 7.6.1 A kérést tartalmazó üzenet... 75 7.6.2 A választ tartalmazó üzenet... 75 7.7. Bilaterális kapacitás átadás visszavnása az átadó számára (RevkeBilateralOfferBySeller)... 76 7.7.1 A kérést tartalmazó üzenet... 78 7.7.2 A választ tartalmazó üzenet... 78 7.8. Bilaterális kapacitás átadás visszautasítása az átvevő számára (RejectBilateralOfferByBuyer) 79 7.8.1 A kérést tartalmazó üzenet... 82 7.8.2 A választ tartalmazó üzenet... 84 7.9. Bilaterális kapacitás átadás jóváhagyása átvevők számára (ApprveBilateralOfferByBuyer).. 84 7.9.1 A kérést tartalmazó üzenet... 87 7.9.2 A választ tartalmazó üzenet... 87 7.10. Bilaterális kapacitás átadás lezárás üzemeltetők számára (ClseBilateralOfferByTs)... 88 7.10.1 A kérést tartalmazó üzenet... 90 7.10.2 A választ tartalmazó üzenet... 90 8. Kapacitás visszaadás... 92 8.1. kapacitás visszaadás ajánlat beadás (OfferSurrenderedCapacity)... 92 8.1.1 A kérést tartalmazó üzenet... 94 8.1.2 A választ tartalmazó üzenet... 95 8.2. Kapacitás visszaadásk lekérdezése üzemeltetők számára (GetSurrenderedCapacityOffersByTs)... 96 8.2.1 A kérést tartalmazó üzenet... 97 8.2.2 A választ tartalmazó üzenet... 97 8.3. Kapacitás Visszaadásk lekérdezése a visszaadó számára (GetSurrenderedCapacityOffersByNetwrkUser)... 101 8.3.1 A kérést tartalmazó üzenet... 102
8.3.2 A választ tartalmazó üzenet... 102 8.4. Kapacitás visszaadás elutasítása üzemeltetők számára (RefuseSurrenderedCapacityOfferByTs)... 105 8.4.1 A kérést tartalmazó üzenet... 108 8.4.2 A választ tartalmazó üzenet... 108 8.5. Kapacitás visszaadás jóváhagyása üzemeltetők számára (ApprveSurrenderedCapacityOfferByTs)... 109 8.5.1 A kérést tartalmazó üzenet... 111 8.5.2 A választ tartalmazó üzenet... 111 8.6. Kapacitás visszaadás visszavnása a visszaadó számára (RevkeSurrenderedCapacityOfferByNetwrkUser)... 112 8.6.1 A kérést tartalmazó üzenet... 114 8.6.2 A választ tartalmazó üzenet... 114 8.7. Kapacitás visszaadás ajánlat visszajelzés üzemeltetők számára (CnfirmSurrenderedCapacityOfferByTs)... 115 8.7.1 A kérést tartalmazó üzenet... 118 8.7.2 A választ tartalmazó üzenet... 118
1. A DOKUMENTUM CÉLJA Jelen dkumentumnak az a célja, hgy a rendszerirányítói engedélyes (FGSZ) és együttműködő partnerei, azaz a RBP TSO Tagjai, RBP Rendszerhasználói Tagjai közötti, az peratív üzletmenet srán alkalmazható, szerver-szerver kmmunikáció alapelveit rögzítse, és üzenetfrmátumait definiálja.
2. BEVEZETÉS A gáziparban a gyakrlati üzletmenet srán intenzív, infrmatikai útn flytattt kmmunikáció zajlik az egyes gázipari szereplők között. Jellegzetes példaként ide srlható a nminálás, az allkálás, a mérési adatk szlgáltatásának területe vnatkzzn az akár földgázszállítói, akár elsztói, akár tárlói rendszerre, és legyen az abban érintett akár rendszerhasználó, akár rendszerüzemeltető. Jelenleg az üzenetváltásk jelentős része E-mail-en, illetve Excel állmányk cseréje révén valósul meg, amely nagybb adatmennyiségek esetén általában mind a küldő, mind a fgadó részére kevéssé hatékny megldásnak biznyul. Mind a rendszerüzemeltetők, mind a rendszerhasználók számára kedvezőbb, és számttevően hatéknyabb, ha a mindennapi üzletmenet srán válttt üzenetek cseréje a partnerek infrmatikai platfrmjai között közvetlenül, önműködően, és érdemi emberi közreműködést nélkülöző módn valósul meg. Ezáltal skkal nagybb tömegű adat knzisztens, é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ú kmmunikáció frmáját hivattt meghatárzni. A kmmunikáció kétldalú jellege miatt a dkumentum is kettős, az FGSZ és Partnerei közötti üzenetváltásk leképezése érdekében. A tvábbi fejezetekben előbb az alapfgalmak, majd a kncepció, az általáns alapelvek, végül az egyes knkrét üzenetfrmátumk ismertetésére kerül sr.
3. FOGALOMTÁR 3.1. HÁLÓZATI INFRASTRUKTÚRA RBP Kapacitás Ascending Clck (ACTA) aukció A Reginal Bking Platfrm lyan elektrnikus kapacitás kereskedelmi platfrm, amely kapacitáslekötési platfrmként megfelel a földgázellátásról szóló 2008. évi XL törvénynek valamint a 984/2013/EU számú Bizttsági rendeletnek. Az RBP Alkalmazás és RBP Prtál együttesen alktja a Reginal Bking Platfrmt. Valamely földgáz-szállító hálózati (akár absztakt) elem földgázáteresztő képessége, azaz azn tulajdnsága, hgy egységnyi időtartam alatt milyen mennyiségű földgáz kibcsátására képes. Alkalmaztt mértékegysége a kw/h és kwh/nap. Az elszámlásra használt mértékegység a TSO Tag és Rendszerhasználó Tag által és köztük megkötött szerződésben van kikötve. A szerződés az adatkat mindkét módn kifejezve tartalmazza Az emelkedőáras aukció lyan aukció, amelyben a rendszerhasználó srrendben bejelentett, meghatárztt árlépcsők szerint igényel mennyiségeket. Unifrm Price (UPTA) aukció Az egyenáras aukció srán a rendszerhasználó egy egykörös ajánlattételi kör srán mind mennyiségi mind árra vnatkzó ajánlatkat ad be, és minden rendszerhasználó, aki elnyer kapacitást, a legalacsnyabb sikeres ajánlat árát fizeti meg. Large Price Step (LPS) Small Price Step (SPS) A nagy árlépcső lyan rögzített vagy váltzó összeg, amely rendszerösszekötési pntnként és szabványs kapacitástermékekként van meghatárzva. A kis árlépcső lyan rögzített vagy váltzó összeg, amely rendszerösszekötési pntnként és szabványs kapacitástermékenként van meghatárzva, és amely kisebb, mint a nagy árlépcső.
3.2. SZEREPLŐK Szállítási rendszerüzemeltető tag (TSO Tag) Rendszerhasználó Tag (NU Tag) Reginal Bking Platfrm Üzemeltető (RBP Üzemeltető) Olyan szállítási rendszerüzemeltető, aki az RBP-n keresztül allkál és köt szerződéseket kapacitáskra, valamint igénybe vesz más kínált szlgáltatáskat is. Az önmagában is egy RBP TSO Tag. Az RBP-re a platfrmn allkált kapacitás lekötés, átruházás vagy szerződéskötés, valamint egyéb kínált szlgáltatás igénybe vételének céljából regisztrált természetes vagy jgi személy. A Reginal Bking Platfrmt üzemeltető jgi szeméy, amely az FGSZ Földgázszállító Zártkörűen Működő Részvénytársaság (FGSZ).
4. ALAPELVEK 4.1. KONCEPCIÓ Jelen specifikáció két fél, mint gázipari szereplő infrmatikai platfrmja közötti kmmunikáció frmáját rögzíti. Mint az 1. ábra mutatja, ebből a szempntból a küldő és a fgadó szerepben levő infrmatikai platfrm közötti különbségtételre kerül sr. 1. ÁBRA: A KÜLDŐ ÉS A FOGADÓ INFORMATIKAI PLATFORM EGYÜTTMŰKÖDÉSE Azt, hgy melyik engedélyes infrmatikai platfrmja tölti be a küldő ill. fgadó szerepet, az adtt üzleti tevékenység határzza meg. Az egyes üzenetfrmátumk leírásánál található Szereplők, szerepkörök rvatban mindig egyértelműen rögzített, hgy a küldő ill. fgadó szerepét mely engedélyes infrmatikai rendszere tölti be. Jelen specifikáció alapkncepciója, hgy minden esetben a küldő fél egy kérést tartalmazó üzenetet küld a másik, fgadó félnek. A fgadó fél a kaptt üzenetet feldlgzza, majd annak eredményét a válaszban a küldőnek eljuttatja. Minden egyes üzleti tevékenység esetén meghatárztt, hgy a kérésnek és a válasznak milyen struktúrában milyen adatkat kell tartalmaznia. Műszaki megvalósítást tekintve a specifikáció alapkncepcióját a 2. ábra mutatja. 2. ÁBRA: A SPECIFIKÁCIÓ MŰSZAKI INFORMATIKAI ALAPKONCEPCIÓJA A fgadó infrmatikai platfrmnak tehát egy HTTPS-en keresztül elérendő web service-es felületet kell biztsítania. Az üzenetváltásk SOAP-n keresztül, XML üzenetek frmájában valósulnak meg. A fgadó 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ánykat, mind a web service-ek leírását, mind az alkalmazandó XML üzenetstruktúrákat jelen dkumentum rögzíti. 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 kmmunikáció flytatása érdekében. Ezen a szerveren kell elérhetőnek lennie azn webszlgáltatásnak, amely a kmmunikációt lehetővé teszi. 4.2.2 A REGIONAL BOOKING PLATFORM ELÉRHETŐSÉGE A szlgáltatás igénybevételének alapfeltétele, hgy az engedélyes megküldje a rendszerirányítónak azn kiszlgá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://test.rbp.eu/app/services/ Itt található minden elérhető szlgáltatás. A szlgáltatásk leírása a kívánt szlgáltatás kiválasztásával érhető el. Az éles prduktív szerver SOAP interfészének elérhetősége: https://rbp.eu/app/services/ Itt található minden elérhető szlgáltatás. A szlgáltatásk leírása a kívánt szlgáltatás kiválasztásával érhető el. Amennyiben az éles környezet a fenti címen nem elérhető, mert az RBP a tartalék környezetben üzemel, akkr a következő címen érhető el: https://standby.rbp.eu/app/services/ Itt található minden elérhető szlgáltatás. A szlgáltatásk leírása a kívánt szlgáltatás kiválasztásával érhető el. A web service elkészítését követően javasljuk a kliens ldali prgram elkészítését úgy, hgy paraméterezhetően, vagy akár autmatikusan át tudjn állni a tartalék RBP hívására, ha az éles környezet nem elérhető. 4.2.3 AZONOSÍTÁS, TANÚSÍTVÁNYOK A web service-ek alkalmazása srán tanúsítvány-alapú aznsítás történik, azaz: az FGSZ infrmatikai platfrmjára minden partner csak az azn alkalmaztt tanúsítvánnyal küldhet üzenetet 4.2.4 ALKALMAZOTT PROTOKOLLOK, KÓDOLÁS A kmmunikáció HTTPS prtklln zajlik, melyen keresztül XML (1.0 ötödik kiadás, http://www.w3.rg/tr/xml/) üzenetek cseréjére kerül sr A web szlgáltatásk hívása minden esetben szinkrn módn történik Szabványk:
UTF-8 : http://www.ietf.rg/rfc/rfc2279.txt HTTPS: http://tls.ietf.rg/html/rfc2818 SOAP: http://tls.ietf.rg/html/rfc3288 XML Séma leírók elérhetősége xmlns:sapenv="http://schemas.xmlsap.rg/sap/envelpe/" xmlns:xsd= http://www.w3.rg/2001/xmlschema xmlns:xsi=http://www.w3.rg/2001/xmlschema-instance 4.2.5 ÜZENETEK ÉRVÉNYESSÉGE VALIDÁLÁS Egy üzenet minden esetben akkr, és csak akkr minősül érvényesnek, ha a jelen specifikációban rögzített frmai és tartalmi követelményeknek eleget tesz. (Amennyiben tehát egy üzenet nem felel meg a frmai és tartalmi követelményeknek, a fgadó visszautasítja azt.) Frmai követelmény pl., hgy a tárgy gáznap frmátum az xsd:datetime-nak feleljen meg. Ez azt jelenti, hgy az engedélyesek infrmatikai platfrmjai kölcsönösen akkr és csak akkr fgadják el a tárgy gáznapt tartalmazó mezőket (és ily módn üzeneteket), ha ennek a frmátumnak eleget tesznek. Tartalmi követelményt tekintve biznys mezők csak biznys értékeket vehetnek fel. Jellegzetesen a gázmennyiségek meghatárzásánál jelen specifikáció csak a kwh-ban megadtt mennyiségeket tartja elfgadttnak más mértékegység használata jelenleg tehát nem értelmezett. Megjegyzendő, hgy az ilyen jellegű tartalmi megkötések a jelen specifikációhz tartzó XML sémákban is megjelennek, amelyeknek az üzeneteknek eleget kell tenniük. 4.2.6 ARCHIVÁLÁS Az RBP Üzemeltető 5 évre archiválja a web service üzeneteket.
5. AJÁNLATADÁS 5.1. AUKCIÓ ADATOK LEKÉRDEZÉSE (GETAUCTIONS) ÜZLETI CÉL, KÖRNYEZET Ez a szlgáltatás azn felhasználók által használható, amelyeknek jguk van ajánlatkat beadni. Ennek a szlgáltatásnak a segítségével az összes futó aukció lekérdezhető, de csak érvényes tanúsítvánnyal vehető igénybe. A válaszüzenetben a Rendszerhasználó Tag beadhat ajánlatt az ACTA és UPTA aukciókra. Ha még nincs beadtt ajánlat, akkr egy üres ajánlat jelenik meg azért, hgy a Rendszerhasználó Tag láthassa az aukció paramétereit. LEÍRÁS Annak érdekében, hgy ajánlatt tudjn beadni, a Rendszerhasználó tagnak rendelkeznie kell az összes infrmációval az aukciókról, amikben részt vesz. A szlgáltatás válaszüzenetében minden lyan infrmáció rendelkezésre áll, aminek segítségével érvényes ajánlatt lehet beadni. A szlgáltatás csak érvényes tanúsítvánnyal vehető igénybe és a tanúsítvány tulajdnsának rendelkeznie kell ajánlattételi jggal. Ezek hiányában a szlgáltatáshz való hzzáférés megtagadásra kerül. A válaszüzenetnek csak azn aukciók és ajánlatk lesznek a részei, melyekben a felhasználó részt vesz, és amelyek már elindultak, de még nem zárultak le és nincsenek két ajánlattételi kör között. Az aukciókat aukció névvel aznsítjuk. SZEREPLŐK, SZEREPKÖRÖK A kérés küldője: Rendszerhasználó Tag A kérés fgadója: RBP Üzemeltető A válasz küldője: RBP Üzemeltető (FGSZ) A válasz fgadója: Rendszerhasználó Tag ÜTEMEZÉS, HATÁRIDŐK A határidők az aukcióban definiált szabályk szerint alakulnak. A válaszüzenet kizárólag azkat az aukciókat tartalmazza, amelyek nyitva állnak az ajánlatk befgadására. ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK A web service kizárólag érvényes tanúsítvánnyal vehető igénybe. A tanúsítvány tulajdnsának rendelkeznie kell ajánlatbeadó jgsultsággal. Ezek hiányában a hzzáférés megtagadásra kerül.
5.1.1 A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS getauctins STRUKTÚRA, CÍMKÉK LEÍRÁSA Az XML üzenet lgikai szerkezete az alábbi struktúra szerint épül fel. Fejrész Tartalm A fejrész nem tartalmaz üzleti infrmációt. MEZŐK A kérés nem tartalmaz infrmációt, mivel a tanúsítvány alapján aznsítunk. PÉLDA <getauctins> <request/> </getauctins> 5.1.2 A VÁLASZT TARTALMAZÓ ÜZENET LEÍRÁS A válaszüzenet tartalmaz minden nyittt aukciót, és a Rendszerhasználó által krábban beadtt összes ajánlatt. LOGIKAI SZERKEZET A válaszüzenet lgikai felépítése az alábbi: Hibaüzenet-srk az alábbiak szerint: Hibakód Hibaüzenet ACTA ajánlatk Aukció név Hálózati pnt neve Hálózati pnt EIC kódja Termék típus (éves, negyedéves, havi, napi, napn belüli, STRIP) Termék név (vnatkzási időszak) Megszakíthatóság (megszakítható, nem megszakítható) Kapacitás típus (kapcslt, nem kapcslt) Aukció iránya (direkt, vissza) Áramlási irány (fizikai, backhaul) Szabványs kapacitástermék (szabványs, nem szabványs, szeznális) Kiinduló ár (devizával együtt) Felajánltt kapacitás
LPS SPS Aktuális árlépcső százalékban Igényelt mennyiség UPTA ajánlatk Aukció név Hálózati pnt neve Hálózati pnt EIC kódja Termék típus (éves, negyedéves, havi, napi, napn belüli, STRIP) Termék név (vnatkzási időszak) Megszakíthatóság (megszakítható, nem megszakítható) Kapacitás típus (kapcslt, nem kapcslt) Aukció iránya (direkt, vissza) Áramlási irány (fizikai, backhaul) Szabványs kapacitástermék (szabványs, nem szabványs, szeznális) Kiinduló ár (devizával együtt) Felajánltt kapacitás Ajánltt ár Igényelt mennyiség Igényelt minimum mennyiség
MEZŐK Megnevezés Leírás XML címkenév Frmátum / típus Aukció név Egy 8 jegyú karaktersrzat, ami az aukció egyértelmű aznsítására szlgál. auctinname Hálózati pnt A hálózati pnt neve capacitypintname neve Hálózati pnt EIC kódja A hálózati pnt EIC kódja eic Termék típus Éves, negyedéves, havi, napi, napn belüli, STRIP prdcttype YEARLY, QUARTERLY MONTHLY, DAILY, WITHINDAY, STRIP Termék név Vnatkzási időszak prductname Megszakíthatóság Megszakítható, nem prductquality FIRM, INTERRUPTIBLE megszakítható Kapacitás típus Kapcslt, nem kapcslt capacitytype BUNDLED, UNBUNDLED Aukció iránya Direkt, vissza directin DIRECT, REVERSE Áramlási irány Fizikai, Backhaul gasflw PHYSICAL, BACKHAUL Szabványs kapacitástermék Szabványs, nem szabványs, szeznális standard STANDARD, NON_STANDARD, NON_STANDARD- SEASONAL Kiinduló ár A kiinduló ár devizával együtt reserveprice Felajánltt kapacitás Az aukción felajánltt kapacitás capacityoffered Integer Aktuális (ACTA) LPS Aktuális nagy árlépcső lps Integer Aktuális (ACTA) SPS Aktuális kis árlépcső sps Integer
Megnevezés Leírás XML címkenév Frmátum / típus Aktuális árlépcső százalék (ACTA) A kiinduló árhz visznyíttt százalék pricestep Integer Igényelt mennyiség (ACTA) Az ajánlatban igényelt mennyiség quantity Integer Ajánltt (UPTA) ár Az egységár amennyit az igényelt mennyiségért fizet price Integer Igényelt mennyiség (UPTA) Az ajánlatban igényelt mennyiség bidquantity Integer Minimum mennyiség (UPTA) Az amennyiség, amennyinél kevesebbet már nem szeretne vásárlni az ajánlattevő minquantity Integer PÉLDA <getauctinsrespnse> <return> <actabids> <bid> <auctinname>00001016</auctinname> <capacitypintname>érsekvadkert</capacitypintname> <eic>39zveersekv11gni</eic> <prducttype>monthly</prducttype> <prductname>2015.06</prductname> <prductquality>firm</prductquality> <capacitytype>unbundled</capacitytype> <directin>direct</directin> <gasflw>physical</gasflw> <standard>standard</standard> <reserveprice>100.0000 HUF</reservePrice> <capacityoffered>10000</capacityoffered> <lps>0</lps> <sps>0</sps> <pricestep>0</pricestep> <quantity>9700</quantity> </bid> <bid>
<auctinname>00001016</auctinname> <capacitypintname>érsekvadkert</capacitypintname> <eic>39zveersekv11gni</eic> <prducttype>monthly</prducttype> <prductname>2015.06</prductname> <prductquality>firm</prductquality> <capacitytype>unbundled</capacitytype> <directin>direct</directin> <gasflw>physical</gasflw> <standard>standard</standard> <reserveprice>100.0000 HUF</reservePrice> <capacityoffered>10000</capacityoffered> <lps>1</lps> <sps>0</sps> <pricestep>10</pricestep> <quantity>6000</quantity> </bid> <bid> <auctinname>00001016</auctinname> <capacitypintname>érsekvadkert</capacitypintname> <eic>39zveersekv11gni</eic> <prducttype>monthly</prducttype> <prductname>2015.06</prductname> <prductquality>firm</prductquality> <capacitytype>unbundled</capacitytype> <directin>direct</directin> <gasflw>physical</gasflw> <standard>standard</standard> <reserveprice>100.0000 HUF</reservePrice> <capacityoffered>10000</capacityoffered> <lps>2</lps> <sps>0</sps> <pricestep>20</pricestep> <quantity>5000</quantity> </bid> </actabids> <uptabids> <bid> <auctinname>00001017</auctinname> <capacitypintname>fót</capacitypintname> <eic>39zvefot00011gnm</eic> <prducttype>daily</prducttype> <prductname>2015.06.01</prductname>
<prductquality>firm</prductquality> <capacitytype>unbundled</capacitytype> <directin>direct</directin> <gasflw>physical</gasflw> <standard>standard</standard> <reserveprice>100.0000 HUF</reservePrice> <capacityoffered>10000</capacityoffered> <price>5000</pricestep> <bidquantity>1000</bidquantity> <minquantity>800</minquantity> </bid> <bid> <auctinname>00001018</auctinname> <capacitypintname>gyál</capacitypintname> <eic>39zvegyal0011gnp</eic> <prducttype>daily</prducttype> <prductname>2015.06.01</prductname> <prductquality>firm</prductquality> <capacitytype>unbundled</capacitytype> <directin>direct</directin> <gasflw>physical</gasflw> <standard>standard</standard> <reserveprice>100.0000 HUF</reservePrice> <capacityoffered>10000</capacityoffered> <price>5000</pricestep> <bidquantity>1000</bidquantity> <minquantity>800</minquantity> </bid> </uptabids> </return> </getauctinsrespnse> 5.2. TÖMEGES AJÁNLAT BEADÁS (BULKMAKEBIDS) ÜZLETI CÉL, KÖRNYEZET A szlgáltatás segítségével a meghatalmaztt felhasználók ajánlatkat adhatnak be. LEÍRÁS A felhasználó ajánlatt tud tenni egy, vagy több futó aukció aktuális körében. A szlgáltatás célja egyrészt, hgy a manuális módszernél gyrsabban lehessen ajánlatt beadni, másrészt az ember által elkövethető hibák minimalizálása
SZEREPLŐK, SZEREPKÖRÖK A kérés küldője: Rendszerhasználó Tag A kérés fgadója: RBP Üzemeltető A válasz küldője: RBP Üzemeltető A válasz fgadója: Rendszerhasználó Tag ÜTEMEZÉS, HATÁRIDŐK A határidők az aukcióban definiált szabályk szerint alakulnak. Ajánlatkat kizárólag abban az időintervallumban fgadunk be, amikr az aukció nyitva áll az ajánlatk befgadására. ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK A webszeríz kizárólag érvényes tanúsítvánnyal vehető igénybe.. A tanúsítvány tulajdnsának rendelkeznie kell ajánlatadó jgsultsággal. Ezek hiányában a hzzáférés megtagadásra kerül. Ezen kívül csak lyan aukcióra fgadunk be ajánlatt, amire a felhasználó által helyettesített Rendszerhasználó Tag meghívást kaptt, és az aukció nyitva áll az aukciózásra. Egy hívással több ascending clck és unifrm price típusú aukcióra is lehet ajánlatkat adni. Az ajánlatk befgadásakr külön kezeljük az ACTA és az UPTA típusú aukciókat. Ha bármelyik ACTA aukcióra adtt ajánlatban hiba van, akkr egyetlen a kérésben szereplő ACTA ajánlatt sem fgad be a rendszer. Emellett ha az UPTA ajánlatk helyesek, akkr az UPTA ajánlatkat befgadjuk. Mindez frdítva is igaz. Az ajánlatadás rendszerét a CAM NC szabályzza. Ennek megfelelően a következő hiba ellenőrzéseket végezzük:
Ellenőrzés Csak akkr lehet ajánlatt beadni, ha nyitva van az aukció SPS ajánlati körre ajánlatt csak az első aluljegyzés után lehet beadni Az aktuálisnál kisebb LPS körre nem lehet ajánlatt beadni. Az aktuálisnál kisebb SPS körre nem lehet ajánlatt beadni. Két LPS kör között nem lehet ajánlatt beadni SPS körre Az igényelt kapacitás nem lehet nagybb, mit a felajánltt kapacitás Csak pzitív egész ajánlatkat lehet beadni A beadtt ajánlatknak körönként egyenlőnek, vagy kisebbnek kell lennie, mint az előző. A beadtt ajánlatknak körönként egyenlőnek, vagy nagybbnak kell lennie, mint a következő. SPS körre nem lehet ajánlatt beadni úgy, hgy LPS kör nem zárult le aluljegyzéssel Az SPS körre beadtt ajánlatknak körönként nagybbnak kell lennie, mint az előző LPS körre beadtt ajánlat. Az SPS körre beadtt ajánlatknak kisebbnek kell lennie, mint az következő LPS körre beadtt ajánlat. A felajánlttnál több kapacitást nem lehet igényelni. Csak létező aukcióra lehet ajánlatt beadni A kis árlépcső ajánlatainak a megfelelő nagy árlépcső értékei között kell lennie Az ajánltt mennyiségnek nagybbnak kell lennie következő lépcsős mennyiségnél A kiadásldali pénzügyi limitet nem lehet túllépni A betáplálásldali pénzügyi limitet nem lehet túllépni A pénzügyi limitet nem lehet túllépni A rendszerhasználó erre az aukcióra nem adhat be ajánlatt A rendszerhasználónak minden érintett zónában letétbe kell helyeznie pénzügyi fedezetet Hibaüzenet aznsítója BIDDING_NOT_ALLOWED SMALL_STEP_BID_PRICE_NOT_BETWEEN_RELEVANT_LARGE_STEP_PRICES LARGE_STEP_SMALLER_THAN_ACTUAL SMALL_STEP_SMALLER_THAN_ACTUAL SMALL_STEP_BID_NOT_BETWEEN_LARGE_STEP_PRICES BID_QUANTITY_GREATER_THAN_CAP_OFFERED NEGATIVE_VALUE BID_QUANTITY_GREATER_PREVIOUS_BID_QUANTITY BID_QUANTITY_SMALLER_NEXT_BID_QUANTITY SMALL_STEP_PHASE_MUST_NOT_BE_STARTED_WITHOUT_LPS_BIDS SPS_BID_QUANTITY_GREATER_PREVIOUS_LPS_BID_QUANTITY SPS_BID_QUANTITY_SMALLER_NEXT_LPS_BID_QUANTITY QUANTITY_OVER_CAPACITY_OFFERED INVALID_AUCTION SMALL_STEP_BID_PRICE_NOT_BETWEEN_RELEVANT_LARGE_STEP_PRICES BID_QUANTITY_SMALLER_NEXT_BID_QUANTITY FINANCIAL_OUT_LIMIT_EXCEEDED FINANCIAL_IN_LIMIT_EXCEEDED FINANCIAL_LIMIT_EXCEEDED NETWORK_USER_CANNOT_BID_ON_GIVEN_AUCTION DEPOSIT_IS_MISSING
21/119 Az ajánltt mennyiség nem lehet több, mint 999999999 Az ajánltt mennyiség nem haladhatja meg az előző lépcsőben megadtt mennyiséget SPS- nél Az ajánltt mennyiség nem lehet 0 vagy negatív Ugyanarra az árlépcsőre csak egy ajánlat menthető Az ajánlat értéke nem lehet kisebb, mint a következő ajánlat LPS- nél A beadtt ajánlat összértéke nem lehet nagybb, mint a rendszerhasználó pénzügyi kerete Az ajánlat értéke nem lehet kisebb, mint a következő ajánlat SPS- nél Érvénytelen kis árlépcső Kis árlépcsőre nem adhat be ajánlatt krábbi nagy árlépcsőre adtt ajánlat nélkül Maximum 10 ajánlatt adhat be UPTA aukcióra UPTA aukcióra nem adhat be több ajánlatt ugyanazn az árn UPTA aukciónál a minimum mennyiségnek kevesebbnek kell lennie az igényelt mennyiségnél UPTA ajánlat mennyisége nem lehet 0 UPTA ajánlatnál a minimum mennyiség nem lehet negatív UPTA ajánlatnál az igényelt mennyiség nem lehet negatív UPTA ajánlatnál az ár nem lehet negatív BID_QUANTITY_MUST_BE_LESS_THAN_999999999 SPS_BID_QUANTITY_GREATER_PREVIOUS_SPS_BID_QUANTITY BID_QUANTITY_EQUALS_OR_LESS_THAN_ZERO NEW_BID_ON_SAME_PRICE_STEP BID_QUANTITY_SMALLER_PREVIOUS_BID_QUANTITY FINANCIAL_LIMIT_TOO_SMAL SPS_BID_QUANTITY_SMALLER_PREVIOUS_SPS_BID_QUANTITY INVALID_SMALL_PRICE_STEP SMALL_STEP_PHASE_MUST_NOT_BE_STARTED_WITHOUT_LPS_BIDS TOO_MANY_BIDS SAME_BID_PRICE MIN_QUANTITY_GREATER_THAN_BID_QUANTITY QUANTITY_ZERO NEGATIVE_MIN_QUANTITY NEGATIVE_QUANTITY NEGATIVE_PRICE
5.2.1 A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS bulkmakebids STRUKTÚRA, CÍMKÉK LEÍRÁSA Az XML üzenet lgikai szerkezete az alábbi struktúra szerint épül fel. Fejrész Tartalm ACTA ajánlatk Ajánlat UPTA ajánlatk Ajánlat A fejrész nem tartalmaz üzleti infrmációt. MEZŐK Megnevezés Leírás XML címkenév Frmátum / típus Aukció név Egy 8 jegyű karaktersrzat, ami az aukció egyértelmű aznsítására szlgál. auctinname LPS (ACTA) Aktuális nagy árlépcső lps Integer SPS (ACTA) Aktuális kis árlépcső sps Integer Mennyiség (ACTA) Az igényelt mennyiség quantity Integer Ár (UPTA) Ajánltt ár UPTA esetében. A kiinduló ár százalékában (%) kifejezve. price Integer Igényelt mennyiség (UPTA) Igényelt mennyiség UPTA esetében. bidquantity Integer Minimum mennyiség (UPTA) Minimum vásárlni kívánt mennyiség UPTA esetében. minquantity Integer
23/119 PÉLDA <bulkmakebids> <request> <actabids> <bid> <auctinname>00001016</auctinname> <lps>0</lps> <sps>0</sps> <quantity>9000</quantity> </bid> </actabids> <uptabids> <bid> <auctinname>00001016</auctinname> <price>5000</price> <bidquantity>1000</bidquantity> <minquantity>800</minquantity> </bid> </uptabids> </request> </bulkmakebids> 5.2.2 A VÁLASZT TARTALMAZÓ ÜZENET LEÍRÁS A válasz üzenetben hiba esetén az aukcióhz tartzó hibakódkat adjuk vissza. LOGIKAI SZERKEZET Az XML üzenet lgikai szerkezete az alábbi struktúra szerint épül fel: Hibaüzenet-srk az alábbiak szerint: Aukciónév Hibakód MEZŐK Megnevezés Leírás XML címkenév Frmátum / típus Aukció név Egy 8 jegyű karaktersrzat, ami az aukció egyértelmű aznsítására szlgál. auctinname Hibakód Hibakód errr
24/119 PÉLDA <sap:bdy> <sap:fault> <faultcde>sap:server</faultcde> <faultstring>invalid_request<faultstring> <detail> <BulkMakeBidsFault> <faultinf> <errr> <auctinname>00001016</auctinname> <errr>bid_quantity_greater_previous_bid_quantity</errr> </errr> </faultinf> </BulkMakeBidsFault> </detail> </sap:fault> </sap:bdy> 5.3. UPTA AJÁNLATOK TÖRLÉSE (BULKREMOVEUPTABIDS) ÜZLETI CÉL, KÖRNYEZET A szlgáltatás segítségével a meghatalmaztt felhasználók eltávlíthatnak UPTA ajánlatkat. (E módszer mellett akármelyik ajánlat eltávlítható az adtt aukcióra való 0 ajánlat beadásával). LEÍRÁS Egy vagy több ajánlat eltávlítható egy vagy több aukcióból. A szlgáltatás célja egyrészt, hgy a manuális módszernél gyrsabban lehessen ajánlatt törölni, másrészt az ember által elkövethető hibák minimalizálása. SZEREPLŐK, SZEREPKÖRÖK A kérés küldője: Rendszerhasználó Tag A kérés fgadója: RBP Üzemeltető A válasz küldője: RBP Üzemeltető A válasz fgadója: Rendszerhasználó Tag ÜTEMEZÉS, HATÁRIDŐK A határidők az aukcióban definiált szabályk szerint alakulnak. Törlést kizárólag abban az időintervallumban fgadunk be, amikr az aukció nyitva áll az ajánlatk befgadására.
25/119 ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK A webservice kizárólag érvényes tanúsítvánnyal vehető igénybe. A tanúsítvány tulajdnsának rendelkeznie kell ajánlatbeadó jgsultsággal. Ezek hiányában a hzzáférés megtagadásra kerül. Ezen kívül csak lyan aukcióra fgadunk be törlés parancst, amire a felhasználó által helyettesített rendszerhasználó meghívást kaptt, és az aukció nyitva áll az aukciózásra. Az ajánlatadás rendszerét a CAM NC szabályzza. Ennek megfelelően a következő hiba ellenőrzéseket végezzük:
26/119 Ellenőrzés Hibaüzenet aznsítója Csak akkr lehet ajánlatt törölni, ha nyitva van az aukció AUCTION_NOT_ACTIVE Az aktuális aukciós státuszban nem lehet ajánlatt törölni UPTA_BID_REMOVE_NOT_ALLOWED Ehhez az aznsítóhz tartzó ajánlatt már törölték UPTA_BID_HAS_ALREADY_REMOVED Nem létező aukció névre nem lehet ajánlatt beadni. INVALID_AUCTION Ajánlat csak akkr törölhető, ha a rendszerhasználó részt vesz az aukcióban NETWORK_USER_CANNOT_BID_ON_GIVEN_AUCTION
5.3.1 A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS bulkremveuptabids STRUKTÚRA, CÍMKÉK LEÍRÁSA Az XML üzenet lgikai szerkezete az alábbi struktúra szerint épül fel. Fejrész Tartalm UPTA ajánlatk Aukció név A fejrész nem tartalmaz üzleti infrmációt. MEZŐK Megnevezés Leírás XML címkenév Frmátum / típus Aukció név Egy 8 jegyű karaktersrzat, ami az aukció egyértelmű aznsítására szlgál. auctinname PÉLDA <bulkremveuptabids> <request> <AuctinNames> <auctinname>00001016</auctinname> <auctinname>00001017</auctinname> </AuctinNames> </request> </bulkmakebids> 5.3.2 A VÁLASZT TARTALMAZÓ ÜZENET LEÍRÁS A válasz üzenetben hiba esetén az aukcióhz tartzó hibakódkat adjuk vissza. LOGIKAI SZERKEZET A válaszüzenet lgikai felépítése az alábbi: Hibaüzenet-srk az alábbiak szerint:
28/119 Aukciónév Hibakód MEZŐK Megnevezés Leírás XML címkenév Frmátum / típus Aukció név Egy 8 jegyű karaktersrzat, ami az aukció egyértelmű aznsítására szlgál. auctinname Hibakód Hibakód errr PÉLDA <sap:bdy> <sap:fault> <faultcde>sap:server</faultcde> <faultstring>invalid_request<faultstring> <detail> <BulkRemveUptaBidsFault> <faultinf> <errr> <auctinname>00001016</auctinname> <errr>bidding_not_allowed</errr> </errr> </faultinf> </BulkRemveUptaBidsFault> </detail> </sap:fault> </sap:bdy>
29/119 6. WEB SERVICE KOMMUNIKÁCIÓ AZ RBP ÉS A TSO TAG KÖZÖTT 6.1. TARIFA ÉS ÁRADATOK KÜLDÉSE IP-BŐL RBP-BE ÜZLETI CÉL, KÖRNYEZET Ez a szlgáltatás biztsítja a megfelelő kmmunikációt az RBP és a TSO IP (back-end rendszer) között annak érdekében, hgy hzzájussn a hálózati pntk legfrissebb kapacitás, tarifa és árlépcső adataihz. Az adatkat a TSO IP-ből az RBP-be küldik. LEÍRÁS Amennyiben RBP-ben aukció került kiírásra, ennek felparaméterezéséhez szükségesek az IP-ben tárlt kapacitás- és áradatk annak érdekében, hgy azk feltöltése után a Setting státuszú aukció Set státuszba léphessen. A szlgáltatás kizárólag érvényes tanúsítvánnyal vehető igénybe és a tanúsítvány tulajdnsának megfelelő jgkkal (Kapacitás adatk WebService) kell rendelkezni, hgy futtathassa a szlgáltatást. Ezen feltételek hiányában a szlgáltatáshz való hzzáférés megtagadásra kerül. SZEREPLŐK, SZEREPKÖRÖK A kérés küldője: TSO IP A kérés fgadója: RBP A válasz küldője: RBP A válasz fgadója: TSO IP ÜTEMEZÉS, HATÁRIDŐK A web service működése szempntjából fnts jb lefuttatásának beállítására az IP Management mdulban nyílik ütemezési lehetőség. ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK Kizárólag érvényes tanúsítvánnyal lehetséges a web service használata. A tanúsítvány tulajdnsának engedéllyel kell rendelkezni, hgy futtathassa a szlgáltatást. Ezek hiányában a hzzáférés megtagadásra kerül. 6.1.1. A KÉRÉST TARTALMAZÓ ÜZENET LEÍRÁS A kérés üzenetben küldünk minden lyan adatt, melyre az RBP-nek szüksége van. STRUKTÚRA, CÍMKÉK LEÍRÁSA Az XML üzenet lgikai szerkezete az alábbi struktúra szerint épül fel.
30/119 MEZŐK Fejrész (nem tartalmaz üzleti infrmációt) Tartalm TSO Tag EIC kódja Gáznap (adatk küldésének idejét közli) Hálózati pnt EIC kódja Hálózati pnt neve Hálózati pnt iránya Kapacitás adatk termék Megszakíthatóság Áramlási irány Kiinduló ár Nagy árlépcső (LPS) Kis árlépcső (SPS) Megnevezés Leírás XML címkenév Frmátum / típus TSO Tag EIC kódja A releváns TSO Tag EIC kódja tseiccde Gáznap A gáznap az adatk publikálásának napja gasday Hálózati pnt EIC kódja A hálózati pnt EIC kódja eiccde Hálózati neve pnt A hálózati pnt neve capacitypintname Kapacitás adatk A kapacitás adatk a termék típus, megszakíthatóság, áramlási irány és hálózati pntk szerint vannak elküldve. Ezen kívül napi és órai adatk is biztsítva lesznek. capacitybynetwrkpints YEARLY, QUARTERLY MONTHLY, DAILY, WITHINDAY, STRIP Megszakíthatóság Megszakítható, megszakítható nem prductquality FIRM, INTERRUPTIBLE Hálózati iránya pnt Direkt, vissza directin DIRECT, REVERSE Áramlási irány Fizikai, Backhaul gasflw PHYSICAL, BACKHAUL
Megnevezés Leírás XML címkenév Frmátum / típus 31/119 Szabványs kapacitástermék Szabványs, szabványs, szeznális nem standard STANDARD, NON_STANDARD, NON_STANDARD- SEASONAL Kiinduló ár A kiinduló ár devizával együtt, termék típus, megszakíthatóság, áramlási irány és hálózati pntk szerint reserveprice Rögzített LPS Tényleges nagy árlépcső lps Integer Rögzített SPS Tényleges kis árlépcső sps Integer PÉLDA <sapenv:envelpe xmlns:sapenv="http://schemas.xmlsap.rg/sap/envelpe/" xmlns:ser="http://service.web.rbp.ipsystems.hu"> <sapenv:header/> <sapenv:bdy> <ser:upladcapacityandtariff> <capacityandtariffdata> <tseiccde>21x-ro-a-a0a0a-s</tseiccde> <gasday>2015-01-01</gasday> <capacitylist> <capacitybynetwrkpints> <eiccde>21z000000000236q</eiccde> <capacitypintname>csanádpalta (HU>RO)</capacityPintName> <directin>direct</directin> <capacitydatarws> <yearlycapacity> <firmdailycapacity>2</firmdailycapacity> <firmhurlycapacity>50</firmhurlycapacity> <interruptibledailycapacity>960</interruptibledailycapacity> <interruptiblehurlycapacity>40</interruptiblehurlycapacity> <backhauldailycapacity>600</backhauldailycapacity> <backhaulhurlycapacity>25</backhaulhurlycapacity> </yearlycapacity> <quarterlycapacity> <firmdailycapacity>480</firmdailycapacity>
32/119 <firmhurlycapacity>2</firmhurlycapacity> <interruptibledailycapacity>96</interruptibledailycapacity> <interruptiblehurlycapacity>4</interruptiblehurlycapacity> <backhauldailycapacity>2400000000</backhauldailycapacity> <backhaulhurlycapacity>10</backhaulhurlycapacity> </quarterlycapacity> <quarterlycapacity> <firmdailycapacity>480</firmdailycapacity> <firmhurlycapacity>20</firmhurlycapacity> <interruptibledailycapacity>96</interruptibledailycapacity> <interruptiblehurlycapacity>4</interruptiblehurlycapacity> <backhauldailycapacity>2400000001</backhauldailycapacity> <backhaulhurlycapacity>10</backhaulhurlycapacity> </quarterlycapacity> <mnthlycapacity> <firmdailycapacity>12000</firmdailycapacity> <firmhurlycapacity>500</firmhurlycapacity> <interruptibledailycapacity>2400</interruptibledailycapacity> <interruptiblehurlycapacity>100</interruptiblehurlycapacity> <backhauldailycapacity>7200</backhauldailycapacity> <backhaulhurlycapacity>300</backhaulhurlycapacity> </mnthlycapacity> <dailycapacity> <firmdailycapacity>720</firmdailycapacity> <firmhurlycapacity>30</firmhurlycapacity> <interruptibledailycapacity>240</interruptibledailycapacity> <interruptiblehurlycapacity>10</interruptiblehurlycapacity> <backhauldailycapacity>1200</backhauldailycapacity> <backhaulhurlycapacity>50</backhaulhurlycapacity> </dailycapacity> </capacitydatarws> </capacitybynetwrkpints> </capacitylist> <reservepricelist> <reservepricebynetwrkpints> <eiccde>21z000000000236q</eiccde> <capacitypintname>csanádpalta (HU>RO)</capacityPintName> <directin>direct</directin> <reservepricedatarws> <yearlyreserveprice> <prducttype>yearly</prducttype> <firmcapacityprice>661</firmcapacityprice>
33/119 <interruptiblecapacityprice>8000.123456</interruptiblecapacityprice> <backhaulcapacityprice>666</backhaulcapacityprice> <seasnalcapacityprice>1000</seasnalcapacityprice> <lps>10</lps> <sps>1</sps> </yearlyreserveprice> <quarterlyreserveprice> <prducttype>quarterly</prducttype> <firmcapacityprice>20000</firmcapacityprice> <interruptiblecapacityprice>7000.123456</interruptiblecapacityprice> <backhaulcapacityprice>1900</backhaulcapacityprice> <lps>18</lps> <sps>9</sps> </quarterlyreserveprice> <mnthlyreserveprice> <prducttype>monthly</prducttype> <firmcapacityprice>30000</firmcapacityprice> <interruptiblecapacityprice>12345678</interruptiblecapacityprice> <backhaulcapacityprice>3000</backhaulcapacityprice> <lps>16</lps> <sps>4</sps> </mnthlyreserveprice> <dailyreserveprice> <prducttype>daily</prducttype> <firmcapacityprice>40000</firmcapacityprice> <interruptiblecapacityprice>999.123456</interruptiblecapacityprice> <backhaulcapacityprice>6000</backhaulcapacityprice> <lps>15</lps> <sps>1</sps> </dailyreserveprice> </reservepricedatarws> </reservepricebynetwrkpints> </reservepricelist> </capacityandtariffdata> </ser:upladcapacityandtariff> </sapenv:bdy> </sapenv:envelpe> 6.1.2. A VÁLASZT TARTALMAZÓ ÜZENET
34/119 LEÍRÁS A válasz üzenet visszajelzést tartalmaz arról, hgy az elküldött adatk sikeresen megérkeztek és mentésre kerültek az RBP-ben. MEZŐK A válasz nem tartalmaz üzleti infrmációt. PÉLDA <sap:envelpe xmlns:sap="http://schemas.xmlsap.rg/sap/envelpe/"> <sap:bdy> <ns2:upladcapacityandtariffrespnse xmlns:ns2="http://service.web.rbp.ipsystems.hu"/> </sap:bdy> </sap:envelpe> 6.2. RBP AUKCIÓK EREDMÉNYEINEK IMPORTJA ÜZLETI CÉL, KÖRNYEZET Ez a szlgáltatás lehetővé teszi, hgy az RBP elküldje a lezárt aukciók szerződéses adatait (TRADE-ek) a TSO Tagnak és a Rendszerhasználó Tagnak. LEÍRÁS A lezárt aukciók sikeres ajánlatai (TRADE-ek) a megfelelő hzzáférési jgk szerint elküldésre kerülnek az igénylő félhez. A szlgáltatás kizárólag érvényes tanúsítvánnyal vehető igénybe és a tanúsítvány tulajdnsának megfelelő jgkkal (Aukció eredmények WebService exprt-érintett TSO Tag) kell rendelkezni, hgy futtathassa a szlgáltatást. Ezek hiányában a szlgáltatáshz való hzzáférés megtagadásra kerül. SZEREPLŐK, SZEREPKÖRÖK A kérés küldője: TSO Tag A kérés fgadója: RBP A válasz küldője: RBP A válasz fgadója: TSO Tag ÜTEMEZÉS, HATÁRIDŐK A web service működése szempntjából fnts jb lefuttatásának beállítására az IP Management mdulban nyílik ütemezési lehetőség. ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK A szlgáltatás kizárólag érvényes tanúsítvánnyal vehető igénybe. A tanúsítvány tulajdnsának engedéllyel kell rendelkezni, hgy futtathassa a szlgáltatást.
35/119 Ezek hiányában a hzzáférés megtagadásra kerül. 6.2.1. A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS gettrades STRUKTÚRA, CÍMKÉK LEÍRÁSA Az XML üzenet lgikai szerkezete az alábbi struktúra szerint épül fel. Fejrész (nem tartalmaz üzleti infrmációt) Tartalm TSO Tag EIC kódja Időintervallum (frm t) MEZŐK Megnevezés Leírás XML címkenév Frmátum / típus TSO Tag EIC kódja A releváns TSO Tag EIC kódja tseiccde Időintervallum (frm t) Az a tól ig időszak, melyek között a TRADE-k lekérdezésre kerülnek gasday PÉLDA <sap:envelpe xmlns:sap="http://schemas.xmlsap.rg/sap/envelpe/"> <sap:bdy> <ns2:gettrades xmlns:ns2="http://service.web.rbp.ipsystems.hu"> <request> <tseiccde>21x-hu-a-a0a0a-8</tseiccde> <frm>2015-05-13t14:32:00.000z</frm> <t>2015-05-14t14:32:08.000z</t> </request> </ns2:gettrades> </sap:bdy> </sap:envelpe> 6.2.2. A VÁLASZT TARTALMAZÓ ÜZENET
36/119 LEÍRÁS A választ tartalmazó üzenetben küldésre kerül az összes, a megadtt intervallumba eső időszak alatt generálódtt minden TRADE. STRUKTÚRA, CÍMKÉK LEÍRÁSA Az XML üzenet lgikai szerkezete az alábbi struktúra szerint épül fel. MEZŐK Fejrész (nem tartalmaz üzleti infrmációt) Tartalm Trade aznsító Aukció név Rendszerhasználó EIC kódja Rendszerhasználókódja Rendszerhasználó neve Hálózati pnt EIC kódja Hálózati pnt neve Hálózati pnt IP kódja (nminatin ID) Terméktípus (éves, negyedéves, havi, napi, STRIP) Instrument (gázév, gáznegyedév, gázhónap, gáznap, STRIP) Érvényesség kezdete Érvényesség vége Kapacitás típus (kapcslt, nem kapcslt) Minőség (megszakítható, nem megszakítható) Irány (fizikai, backhaul) Szabványs (szabványs, nem szabványs) Allkált mennyiség Kiinduló ár Elszámló ár Aukciós felár Ügyletaznsító Megnevezés Leírás XML címkenév Frmátum / típus Trade aznsító A Trade aznsítására szlgáló szám tradeid Aukció név Egy 8 jegyű karaktersrzat, ami az aukció egyértelmű aznsítására szlgál. auctinname Rendszerhasználó A rendszerhasználó EIC netwrkusereic
37/119 EIC kódja kódja Rendszerhasználó Operátr kódja A rendszerhasználó perátri kódja netwrkusercde Rendszerhasználó neve Hálózati pnt EIC kódja A rendszerhasználó neve netwrkusername A hálózati pnt EIC kódja netwrkpinteic Hálózati neve pnt A hálózati pnt neve netwrkpintname Hálózati pnt IP kódja (nminatin ID) A releváns hálózati pnt IP kódja (nminatin ID) netwrkpintnminatinid Termék típus Éves, negyedéves, havi, napi, napn belüli, STRIP prdcttype YEARLY, QUARTERLY MONTHLY, DAILY, WITHINDAY, STRIP Instrument Vnatkzási időszak instrument Érvényesség kezdete Az érvényesség kezdő dátuma validitystart Érvényesség vége Az érvényesség végét jelző dátum validityend Kapacitás típus Kapcslt, nem kapcslt capacitytype BUNDLED, UNBUNDLED Megszakíthatóság Megszakítható, megszakítható nem capacityquality FIRM, INTERRUPTIBLE Áramlási irány Fizikai, Backhaul gasflw PHYSICAL, BACKHAUL Szabványs kapacitástermék Szabványs, nem szabványs, szeznális standard STANDARD, NON_STANDARD, NON_STANDARD- SEASONAL Allkált mennyiség Az érintett rendszerhasználónak allcatedcapacity
38/119 allkált mennyiség Kiinduló ár A kiinduló ár devizával együtt reserveprice Elszámló ár Aukciós felárral növelt kiinduló ár clearingprice Aukciós felár Elnyert kapacitásért, a kiinduló ár mellett fizetendő felár clearingpremium Ügyletaznsító Ügylet aznsítására egyedi ID pnts szlgáló cnfirmatnid PÉLDA <sap:envelpe xmlns:sap="http://schemas.xmlsap.rg/sap/envelpe/"> <sap:bdy> <ns2:gettradesrespnse xmlns:ns2="http://service.web.rbp.ipsystems.hu"> <return> <trades> <trade> <tradeid>150</tradeid> <auctinname>00000299</auctinname> <auctinstart>2015-05- 14T09:54:28.808Z</auctinStart> <netwrkusereic>15x-gdf-suez--- 2</netwrkUserEic> <netwrkusercde>gdfsuez</netwrkusercde> <netwrkusername>gdf SUEZ Energia Magyarrszág Zrt.</netwrkUserName> <netwrkpinteic>39wsiforrasfsen2</netwrkpinteic> <netwrkpintname>egyesített Kitárlás</netwrkPintName> <netwrkpintnminatinid>siforrasfsen</netwrkpintnminatinid> <prducttype>yearly</prducttype> <instrument>2015 GASYEAR</instrument> <validitystart>2015.10.01</validitystart> <validityend>2016.09.30</validityend>
--2/00000299</cnfirmatinId> 14T09:54:28.808Z</auctinStart> 2</netwrkUserEic> Magyarrszág Zrt.</netwrkUserName> 39/119 <capacitytype>unbundled</capacitytype> <capacityquality>firm</capacityquality> <gasflw>physical</gasflw> <standard>standard</standard> <allcatedcapacity>9000000</allcatedcapacity> <reserveprice>418.29</reserveprice> <clearingprice>418.29</clearingprice> <clearingpremium>0</clearingpremium> <cnfirmatinid>21x-hu-a-a0a0a-8/15x-gdf-suez- <pricedecimals>4</pricedecimals> </trade> <trade> <tradeid>151</tradeid> <auctinname>00000228</auctinname> <auctinstart>2015-05- <netwrkusereic>15x-gdf-suez--- <netwrkusercde>gdfsuez</netwrkusercde> <netwrkusername>gdf SUEZ Energia <netwrkpinteic>39wketeljcs58en1</netwrkpinteic> <netwrkpintname>mol Nyrt KTD összevnt betáplálási pntja (2/S)</netwrkPintName> <netwrkpintnminatinid>keteljcs58en</netwrkpintnminatinid> <prducttype>yearly</prducttype> <instrument>2015 GASYEAR</instrument> <validitystart>2015.10.01</validitystart> <validityend>2016.09.30</validityend> <capacitytype>unbundled</capacitytype> <capacityquality>firm</capacityquality> <gasflw>physical</gasflw> <standard>standard</standard> <allcatedcapacity>1000</allcatedcapacity> <reserveprice>1 194.08</reservePrice> <clearingprice>1 194.08</clearingPrice> <clearingpremium>0</clearingpremium> <cnfirmatinid>21x-hu-a-a0a0a-8/15x-gdf-suez- --2/00000228</cnfirmatinId> <pricedecimals>4</pricedecimals>
14T09:54:28.808Z</auctinStart> 2</netwrkUserEic> Magyarrszág Zrt.</netwrkUserName> </trade> <trade> <tradeid>152</tradeid> <auctinname>00000298</auctinname> <auctinstart>2015-05- <netwrkusereic>15x-gdf-suez--- 40/119 <netwrkusercde>gdfsuez</netwrkusercde> <netwrkusername>gdf SUEZ Energia <netwrkpinteic>39zsifgtarolsenx</netwrkpinteic> <netwrkpintname>egyesített Letárlás</netwrkPintName> <netwrkpintnminatinid>sifgtarolsen</netwrkpintnminatinid> <prducttype>yearly</prducttype> <instrument>2015 GASYEAR</instrument> <validitystart>2015.10.01</validitystart> <validityend>2016.09.30</validityend> <capacitytype>unbundled</capacitytype> <capacityquality>firm</capacityquality> <gasflw>physical</gasflw> <standard>standard</standard> <allcatedcapacity>8000000</allcatedcapacity> <reserveprice>0</reserveprice> <clearingprice>0</clearingprice> <clearingpremium>0</clearingpremium> <cnfirmatinid>21x-hu-a-a0a0a-8/15x-gdf-suez- --2/00000298</cnfirmatinId> <pricedecimals>4</pricedecimals> </trade> 6.3. RBP AUKCIÓK EREDMÉNYEINEK IMPORTJA V2 ÜZLETI CÉL, KÖRNYEZET Ez a szlgáltatás lehetővé teszi, hgy az RBP visszaadja a lezárt aukciók szerződéses adatait (TRADEek) a TSO Tagnak és a Rendszerhasználó Tagnak. Ez a szlgáltatás az ajánlat adás srán megadtt balancing grup infrmációkat is tartalmazza.
41/119 LEÍRÁS A lezárt aukciók sikeres ajánlatai (TRADE-ek) a megfelelő hzzáférési jgk szerint lekérdezhetők az érintett TSO Tag és a Rendszerhasználó Tag számára. A szlgáltatás kizárólag érvényes tanúsítvánnyal vehető igénybe és a tanúsítvány tulajdnsának megfelelő jgkkal (Aukció eredmények WebService exprt-érintett) kell rendelkezni, hgy futtathassa a szlgáltatást. Ezek hiányában a szlgáltatáshz való hzzáférés megtagadásra kerül. SZEREPLŐK, SZEREPKÖRÖK A kérés küldője: TSO Tag vagy Rendszerhasználó A kérés fgadója: RBP A válasz küldője: RBP A válasz fgadója: TSO Tag vagy Rendszerhasználó ÜTEMEZÉS, HATÁRIDŐK A szlgáltatás több mint egy évre visszamenőleg képes visszaadni az aukció eredményeket. ÜZLETI FELTÉTELRENDSZER, MEGSZORÍTÁSOK A szlgáltatás kizárólag érvényes tanúsítvánnyal vehető igénybe. A tanúsítvány tulajdnsának engedéllyel kell rendelkezni, hgy futtathassa a szlgáltatást. Ezek hiányában a hzzáférés megtagadásra kerül. 6.2.1. A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS gettradesv2 STRUKTÚRA, CÍMKÉK LEÍRÁSA Az XML üzenet lgikai szerkezete az alábbi struktúra szerint épül fel. Fejrész (nem tartalmaz üzleti infrmációt) Tartalm TSO Tag vagy Rendszerhasználó EIC kódja Időintervallum kezdete Időintervallum vége MEZŐK Megnevezés Leírás XML címkenév Frmátum / típus TSO Tag vagy Rendszerhasználó EIC kódja A releváns TSO Tag vagy rendszerhasználó EIC kódja eiccde
42/119 Időintervallum kezdete A kérdéses intervallum kezdete frm Date Időintervallum vége A kérdéses intervallum vége t Date PÉLDA <rbp:gettradesv2> <request> <eiccde>39x50shell00001y</eiccde> <frm>2015-01-01</frm> <t>2015-11-20</t> </request> </rbp:gettradesv2> 6.2.2. A VÁLASZT TARTALMAZÓ ÜZENET LEÍRÁS A választ tartalmazó üzenetben küldésre kerül az összes, a megadtt intervallumba eső időszak alatt generálódtt minden TRADE illetve a balancing grup adatk. STRUKTÚRA, CÍMKÉK LEÍRÁSA Az XML üzenet lgikai szerkezete az alábbi struktúra szerint épül fel. Fejrész (nem tartalmaz üzleti infrmációt) Tartalm Trade aznsító Aukció név Aukció kezdete Aukció vége Rendszerhasználó EIC kódja Rendszerhasználó kódja Rendszerhasználó neve Hálózati pnt EIC kódja Hálózati pnt neve Hálózati pnt IP kódja (nminatin ID) Terméktípus (éves, negyedéves, havi, napi, STRIP) Instrument Érvényesség kezdete Érvényesség vége Kapacitás típus (kapcslt, nem kapcslt) Minőség (megszakítható, nem megszakítható)
43/119 Irány (fizikai, backhaul) Szabványs (szabványs, nem szabványs) Allkált mennyiség Kiinduló ár Elszámló ár Aukciós felár Ügyletaznsító Tizedes jegyek száma Kapacitás egység Ár mértékegység Pénznem Kapacitás díj Aukciós egységár Aukciós díj Elszámló ár százalékban Elszámló díj TSO EIC kódja TSO neve Balancing grup infrmáció (lista) Balancing grup aznsító Zóna aznsító Mennyiség MEZŐK Megnevezés Leírás XML címkenév Frmátum / típus Trade aznsító A Trade aznsítására szlgáló szám tradeid Aukció név Egy 8 jegyű karaktersrzat, ami az aukció egyértelmű aznsítására szlgál. auctinname Aukció kezdő Az aukció kezdő időpntja auctinstart Datetime időpntja Aukció záró Az aukció záró időpntja auctinend Datetime időpntja Rendszerhasználó EIC kódja A rendszerhasználó EIC kódja netwrkusereic
44/119 Rendszerhasználó Operátr kódja A rendszerhasználó perátri kódja netwrkusercde Rendszerhasználó neve Hálózati pnt EIC kódja A rendszerhasználó neve netwrkusername A hálózati pnt EIC kódja netwrkpinteic Hálózati neve pnt A hálózati pnt neve netwrkpintname Hálózati pnt IP kódja (nminatin ID) A releváns hálózati pnt IP kódja (nminatin ID) netwrkpintnminatinid Termék típus Éves, negyedéves, havi, napi, napn belüli, STRIP prdcttype YEARLY, QUARTERLY MONTHLY, DAILY, WITHINDAY, STRIP Instrument Vnatkzási időszak instrument Érvényesség kezdete Az érvényesség kezdő időpnt validitystart Datetime Érvényesség vége Az érvényesség végét jelző időpnt validityend Datetime Kapacitás típus Kapcslt, nem kapcslt capacitytype BUNDLED, UNBUNDLED Megszakíthatóság Megszakítható, megszakítható nem capacityquality FIRM, INTERRUPTIBLE Áramlási irány Fizikai, Backhaul gasflw PHYSICAL, BACKHAUL Szabványs kapacitástermék Szabványs, nem szabványs, szeznális standard STANDARD, NON_STANDARD, NON_STANDARD- SEASONAL Allkált mennyiség Az érintett rendszerhasználónak allcatedcapacity Decimal
45/119 allkált mennyiség Kiinduló ár A kiinduló ár devizával együtt reserveprice Decimal Elszámló ár Aukciós felárral növelt kiinduló ár clearingprice Decimal Aukciós felár Elnyert kapacitásért, a kiinduló ár mellett fizetendő felár clearingpremium Decimal Ügyletaznsító Ügylet aznsítására egyedi ID pnts szlgáló cnfirmatnid Tizedesjegyek A maximális tizedesjegyek száma pricedecimals Decimal Kapacitás egység a kapacitás mértékegysége: kwh/h/termék típus capacityunit Currency unit Az árra vnatkztattt mértékegység: Currency/kWh/h/Prduct type currencyunit Pénznem A használt pénznem currency Kapacitás díj Tisztán a kapacitásért fizetendő díj capacityfee Decimal Az egységára aukció Az aukció ára a kiinduló ár és az elszámlási premium tükrében auctinunitprice Decimal Aukciós díj Az aukciós egységár szrzva a mennyiséggel auctinfee Decimal Elszámló százalékban ár Az elszámló ár százalékban clearingprice Decimal Elszámló díj A kapacitás díj és az aukciós díj együttesen clearingfee Decimal