eÁFA 2.0 XML ellenőrzése a böngészőben
Töltse be a fájlt, és megmutatjuk, ha formai hibát találunk a NAV eÁFA 2.0 sémája szerint. Az ellenőrzés a böngészőjében fut, így a fájl nem hagyja el a gépét. NAV eÁFA 2.0 XSD, rögzített kiadás 2.0.2 (2026. július 1., commit 21065b6b).
Mikor használja?
- Mielőtt eÁFA XML-t tölt fel a NAV webes felületén — a mellékletek adatai utólag nem pótolhatók.
- M2M-integráció fejlesztése vagy hibakeresése közben, a beküldés előtti formai szűrőként.
- Ha új ERP- vagy könyvelőprogram-verzió, illetve új exportbeállítás készült.
Mire való ez az ellenőrző?
Mit talál meg
- Hiányzó vagy hibás mezők
- Rossz dátum- és számformátum
- Hibás elem-sorrend
- Ha a fájl nem eÁFA 2.0 XML
Mit nem dönt el
- Hogy a bevallás adózási tartalma helyes-e
- Hogy a NAV üzleti szabályai szerint elfogadható-e
- Hogy az adókód-megfeleltetés szakmailag megfelelő-e
A sikeres ellenőrzés nem jelenti a NAV elfogadását. Ez az oldal a fájl formai hibáit segíti megtalálni. A NAV a bevallás tartalmát és további üzleti szabályokat is vizsgálhat.
Mit ellenőriz a három lépés?
XML felépítés
Megvizsgáljuk, hogy az XML jól formázott-e: nincs-e lezáratlan vagy össze nem illő tag, illetve nem hibás-e a kódolás. A gyakorlatban a hibák jelentős része már itt kiderül.
eÁFA 2.0 felismerés
Csak a gyökérelemet és a névteret ellenőrizzük, vagyis hogy valóban eÁFA 2.0 adatszolgáltatásról van-e szó. Korábbi verzióból származó export itt akad el. A hiányzó kötelező elemek — például a declarationInfo — a következő, XSD-lépéshez tartoznak.
NAV sémaellenőrzés
A fájlt a rögzített NAV eÁFA 2.0 XSD-vel vetjük össze: kötelező elemek, elem-sorrend, megengedett értékek és formátumok. A validációt a széles körben használt libxml2 motor végzi.
Milyen hibákat jelez, és hogyan javíthatók?
Az ellenőrző által jelzett összes hibatípus, a három lépés sorrendjében. A NAV-séma eredeti üzenetei angolul és technikai megfogalmazásban érkeznek, ezért sémahibánál a táblázat az eredeti libxml2-üzenet mintáját is mutatja — a technikai részletekből kimásolt üzenet így itt visszakereshető.
| Jelzett hiba | Lépés | Tipikus ok | Javítás |
|---|---|---|---|
| Az XML-fájl üres | XML felépítés | A fájl nem tartalmaz XML-t, vagy csak szóközöket tartalmaz. Jellemzően megszakadt vagy hibásan mentett export. | Készítsen új eÁFA 2.0 exportot a forrásrendszerből, és ellenőrizze a fájl méretét. |
| Hibás karakterkódolás | XML felépítés | A fájl nem olvasható megbízhatóan UTF-8 kódolású XML-ként. Jellemzően más kódlappal (például Windows-1250) mentett fájlban az ékezetes karaktereknél jelentkezik. | Mentse vagy exportálja újra a fájlt UTF-8 kódolással, és ellenőrizze, hogy az XML-deklarációban is UTF-8 szerepel-e. |
| Lezáratlan vagy hibás XML-tag | XML felépítés | Egy nyitó vagy záró tag hiányzik, vagy nem illeszkedik a párjához. Csonkolt fájlnál vagy kézi szerkesztés után fordul elő. | Javítsa a jelzett sor környezetében a tageket, majd futtassa újra az ellenőrzést. |
| Ez nem eÁFA 2.0 XML-fájl | eÁFA 2.0 felismerés | Hiányzik a VatDeclarationData gyökérelem vagy az eÁFA névtér, vagy a fájl egyáltalán nem tartalmaz gyökérelemet. Jellemzően egészen más adatszolgáltatás fájlja. | Ellenőrizze, hogy eÁFA M2M 2.0 exportot választott-e ki a forrásrendszerben. |
| Elavult EAR 1.0-s eÁFA XML | eÁFA 2.0 felismerés | A fájl az eÁFA korábbi, http://schemas.nav.gov.hu/EAR/1.0/data névterét használja. Az ellenőrző a 2.0-s sémához mér, ezért az 1.0-s fájlt nem validálja. | Frissítse a forrásrendszer exportját eÁFA 2.0 formátumra, majd exportáljon újra. |
| Eltérő eÁFA névtér | eÁFA 2.0 felismerés | A gyökérelem rendben van, de a névtér nem a 2.0-s sémáé (http://schemas.nav.gov.hu/EAR/2.0/data). Gyakori oka az elgépelt vagy kézzel átírt névtér. | Javítsa a gyökérelem névterét, vagy kérjen új eÁFA 2.0 exportot a forrásrendszerből. |
Hiányzó vagy rossz helyen álló kötelező elemElement '…': Missing child element(s). Expected is ( … ).Element '…': This element is not expected. Expected is ( … ). |
NAV-séma (XSD) | A séma szerint az adott ponton kötelező elem hiányzik, vagy az elemek sorrendje eltér az előírtól. Az XSD kötött sorrendet ír elő, tehát a helyes elem rossz helyen is hibát okoz. Ide tartozik az is, ha egy oda nem illő elem áll ott, ahol a séma mást vár. Az „Expected is” utáni név a várt elem. | Pótolja a várt elemet, és nézze át az érintett rész elem-sorrendjét. |
Nem megengedett elemElement '…': This element is not expected. |
NAV-séma (XSD) | A séma ezen a helyen nem fogad el több elemet — az üzenetben nincs „Expected is” rész. Gyakran belső, egyedi mező marad az exportban, vagy elírás van az elem nevében. | Ellenőrizze az elem nevét, névterét és helyét, majd a forrásrendszer eÁFA 2.0 exportbeállítását. |
Hibás érték (formátum, hossz vagy értékkészlet)Element '…': '…' is not a valid value of the atomic type '…'.Element '…': [facet 'pattern'] The value '…' is not accepted by the pattern '…'.Element '…': [facet 'length'] The value has a length of '…'; this differs from the allowed length of '…'. |
NAV-séma (XSD) | A mező értéke nem felel meg a séma által előírt formátumnak, hossznak vagy értékkészletnek. Tipikus eset a dátumformátum, a tizedesjegyek és a felsorolt kódértékek. Hossz-eltérésnél az ellenőrző kiírja a várt és a tényleges karakterszámot. | Javítsa az értéket a jelzett sorban a séma szerinti formátumra, majd exportálja újra az XML-t. |
Hibás érték: adószám (taxNumber)Element '{…}taxNumber': [facet 'length'] The value has a length of '…'; this differs from the allowed length of '8'. |
NAV-séma (XSD) | Az adószám mezőbe a teljes, kötőjeles adószám vagy országkóddal kiegészített érték került. A séma csak a törzsszámot fogadja el. | A taxNumber mezőbe csak a nyolcjegyű adószám-törzsszám kerüljön, szóköz, kötőjel és országkód nélkül. |
| Egyéb sémahiba | NAV-séma (XSD) | Az érintett mező vagy a környező szerkezet más okból nem felel meg a sémának. Ilyenkor a technikai részletek között a NAV-séma eredeti üzenete is megjelenik. | Ellenőrizze a jelzett sort, majd szükség esetén kérjen új eÁFA 2.0 exportot a forrásrendszerből. |
Webes felület, XML-feltöltés vagy M2M: hol segít az ellenőrző?
Az eÁFA-bevallás háromféleképpen adható be. Az ellenőrzőnek ott van szerepe, ahol az XML-t saját rendszer állítja elő.
| Csatorna | Hogyan működik? | Az ellenőrző szerepe |
|---|---|---|
| Webes felület | A NAV a számla-, pénztárgép- és vámadatokból adókódolt bevallástervezetet állít össze, ezt a felületen ellenőrzik, módosítják és hagyják jóvá. Bevallási időszakonként 100 ezer számla alatt használható. | Nem szükséges: saját XML-fájl nem készül. |
| XML-feltöltés | A saját rendszerben előállított adónyilvántartás XML-fájlként kerül fel a webes felületre. A mellékletek adatainak is az XML-ben kell szerepelniük, utólag nem pótolhatók. | Feltöltés előtt: a feltöltött fájl ugyanahhoz az eÁFA 2.0 XSD-hez igazodik, amelyhez az ellenőrző mér. |
| Gépi (M2M) kapcsolat | Az ERP vagy a bevallási szoftver gépi interfészen küldi a bizonylatszintű adónyilvántartást, a NAV ellenőrzi, és a tervezetet a rendszer gépi úton hagyja jóvá. | Fejlesztéskor és hibakereséskor: az export formai hibái a beküldés előtt kiszűrhetők. |
Részletes csatorna-összevetés esetpéldákkal
Gyakori kérdések
Feltöltődik valahova a fájl?
Nem. Az ellenőrzés a böngészőben fut: a fájlt a böngésző olvassa be, és a sémavalidáció is helyben, WebAssembly-re fordított libxml2-vel történik. A fájl tartalma nem hagyja el a gépet — ez a böngésző fejlesztői eszközeinek hálózati fülén ellenőrizhető is.
Melyik sémához mér az ellenőrző?
A NAV nyilvános eVAT tárhelyén közzétett, rögzített eÁFA 2.0 XSD-kiadáshoz (NAV eÁFA 2.0 XSD, rögzített kiadás 2.0.2 (2026. július 1., commit 21065b6b)). A sémát nem tartjuk másolatban, hanem a NAV forrásából töltjük le ehhez a kiadáshoz. Az ellenőrzés alapját az oldal a futtatás előtt és után is kiírja.
Ha átmegy az ellenőrzésen, a NAV biztosan elfogadja?
Nem. Ez formai ellenőrzés: azt vizsgálja, hogy a fájl megfelel-e a séma szerinti szerkezetnek és formátumnak. A NAV ezen felül technikai, feldolgozási és üzleti validációt is futtat, saját hibaüzenetekkel — ezeket az eÁFA hibakódok oldalon gyűjtöttük össze.
Mekkora fájlt tud ellenőrizni?
A méret korlátja a gép memóriája, nem szerveroldali limit. A validáció külön szálon (Web Workerben) fut, így nagyobb analitika esetén sem fagy le a felület.
Miért kötött az elemek sorrendje?
Mert az XSD sorrendet is előír, nem csak azt, hogy mely elemek szerepelhetnek. Ezért egy önmagában helyes elem is hibát okoz, ha rossz helyen áll — ez az egyik leggyakoribb félreértés a séma szerinti hibáknál.