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