Az eÁFA gépi interfészéhez nincs külön regisztráció. Technikai felhasználót hozol létre a NAV Felhasználókezelőben, generálsz hozzá két kulcsot, a jogosultságokat pedig két külön felületen adod meg.
Ez az útmutató az áfabevallás eÁFA M2M interfészéről szól. Ha bizonylatot akarsz beküldeni a NAV M2M csatornán, ez a beállítás nem elég hozzá. Ott a NAV Ügyfélportál M2M-regisztrációs alkalmazásában kell regisztrálnod — előbb a kliensprogramot, majd a felhasználót —, és a tárhelyedre kézbesített API-kulcs azonosít. A NAV M2M regisztráció lépései
Gépi úton akarod beküldeni az áfabevallást, és a programnak hozzáférést kell adnod a NAV eÁFA-rendszeréhez.
Ki végezheti: Elsődleges felhasználóként tudod elvégezni: adózóként, törvényes képviselőként vagy állandó meghatalmazottként.
Mire jó: A gépi interfészen a NAV nem téged azonosít, hanem egy technikai felhasználót, kulcspárral. Ebben a szakaszban létrehozod ezt a technikai felhasználót, és megadod neki a jogosultságokat.
NAV Felhasználókezelő — https://uam.nav.gov.hu/
Mielőtt bármit beállítanál, legalább egyszer be kell jelentkezned az Online Számla rendszerbe. Enélkül a többi lépés nem indul.
A belépés 2024. április 25. óta a NAV Felhasználókezelőn át vezet — ez a közös kapu az Online Számlához, az Online Számlázóhoz és az eÁFA-hoz. Elsődleges felhasználóként KAÜ-azonosítással lépsz be.
Ha több cég képviseletére van jogosultságod — könyvelőirodaként jellemzően van —, belépés után mindegyiket látni fogod. A NAV úgy fogalmaz, hogy „az összes olyan adózó látható az elsődleges felhasználó számára, akire a képviseleti jogosultsága vonatkozik”. Válaszd ki azt a céget, amelyiknek a gépi kapcsolatát beállítod.
Eredmény: Bejutottál, a megfelelő cég van kiválasztva, és eléred a Felhasználók menüpontot.
Figyelem: A cégválasztást a legelején intézd el. A technikai felhasználó, a kulcsok és a jogosultságok mind adózónként állnak be — ha rossz cégnél kezded, végigcsinálod a hat lépést, és a végén a másik cégnek lesz gépi kapcsolata.
NAV Felhasználókezelő → Felhasználók
A Felhasználók menüpontban vedd fel a technikai felhasználót. Adózónként legalább egy kell.
Ha az Online Számlában már van technikai felhasználód, azt használhatod az eÁFA-hoz is — ilyenkor csak a jogosultságait kell kiegészítened. Újat akkor érdemes felvenned, ha a gépi eÁFA-kapcsolatot szándékosan el akarod különíteni.
Eredmény: Megvan a technikai felhasználó. Erre épül a kulcsgenerálás és a két jogosultsági szint.
Figyelem: Ha az Online Számla rendszerben keresed a felhasználókezelést, nem találod: 2024. április 25-én került át a felhasználókezelőbe. A kiosztás módja nem változott, csak a helye.
NAV Felhasználókezelő → Felhasználók → technikai felhasználó
A technikai felhasználóhoz két kulcs kell: aláírókulcs és cserekulcs. A gépi kapcsolat egyik nélkül sem működik.
A kulcsok a technikai felhasználó adatlapján keletkeznek, tehát ott, ahol az imént létrehoztad. Csináld meg rögtön, mielőtt továbblépnél.
Eredmény: Megvan a két kulcs, amivel a programod azonosítja magát a NAV felé.
Figyelem: Ne keverd össze a NAV M2M bizonylatbeküldéssel: ott API-kulcs azonosít, itt kulcspár. A kettő nem cserélhető fel.
NAV Felhasználókezelő → Felhasználók → technikai felhasználó
A jogosultságok két szinten állnak, és két külön felületen. Az első az interfész-elérési jogosultság: ez dönti el, hogy a technikai felhasználó egyáltalán hozzáférhet-e az eÁFA-hoz.
Eredmény: A technikai felhasználó eléri az eÁFA-t, de műveletet még nem tud végezni.
Figyelem: Itt még nem vagy kész, és a következő lépés már nem is ezen a felületen lesz. Innen az eÁFA saját webes felületére kell átlépned — ezen bukik el a legtöbb beállítás.
eÁFA webes felület → Felhasználók → technikai felhasználó — https://eafa.nav.gov.hu/
Lépj át az eÁFA felületére az „Alkalmazások” funkcióval. Ott nyisd meg a „Felhasználók” menüpontot, válaszd ki a technikai felhasználódat, és az ő felületén add meg a jogosultságokat.
Csak azokat kapcsold be, amelyeket ténylegesen használni fogsz. Három közül választhatsz: bevalláskezelés, bevallásjóváhagyás, valamint kényelmi szolgáltatások és lekérdezések.
Eredmény: A technikai felhasználó elvégzi azokat a műveleteket, amiket kijelöltél.
Figyelem: A jóváhagyás külön jogosultság. Ha csak a bevalláskezelést adod meg, a programod összeállítja a bevallást, de beküldeni nem tudja — ahhoz valakinek kézzel kell jóváhagynia a webes felületen.
A bevallást beküldő program
Vidd be a két kulcsot abba a programba, amelyik a bevallást beküldi. Innentől a program a technikai felhasználó nevében kommunikál a NAV-val.
Eredmény: A gépi kapcsolat él.
Te írod a programot, és rá kell illesztened az eÁFA gépi interfészére: sémák, tesztkörnyezet, adókódok.
Ki végezheti: Ehhez nem kell képviseleti jogosultság. A tesztkörnyezeti technikai felhasználót viszont már az elsődleges felhasználó hozza létre.
Mire jó: Az interfész technikai illesztése. A hozzáférés beállítása ettől független — azzal a másik ág foglalkozik.
NAV eVAT GitHub-repó
Az eÁFA M2M nyilvános anyagai GitHubon vannak: séma-leírók, példa-XML-ek és az interfészspecifikáció.
Technikai kérdést ugyanitt tehetsz fel, a repó Discussions felületén. Jogértelmezést igénylő kérdéssel viszont a NAV levélküldő felületére kell fordulnod.
Eredmény: Megvan a séma és a specifikáció, amire a beküldött állományt illeszted.
https://onlineszamla-test.nav.gov.hu/home
A tesztkörnyezet önálló rendszer, nem az éles másolata. Hozz létre benne külön technikai felhasználót — adózónként legalább egyet —, és generálj hozzá külön kulcsokat.
A felhasználókezelőnek is van tesztváltozata: https://uam-test.nav.gov.hu/
Az eÁFA-nak szintén saját tesztfelülete van, ott állítod be az eÁFA-jogosultságokat: https://eafa-test.nav.gov.hu/home
Figyelem: Az éles belépési adataid itt nem működnek. Ha nem jutsz be, a NAV az adószámot, a cégnevet és az elsődleges felhasználó adóazonosító jelét kéri.
Képezd le a saját adókódjaidat a NAV standard adókódjaira. A NAV ezt külön kiemeli, és jó okkal: a gépi beküldés a leggyakrabban nem az interfészen bukik el, hanem a saját törzsadatokon.
Eredmény: A saját adókódjaid le vannak képezve a NAV standard adókódjaira.
Az interfészspecifikáció verziózva jelenik meg. Mindig arra a sémaverzióra illessz, amelyet a NAV éppen érvényesnek jelöl, és kövesd a verzióváltásokat.
A beállítás két külön NAV-felületen fut. A NAV Felhasználókezelőben (https://uam.nav.gov.hu/) történik a belépés, a technikai felhasználó létrehozása, a kulcsgenerálás és az interfész-elérési jogosultság megadása. Onnan az „Alkalmazások” funkcióval kell átlépni az eÁFA webes felületére (https://eafa.nav.gov.hu/), ahol az eÁFA-interfészspecifikus jogosultságok állnak be. Végül a kulcsok a bevallást beküldő programba kerülnek.
A NAV megnevezi ezt a három jogosultságot, de sehol nem írja le, mit fed le pontosan egyik sem — sem a felkészülési tájékoztatóban, sem az eÁFA-rendszer felhasználói kézikönyvében, amelynek 3.4.1. pontja szintén csak felsorolja őket. Az alábbi leírások ezért nem NAV-idézetek: a NAV eÁFA-M2M-interfészspecifikáció 2.0 műveletneveiből olvashatók ki, és a csoportosítás a mi olvasatunk. Ha egy konkrét ügyben a jogosultság pontos határa számít, a specifikáció műveletlistája az irányadó.
A NAV felkészülési tájékoztatója még az Online Számla rendszer Felhasználók menüpontját nevezi meg a jogosultságok helyeként. A NAV Felhasználókezelőről szóló közleménye viszont rögzíti, hogy a másodlagos és technikai felhasználók jogosultságait az elsődleges felhasználók 2024. április 25-től már nem ott kezelik. Az útmutató az újabb közleményt követi; ha a felületen eltérést tapasztalsz, a NAV aktuális tájékoztatása az irányadó.
A tesztkörnyezet önálló rendszer, nem az éles környezet másolata. Külön technikai felhasználót kell benne létrehozni, és ahhoz külön kulcsokat generálni. Elérhetősége: https://onlineszamla-test.nav.gov.hu/home