GAZDÁLKODÁSI RENDSZER INTERFÉSZ AJÁNLÁS 1
A dokumentum az Új Magyarország Fejlesztési Terv keretében, az Államreform Operatív Program támogatásával, az Elektronikus közigazgatási keretrendszer tárgyú kiemelt projekt megvalósításának részeként készült. A dokumentum elkészítésében részt vett: 2
1. Metaadat-táblázat Megnevezés Leírás Cím (dc:title) Gazdálkodási rendszer interfész ajánlás Kulcsszó (dc:subject) Önkormányzat; interoperabilitás; interfész specifikáció; ajánlás Leírás (dc:description) Az ügyintézésben elıforduló pénzügyi tranzakciókat (kötelezettségválllalás, utalványozás, bevételi elıírás, beszedés, befizetések ellenırzése) bonyolító, illetve az azokhoz szükséges támogató interfészeken átadandó adattartalom definíciója. Típus (dc:type) Szöveg Forrás (dc:source) Stratis Kft. Kapcsolat (dc:relation) Önkormányzati architektúra ajánlás Terület (dc:coverage) Önkormányzati szemantikai interoperabilitás Létrehozó (dc:creator) e-közigazgatási Keretrendszer Kialakítása projekt Kiadó (dc:publisher) MEH EKK Résztvevı (dc:contributor) Stratis Kft. Önkormányzati interoperabilitási szemantikai munkacsoport Jogok (dc:rights) Dátum (dc:date) 2008.10.03. Formátum (dc:format) Elektronikus Azonosító (dc:identifier) Nyelv (dc:language) Magyar Verzió (dc:version) V2 Státusz (State) Fájlnév (FileName) EKK_ekozig_ Gazdalkodasi_rendszer_Interfeszek _081003_V2.doc Méret (Size) 1191 kb Ár (Price) - Felhasználási jogok (UserRights) A közigazgatás egészében szabad felhasználású, a forrás megjelölésével. 3
2. Verziókövetési táblázat A dokumentum neve Gazdálkodási rendszer interfész ajánlás A dokumentum készítıjének neve Stratis Kft. A dokumentum jóváhagyójának neve A dokumentum készítésének dátuma 2008.10.03. Verziószám V2 Összes oldalszám 45 A projekt azonosítója e-közigazgatási Keretrendszer Kialakítása projekt 2.1. Változáskezelés Verzió Dátum A változás leírása V1 2008.09.22. MeH-nek átadott verzió V2 2008.10.03. Minıségbiztosítási vélemény alapján javított verzió. V3 4
3. Szövegsablon Megnevezés 1. Elıszó (Foreword) 2. Bevezetés (Preamble) 3. Alkalmazási terület (Scope) 4. Rendelkezı hivatkozások (References) 5. Fogalom-meghatározások (Definitions) 6. A szabvány egyedi tartalma (UniqueContent) 7. Bibliográfia 8. Rövidítésgyőjtemény 9. Fogalomtár 10. Ábrák 11. Képek 12. Fogalmak 13. Verzió 14. Mellékletek (Appendix) Leírás 5
4. Tartalomjegyzék 1. METAADAT-TÁBLÁZAT... 3 2. VERZIÓKÖVETÉSI TÁBLÁZAT... 4 2.1. VÁLTOZÁSKEZELÉS 4 3. SZÖVEGSABLON... 5 4. TARTALOMJEGYZÉK... 6 5. ELİSZÓ... 7 6. BEVEZETÉS... 7 7. ALKALMAZÁSI TERÜLET... 7 8. RENDELKEZİ HIVATKOZÁSOK... 8 9. FOGALOM-MEGHATÁROZÁSOK... 8 10. A SZABVÁNY EGYEDI TARTALMA... 9 10.1. A GAZDÁLKODÁSI RENDSZER INTERFÉSZEI 9 10.1.1. Hozzáférhetı elıirányzatok listája 12 10.1.2. Elıirányzaton rendelkezésre álló fedezet lekérdezése 14 10.1.3. Bankszámlaszám-lista lekérdezése 16 10.1.4. Kötelezettségvállalás 18 10.1.5. Kifizetési utalvány fogadása (Utalványozás) 24 10.1.6. Bevételi elıírás fogadása 29 10.1.7. Bevételi utalvány fogadása 32 10.1.8. Fizetési tranzakció ellenırzése 37 11. MELLÉKLETEK... 40 11.1. KÓDKATALÓGUS-KEZELÉSI ELJÁRÁSOK 40 11.2. ADATTÍPUS DEFINÍCIÓK 41 11.2.1. FizetesiModTipus 41 11.2.2. Kedvezményezett / Befizetı 41 11.2.3. BankSzamlaSzamTipus 42 11.2.4. KTK (Kincstári Tranzakciós Kód) 42 11.2.5. Tevékenység-típus 43 11.2.6. Kötelezettségvállalás tételei (KotelezettsegVallalasTetelTipus) 43 11.2.7. Kifizetési és bevételi utalványok (KifizetesiUtalvanyTipus, BeveteliUtalvanyTipus) 43 11.3. XSD FÁJL 44 12. SZAKIRODALMI HIVATKOZÁS... 44 13. RÖVIDÍTÉSGYŐJTEMÉNY... 44 14. ÁBRÁK... 45 15. KÉPEK... 45 16. TÁBLÁZATOK... 45 6
17. VERZIÓSZÁM... 45 5. Elıszó A Miniszterelnöki Hivatal Elektronikus Közigazgatás Stratégiai Központja a Budapesti Mőszaki Egyetem Informatikai Központja vezette konzorciumot bízta meg az Önkormányzati architektúra ajánlás és kapcsolódó interfész-specifikációk elkészítésével. Jelen dokumentum az önkormányzati gazdálkodási rendszerekben megvalósításra ajánlott interfészeket definiálja. 6. Bevezetés Jelen ajánlás célja az önálló gazdálkodást folytató, de az államháztartás felé jelentési kötelezettséggel bíró önkormányzatok operatív gazdálkodási folyamatainak, tranzakcióinak támogatása, a papíralapú iratmozgások mennyiségének csökkentése. Az interfészek szemantikai szinten definiálják az általános, hatósági eljárás során nagy tömegben elıforduló tranzakciók során a szakrendszerek és gazdálkodási rendszerek között átadandó adatstruktúrákat, amelyek a jogszabályokban elıírt kötelezı tartalom mellett a kiadások/bevételek könyvelését támogató információkat is tartalmaznak. Az egyes tranzakciók kiválasztása, illetve az azok során átadott adatstruktúrák kialakítása a következık alapján történt: Az ügyintézési folyamat során elıforduló gyakori pénzügyi tranzakciók azonosítása Jogszabályok elemzése Gazdálkodási rendszerek mőködésének, funkcionalitásának elemzése Az ajánlásban leírtakon túl az egyes szervezetek mőködési sajátosságainak figyelembe vételével további adattartalmak is használhatók, az ajánlás az általános, minden, a lenti tranzakciókat végzı szervezetnél használható adattartalmakat definiálja. 7. Alkalmazási terület Az interfészek alkalmazási területe az önkormányzatoknál alkalmazott szakrendszerek által a gazdálkodási rendszer felé kezdeményezett pénzügyi/gazdasági tranzakciók elektronikus útra helyezése. Az ajánlás hatóköre a pénzügyi folyamatnak az ügyintézéshez köthetı, más rendszerekkel való kapcsolatot igénylı szakasza. Az ajánlás nem foglalkozik a jellemzıen rendszeren belül végzett tervezési, illetve könyvelési feladatokkal, a költségvetés, elıirányzatok szerkezetének kialakításával, folyamataival, valamint a szervezetek által elıállítandó jelentések készítésével, mivel azok a gazdálkodási rendszeren belüli feladatok, de ahol lehetséges, lehetıséget biztosít a fent említett tevékenységeket egyszerősítı adatok átadására (pl. Kincstári tranzakciós kód). 7
8. Rendelkezı hivatkozások Önkormányzati architektúra ajánlás: jelen ajánlás az Önkormányzati architektúra ajánlásban definiált funkciókat figyelembe véve, az abban leírt interfész-struktúrának megfelelıen készült. 217/1998. (XII. 30.) Korm. rendelet az államháztartás mőködési rendjérıl 2004. évi CXL. törvény (KET) 193/2005. (IX. 22.) Korm. rendelet az elektronikus ügyintézés részletes szabályairól (KET végrehajtási rendelete) 1990. évi LXV. törvény a helyi önkormányzatokról 36/1999. (XII. 27.) PM rendelet a kincstári rendszer mőködésével kapcsolatos pénzügyi szolgáltatások teljesítésének rendjérıl 1992. évi XXXVIII. törvény az államháztartásról (helyi önkormányzatokra vonatkozóan 62-83) 1991. évi XX. törvény a helyi önkormányzatok és szerveik, a köztársasági megbízottak, valamint egyes centrális alárendeltségő szervek feladat- és hatásköreirıl 249/2000. (XII. 24.) Korm. rendelet az államháztartás szervezetei beszámolási és könyvvezetési kötelezettségének sajátosságairól 2007. évi CLXIX. törvény a Magyar Köztársaság 2008. évi költségvetésérıl 1990. évi XCIII. törvény az illetékekrıl (Harmadik rész) 193/2005. (IX. 22.) Korm. rendelet az elektronikus ügyintézés részletes szabályairól IX. fejezet 44/2004. (XII. 20.) PM rendelet az eljárási illetékek megfizetésének és a megfizetés ellenırzésének részletes szabályairól http://net.jogtar.hu/jr/gen/hjegy_doc.cgi?docid=99100013.pm13/1991. (V. 21.) PM rendelet a települési önkormányzat hatáskörébe tartozó adók és adók módjára behajtandó köztartozások nyilvántartásáról, kezelésérıl és elszámolásáról 21/2006. (XI. 24.) MNB rendelet a pénzforgalom lebonyolításáról 79/2004. (IV. 19.) Korm. rendelet a postai szolgáltatások ellátásáról és minıségi követelményeirıl 9. Fogalom-meghatározások Bevételi elıírás: az elıre látható bevételek (önkormányzat által beszedett adók, nyújtott szolgáltatások ellenértéke, stb.) rögzítése. Bevételi utalvány: az ügyfél/partner hivatal felé való fizetési kötelezettségének jelzése CDV (Check Digit Verification): a bankszámlaszámok formai validálása során (is) használt eljárás. (Kifizetési) utalvány: a kötelezettségvállalásban foglalt feltételek teljesülése esetén a hivatalra vonatkozó (jelen esetben pénzügyi) kötelezettség teljesítése, a vonatkozó összeg kifizetésére adott megbízás: Az utalvány tartalmára vonatkozóan a 217/1998. (XII. 30.) Korm. rendelet (az államháztartás mőködési rendjérıl) 136. 4.bekezdése 8
Kötelezettségvállalás: jelen ajánlás szempontjából a kötelezettségvállalás olyan intézkedés, amely jövıbeni fizetési kötelezettséget von maga után. Ügyazonosító szám az eljárási illeték esetében a Magyar Államkincstár által kiadott, az eljáró szervet azonosító intézményazonosító számból és az eljáró szerv által megadott ügyszámból áll a Magyar Államkincstár által meghatározott formátum szerint. Az ügyazonosító az igazgatási szolgáltatási díj esetében az eljáró szerv által megadott szám. 10. A szabvány egyedi tartalma 10.1. A gazdálkodási rendszer interfészei A gazdálkodási rendszerek szakrendszerek felé nyújtott szolgáltatásai alapvetıen a következı eseményekhez köthetık: Kötelezettségvállalás, bevételi elıírás A kötelezettségvállalások és bevételi elıírások nyilvántartása azon túl, hogy jogszabályi elıírás, a hivatalok pénzügyi tervezését is támogatja. Mivel a kiadási elıirányzatok túllépése a hivatalok számára aggályos, a kifizetések esetében minden esetben szükséges az elıirányzaton rendelkezésre álló fedezet ellenırzése, illetve kötelezettségvállalással való lefoglalása. Bevételek: Bevételek alatt nem csak azokat a tranzakciókat értjük, amelyeknek összege a hivatal számláján jelenik meg, hanem beleértjük ebbe a halmazba azokat a fizetéseket is, amelyeket az ügyfél az Államkincstár felé teljesít, de teljesülésének ellenırzésére szükség lehet. Szolgáltatások ellenértéke: a hivatal által nyújtott szolgáltatásokból, bérbeadott területekbıl, stb. eredı bevételek. Ezek jellemzıen elıre ismertek, bevételi elıírás hozható létre rájuk. Igazgatási szolgáltatási díj (193/2005, 39..): az eljáró szerv által megadott ügyanozosító ismeretében fizethetı meg, amennyiben jogszabály lehetıvé teszi, legkésıbb a közigazgatási eljárást lezáró határozat személyes átvételével egyidejőleg. Az ügyazonosító az igazgatási szolgáltatási díj esetében az eljáró szerv által megadott szám. Államigazgatási eljárási illeték (193/2005, 39.par.): Az eljárási illetékkötelezettség az eljárás megindítása iránti kérelem elıterjesztésekor keletkezik (1990. évi XCIII. tv.). Az eljárási illeték a Magyar Államkincstárnál vezetett eljárási illetékbevételi számla javára fizetendı, de az az eljárás megindítása elıtt is megfizethetı, készpénz-átutalási megbízással. Az eljárási illetékre vonatkozó kötelezettség az ügyazonosító ismeretében banki átutalással is teljesíthetı. Az eljárási illeték elızetes megfizetését az eljárás megindításakor - a készpénz-átutalási megbízás feladóvevényén szereplı azonosító szám (8 számjegyő azonosító), a megfizetett 9
eljárási illeték összegének és a befizetés idıpontjának feltüntetésével - közölni kell az eljáró szervvel. Az eljárási illeték elızetes megfizetésével indított ügyben az eljáró szerv a befizetés tényét a Magyar Államkincstár megkeresésével - a 8 számjegyő azonosító szám feltüntetése mellett - ellenırzi. A Magyar Államkincstár a megkeresésre - a 8 számjegyő azonosító szám alapján - közli a megfizetett illeték összegét, a megfizetés idıpontját és azt a tényt, hogy az adott azonosító számra érkezett-e korábban megkeresés más szervtıl. Az eljáró közigazgatási szerv nyilvántartást vezet az ügyfél által közölt 8 számjegyő azonosító számról, a megfizetett összeg nagyságáról, a befizetés idıpontjáról. Az ügyazonosító szám az eljárási illeték esetében a Magyar Államkincstár által kiadott, az eljáró szervet azonosító intézményazonosító számból és az eljáró szerv által megadott ügyszámból áll a Magyar Államkincstár által meghatározott formátum szerint. Az interoperabilitás szempontjából fontos jellemzık: Az eljárási illeték elıre is megfizethetı, a hivatal által elıre nem ismert hivatkozási számmal (ügyazonosítóval). Befizetése a Magyar Államkincstárhoz történik, a készpénz-átutalási megbízáson szereplı 8 számjegyő azonosító képezi a kapcsolatot. Ügyintézés esetén a bizonylat alapján az ügyintézés megkezdhetı, de a tranzakció-lekérdezı interfész lehetıséget ad a készpénz-átutalási megbízás alapján történı lekérdezésre is. Házipénztárban is befizethetı (44/2004. (XII. 20.) PM rendelet 4. par.)(ezesetben nem szükséges interfészen státuszt lekérdezni) Határozat alapján keletkezı bevételek (pl. bírság): Az ilyen bevételek jellemzıje, hogy az ügyfél fizetési kötelezettsége az ügyintézés során, annak eredményeképpen keletkezik, így egyértelmően azonosítóható az ügyfél, illetve az ügy (ügyirat) is. A gazdálkodási rendszer és a szakrendszerek közötti interfészek szempontjából bár a fenti bevételek némelyike külsı hivatkozási számon érkezik, de a benyújtott bizonylattal ezt a hivatkozási számot a hivatal is megismeri, így a fizetés megtörténtének ellenırzése szempontjából nem jelentenek különbséget (a hivatkozási szám a pénzügyi szolgáltatón keresztül eljut a gazdálkodási rendszerbe, a bizonylattal pedig az ügyintézıhöz). Eljárási illeték esetén a szakrendszer általi lekérdezés sikerességéhez szükséges, hogy az Államkincstártól a hivatal által lekérdezésre kerüljön a befizetés ténye. Az eljárási illeték sajátossága továbbá, hogy beérkezésének ténye elıre nem ismert, így bevételi elıírás, beszedési megbízás nem szükséges a szakrendszerbıl a gazdálkodási rendszer irányába. Ügyfélnek/partnernek történı kifizetések A hivatal általi kifizetések (támogatások; segélyek; áruk, szolgáltatások ellenértéke; személyi jellegő juttatások, stb.) interoperabilitás szempontjából fontos közös jellemzıje, hogy mindig egyértelmően a hivatal által is ismert hivatkozási számhoz/azonosítóhoz köthetıek, és ez a hivatkozás a tranzakció megtörténének lekérdezésére is használható. A pénzügyi eseményeket, illetve a támogató jellegő szolgáltatásokat a következı ábra mutatja be: 10
Elıirányzat-foglalás Pénzügyi tranzakciók Kötelezettség-vállalás Utalványozás (kifizetés kérése) Bevételi elıírások fogadása Bevételi utalványok (beszedési megbízás) Támogató funkciók Fedezetvizsgálat Elérhetı elıirányzatok listája Bankszámla-lista Fizetési tranzakció megtörténtének ellenırzése 1. ábra: Az ajánlás hatókörébe tartozó interfész szolgáltatások A fenti tranzakciókkal kapcsolatban az önkormányzati gazdálkodási rendszerekben a következı interfészek megvalósítása szükséges a szakrendszerekbıl kezdeményezett, gyakori tranzakciók elektronikus útra tereléséhez: 1. Táblázat A definiált szolgáltatások Szolgáltatás megnevezése Felhasználó által hozzáférhetı elıirányzatok listája (EloiranyazatLista) Elıirányzatban rendelkezésre álló fedezet lekérdezése (FedezetVizsgalat) Bankszámla-lista lekérdezése (BankszamlaLista) Kötelezettségvállalás (KotelezettsegVallalas) Utalvány fogadása (KifizetesiUtalvanyozas) Bevételi elıírás (BeveteliEloiras) Bevételi utalvány fogadása (BeveteliUtalvany) Fizetési tranzakció ellenırzése (FizetesLekerdezes) Szolgáltatás rövid leírása Azon elıirányzatok/elemi elıirányzatok lekérdezése, amelyek terhére a felhasznló kötelezettség vállalására jogosult. A szakrendszerekben történı kötelezettségvállalás elıtt szükséges fedezet-ellenırzés. Az utalványozás során használható bankszámlák listájának lekérdezése (kitöltési segédletként) A szakrendszerekben vállalt kötelezettségekre vonatkozó összeg lefoglalása A szakrendszerekben elkészített kifizetési megbízások átadásához, kötelezettségvállalásra történı hivatkozással. A jövıben várt, elıre ismert bevételek rögzítése. A bevételi elıírás egyes tételeire vonatkozó beszedési megbízás. A kifizetési és bevételi utalványokhoz tartozó pénzmozgás megtörténtének ellenırzése. 11
10.1.1. Hozzáférhetı elıirányzatok listája A szolgáltatás a kapcsolódó szakrendszerbe bejelentkezett felhasználó jogosultságai, valamint a szakrendszer jellege alapján leszőri a számára hozzáférhetı elıirányzatokat (attól függıen, hogy kötelezettségvállalás/kifizetés, vagy befizetés történik-e), és visszaadja az alkalmazásnak a rendelkezésre álló elıirányzatkód elıirányzat párokat. Az elıirányzatokat az önkormányzat érvényes költségvetési rendelete tartalmazza. Ezekhez (amennyiben a rendelet ezt nem tartalmazza) a gazdasági rendszerben egyértelmő azonosítót kell rendelni. Az elıirányzatok hierarchiáját a hivatalok szabadon definiálhatják, ezért az elıirányzat-kód, illetve elıirányzat mezık értékkészlete nem definiálható, azt az elıirányzat-lista lekérdezés során kapja meg a szakrendszer. 10.1.1.1. Az Elıirányzatlista kérés adattartalma és formátum specifikációja 2. Táblázat Az Elıirányzatlista interfészen várt adatok Adatmezı Formátum Kötelezı Megjegyzés Fejléc Fejléc típus I - Tevékenység típusa Kód (ld. az XSD specifikációban) I Annak azonosítása, hogy a felhasználó milyen tevékenységet kíván elvégezni az adott elıirányzattal kapcsolatban. 10.1.1.1.1. Az Elıirányzatlista kérés XSD definíciója 10.1.1.1.1.1. A kérés struktúrája 2. ábra Az Elıirányzatlista kérés struktúrája 10.1.1.1.1.2. Az xsd file (tartalmi rész) <xs:complextype name="eloiranyzatlistakerestipus"> <xs:element name="fejlec" type="fejlectipus" /> <xs:element name="tevekenysegtipus" type="tevekenysegtipus" /> 12
10.1.1.2. A válasz adattartalom és formátum specifikációja 3. Táblázat Az Elıirányzatlista interfészen küldött válasz tartalma Adatmezı Formátum Kötelezı Megjegyzés Fejlec Üzenet fejléc típus I - Elıriányzat kód String I 0 vagy több pár Elıirányzat név String I Elemi elıirányzat kód String N 0 vagy több pár Elemi elıirányzat név String N Az interfészen lehetséges specifikus hibakódok: - 10.1.1.2.1. A válasz XSD definíciója 10.1.1.2.1.1. A válasz struktúrája 3. ábra Az Elıirányzatlista válasz struktúrája 10.1.1.2.1.2. Az xsd file (tartalmi rész) <xs:complextype name="eloiranyzatlistavalasztipus"> <xs:element name="fejlec" type="fejlectipus" /> <xs:choice> <xs:element name="eloiranyzatok"> <xs:documentation>a hivatal által alkalmazott elıirányzatrendszernek megfelelıen.</xs:documentation> <xs:complextype> <xs:element minoccurs="0" maxoccurs="unbounded" name="eloiranyzat"> <xs:complextype> <xs:element name="eloiranyzatkod" type="xs:string" /> <xs:element name="eloiranyzatnev" type="xs:string" /> 13
<xs:element minoccurs="0" maxoccurs="unbounded" name="elemieloiranyzat"> <xs:complextype> <xs:element name="elemieloiranyzatkod" type="xs:string" /> <xs:element name="elemieloiranyzatnev" type="xs:string" /> <xs:element name="hibalista" type="hibalistatipus" /> </xs:choice> 10.1.2. Elıirányzaton rendelkezésre álló fedezet lekérdezése A szükséges jogosultság megléte esetén kötelezettségvállalás elıtt a felhasználó ellenırizheti, hogy az adott elıirányzatban rendelkezésre áll-e a szükséges, kötelezettségvállalással még nem terhelt fedezet, és ennek ismeretében hozhatja meg a döntést. Bár a funkciónak a kiadásokra vonatkozó kötelezettségvállalásokra vonatkozóan van elsısorban szerepe, bevételi elıírásokra is alkalmazható. A fedezetvizsgálat a szükséges összeg ismeretében igen/nem választ ad vissza. 10.1.2.1. A kérés adattartalma és formátum specifikációja 4. Táblázat - A Fedezetvizsgálat kérés interfészen várt adatok Adatmezı Formátum Kötelezı Megjegyzés Fejléc Fejléc típus I - Elıirányzat-kód String I - Vagy Elemi elıirányzat kód String I - Vizsgált összeg Összeg (float) Devizanem típus (3 karakteres string) I Összeg és devizanem 10.1.2.1.1. A kérés XSD definíciója 10.1.2.1.1.1. A kérés struktúrája 14
4. ábra - A Fedezetvizsgálat kérés struktúrája 10.1.2.1.1.2. Az xsd file (tartalmi rész) <xs:complextype name="fedezetvizsgalatkerestipus"> <xs:element name="fejlec" type="fejlectipus" /> <xs:choice> <xs:element name="eloiranyzatkod" type="xs:string" /> <xs:element name="elemieloiranyzatkod" type="xs:string" /> </xs:choice> <xs:element name="vizsgaltosszeg"> <xs:complextype> <xs:element name="osszeg" type="xs:float" /> <xs:element name="devizanem" type="devizanemtipus" /> 10.1.2.2. A válasz adattartalom és formátum specifikációja 5. Táblázat A Fedezetvizsgálat interfészen küldött válasz tartalma Adatmezı Formátum Kötelezı Megjegyzés Fejlec Üzenet fejléc típus I - FedezetRendelkezesreAll Boolean I - Vagy Hibalista Hibalista típus I - Az interfészen lehetséges specifikus hibakódok: 600: Nem létezı elıirányzatkód 15
10.1.2.2.1. A válasz XSD definíciója 10.1.2.2.1.1. A válasz struktúrája 5. ábra A Fedezetvizsgálat válasz struktúrája 10.1.2.2.1.2. Az xsd file (tartalmi rész) <xs:complextype name="fedezetvizsgalatvalasztipus"> <xs:element name="fejlec" type="fejlectipus" /> <xs:choice> <xs:element name="fedezetrendelkezesreall" type="xs:boolean" /> <xs:element name="hibalista" type="hibalistatipus"> <xs:documentation>nem létezı elıirányzatkód</xs:documentation> </xs:choice> 10.1.3. Bankszámlaszám-lista lekérdezése A bankszámlaszám-lista lekérdezése kitöltési segédletként szolgál a pénzügyi tranzakciókat kezdeményezı szakrendszeri ügyintézık számára. 10.1.3.1. A kérés adattartalma és formátum specifikációja 6. Táblázat - A Bankszámlaszám-lista kérés interfészen várt adatok Adatmezı Formátum Kötelezı Megjegyzés Fejléc Fejléc típus I 16
10.1.3.1.1. A kérés XSD definíciója 10.1.3.1.1.1. A kérés struktúrája 6. ábra A Bankszámlaszám-lista kérés struktúrája 10.1.3.1.1.2. Az xsd file (tartalmi rész) <xs:complextype name="bankszamlalistakerestipus"> <xs:element name="fejlec" type="fejlectipus" /> 10.1.3.2. A Bankszámlaszám-lista válasz adattartalom és formátum specifikációja 7. Táblázat A Bankszámlaszám-lista interfészen küldött válasz tartalma Adatmezı Formátum Kötelezı Megjegyzés Fejlec Üzenet fejléc típus I - Hibalista Hibalistatípus - Vagy 0 vagy több Bankszámla megnevezése String I - Bankszámlaszám Bankszámlaszám típus I - 10.1.3.2.1. A válasz XSD definíciója 10.1.3.2.1.1. A válasz struktúrája 7. ábra - A Bankszámlaszám-lista válasz struktúrája 10.1.3.2.1.2. Az xsd file (tartalmi rész) <xs:complextype name="bankszamlalistavalasztipus"> <xs:documentation>a felhasználó által használható bankszámlák jellemzıinek visszaadása.</xs:documentation> 17
/> <xs:element name="fejlec" type="fejlectipus" /> <xs:choice> <xs:element name="hibalista" type="hibalistatipus" /> <xs:element minoccurs="0" maxoccurs="unbounded" name="bankszamla"> <xs:complextype> <xs:element name="bankszamlamegnevezese" type="xs:string" /> <xs:element name="bankszamlaszam" type="bankszamlaszamtipus" </xs:choice> 10.1.4. Kötelezettségvállalás Amennyiben az adott elıirányzaton rendelkezésre áll a szükséges fedezet, a jogosultsággal rendelkezı felhasználónak lehetısége van annak terhére fizetési kötelezettséget vállalni (szerzıdés aláírása, határozat-hozatal). A kötelezettségvállalás több tételt is tartalmazhat, ezek egyedi azonosítása a gazdálkodási rendszer által visszaadott kötelezettségvállalás-nyilvántartási szám, valamint a tétel kötelezettségvállaláson belüli sorszáma alapján lehet. A kötelezettségvállalás tételei között elıfordulhatnak ismétlıdı kifizetések. Amennyiben a kifizetés szabályos idıközönként ismétlıdik, lehetıség van a az ismétlıdési periódus (idıszakok száma + idıszak, pl. 30 nap). 10.1.4.1. A Kötelezettségvállalás adattartalma és formátum specifikációja 8. Táblázat - A Kötelezettségvállalás interfészen várt adatok Adatmezı Formátum Kötelezı Megjegyzés Fejléc Fejléc típus I - Kedvezményezett Kedvezményezett típus (név, cím, bankszámlaszám, opcionálisan I - cégjegyzékszám vagy MÁK azonosító) Kötelezettség tárgya String I - Keletkezés dátuma Dátum I - Kötelezettségvállalás tételei Tétel sorszáma String I - Tétel megnevezése String I - Elıirányzatkód v. elemi elıirányzatkód String I - Fizetési adatok Fizetési ütemezés és összeg I - KTK KTK típus N Csak KTK-t is alkalmazó szervezetek 18
esetén használható. Kapcsolódó dokumentumok Iktatószám vagy érkeztetıszám I Elsısorban iktatószámmal rendelkezı dokumentumok fordulhatnak elı. 10.1.4.1.1. A kérés XSD definíciója 10.1.4.1.1.1. A kérés struktúrája 8. ábra - A Kötelezettségvállalás kérés struktúrája 10.1.4.1.1.2. Az xsd file (tartalmi rész) <xs:complextype name="kotelezettsegvallalaskerestipus"> <xs:element name="fejlec" type="fejlectipus" /> <xs:element name="kedvezmenyezett" type="kedvezmenyezetttipus" /> <xs:element name="kotelezettsegtargya" type="xs:string" /> <xs:element name="keletkezesdatuma" type="xs:date" /> <xs:element minoccurs="1" maxoccurs="unbounded" name="kotelezettsegtetel" type="kotelezettsegvallalasteteltipus" /> <xs:element name="kapcsolododokumentumok"> 19
<xs:documentation>megbízás, szerzıdés, teljesítés-igazolások, számla meghivatkozása.</xs:documentation> <xs:complextype> <xs:element minoccurs="0" maxoccurs="unbounded" name="iktatoszam" type="iktatoszamtipus" /> <xs:element minoccurs="0" maxoccurs="unbounded" name="erkeztetoszam" type="xs:string" /> A kötelezettségvállalás tételek felépítése: <xs:complextype name="kotelezettsegvallalasteteltipus"> <xs:element name="tetelsorszam" type="xs:string"> <xs:documentation>az alkalmazás vagy felhasználó által generált, utalványon belül egyedi sorszám. </xs:documentation> <xs:element name="tetelmegnevezes" type="xs:string"> <xs:documentation>a tétel megnevezése.</xs:documentation> <xs:choice> <xs:element name="eloiranyzatkod" type="xs:string"> <xs:documentation>elıirányzat kód, a szervezet költségvetési szerkezete alapján.</xs:documentation> <xs:element name="elemieloiranyzatkod" type="xs:string"> <xs:documentation>elemi elıirányzat kód, a szervezet költségvetési szerkezete alapján.</xs:documentation> </xs:choice> <xs:element name="fizetesiadatok"> <xs:complextype> <xs:choice> <xs:element name="egyszerifizetes"> <xs:documentation>egyszeri fizetés esetén a fizetendı összeg, illetve a fizetési határidı megadása szükséges.</xs:documentation> <xs:complextype> 20
<xs:element minoccurs="0" maxoccurs="1" name="fizetesihatarido" type="xs:date"> <xs:documentation>a határidıt akkor nem kötelezı megadni, ha egy lépésben történik a kötelezettségvállalás és utalványozás, azonnali fizetési kötelezettséggel.</xs:documentation> <xs:element name="fizetendo"> <xs:documentation>a kifizetendı összeg és devizaneme.</xs:documentation> <xs:complextype> <xs:element name="osszeg" type="xs:float" /> <xs:element name="devizanem" type="devizanemtipus" /> <xs:element name="utemezettfizetes"> <xs:complextype> <xs:element name="elsofizetes" type="xs:date"> <xs:documentation>az elsı fizetési határidı, dátum formátumban.</xs:documentation> <xs:element name="ismetlodesiperiodus"> <xs:documentation>az ismétlıdési periódus két részbıl áll: - idıszak (ev, honap, nap) - idıszakok száma a fizetési periódusban. pl. 30, nap 3, honap </xs:documentation> <xs:complextype> <xs:element name="idoszakszama" type="xs:integer"> <xs:documentation>a fizetések közötti idıszakok száma.</xs:documentation> <xs:element name="idoszak"> <xs:documentation>az idıszak azonosítása. Lehetséges értékei: nap, honap, ev</xs:documentation> <xs:simpletype> <xs:restriction base="xs:string"> 21
<xs:enumeration value="nap" /> <xs:enumeration value="honap" /> <xs:enumeration value="ev" /> </xs:restriction> </xs:simpletype> <xs:element name="utolsofizetes" type="xs:date"> <xs:documentation>utolsó fizetési ütem. Amennyiben az elsı és utolsó fizetési ütem között </xs:documentation> <xs:element name="esetifizetendo"> <xs:documentation>egy fizetési ütemben teljesítendı összeg (azaz a tételhez tartozó összes kifizetés a fizetések számának és jelen összegnek a szorzata.</xs:documentation> <xs:complextype> <xs:element name="osszeg" type="xs:float" /> <xs:element name="devizanem" type="devizanemtipus" /> <xs:element minoccurs="0" maxoccurs="1" name="fizetesekszama"> <xs:documentation>a fizetések száma elvileg kiderül az elsı és utolsó idıpont közötti idıszakból és a periódus hosszából, de ellenırzésként megadható a fizetések száma.</xs:documentation> <xs:simpletype> <xs:restriction base="xs:int"> <xs:mininclusive value="1" /> </xs:restriction> </xs:simpletype> </xs:choice> <xs:element minoccurs="0" maxoccurs="1" name="ktk" type="ktktipus"> <xs:documentation>a Magyar Államkincstár által közzétett Kincstári Tranzakciós Kód lista alapján átadható kód. Mivel nem minden közigazgatási szervezet kincstári ügyfél, használata nem kötelezı. </xs:documentation> 22
10.1.4.2. A Kötelezettségvállalás válasz adattartalom és formátum specifikációja 9. Táblázat A Kötelezettségvállalás interfészen küldött válasz tartalma Adatmezı Formátum Kötelezı Megjegyzés Fejlec Üzenet fejléc típus I - Kötelezettségvállalás I - String nyilvántartási száma Vagy Hibalista Hibalista típus I - Az interfészen lehetséges specifikus hibakódok: 600 - Nem elégséges keret 700 - Hibás elıirányzatkód 10.1.4.2.1. A válasz XSD definíciója 10.1.4.2.1.1. A válasz struktúrája 9. ábra - A Kötelezettségvállalás válasz struktúrája 10.1.4.2.1.2. Az xsd file (tartalmi rész) <xs:complextype name="kotelezettsegvallalasvalasztipus"> <xs:element name="fejlec" type="fejlectipus" /> <xs:choice> <xs:element name="kotelezettsegvallalasnyilvantartasiszam" type="xs:string" /> <xs:element name="hibalista" type="hibalistatipus"> <xs:documentation> 600 - Nem elégséges keret 700 - Hibás elıirányzatkód </xs:documentation> </xs:choice> 23
10.1.5. Kifizetési utalvány fogadása (Utalványozás) Az utalványozás a kötelezettségvállalással korábban lekötött pénzösszeg kifizetésének kezdeményezése az ügyintézı által kötelezettségvállaláshoz tartozó feltételek teljesülése esetén. A Kifizetési utalvány fogadása szolgáltatás minden, kifizetést igénylı esemény, eljárás esetén igénybe vehetı, pl.: Szállítói, szolgáltatási szerzıdések ellenértékének kiegyenlítése Segélyek, támogatások folyósításának kezdeményezése Önkormányzati intézményeknek történı folyósításának kezdeményezése Munkabérek, járulékok megfizetése A fizetési módokra vonatkozóan a 21/2006. (XI. 24.) MNB rendelet (a pénzforgalom lebonyolításáról) 16. par. rendelkezik. Az ajánlás a következı fizetési módokra tér ki: Kifizetés esetén: - banki átutalás - pénzösszeg közvetlen átadása - belföldi postautalvány 10.1.5.1. A Kifizetési utalvány fogadása kérés adattartalma és formátum specifikációja 10. Táblázat - A Kifizetési utalvány fogadása kérés interfészen várt adatok Adatmezı Formátum Kötelezı Megjegyzés Fejléc Fejléc típus I - Kifizetési utalvány Utalványazonosító String I Az utalványazonosítónak szakrendszeren belül egyedileg azonosítania kell az utalványokat. A gazdálkodási rendszer gondoskodik arról, hogy szervezeti szinten egyedi azonosítókkal is ellássa az utalványokat. Rendelkezı Címtárhivatkozás I - Költségvetési év Évszám I - Elıirányzat kód vagy elemi elıirányzat kód. String I - KTK (Kincstári tranzakciós kód) KTKTípus N - Kötelezettségvállalási tétel Köt.váll. nyilvántartási száma és tételsorszáma I - Fizetési információk A fizetés módja, illetve az ahhoz szükséges információk I - (kedvezményezett adatai) Fizetés idıpontja Jövıbeli dátum N Jövıbeni kifizetés esetén megadható. Megterhelendı bankszámla String I - 24
megnevezése Megterhelendı bankszámla száma Kötelezettségvállalás nyilvántartási száma Kapcsolódó dokumentumok Bankszámlaszám formátum (BankSzamlaSzamTipus) String Iktatószám(ok) és/vagy érkeztetıszámok Fizetendı összeg Összeg és devizanem I - Hivatkozás String N - I I I Magyar vagy IBAN formátumú bankszámlaszám A kötelezettségvállalás rögzítésekor visszakapott nyilvántartási szám. A kapcsolódó bizonylatok, számlák, teljesítésigazolás, határozat, stb. iktatószámai. Legalább 1 dokumenum meghivatkozása kötelezı. Az utalvány a rendelkezı elektronikus aláírásával. String I - 10.1.5.1.1. A kérés XSD definíciója 10.1.5.1.1.1. A kérés struktúrája 10. ábra - A Kifizetési utalvány fogadása kérés struktúrája 10.1.5.1.1.2. Az xsd file (tartalmi rész) <xs:complextype name="kifizetesiutalvanyozaskerestipus"> 25
<xs:element name="fejlec" type="fejlectipus" /> <xs:element name="kifizetesiutalvany" type="kifizetesiutalvanytipus" /> <xs:element name="elektronikusalairas" type="xs:string"> <xs:documentation>a kifizetési utalvány a rendelkezı elektronikus aláírásával ellátva.</xs:documentation> Kifizetési utalvány: <xs:complextype name="kifizetesiutalvanytipus"> <xs:documentation>217/1998. (XII. 30.) Korm. rendelet 136. alapján.</xs:documentation> <xs:element name="utalvanyazonosito" type="xs:string" /> <xs:element name="rendelkezo" type="cimtarhivatkozastipus" /> <xs:element name="koltsegvetesiev"> <xs:simpletype> <xs:restriction base="evszamtipus"> <xs:pattern value="[0-9]{4}" /> <xs:mininclusive value="1950" /> <xs:maxinclusive value="2200" /> </xs:restriction> </xs:simpletype> <xs:choice> <xs:element name="eloiranyzatkod" type="xs:string" /> <xs:element name="elemieloiranyzatkod" type="xs:string" /> </xs:choice> <xs:element minoccurs="0" maxoccurs="1" name="ktk" type="ktktipus"> <xs:documentation>a Magyar Államkincstár által közzétett Kincstári Tranzakciós Kód lista alapján.</xs:documentation> <xs:element name="kotelezettsegvallalastetel"> <xs:documentation>a bevételi elıírás nyilvántartási számából és az azon belüli tételsorszámból képzett azonosító.</xs:documentation> <xs:complextype> <xs:element name="kotelezettsegvalllalasnyilvantartasiszam" type="xs:string" /> <xs:element name="tetelsorszam" type="xs:string" /> <xs:element name="fizetesiinformaciok"> <xs:complextype> 26
<xs:choice> <xs:element name="fizetesimod" type="xs:string"> <xs:documentation>a fizetési mód kódok közül a banki átutaláshoz tartozó kód.</xs:documentation> <xs:element minoccurs="1" maxoccurs="1" name="kedvezmenyezett" type="kedvezmenyezetttipus" /> <xs:element name="bankszamlaszam" type="bankszamlaszamtipus" /> <xs:element name="fizetesimod" type="xs:string"> <xs:documentation>a fizetési mód kódok közül a belföldi postautalványhoz tartozó kód.</xs:documentation> <xs:element minoccurs="1" maxoccurs="1" name="kedvezmenyezett" type="kedvezmenyezetttipus" /> <xs:element name="fizetesimod" type="xs:string"> <xs:documentation>a fizetési mód kódok közül a pénzösszeg közvetlen átadásához tartozó kód.</xs:documentation> <xs:element minoccurs="1" maxoccurs="1" name="kedvezmenyezett" type="kedvezmenyezetttipus" /> </xs:choice> <xs:element minoccurs="0" maxoccurs="1" name="fizetesidopontja" type="xs:date" /> <xs:element name="megterhelendobankszamlamegnevezese" type="xs:string" /> <xs:element name="megterhelendobankszamlaszam" type="bankszamlaszamtipus" /> <xs:element name="kotelezettsegvallalasnyilvantartasiszama" type="xs:string"> <xs:documentation>a kötelezettségvállalás beküldésekor visszakapott nyilvántartási szám. </xs:documentation> <xs:element name="kapcsolododokumentumok"> <xs:documentation>a kifizetés alapjául szolgáló bizonylatok (teljesítés-igazolások, számla, stb.) meghivatkozása.</xs:documentation> <xs:complextype> 27
<xs:element minoccurs="0" maxoccurs="unbounded" name="iktatoszam" type="iktatoszamtipus" /> <xs:element minoccurs="0" maxoccurs="unbounded" name="erkeztetoszam" type="xs:string" /> <xs:element name="fizetendo"> <xs:documentation>a kötelezettség nettó összege.</xs:documentation> <xs:complextype> <xs:element name="osszeg" type="xs:float" /> <xs:element name="devizanem" type="devizanemtipus" /> <xs:element name="hivatkozas" type="xs:string"> <xs:documentation>az átutalás, postai kifizetés közleménye. A kifizetés jellegétıl függıen számlaszám, ügyiratszám, határozatszám, stb., amely alapján a kedvezményezett egyértelmően azonosítani tudja a tételt. </xs:documentation> 10.1.5.2. A Kifizetési utalvány fogadása válasz adattartalom és formátum specifikációja 11. Táblázat A Kifizetési utalvány fogadása interfészen küldött válasz tartalma Adatmezı Formátum Kötelezı Megjegyzés Fejlec Üzenet fejléc típus I - Pénzügyi iktatószám String I - vagy Hibalista Hibalista típus I - Az interfészen lehetséges specifikus hibakódok: 600 - Elıirányzat nem fedezi a kifizetést 650 A hivatkozott kötelezettség nem fedezi a kifizetést 700 Hibás terhelendı bankszámlaszám 800 Hibás vagy hiányzó kedvezményezett bankszámlaszám (banki átutalás esetén lehetséges) 900 CDV hiba (bankszámlaszám ellenırzı összeg) 28
10.1.5.2.1. A válasz XSD definíciója 10.1.5.2.1.1. A válasz struktúrája 11. ábra - A Kifizetési utalvány fogadása válasz struktúrája 10.1.5.2.1.2. Az xsd file (tartalmi rész) <xs:complextype name="kifizetesiutalvanyozasvalasztipus"> <xs:element name="fejlec" type="fejlectipus" /> <xs:choice> <xs:element name="penzugyiiktatoszam" type="xs:string" /> <xs:element name="hibalista" type="hibalistatipus"> <xs:documentation>az interfészen lehetséges specifikus hibaüzenetek: 600 - Elıirányzat nem fedezi a kifizetést 700 Hibás terhelendı bankszámlaszám 800 Hibás vagy hiányzó kedvezményezett bankszámlaszám (banki átutalás esetén lehetséges) </xs:documentation> </xs:choice> 10.1.6. Bevételi elıírás fogadása A bevételi elıírás az elıre látható bevételek (önkormányzat által beszedett adók, nyújtott szolgáltatások ellenértéke, stb.) rögzítése, tulajdonképpen a kiadási kötelezettség ellenpárja. A szolgáltatás a bevételi elıírások elektronikus rögzítését teszi lehetıvé. A bevételi elıírás több tételt tartalmazhat (pl. szerzıdés több teljesítési üteme, részletfizetési lehetıséggel kirótt bírság, stb.), melyek egyenként elıirányzathoz rendelhetık. Lehetıség van a kapcsolódó (alátámasztó) dokumentumok meghivatkozására az iratkezelı rendszerbıl (pl. szerzıdés). 10.1.6.1. A kérés adattartalma és formátum specifikációja 12. Táblázat - A Bevételi elıírás fogadása kérés interfészen várt adatok 29
Adatmezı Formátum Kötelezı Megjegyzés Fejléc Fejléc típus I - Befizetı Befizetı típus (név, cím, bankszámlaszám, opcionálisan egyedi I - azonosító) Bevételi elıírás tárgya String I - Keletkezés dátuma Dátum I - Bevételi elıírás tételei Tétel sorszáma String I - Tétel megnevezése String I - Elıirányzatkód v. elemi elıirányzatkód String I - Fizetési adatok Fizetési ütemezés és összeg I - KTK KTK típus N Csak KTK-t is alkalmazó szervezetek esetén használható. Kapcsolódó dokumentumok Iktatószám vagy érkeztetıszám I Elsısorban iktatószámmal rendelkezı dokumentumok fordulhatnak elı. 10.1.6.1.1. A kérés XSD definíciója 10.1.6.1.1.1. A kérés struktúrája 12. ábra - A Bevételi elıírás kérés struktúrája 10.1.6.1.1.2. Az xsd file (tartalmi rész) <xs:complextype name="bevetelieloiraskerestipus"> <xs:element name="fejlec" type="fejlectipus" /> <xs:element name="befizeto" type="befizetotipus" /> 30
<xs:element name="bevetelieloirastargya" type="xs:string" /> <xs:element name="keletkezesdatuma" type="xs:date" /> <xs:element minoccurs="1" maxoccurs="unbounded" name="bevetelieloirastetel" type="kotelezettsegvallalasteteltipus" /> <xs:element name="kapcsolododokumentumok"> <xs:documentation>megbízás, szerzıdés, teljesítés-igazolások, számla meghivatkozása.</xs:documentation> <xs:complextype> <xs:element minoccurs="0" maxoccurs="unbounded" name="iktatoszam" type="iktatoszamtipus" /> <xs:element minoccurs="0" maxoccurs="unbounded" name="erkeztetoszam" type="xs:string" /> 10.1.6.2. A válasz adattartalom és formátum specifikációja 13. Táblázat A Bevételi elıírás interfészen küldött válasz tartalma Adatmezı Formátum Kötelezı Megjegyzés Fejléc Fejléc típus I - Bevételi elıírás nyilvántartási száma String I - Vagy Hibalista Hibalista típus I - Az interfészen lehetséges specifikus hibakódok: 600: Nem létezı elıirányzat: amennyiben valamely tétel nem létezı bevételi elıirányzatra hivatkozik. A hiba leírásában jelezni kell, hogy mely tétel hibás. 10.1.6.2.1. A válasz XSD definíciója 10.1.6.2.1.1. A válasz struktúrája 13. ábra - A Bevételi elıírás válasz struktúrája 31
10.1.6.2.1.2. Az xsd file (tartalmi rész) <xs:complextype name="bevetelieloirasvalasztipus"> <xs:element name="fejlec" type="fejlectipus" /> <xs:choice> <xs:element name="bevetelieloirasnyilvantartasiszam" type="xs:string" /> <xs:element name="hibalista" type="hibalistatipus"> <xs:documentation>600 - Nem elégséges keret 700 - Hibás elıirányzatkód </xs:documentation> </xs:choice> 10.1.7. Bevételi utalvány fogadása A bevételi utalvány egy bevételi elıirányzathoz tartozó (általában bevételi elıírással lefoglalt) bevétel realizálása. A bevételi utalvány átvételével az azon szereplı összeg behajtásával, követésével kapcsolatos feladatok átkerülnek a gazdálkodási rendszer hatókörébe. 10.1.7.1. A kérés adattartalma és formátum specifikációja 14. Táblázat - A Bevételi utalvány fogadása kérés interfészen várt adatok Adatmezı Formátum Kötelezı Megjegyzés Fejléc Fejléc típus I - Bevételi utalvány Utalványazonosító String I - Rendelkezı Címtárhivatkozás I - Költségvetési év Évszám I 1950 és 2200 közé korlátozva. Elıirányzatkód vagy Elemi elıirányzat kód Bevételi elıírás tétel Befizetı String I - Bevételi elıírás nyilv. száma és tételsorszám Természetes személy, szervezet, vagy közigazgatási szervezet neve, címe (opcionálisan egyedi azonosítója) Várható fizetési mód Fizetési mód típus N vagy Inkasszó adatok Az inkasszós beszedés esetén használandó adatok: N I - N Mivel a bevételi utalvány nem minden esetben köthetı bevételi elıíráshoz, megadása nem kötelezı. Nem mindig ismert, ezért megadása nem kötelezı. Csak inkasszós beszedésnél. 32
- kötelezett bankszámlaszáma - benyújtás indoka (A lehetséges értékeket a 21/2006. (XI. 24.) MNB rendelet melléklete definiálja.) Fizetési határidı Jövıbeli dátum I 2000 és 2200 közé korlátozva. Jóváírandó bankszámla Bankszámla megnevezése I - megnevezése Jóváírandó bankszámla Bankszámlaszám formátum I száma (BankSzamlaSzamTipus) Utalvány kelte Dátum I - Kapcsolódó dokumentumok Iktatószám(ok) Fizetendı összeg Összeg és pénznem I - Hivatkozás String I I Magyar vagy nemzetközi formátumú bankszámlaszám A kapcsolódó bizonylatok, számlák, teljesítésigazolás, határozat, stb. iktatószámai. Mivel a kimenı számlák iktatásra kerülnek, ezért itt érkeztetıszám nem fordulhat elı. Az ügyfélnek/befizetınek átadott hivatkozási szám. 10.1.7.1.1. A kérés XSD definíciója 10.1.7.1.1.1. A kérés struktúrája 33
14. ábra - A Bevételi utalvány fogadása kérés struktúrája 10.1.7.1.1.2. Az xsd file (tartalmi rész) <xs:complextype name="beveteliutalvanyfogadasakerestipus"> <xs:element name="fejlec" type="fejlectipus" /> <xs:element name="beveteliutalvany" type="beveteliutalvanytipus" /> Bevételi utalvány: <xs:complextype name="beveteliutalvanytipus"> <xs:element name="utalvanyazonosito" type="xs:string" /> <xs:element name="rendelkezo" type="cimtarhivatkozastipus" /> <xs:element name="koltsegvetesiev"> <xs:simpletype> <xs:restriction base="evszamtipus"> <xs:pattern value="[0-9]{4}" /> <xs:mininclusive value="1950" /> <xs:maxinclusive value="2200" /> </xs:restriction> </xs:simpletype> <xs:choice> <xs:element name="eloiranyzatkod" type="xs:string" /> <xs:element name="elemieloiranyzatkod" type="xs:string" /> </xs:choice> <xs:element minoccurs="0" maxoccurs="1" name="bevetelieloirastetel"> <xs:documentation>a bevételi elıírás nyilvántartási számából és az azon belüli tételsorszámból képzett azonosító.</xs:documentation> <xs:complextype> <xs:element name="bevetelieloirasnyilvantartasiszam" type="xs:string" /> <xs:element name="tetelsorszam" type="xs:string" /> <xs:element name="befizeto" type="befizetotipus" /> <xs:choice> <xs:element minoccurs="0" maxoccurs="1" name="varhatofizetesimod" /> <xs:element minoccurs="0" maxoccurs="1" name="inkasszoadatok"> <xs:documentation>megadása inkasszó esetén kötelezı. </xs:documentation> <xs:complextype> <xs:element name="kotelezettbankszamlaszama" type="bankszamlaszamtipus" /> <xs:element name="benyujtasindoka" type="xs:string"> 34
<xs:documentation>a lehetséges értékeket a 21/2006. (XI. 24.) MNB rendelet melléklete definiálja.</xs:documentation> <xs:element name="jogcimkod"> <xs:simpletype> <xs:restriction base="xs:string"> <xs:maxlength value="3" /> </xs:restriction> </xs:simpletype> <xs:element name="bizonylatszam" type="xs:string" /> <xs:element minoccurs="0" maxoccurs="1" name="kifogasolasihatarido" type="xs:date"> <xs:documentation>határidıs beszedés esetén.</xs:documentation> </xs:choice> <xs:element name="fizetesihatarido"> <xs:simpletype> <xs:restriction base="xs:date"> <xs:maxinclusive value="2200" /> <xs:mininclusive value="2000" /> </xs:restriction> </xs:simpletype> <xs:element name="jovairandobankszamlamegnevezese" type="xs:string" /> <xs:element name="jovairandobankszamlaszam" type="bankszamlaszamtipus" /> <xs:element name="kelt" type="xs:date" /> <xs:element name="kapcsolododokumentumok"> <xs:documentation>megbízás, szerzıdés, teljesítés-igazolások, számla meghivatkozása.</xs:documentation> <xs:complextype> <xs:element minoccurs="0" maxoccurs="unbounded" name="iktatoszam" type="iktatoszamtipus" /> <xs:element name="fizetendo"> <xs:documentation>a kötelezettség nettó összege.</xs:documentation> <xs:complextype> <xs:element name="osszeg" type="xs:float" /> <xs:element name="devizanem" type="devizanemtipus" /> 35
<xs:element name="hivatkozas" type="xs:string"> <xs:documentation>az a hivatkozási kód, amely az ügyfélnek is átadásra került, és az átutalás, készpénzátutalási megbízás közleményében szerepelni kell. </xs:documentation> 10.1.7.2. A válasz adattartalom és formátum specifikációja 15. Táblázat Az interfészen küldött válasz tartalma Adatmezı Formátum Kötelezı Megjegyzés Fejlec Üzenet fejléc típus I - Pénzügyi iktatószám String I - Vagy Hibalista Hibalista típus I - Az interfészen lehetséges specifikus hibakódok: 600 - Hiányzó bankszámlaszám 700 CDV hiba 10.1.7.2.1. A válasz XSD definíciója 10.1.7.2.1.1. A válasz struktúrája 15. ábra A Bevételi utalvány fogadása válasz struktúrája 10.1.7.2.1.2. Az xsd file (tartalmi rész) <xs:complextype name="beveteliutalvanyfogadasavalasztipus"> <xs:element name="fejlec" type="fejlectipus" /> <xs:choice> <xs:element name="penzugyiiktatoszam" type="xs:string" /> <xs:element name="hibalista" type="hibalistatipus"> 36
<xs:documentation>600 - Hibás bankszámlaszám </xs:documentation> </xs:choice> 10.1.8. Fizetési tranzakció ellenırzése A következı típusú fizetési tranzakciók státuszának ellenırzésére lehet szükség: Kifizetési utalvánnyal kezdeményezett kifizetés: az utalványozás során visszakapott pénzügyi iktatószám alapján lehetséges a lekérdezés. Bevételi utalványhoz tartozó beérkezés: a bevételi utalvány Hivatkozás mezıje alapján ellenırizhetı. A válasz igen vagy nem értéket vehet fel. A részteljesítések miatti behajtási, egyeztetési lépéseknek a gazdálkodási rendszeren belül kell lezajlania, az ügyintézı számára a munkafolyamat továbbléptetéséhez elegendı a teljes fizetés megtörténtének/késlekedésének ténye. Ügyfél által kezdeményezett, eljárás indításához tartozó illeték ellenırzése: az ügyfél által benyújtott bizonylaton (készpénz-átutalási megbízás) szereplı 8 számjegyő hivatkozási szám alapján ellenırizhetı. Figyelembe kell venni, hogy az igazoló szelvény postai érvényesítése után a gazdálkodási rendszerben csak az Államkincstártól való lekérdezés után jelenik meg a tranzakció, így ilyen lekérdezésre ritkán lehet szükség. 10.1.8.1. A kérés adattartalma és formátum specifikációja 16. Táblázat - A Fizetési tranzakció ellenırzése kérés interfészen várt adatok Adatmezı Formátum Kötelezı Megjegyzés Fejléc Fejléc típus I - Pénzügyi Iktatószám String I - vagy Készpénz-átutalási megbízás azonosítója 8 számjegy I - 37
10.1.8.1.1. A kérés XSD definíciója 10.1.8.1.1.1. A kérés struktúrája 16. ábra - A Fizetési tranzakció ellenırzése kérés struktúrája 10.1.8.1.1.2. Az xsd file (tartalmi rész) <xs:complextype name="fizeteslekerdezeskerestipus"> <xs:element name="fejlec" type="fejlectipus" /> <xs:choice> <xs:element name="penzugyiiktatoszam" type="xs:string" /> <xs:element name="keszpenzatutalasimegbizasszam" type="xs:string"/> <xs:element name="hivatkozas" type="xs:string"> <xs:documentation>az ügyfélnek megadott hivatkozási szám.</xs:documentation> </xs:choice> 10.1.8.2. A válasz adattartalom és formátum specifikációja A válaszban az ügyfél fizetési információi (pl. bankszámlaszám, bankszámlaszám tulajdonosa) nem szükségesek, így adatvédelmi szempontok miatt csak a fizetés megtörténtének/késedelmének ténye kerül visszaadásra. Több tételt tartalmazó utalványok vagy beszedések esetén 17. Táblázat A Fizetési tranzakció ellenırzése interfészen küldött válasz tartalma Adatmezı Formátum Kötelezı Megjegyzés Fejlec Üzenet fejléc típus I - Hibalista Hibalista típus I - vagy Fizetés megtörtént? Boolean I - Fizetés dátuma Dátum N Megtörtént fizetés esetén kötelezı. 38
Az interfészen lehetséges specifikus hibakódok: 600: Nem létezı hivatkozási szám 10.1.8.2.1. A válasz XSD definíciója 10.1.8.2.1.1. A válasz struktúrája 17. ábra A Fizetési tranzakció ellenırzése válasz struktúrája 10.1.8.2.1.2. Az xsd file (tartalmi rész) <xs:complextype name="fizeteslekerdezesvalasztipus"> <xs:element name="fejlec" type="fejlectipus" /> <xs:choice> <xs:element name="hibalista" type="hibalistatipus" /> <xs:element name="fizetesmegtortent" type="xs:boolean"> <xs:documentation>teljes összeg beérkezése esetén. </xs:documentation> <xs:element minoccurs="0" maxoccurs="1" name="fizetesdatum" type="xs:date"> <xs:documentation>megtörtént fizetés esetén visszaadandó.</xs:documentation> </xs:choice> 39
11. Mellékletek 11.1. Kódkatalógus-kezelési eljárások Az XSD struktúrákban használt, nagy elemszámú kódkészletet használó mezık tekintetében az ajánlás tartalmazza a használható elemeket, illetve azok forrását, de a kódkészlet hosszú távú karbantartása érdekében a következı tevékenységek elvégzése szükséges: Adatgazdák kijelölése: az egyes adattípusok tekintetében ki kell választani azt a szervezetet, amely gondoskodik - az adatformátumra vonatkozó követelmények naprakészen tartásáról - a kódkészlet karbantartásáról - a gyakran változó listák esetén online lekérdezési lehetıség biztosításáról A dokumentáció az érintett adattípusok esetén jelöli azok forrását (jogszabály, közzétevı szervezet, stb.) a dokumentáció készítésének idıpontjában, de az ajánlás hosszú távú felhasználhatósága érdekében elkerülhetetlen az adatgazdák kijelölése. A kijelölt adatgazda számára biztosítani kell a felelısségi körébe utalt adatok karbantartásához szükséges erıforrásokat és ismereteket. Hozzáférési mód kijelölése: az adatok jellegétıl, mennyiségétıl, a lekérdezések gyakoriságától függıen a következı lehetıségek alkalmazhatók: - Adatstruktrúrára vonatkozóan az XSD struktúrában használt típus kezelésének átadása az adatgazda számára, aki http/https protokollon keresztül elérhetıvé teszi azt, és a felhasználó oldali XSD/XML fájlok az innen meghivatkozott típust (struktúrát használják) - Kódkészletre vonatkozóan o Az XSD adatstruktúrán belül definiált enumeráció alkalmazásával, o A lehetséges értékek lekérdezése webservice-en keresztül A hozzáférést az adat jellegétıl függıen meghatározott szervezetek, a teljes EKG közösség, vagy az Internet felé lehet lehetıvé tenni. Egyes adattípusok esetén szükség lehet a kódkészlet vonatkozásában történetiség kezelésére, azaz az aktuális mellett más, korábbi vagy jövıbeni állapotok lekérdezésére. Ezeknél az adatoknál a lekérdezésben az ErvenyessegDatum mezı megadásával lehet a lekérdezett állapot dátumát jelezni. Az alábbi táblázatban összefoglaljuk azokat a gazdálkodási rendszer interfészhez kötıdı adattípusokat, amelyek vonatkozásában a fenti tevékenységek elvégzése szükséges: A fentiek vonatkoznak az ajánlásban használt egyéb adattípusokra is, azaz ki kell jelölni az azok formátumát, lehetséges értékeit nyilvántartó és közzétevı szervezeteket (triviális példa lehet adószám esetén az APEH, KTK esetén az Államkincstár), és számukra biztosítani kell a szükséges erıforrásokat. 40
18. Táblázat Központi karbantartást igénylı adatok Adattípus Jelenlegi forrás Lehetséges adatgazdák Országok, állampolgárságok kódkészlete ISO 3166 KEKKH Külügyminisztérium Magyar Nemzeti Bank Fizetési módok kódkészlete 21/2006. (XI. 24.) MNB rendelet Devizanemek kódkészlete Kincstári tranzakciós kód kódkészlete Magyar Nemzeti Bank által közzétett devizakódok (LINK) Magyar Államkincstár Magyar Nemzeti Bank Magyar Államkincstár 11.2. Adattípus definíciók Az alábbiakban összefoglaljuk azon adattípusok jellemzıit, amelyeknél az XSD-ben leírt információkon túl további információk leírása célszerő. 11.2.1. FizetesiModTipus A fizetési módokra vonatkozóan a 21/2006. (XI. 24.) MNB rendelet a pénzforgalom lebonyolításáról 16. par. rendelkezik. Az ajánlás a következı fizetési módokra tér ki: Kifizetés esetén: - átutalás - pénzösszeg közvetlen átadása - belföldi postautalvány Az ügyfélbefizetések tekintetében a fizetési módnak abból a szempontból nincs jelentısége, hogy a befizetés ellenırzése a gazdasági rendszer és a szakrendszer között megtörténjen, itt a megfelelı hivatkozásokat kell biztosítani. 11.2.2. Kedvezményezett / Befizetı A kedvezményezett, illetve befizetı adatainak meghatározásakor az utalványok tartalmára vonatkozó jogszabályi elıírásból kiindulva, a gyakorlatban felhasználható adatok körét határoztuk meg. A fentiek alapján a kedvezményezett/befizetı neve és címe a mindenkor átadandó kötelezı elem, de az egyértelmő azonosíthatóság érdekében átadhatók további, az ügyfelet egyértelmően azonosító adatok: Természetes személy esetén természetes azonosítókat vagy a személyazonosításra alkalmas okmány típusát Vállalkozások, egyéb szervezetek esetén a cégjegyzékszámot vagy adószámot, Közigazgatási szervezetek esetén a kincstári azonosítót (MÁK azonosító, vagy címtárhivatkozás) 41
El kell azonban fogadni, hogy a fenti azonosító adatok általában csak a szervezeten belül használhatók, a következık miatt: A pénzügyi szolgáltatók általában nem kezelik, nem ellenırzik ezeket az adatokat, Természetes személyek esetén a fenti adatok kiadása a pénzügyi szolgáltatók felé adatvédelmi aggályokat is felvet. A beérkezı befizetéseknél nem lehet számítani arra, hogy a hivatkozási számon túl bármely adat pontosan beérkezik (pl. nem saját bankszámláról kezdeményezett utalás esetén) A fentiek miatt a fizetési események azonosítására mindenhol egyértelmő tranzakció azonosítót kell használni, a befizetı/kedvezményezett adatai csak hibás hivatkozás esetén, manuális konszolidáció esetén használandók. 11.2.3. BankSzamlaSzamTipus A bankszámlaszám két típusú lehet: Magyarországon belül használt pénzforgalmi jelzıszám (BBAN) Nemzetközi használatú pénzforgalmi jelzıszám (IBAN International Bank Account Number): külföldre történı átutalás esetén használandó. A 21/2006. (XI. 24.) MNB rendelet a pénzforgalom lebonyolításáról II. fejezete alapján a magyarországi bankszámlák jelölésére szolgáló pénzforgalmi jelzıszám 16 vagy 24 numerikus karakter. Ugyanez a fejezet rendelkezik arról, hogy a magyarországi számlák IBAN számát (nemzetközi pénzforgalomban használható jelzıszám) 28 alfanumerikus karakterben határozza meg, de ez országonként eltérhet, ezért az ajánlás 34 karakterre korlátozza a hosszt. Az IBAN formátumára vonatkozó magyar nyelvő részletes leírás a következı címen található: http://www.mnb.hu/resource.aspx?resourceid=mnbfile&resourcename=iban_ellenorzoszam_hu A nemzetközi bankszámlaszámokhoz az egyértelmőség érdekében ajánlott megadni a SWIFT kódot, amely 8 vagy 11 karakter hosszú alfanumerikus string. A BankSzamlaSzamTipus felépítése: 18. ábra: A BankSzamlaSzamTipus felépítése 11.2.4. KTK (Kincstári Tranzakciós Kód) A kincstári tranzakció kódot a kincstári ügyfelek alkalmazzák a tranzakciók besorolásához. A tranzakciós kódok listája a http://www.allamkincstar.gov.hu/hu/ugyfelkapcs/szamlaszamokktk címen 42
érhetı el. A kincstári tranzakciós kódok közlése alól mentességet élvezı számlák esetén értéke 000. Az önkormányzatok számára a KTK használata nem elıírás, ezért a mezı mindenhol opcionális. 11.2.5. Tevékenység-típus Az adat célja, hogy azonosítsa a felhasználó által végrehajtani kívánt tevékenység jellegét. A gazdálkodási rendszer a tevékenység és a felhasználó jogosultságainak összevetésével tudja azonosítani a használható elıirányzatokat, elemi elıirányzatokat. Az ajánlás a leggyakoribb tevékenységtípusokra definiál interfészt: 1 Kötelezettségvállalás 2 - Bevételi elıírás 3 Kifizetési utalványozás 4 Bevételi utalvány 11.2.6. Kötelezettségvállalás tételei (KotelezettsegVallalasTetelTipus) A hivatal által tett kötelezettségvállalás egyes esetekben több jövıbeni kifizetésre is vonatkozhat (pl. szerzıdés részteljesítéséi). Ennek leképezése érdekében bevezetésre került a fenti adattípus. A kötelezettségvállalás egyes tételeihez azok az adatok adandók meg, amelyek nem általános érvényőek a kötelezettségvállalás vonatkozásában, hanem tételenként eltérhetnek: Tétel sorszáma: a tételt kötelezettégvállaláson belül egyértelmően azonosító, a szakrendszer által generált sorszám Tétel megnevezése: a tételt leíró szöveges adat (pl. 1. részteljesítés, Hardverszállítás, stb.) Elıirányzat vagy elemi elıirányzat kódja (ennek terhére kerül nyilvántartásba a kötelezettségvállalás) A tételhez tartozó pénzügyi adatok: o Egyszeri fizetés esetén fizetési határidı és összeg (összeg és devizanem) o Ütemezett fizetés esetén (pl. havidíjak) az elsı és utolsó fizetési összeg, és a fizetési periódus (idıszak, idıszakok száma, pl. 30 nap, 1 hónap, stb.) KTK: a kincstári tranzakciós kódot is használó szervezeteknél átadható ez az adat, a jelentések elkészítésének könnyítése érdekében. 11.2.7. Kifizetési és bevételi utalványok (KifizetesiUtalvanyTipus, BeveteliUtalvanyTipus) Az utalvány tartalmára vonatkozóan a 217/1998. (XII. 30.) Korm. rendelet (az államháztartás mőködési rendjérıl) 136. 4.bekezdése a következı adatokat írja elı: a. a rendelkezınek és a rendelkezést végrehajtónak a megnevezését; b. az,,utalvány szót; c. a költségvetési évet; d. a befizetı és a kedvezményezett megnevezését, címét, bankszámlájának a számát; 43
e. a fizetés idıpontját, módját és összegét; f. a megterhelendı, jóváírandó bankszámla számát és megnevezését; g. a keltezést, valamint az utalványozó és az ellenjegyzı aláírását; h. a kötelezettségvállalás-nyilvántartásba vételi sorszámát. (Ugyanitt az 5. bekezdés megengedi, hogy az érvényesített okmányra vezetett rendelkezésben (rövidített utalványban) a (4) bekezdésben meghatározottak közül az okmányon már feltüntetett adatokat nem kell megismételni, de az elektronikus utalvány ebbıl a szempontból külön írásbeli rendelkezésnek tekintendı, mivel a gazdálkodási rendszer nem értelmezi a kapcsolódó dokumentumokat.) Mivel az a) pontban rendelkezést végrehajtó a gazdálkodási rendszer felhasználója, ez az információ, illetve a pénzügyi iktatószám a gazdálkodási rendszerben jön létre. A d) pont tekintetében az adatstruktúrákat úgy alakítottuk ki, hogy a bankszámlaszám nem mindenhol kötelezı, mivel magánszemélyek esetén az nem mindig áll rendelkezésre. 11.3. XSD fájl A dokumentum az IOP_GazdalkodasiRsz_IF.xsd: a fent leírt és hivatkozott struktúrákat leíró XSD file alapján készült, azzal együtt értelmezhetı. 12. Szakirodalmi hivatkozás Felhasznált irodalom: Pénzintézetek és állami intézmények információs rendszerei Magyarországon Budai Balázs Benjámin: E-government Serfızı Gyula: Hazai számviteli rendszerek Települési önkormányzatok költségvetési rendeletei, kötelezettségvállalással, utalványozással kapcsolatos szabályzatai 13. Rövidítésgyőjtemény CDV: Check Digit Verification (ellenırzı összeg alapján történı hibavizsgálat) 44
14. Ábrák 1. ábra: Az ajánlás hatókörébe tartozó interfész szolgáltatások... 11 2. ábra Az Elıirányzatlista kérés struktúrája... 12 3. ábra Az Elıirányzatlista válasz struktúrája... 13 4. ábra - A Fedezetvizsgálat kérés struktúrája... 15 5. ábra A Fedezetvizsgálat válasz struktúrája... 16 6. ábra A Bankszámlaszám-lista kérés struktúrája... 17 7. ábra - A Bankszámlaszám-lista válasz struktúrája... 17 8. ábra - A Kötelezettségvállalás kérés struktúrája... 19 9. ábra - A Kötelezettségvállalás válasz struktúrája... 23 10. ábra - A Kifizetési utalvány fogadása kérés struktúrája... 25 11. ábra - A Kifizetési utalvány fogadása válasz struktúrája... 29 12. ábra - A Bevételi elıírás kérés struktúrája... 30 13. ábra - A Bevételi elıírás válasz struktúrája... 31 14. ábra - A Bevételi utalvány fogadása kérés struktúrája... 34 15. ábra A Bevételi utalvány fogadása válasz struktúrája... 36 16. ábra - A Fizetési tranzakció ellenırzése kérés struktúrája... 38 17. ábra A Fizetési tranzakció ellenırzése válasz struktúrája... 39 15. Képek - 16. Táblázatok 1. Táblázat A definiált szolgáltatások... 11 2. Táblázat Az Elıirányzatlista interfészen várt adatok... 12 3. Táblázat Az Elıirányzatlista interfészen küldött válasz tartalma... 13 4. Táblázat - A Fedezetvizsgálat kérés interfészen várt adatok... 14 5. Táblázat A Fedezetvizsgálat interfészen küldött válasz tartalma... 15 6. Táblázat - A Bankszámlaszám-lista kérés interfészen várt adatok... 16 7. Táblázat A Bankszámlaszám-lista interfészen küldött válasz tartalma... 17 8. Táblázat - A Kötelezettségvállalás interfészen várt adatok... 18 9. Táblázat A Kötelezettségvállalás interfészen küldött válasz tartalma... 23 10. Táblázat - A Kifizetési utalvány fogadása kérés interfészen várt adatok... 24 11. Táblázat A Kifizetési utalvány fogadása interfészen küldött válasz tartalma... 28 12. Táblázat - A Bevételi elıírás fogadása kérés interfészen várt adatok... 29 13. Táblázat A Bevételi elıírás interfészen küldött válasz tartalma... 31 14. Táblázat - A Bevételi utalvány fogadása kérés interfészen várt adatok... 32 15. Táblázat Az interfészen küldött válasz tartalma... 36 16. Táblázat - A Fizetési tranzakció ellenırzése kérés interfészen várt adatok... 37 17. Táblázat A Fizetési tranzakció ellenırzése interfészen küldött válasz tartalma... 38 18. Táblázat Központi karbantartást igénylı adatok... 41 17. Verziószám A szabvány verziószáma. 45
46