Reginal Bking Platfrm Webservice szlgáltatás illeszkedési felület dkumentáció 5.7 verzió Készítette: IP Rendszerintegrátr Kft.
Tartalmjegyzék 1. Váltzásk az előző verzióhz képest... 7 2. A dkumentum célja... 9 3. Bevezetés... 10 4. Fgalmtár... 11 4.1. Hálózati infrastruktúra... 11 4.2. Szereplők... 12 5. Alapelvek... 13 5.1. Kncepció... 13 5.2. Műszaki infrmatikai megvalósításra vnatkzó alapelvek... 14 5.2.1 Rendelkezésre állás... 14 5.2.2 A reginal bking platfrm elérhetősége... 14 5.2.3 Aznsítás, tanúsítványk... 14 5.2.4 Alkalmaztt prtkllk, kódlás... 14 5.2.5 Üzenetek érvényessége validálás... 15 5.2.6 Archiválás... 15 6. Ajánlatadás... 16 6.1. Aukció adatk lekérdezése (getauctins)... 16 6.1.1 A kérést tartalmazó üzenet... 17 6.1.2 A választ tartalmazó üzenet... 17 6.2. Tömeges ajánlat beadás (bulkmakebids)... 23 6.2.1 A kérést tartalmazó üzenet... 27 6.2.2 A választ tartalmazó üzenet... 28 6.3. UPTA ajánlatk törlése (bulkremveuptabids)... 29 6.3.1 A kérést tartalmazó üzenet... 32 6.3.2 A választ tartalmazó üzenet... 32 7. Web service kmmunikáció az RBP és a TSO Tag között... 34 7.1. Kapacitás és áradatk küldése IP-ből RBP-be (upladcapacityandtariff, upladwithindaycapacity)... 34 7.1.1 A kérést tartalmazó üzenet... 34 7.1.2 A választ tartalmazó üzenet... 43 7.1.3 A kérést tartalmazó üzenet napn belüli aukció esetén... 44 7.1.4 A választ tartalmazó üzenet napn belüli aukció esetén... 46 7.2. Tarifa adatk feltöltése (upladtariff)... 48
7.2.1 A kérést tartalmazó üzenet... 48 7.2.2 A választ tartalmazó üzenet... 51 7.3. Kapacitás adatk feltöltése (upladcapacity)... 51 7.3.1 A kérést tartalmazó üzenet... 52 7.3.2 A választ tartalmazó üzenet... 54 7.4. Kapacitás adatk feltöltése autmatikusan kiírt megszakítható aukciókhz (upladcapacityv2)... 55 7.4.1 A kérést tartalmazó üzenet... 55 7.4.2 A választ tartalmazó üzenet... 58 7.5. RBP aukciók eredményeinek exprtja... 58 7.5.1 A kérést tartalmazó üzenet... 59 7.5.2 A választ tartalmazó üzenet... 60 7.6. RBP aukciók eredményeinek exprtja v2... 65 7.6.1 A kérést tartalmazó üzenet... 66 7.6.2 A választ tartalmazó üzenet... 67 7.7. RBP aukciók eredményeinek exprtja v3... 72 7.7.1 A kérést tartalmazó üzenet... 73 7.7.2 A választ tartalmazó üzenet... 74 7.8. RBP aukciók eredményeinek exprtja v4... 79 7.8.1 A kérést tartalmazó üzenet... 80 7.8.2 A választ tartalmazó üzenet... 81 7.9. RBP aukciók eredményeinek exprtja v5... 86 7.9.1 A kérést tartalmazó üzenet... 87 7.9.2 A választ tartalmazó üzenet... 88 7.10. RBP aukciók eredményeinek exprtja v6... 95 7.10.1 A kérést tartalmazó üzenet... 95 7.10.2 A választ tartalmazó üzenet... 97 8. Kapacitás visszavásárlás... 103 8.1. Visszavásárlási aukció létrehzás (CreateBuybackAuctinCandidate)... 103 8.1.1 A kérést tartalmazó üzenet... 104 8.1.2 A választ tartalmazó üzenet... 107 8.2. Visszavásárlási aukciós adatk lekérdezése (getbuybacktrades)... 108 8.2.1 A kérést tartalmazó üzenet... 108 8.2.2 A választ tartalmazó üzenet... 109 8.3. Visszavásárlási aukciós adatk lekérdezése, exit/entry TSO értékkel (getbuybacktradesv2).. 113 8.3.1 A kérést tartalmazó üzenet... 114 8.3.2 A választ tartalmazó üzenet... 115
9. Bilaterális kapacitás átadás... 120 9.1. Bilaterális ajánlat beadás (OfferBilateralCapacity)... 120 9.1.1 A kérést tartalmazó üzenet... 123 9.1.2 A választ tartalmazó üzenet... 124 9.2. Bilaterális ajánlat beadás, ár adattal (OfferBilateralCapacityV2)... 125 9.2.1 A kérést tartalmazó üzenet... 128 9.2.2 A választ tartalmazó üzenet... 129 9.3. Bilaterális kapacitás átadásk lekérdezése üzemeltetők számára (GetBilateralOffersByTs). 130 9.3.1 A kérést tartalmazó üzenet... 131 9.3.2 A választ tartalmazó üzenet... 132 9.4. Bilaterális kapacitás átadásk lekérdezése üzemeltetők számára, ár adattal (GetBilateralOffersByTsV2)... 135 9.4.1 A kérést tartalmazó üzenet... 136 9.4.2 A választ tartalmazó üzenet... 137 9.5. Bilaterális kapacitás átadásk lekérdezése az átadó számára (GetBilateralOffersBySeller)... 140 9.5.1 A kérést tartalmazó üzenet... 141 9.5.2 A választ tartalmazó üzenet... 142 9.6. Bilaterális kapacitás átadásk lekérdezése az átadó számára, ár adattal (GetBilateralOffersBySellerV2)... 145 9.6.1 A kérést tartalmazó üzenet... 146 9.6.2 A választ tartalmazó üzenet... 147 9.7. Bilaterális kapacitás átadásk lekérdezése az átvevő számára (GetBilateralOffersByBuyer). 150 9.7.1 A kérést tartalmazó üzenet... 151 9.7.2 A választ tartalmazó üzenet... 152 9.8. Bilaterális kapacitás átadásk lekérdezése az átvevő számára, ár adattal (GetBilateralOffersByBuyerV2)... 155 9.8.1 A kérést tartalmazó üzenet... 156 9.8.2 A választ tartalmazó üzenet... 157 9.9. Bilaterális kapacitás átadás elutasítása üzemeltetők számára (RefuseBilateralOfferByTs).. 160 9.9.1 A kérést tartalmazó üzenet... 162 9.9.2 A választ tartalmazó üzenet... 162 9.10. Bilaterális kapacitás átadás jóváhagyása üzemeltetők számára (ApprveBilateralOfferByTs)... 163 9.10.1 A kérést tartalmazó üzenet... 166 9.10.2 A választ tartalmazó üzenet... 166 9.11. Bilaterális kapacitás átadás visszavnása az átadó számára (RevkeBilateralOfferBySeller)167 9.11.1 A kérést tartalmazó üzenet... 169 9.11.2 A választ tartalmazó üzenet... 169
9.12. Bilaterális kapacitás átadás visszautasítása az átvevő számára (RejectBilateralOfferByBuyer)... 170 9.12.1 A kérést tartalmazó üzenet... 173 9.12.2 A választ tartalmazó üzenet... 175 9.13. Bilaterális kapacitás átadás jóváhagyása átvevők számára (ApprveBilateralOfferByBuyer)... 175 9.13.1 A kérést tartalmazó üzenet... 178 9.13.2 A választ tartalmazó üzenet... 178 9.14. Bilaterális kapacitás átadás lezárás üzemeltetők számára (ClseBilateralOfferByTs)... 179 9.14.1 A kérést tartalmazó üzenet... 181 9.14.2 A választ tartalmazó üzenet... 181 10. Kapacitás visszaadás... 183 10.1. kapacitás visszaadás ajánlat beadás (OfferSurrenderedCapacity)... 183 10.1.1 A kérést tartalmazó üzenet... 185 10.1.2 A választ tartalmazó üzenet... 186 10.2. Kapacitás visszaadásk lekérdezése üzemeltetők számára (GetSurrenderedCapacityOffersByTs)... 187 10.2.1 A kérést tartalmazó üzenet... 188 10.2.2 A választ tartalmazó üzenet... 188 10.3. Kapacitás visszaadásk lekérdezése üzemeltetők számára, felajánlási időpnttal (GetSurrenderedCapacityOffersByTsV2)... 192 10.3.1 A kérést tartalmazó üzenet... 193 10.3.2 A választ tartalmazó üzenet... 193 10.4. Kapacitás Visszaadásk lekérdezése a visszaadó számára (GetSurrenderedCapacityOffersByNetwrkUser)... 197 10.4.1 A kérést tartalmazó üzenet... 198 10.4.2 A választ tartalmazó üzenet... 199 10.5. Kapacitás Visszaadásk lekérdezése a visszaadó számára, exit/entry TSO értékkel (GetSurrenderedCapacityOffersByNetwrkUserV2)... 202 10.5.1 A kérést tartalmazó üzenet... 203 10.5.2 A választ tartalmazó üzenet... 203 10.6. Kapacitás visszaadás elutasítása üzemeltetők számára (RefuseSurrenderedCapacityOfferByTs)... 206 10.6.1 A kérést tartalmazó üzenet... 209 10.6.2 A választ tartalmazó üzenet... 209 10.7. Kapacitás visszaadás jóváhagyása üzemeltetők számára (ApprveSurrenderedCapacityOfferByTs)... 210 10.7.1 A kérést tartalmazó üzenet... 212 10.7.2 A választ tartalmazó üzenet... 212
10.8. Kapacitás visszaadás visszavnása a visszaadó számára (RevkeSurrenderedCapacityOfferByNetwrkUser)... 213 10.8.1 A kérést tartalmazó üzenet... 215 10.8.2 A választ tartalmazó üzenet... 215 10.9. Kapacitás visszaadás ajánlat visszajelzés üzemeltetők számára (CnfirmSurrenderedCapacityOfferByTs)... 216 10.9.1 A kérést tartalmazó üzenet... 218 10.9.2 A választ tartalmazó üzenet... 218 11. Web service kmmunikáció kapacitás lekötési platfrmk között... 220 11.1. A lkális platfrmn megadtt aukciós adatk elküldése (OfferedCapacity)... 220 11.1.1 A kérést tartalmazó üzenet... 221 11.2. A távli platfrmn megadtt aukciós adatk fgadása... 225 11.2.1 A kérést tartalmazó üzenet... 227 11.3. A távli platfrmn lefuttt aukció eredményének fgadása (AuctinResults)... 233 11.3.1 A kérést tartalmazó üzenet... 234 12. Pénzügyi limit kezelése... 246 12.1. Limit érték megadása (upladfincred)... 246 12.1.1 A kérést tartalmazó üzenet... 246 12.1.2 A választ tartalmazó üzenet... 248 13. REMIT riprtk... 250 13.1. REMIT riprt lekérdezése (dwnladremitreprt, dwnladremitreprtwithzip)... 250 13.1.1 A kérést tartalmazó üzenet... 250 13.1.2 A választ tartalmazó üzenet... 252 14. Balancing grup kezelés... 253 14.1. Új balancing grup létrehzása (createbalancinggrup)... 253 14.1.1 A kérést tartalmazó üzenet... 253 14.1.2 A választ tartalmazó üzenet... 255 14.2. Balancing grup módsítása (mdifybalancinggrup)... 255 14.2.1 A kérést tartalmazó üzenet... 256 14.2.2 A választ tartalmazó üzenet... 257
1. VÁLTOZÁSOK AZ ELŐZŐ VERZIÓHOZ KÉPEST Új elemek Web szlgáltatás Dkumentum verzió Verzió dátuma GetSurrenderedCapacityOffersByNetwrkUserV2 5.7 2017.02.22. GetSurrenderedCapacityOffersByTsV2 5.7 2017.02.22. GetBuybackTradesV2 5.7 2017.02.22. GetTradesV6 5.6 2017.01.27. GetBilateralOffersBySellerV2 5.5 2016.12.06. GetBilateralOffersByBuyerV2 5.5 2016.12.06. OfferBilateralCapacityV2 5.5 2016.12.06. GetBilateralOffersByTsV2 5.5 2016.12.06. UpladCapacityV2 5.5 2016.12.06. GetTradesV5 5.5 2016.12.06. CreateBuybackAuctinCandidate 5.5 2016.12.06. GetBuybackTrades 5.5 2016.12.06. Módsításk Web szlgáltatás Dkumentum verzió Verzió dátuma GetTrades GetTradesV6 5.7 2017.03.02. CreateBuybackAuctinCandidat e GetSurrenderedCapacityOffersB ynetwrkuser GetSurrenderedCapacityOffersB yts 5.7 2017.03.02. 5.7 2017.02.22. 5.7 2017.02.22. GetBuybackTrades 5.7 2017.02.22. GetBuybackTrades 5.6 2017.01.27. GetSurrenderedCapacityOffersB yts GetSurrenderedCapacityOffersB ynetwrkuser 5.6 2017.01.27. 5.6 2017.01.27.
GetAuctins 5.6 2017.01.27.
2. 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.
3. 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.
4. FOGALOMTÁR 4.1. HÁLÓZATI INFRASTRUKTÚRA RBP 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. Kapacitás Ascending Clck (ACTA) aukció Unifrm Price (UPTA) aukció Pr Ráta aukció Large Price Step (LPS) Small Price Step (SPS) 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. 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. Trlódás esetén pr ráta elvet alkalmazó aukciós eljárás típus. A pr ráta aukció srán a rendszerhasználó egy egykörös ajánlattételi kör srán egy darab, mennyiségre vnatkzó ajánlatt ad be, és minden rendszerhasználó, aki elnyer kapacitást, a kiinduló árn fizeti meg az elnyert kapacitás díját. 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ő.
4.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).
5. ALAPELVEK 5.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. Küldő infrmatikai platfrm KÉRÉS VÁLASZ Fgadó infrmatikai platfrm 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. Küldő infrmatikai platfrm XML, SOAP, HTTPS VISSZATÉRÉSI ÉRTÉK Web service felület Fgadó infrmatikai platfrm 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. 5.2. MŰSZAKI INFORMATIKAI MEGVALÓSÍTÁSRA VONATKOZÓ ALAPELVEK 5.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. 5.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ő. 5.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 5.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 5.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. 5.2.6 ARCHIVÁLÁS Az RBP Üzemeltető 5 évre archiválja a web service üzeneteket.
6. AJÁNLATADÁS 6.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 beadtt ajánlatkban szerepelnek az ajánlat srán megadtt balancing grup infrmációk is. A szlgáltatás külön mezőkben feltüntve jeleníti meg hgy az egyes aukciók esetében ki az Exit illetve ki az Entry TSO. 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ő 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.
6.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> 6.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 és az ajánlatban megadtt balancing grup infrmációkat is (ACTA és UPTA esetén). 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 Exit TSO Entry TSO Exit TSO EIC Entry TSO EIC 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ő Igényelt mennyiség Kapacitás mértékegysége (kwh/h vagy kwh/d) Aukció felár típus (százalék vagy deviza) Balancing grup infrmáció (lista) Balancing grup aznsító Zóna aznsító Mennyiség UPTA ajánlatk Aukció név Hálózati pnt neve Hálózati pnt EIC kódja Exit TSO Entry TSO Exit TSO EIC Entry TSO EIC 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 Kapacitás mértékegysége (kwh/h vagy kwh/d) Aukció felár típus (százalék vagy deviza) Igényelt minimum mennyiség Balancing grup infrmáció (lista) Balancing grup aznsító Zóna aznsító Mennyiség Pr ráta ajánlatk Aukció név Hálózati pnt neve
Hálózati pnt EIC kódja Exit TSO Entry TSO Exit TSO EIC Entry TSO EIC 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 Igényelt mennyiség Kapacitás mértékegysége (kwh/h vagy kwh/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 Hálózati neve pnt A hálózati pnt neve capacitypintname Hálózati pnt EIC kódja A hálózati pnt EIC kódja eic Exit TSO A kapacitás irányát határzza meg annak a TSO-nak a kijelölésével, amely felől a földgáz áramlik. exitts Entry TSO A kapacitás irányát határzza meg annak a TSO-nak a kijelölésével, amely felé a földgáz áramlik. entryts Exit TSO EIC Annak a TSO-nak az EIC kódja, amely felől a födgáz áramlik. exittseic
Megnevezés Leírás XML címkenév Frmátum / típus Entry TSO EIC Annak a TSO-nak az EIC kódja, amely felé a födgáz áramlik. entrytseic 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 megszakítható prductquality FIRM, INTERRUPTIBLE 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 Aktuális árlépcső (ACTA) A kiinduló árhz visznyíttt felár 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
Megnevezés Leírás XML címkenév Frmátum / típus Igényelt mennyiség (UPTA/Pr ráta) 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 Kapacitás mértékegysége Az aukción felajánltt kapacitás mértékegysége measureunit DAY, HOUR Aukció felár típus Jelzi, hgy az aukció százaléks vagy devizás felár értelmezésben került kiírásra. auctinpremiumtyp e Balancing grup infrmációk Balancing grup infrmáció lista balancinggrupvalu es List Balancing aznsító grup Az ajánlatadás srán megadtt balancing grup aznsító balancinggrup Zna aznsító Az érintett zóna aznsítója zneid Mennyiség A balancing grup- ra vnatkztattt mennyiség quantity Decimal PÉLDA <sap:envelpe xmlns:sap="http://schemas.xmlsap.rg/sap/envelpe/"> <sap:bdy> <ns2:getauctinsrespnse xmlns:ns2="http://rbp.hu"> <return> <actabids> <bid> <auctinname>00000206-rbp</auctinname> <capacitypintname>csanádpalta</capacitypintname> <eic>21z000000000236q</eic> <exitts>fgsz SN</exitTs> <entryts>transgaz SN</entryTs> <exittseic>21x-hu-a-a0a0a-8</exittseic> <entrytseic>21x-ro-a-a0a0a-s</entrytseic>
<prducttype>yearly</prducttype> <prductname>2017/2018</prductname> <prductquality>firm</prductquality> <capacitytype>bundled</capacitytype> <directin>direct</directin> <gasflw>physical</gasflw> <standard>standard</standard> <reserveprice>30 HUF, 20 RON</reservePrice> <capacityoffered>1000</capacityoffered> <bidquantity>0</bidquantity> <measureunit>hour</measureunit> <auctinpremiumtype>percentage</auctinpremiumtype> <lps>0</lps> <sps>0</sps> <pricestep>0</pricestep> </bid> </actabids> <uptabids> <bid> <auctinname>00000212-rbp</auctinname> <capacitypintname>balassagyarmat</capacitypintname> <eic>39zvebalass11gnj</eic> <exitts>fgsz SN</exitTs> <entryts/> <exittseic>21x-hu-a-a0a0a-8</exittseic> <entrytseic/> <prducttype>daily</prducttype> <prductname>2017.01.29</prductname> <prductquality>firm</prductquality> <capacitytype>unbundled</capacitytype> <directin>direct</directin> <gasflw>physical</gasflw> <standard>standard</standard> <reserveprice>10 HUF</reservePrice> <capacityoffered>1000</capacityoffered> <bidquantity>0</bidquantity> <measureunit>hour</measureunit> <auctinpremiumtype>percentage</auctinpremiumtype> <price>0</price> <minquantity>0</minquantity> </bid> </uptabids> <prratabids>
<bid> <auctinname>00000215-rbp</auctinname> <capacitypintname>drávaszerdahely (CR>HU)</capacityPintName> <eic>39wgedravas1iina</eic> <exitts/> <entryts> FGSZ SN </entryts> <exittseic/> <entrytseic>21x-hu-a-a0a0a-8</entrytseic> <prducttype>monthly</prducttype> <prductname>2016/2017 FEB</prductName> <prductquality>firm</prductquality> <capacitytype>unbundled</capacitytype> <directin>reverse</directin> <gasflw>physical</gasflw> <standard>standard</standard> <reserveprice>20.0000 HUF</reservePrice> <capacityoffered>2000</capacityoffered> <bidquantity>0</bidquantity> <measureunit>hour</measureunit> </bid> </prratabids> </return> </ns2:getauctinsrespnse> </sap:bdy> </sap:envelpe> 6.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, unifrm price ás pr ráta típusú aukcióra is lehet ajánlatkat adni. Az ajánlatk befgadásakr külön kezeljük az ACTA, UPTA és pr ráta 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, illetve pr ráta aukciók esetén is érvényes. 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
26/258 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
6.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 Pr rata 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, Pr ráta) Igényelt mennyiség UPTA/Pr ráta esetében. bidquantity Integer Minimum mennyiség Minimum vásárlni kívánt mennyiség UPTA esetében. minquantity Integer
28/258 (UPTA) 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> <prratabids> <bid> <auctinname>00000301-rbp</auctinname> <bidquantity>10000</bidquantity> </bid> </prratabids> </request> </bulkmakebids> 6.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
29/258 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> <BulkMakeBidsFault> <faultinf> <errr> <auctinname>00001016</auctinname> <errr>bid_quantity_greater_previous_bid_quantity</errr> </errr> </faultinf> </BulkMakeBidsFault> </detail> </sap:fault> </sap:bdy> 6.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.
30/258 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. Ü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:
31/258 Ellenőrzés Csak akkr lehet ajánlatt törölni, ha nyitva van az aukció Az aktuális aukciós státuszban nem lehet ajánlatt törölni Ehhez az aznsítóhz tartzó ajánlatt már törölték Nem létező aukció névre nem lehet ajánlatt beadni. Ajánlat csak akkr törölhető, ha a rendszerhasználó részt vesz az aukcióban Hibaüzenet aznsítója AUCTION_NOT_ACTIVE UPTA_BID_REMOVE_NOT_ALLOWED UPTA_BID_HAS_ALREADY_REMOVED INVALID_AUCTION NETWORK_USER_CANNOT_BID_ON_GIVEN_AUCTION
6.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> 6.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:
33/258 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>
34/258 7. WEB SERVICE KOMMUNIKÁCIÓ AZ RBP ÉS A TSO TAG KÖZÖTT 7.1. KAPACITÁS ÉS ÁRADATOK KÜLDÉSE IP-BŐL RBP-BE (UPLOADCAPACITYANDTARIFF, UPLOADWITHINDAYCAPACITY) Ü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. 7.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.
35/258 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) 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 Gáznap A megadtt gáznaphz visznyíttt időbélyeggel kerülnek betöltésre és lementésre a kapacitás adatk. Ha a példában szereplő gasday értéket (2016-01-01) vesszük alapul, akkr: gasday Éves kapacitás típus esetén a 2015-ös (2015.10.01-2016.09.30) gázévre vnatkzóan fgnak az éves kapacitás adatk lementődni. Negyedéves kapacitás típus esetén mindig annak a gázévnek az első gáznegyedévére fgnak betöltődni az értékek, amelyik gázévbe a gasday-ben a megadtt dátum esik. Tehát a példa szerint ez a 2015-ös gázév első, azaz a Q1 gáznegyedéve (2015.10.01-2015.12.31). Az adtt gázév tvábbi negyedéveire történő kapacitás- és tarifadatk
36/258 Megnevezés Leírás XML címkenév Frmátum / típus betöltésére is van lehetőség, méghzzá a capacitydatarws és a reservepricedatarws blkkk ismétlésével (ld.: Példa az összes gáznegyedévre történő kapaictás- és tarifa értékek betöltésére). Havi kapacitástípus esetén mindig a következő hónapra vnatkzó havi kapacitás- és tarifa értékek fgnak betöltésre kerülni. Jelen példa esetén, ha a gasday értéke 2016-01-01, akkr a gázév következő hónapjára, azaz februárra vnatkzóan fgnak az adatk mentésre kerülni. Napi kapacitástípus esetén mindig a következő napra vnatkzó kapacitás- és tarifa értékek fgnak betöltésre kerülni. Jelen példa esetén, ha a gasday értéke 2016-01-01, akkr a gázév következő napjára, azaz 2016.01.02-re vnatkzóan fgnak az adatk mentésre kerülni. 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 capacitypintna me 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. capacitybynetw rkpints YEARLY, QUARTERLY MONTHLY, DAILY, WITHINDAY, STRIP Megszakíthatóság Megszakítható, nem megszakítható prductquality FIRM,
37/258 Megnevezés Leírás XML címkenév Frmátum / típus INTERRUPTIBLE Hálózati iránya pnt 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, 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>2016-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>
38/258 <backhauldailycapacity>600</backhauldailycapacity> <backhaulhurlycapacity>25</backhaulhurlycapacity> </yearlycapacity> <quarterlycapacity> <firmdailycapacity>480</firmdailycapacity> <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>
39/258 <reservepricedatarws> <yearlyreserveprice> <prducttype>yearly</prducttype> <firmcapacityprice>661</firmcapacityprice> <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>
40/258 PÉLDA AZ ÖSSZES NEGYEDÉVRE TÖRTÉNŐ KAPACITÁS- ÉS TARIFA ÉRTÉKEK BETÖLTÉSÉRE <sapenv:envelpe xmlns:sapenv="http://schemas.xmlsap.rg/sap/envelpe/" xmlns:rbp="http://rbp.hu"> <sapenv:header/> <sapenv:bdy> <rbp:upladcapacityandtariff> <capacityandtariffdata> <tseiccde>21x-hu-a-a0a0a-8</tseiccde> <gasday>2016-12-20</gasday> <!--Optinal:--> <capacitylist> <!--Zer r mre repetitins:--> <capacitybynetwrkpints> <!--Optinal:--> <eiccde>21z000000000236q</eiccde> <!--Optinal:--> <capacitypintname>csanádpalta (HU>RO)</capacityPintName> <!--Optinal:--> <directin>direct</directin> <!--Zer r mre repetitins:--> <capacitydatarws> <quarterlycapacity> <firmdailycapacity>480</firmdailycapacity> <firmhurlycapacity>20</firmhurlycapacity> <interruptibledailycapacity>96</interruptibledailycapacity> <interruptiblehurlycapacity>4</interruptiblehurlycapacity> <backhauldailycapacity>2400000001</backhauldailycapacity> <backhaulhurlycapacity>10</backhaulhurlycapacity> </quarterlycapacity> </capacitydatarws> <capacitydatarws> <quarterlycapacity> <firmdailycapacity>480</firmdailycapacity> <firmhurlycapacity>20</firmhurlycapacity> <interruptibledailycapacity>96</interruptibledailycapacity> <interruptiblehurlycapacity>4</interruptiblehurlycapacity> <backhauldailycapacity>2400000001</backhauldailycapacity> <backhaulhurlycapacity>10</backhaulhurlycapacity> </quarterlycapacity>
41/258 </capacitydatarws> <capacitydatarws> <quarterlycapacity> <firmdailycapacity>480</firmdailycapacity> <firmhurlycapacity>20</firmhurlycapacity> <interruptibledailycapacity>96</interruptibledailycapacity> <interruptiblehurlycapacity>4</interruptiblehurlycapacity> <backhauldailycapacity>2400000001</backhauldailycapacity> <backhaulhurlycapacity>10</backhaulhurlycapacity> </quarterlycapacity> </capacitydatarws> <capacitydatarws> <quarterlycapacity> <firmdailycapacity>480</firmdailycapacity> <firmhurlycapacity>20</firmhurlycapacity> <interruptibledailycapacity>96</interruptibledailycapacity> <interruptiblehurlycapacity>4</interruptiblehurlycapacity> <backhauldailycapacity>2400000001</backhauldailycapacity> <backhaulhurlycapacity>10</backhaulhurlycapacity> </quarterlycapacity> </capacitydatarws> </capacitybynetwrkpints> </capacitylist> <!--Optinal:--> <reservepricelist> <!--Zer r mre repetitins:--> <reservepricebynetwrkpints> <!--Optinal:--> <eiccde>21z000000000236q</eiccde> <!--Optinal:--> <capacitypintname>csanádpalta (HU>RO)</capacityPintName> <!--Optinal:--> <directin>direct</directin> <!--Zer r mre repetitins:--> <reservepricedatarws> <!--Optinal:--> <quarterlyreserveprice> <!--Optinal:-->
42/258 <prducttype>quarterly</prducttype> <!--Optinal:--> <firmcapacityprice>1</firmcapacityprice> <!--Optinal:--> <interruptiblecapacityprice>1</interruptiblecapacityprice> <!--Optinal:--> <backhaulcapacityprice>1</backhaulcapacityprice> <!--Optinal:--> <lps>10</lps> <!--Optinal:--> <sps>1</sps> </quarterlyreserveprice> </reservepricedatarws> <reservepricedatarws> <!--Optinal:--> <quarterlyreserveprice> <!--Optinal:--> <prducttype>quarterly</prducttype> <!--Optinal:--> <firmcapacityprice>1</firmcapacityprice> <!--Optinal:--> <interruptiblecapacityprice>1</interruptiblecapacityprice> <!--Optinal:--> <backhaulcapacityprice>1</backhaulcapacityprice> <!--Optinal:--> <lps>10</lps> <!--Optinal:--> <sps>1</sps> </quarterlyreserveprice> </reservepricedatarws> <reservepricedatarws> <!--Optinal:--> <quarterlyreserveprice> <!--Optinal:--> <prducttype>quarterly</prducttype> <!--Optinal:--> <firmcapacityprice>1</firmcapacityprice> <!--Optinal:--> <interruptiblecapacityprice>1</interruptiblecapacityprice> <!--Optinal:-->