Reginal Bking Platfrm Webservice szlgáltatás illeszkedési felület dkumentáció 5.0 verzió Készítette: IP Rendszerintegrátr Kft.
Tartalmjegyzék 1. A dkumentum célja... 6 2. Bevezetés... 7 3. Fgalmtár... 8 3.1. Hálózati infrastruktúra... 8 3.2. Szereplők... 9 4. Alapelvek... 10 4.1. Kncepció... 10 4.2. Műszaki infrmatikai megvalósításra vnatkzó alapelvek... 11 4.2.1 Rendelkezésre állás... 11 4.2.2 A reginal bking platfrm elérhetősége... 11 4.2.3 Aznsítás, tanúsítványk... 11 4.2.4 Alkalmaztt prtkllk, kódlás... 11 4.2.5 Üzenetek érvényessége validálás... 12 4.2.6 Archiválás... 12 5. Ajánlatadás... 13 5.1. Aukció adatk lekérdezése (getauctins)... 13 5.1.1 A kérést tartalmazó üzenet... 14 5.1.2 A választ tartalmazó üzenet... 14 5.2. Tömeges ajánlat beadás (bulkmakebids)... 19 5.2.1 A kérést tartalmazó üzenet... 23 5.2.2 A választ tartalmazó üzenet... 24 5.3. UPTA ajánlatk törlése (bulkremveuptabids)... 25 5.3.1 A kérést tartalmazó üzenet... 28 5.3.2 A választ tartalmazó üzenet... 28 5.4. Aukció adatk lekérdezése (getauctinsv2)... 29 5.4.1 A kérést tartalmazó üzenet... 30 5.4.2 A választ tartalmazó üzenet... 31 6. Web service kmmunikáció az RBP és a TSO Tag között... 39 6.1. Tarifa és áradatk küldése IP-ből RBP-be... 39 6.2. RBP aukciók eredményeinek imprtja... 52 6.3. RBP aukciók eredményeinek imprtja v2... 59 7. Bilaterális kapacitás átadás... 67
7.1. Bilaterális ajánlat beadás (OfferBilateralCapacity)... 67 7.1.1 A kérést tartalmazó üzenet... 70 7.1.2 A választ tartalmazó üzenet... 71 7.2. Bilaterális kapacitás átadásk lekérdezése üzemeltetők számára (GetBilateralOffersByTs)... 72 7.2.1 A kérést tartalmazó üzenet... 73 7.2.2 A választ tartalmazó üzenet... 74 7.3. Bilaterális kapacitás átadásk lekérdezése az átadó számára (GetBilateralOffersBySeller)... 77 7.3.1 A kérést tartalmazó üzenet... 78 7.3.2 A választ tartalmazó üzenet... 79 7.4. Bilaterális kapacitás átadásk lekérdezése az átvevő számára (GetBilateralOffersByBuyer)... 82 7.4.1 A kérést tartalmazó üzenet... 83 7.4.2 A választ tartalmazó üzenet... 84 7.5. Bilaterális kapacitás átadás elutasítása üzemeltetők számára (RefuseBilateralOfferByTs)... 87 7.5.1 A kérést tartalmazó üzenet... 90 7.5.2 A választ tartalmazó üzenet... 90 7.6. Bilaterális kapacitás átadás jóváhagyása üzemeltetők számára (ApprveBilateralOfferByTs) 91 7.6.1 A kérést tartalmazó üzenet... 94 7.6.2 A választ tartalmazó üzenet... 94 7.7. Bilaterális kapacitás átadás visszavnása az átadó számára (RevkeBilateralOfferBySeller)... 95 7.7.1 A kérést tartalmazó üzenet... 97 7.7.2 A választ tartalmazó üzenet... 97 7.8. Bilaterális kapacitás átadás visszautasítása az átvevő számára (RejectBilateralOfferByBuyer) 98 7.8.1 A kérést tartalmazó üzenet... 101 7.8.2 A választ tartalmazó üzenet... 103 7.9. Bilaterális kapacitás átadás jóváhagyása átvevők számára (ApprveBilateralOfferByBuyer) 103 7.9.1 A kérést tartalmazó üzenet... 106 7.9.2 A választ tartalmazó üzenet... 106 7.10. Bilaterális kapacitás átadás lezárás üzemeltetők számára (ClseBilateralOfferByTs)... 107 7.10.1 A kérést tartalmazó üzenet... 109 7.10.2 A választ tartalmazó üzenet... 109 8. Kapacitás visszaadás... 111 8.1. kapacitás visszaadás ajánlat beadás (OfferSurrenderedCapacity)... 111 8.1.1 A kérést tartalmazó üzenet... 113 8.1.2 A választ tartalmazó üzenet... 114 8.2. Kapacitás visszaadásk lekérdezése üzemeltetők számára (GetSurrenderedCapacityOffersByTs)... 115 8.2.1 A kérést tartalmazó üzenet... 116 8.2.2 A választ tartalmazó üzenet... 116
8.3. Kapacitás Visszaadásk lekérdezése a visszaadó számára (GetSurrenderedCapacityOffersByNetwrkUser)... 120 8.3.1 A kérést tartalmazó üzenet... 121 8.3.2 A választ tartalmazó üzenet... 121 8.4. Kapacitás visszaadás elutasítása üzemeltetők számára (RefuseSurrenderedCapacityOfferByTs)... 124 8.4.1 A kérést tartalmazó üzenet... 127 8.4.2 A választ tartalmazó üzenet... 127 8.5. Kapacitás visszaadás jóváhagyása üzemeltetők számára (ApprveSurrenderedCapacityOfferByTs)... 128 8.5.1 A kérést tartalmazó üzenet... 130 8.5.2 A választ tartalmazó üzenet... 130 8.6. Kapacitás visszaadás visszavnása a visszaadó számára (RevkeSurrenderedCapacityOfferByNetwrkUser)... 131 8.6.1 A kérést tartalmazó üzenet... 133 8.6.2 A választ tartalmazó üzenet... 133 8.7. Kapacitás visszaadás ajánlat visszajelzés üzemeltetők számára (CnfirmSurrenderedCapacityOfferByTs)... 134 8.7.1 A kérést tartalmazó üzenet... 136 8.7.2 A választ tartalmazó üzenet... 136 9. Web service kmmunikáció kapacitás lekötési platfrmk között... 138 9.1. A lkális platfrmn megadtt aukciós adatk elküldése... 138 9.1.1 A kérést tartalmazó üzenet... 139 9.2. A távli platfrmn megadtt aukciós adatk fgadása... 143 9.2.1 A kérést tartalmazó üzenet... 145 9.3. A távli platfrmn lefuttt aukció eredményének fgadása... 151 9.3.1 A kérést tartalmazó üzenet... 151 10. Pénzügyi limit kezelése... 164 10.1. Limit érték megadása... 164 10.1.1 A kérést tartalmazó üzenet... 164 10.1.2 A választ tartalmazó üzenet... 166 11. REMIT riprtk... 168 11.1. REMIT riprt lekérdezése... 168 11.1.1 A kérést tartalmazó üzenet... 168 11.1.2 A választ tartalmazó üzenet... 169
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. Az ajánlatadás ü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ő 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 Mértékegysé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 Mértékegysé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 a mennyiség, amennyinél kevesebbet már nem szeretne vásárlni az ajánlattevő minquantity Integer Mértékegység Az aukcióban kiírt kapacitás mennyiség mértékegysége. measureunit DAY, HOUR 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> <measureunit>hour</ measureunit > </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> <measureunit>hour</ measureunit > </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> <measureunit>hour</ measureunit > </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> <measureunit>hour</ measureunit > </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> <measureunit>hour</ measureunit > </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
22/170 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
24/170 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
25/170 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.
26/170 Ü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:
27/170 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:
29/170 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> 5.4. AUKCIÓ ADATOK LEKÉRDEZÉSE (GETAUCTIONSV2) Ü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.
30/170 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. 5.4.1 A KÉRÉST TARTALMAZÓ ÜZENET METÓDUS getauctinsv2 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.
31/170 PÉLDA <getauctinsv2> <request/> </getauctinsv2> 5.4.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. 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 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 Termék típus (éves, negyedéves, havi, napi, napn belüli, STRIP)
32/170 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 Balancing grup infrmáció (lista) Balancing grup aznsító Zóna aznsító Mennyiség
33/170 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
34/170 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 Balancing grup infrmációk Balancing grup infrmáció lista balancinggrupvalu es List Balancing grup aznsító 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 <getauctinsv2respnse> <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>
35/170 <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> <balancinggrupvalues> <balancinggrupvalue> <balancinggrup>xxx</balancinggrup> <zneid>hun</zneid> <quantity>4400</quantity> </balancinggrupvalue> <balancinggrupvalue> <balancinggrup>yyy</balancinggrup> <zneid>hun</zneid> <quantity>5300</quantity> </balancinggrupvalue> </balancinggrupvalues> </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> <balancinggrupvalues> <balancinggrupvalue> <balancinggrup>xxx</balancinggrup>
36/170 <zneid>hun</zneid> <quantity>3000</quantity> </balancinggrupvalue> <balancinggrupvalue> <balancinggrup>yyy</balancinggrup> <zneid>hun</zneid> <quantity>3000</quantity> </balancinggrupvalue> </balancinggrupvalues> </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> <balancinggrupvalues> <balancinggrupvalue> <balancinggrup>xxx</balancinggrup> <zneid>hun</zneid> <quantity>3000</quantity> </balancinggrupvalue> <balancinggrupvalue> <balancinggrup>yyy</balancinggrup> <zneid>hun</zneid> <quantity>2000</quantity> </balancinggrupvalue> </balancinggrupvalues> </bid> </actabids> <uptabids>
37/170 <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> <balancinggrupvalues> <balancinggrupvalue> <balancinggrup>xxx</balancinggrup> <zneid>hun</zneid> <quantity>400</quantity> </balancinggrupvalue> <balancinggrupvalue> <balancinggrup>yyy</balancinggrup> <zneid>hun</zneid> <quantity>600</quantity> </balancinggrupvalue> </balancinggrupvalues> </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>
38/170 <price>5000</pricestep> <bidquantity>1000</bidquantity> <minquantity>800</minquantity> <balancinggrupvalues> <balancinggrupvalue> <balancinggrup>xxx</balancinggrup> <zneid>hun</zneid> <quantity>600</quantity> </balancinggrupvalue> <balancinggrupvalue> <balancinggrup>yyy</balancinggrup> <zneid>hun</zneid> <quantity>400</quantity> </balancinggrupvalue> </balancinggrupvalues> </bid> </uptabids> </return> </getauctinsv2respnse>
39/170 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.
40/170 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
41/170 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,
42/170 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>
43/170 <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>
44/170 <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>
45/170 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>