Az eÁFA gépi interfészéhez nincs külön regisztrációs kérelem. A hozzáféréshez technikai felhasználó, aláíró- és cserekulcs, valamint két felületen kiosztott jogosultságok szükségesek.
A NAV-nál két külön gépi csatorna van, két külön regisztrációval. Az egyik nem helyettesíti a másikat.
Adózóként vagy képviselőként technikai felhasználót, kulcsokat és eÁFA-jogosultságokat állítasz be a beküldő szoftverhez.
Ki végezheti: Az adózó elsődleges felhasználója: maga az adózó, a törvényes képviselő vagy az állandó meghatalmazott.
Mire jó: Létrehozza az eÁFA M2M-kapcsolathoz szükséges technikai felhasználót, kulcspárt és műveleti jogosultságokat.
NAV Felhasználókezelő — https://uam.nav.gov.hu/
A beállítás megkezdése előtt legalább egyszer jelentkezz be az Online Számla rendszerbe. Ez szükséges ahhoz, hogy a további funkciók elérhetővé váljanak.
A belépés a NAV Felhasználókezelőn keresztül, KAÜ-azonosítással történik. Ez a közös belépési pont az Online Számlához, az Online Számlázóhoz és az eÁFA-hoz.
Ha több adózó képviseletére vagy jogosult, válaszd ki azt a szervezetet, amelyhez az eÁFA M2M-kapcsolatot beállítod.
Eredmény: A megfelelő adózó profilja aktív, és elérhető a Felhasználók menüpont.
Figyelem: A technikai felhasználó, a kulcsok és a jogosultságok adózónként külön jönnek létre. A folytatás előtt ellenőrizd, hogy a megfelelő szervezet van kiválasztva.
NAV Felhasználókezelő → Felhasználók
A Felhasználók menüpontban hozz létre legalább egy technikai felhasználót az érintett adózóhoz.
Meglévő Online Számla technikai felhasználó is használható, ha megkapja a szükséges eÁFA-jogosultságokat. Külön technikai felhasználóval a két adatkapcsolat jogosultságai és kulcsai egyértelműen elkülöníthetők.
Eredmény: Létrejött az a technikai felhasználó, amelyhez a kulcsok és a jogosultságok kapcsolódnak.
Figyelem: A felhasználókezelés 2024. április 25. óta nem az Online Számla felületén, hanem a NAV Felhasználókezelőben érhető el.
NAV Felhasználókezelő → Felhasználók → technikai felhasználó
Az eÁFA M2M-kapcsolathoz aláírókulcs és cserekulcs egyaránt szükséges. A kapcsolat egyik kulcs nélkül sem működik.
Mindkét kulcsot a technikai felhasználó adatlapján generáld le, majd biztonságos módon add át a beküldő szoftver konfigurációjához.
Eredmény: Rendelkezésre áll a beküldő szoftver NAV-azonosításához szükséges kulcspár.
Figyelem: Az eÁFA aláíró- és cserekulcsa nem azonos a NAV M2M bizonylatbeküldés API-kulcsával. A két hitelesítési megoldás nem cserélhető fel.
NAV Felhasználókezelő → Felhasználók → technikai felhasználó
A jogosultságok két szinten, két külön felületen állíthatók be. Először a NAV Felhasználókezelőben add meg a technikai felhasználónak a „Hozzáférés e-ÁFA rendszer interfészhez” jogosultságot — ez engedi, hogy egyáltalán elérje az eÁFA-t. A technikai felhasználó jelszava is itt állítható be.
Eredmény: A technikai felhasználó elérheti az eÁFA interfészét; a konkrét műveletekhez még külön jogosultságok szükségesek.
Figyelem: Ez a jogosultság önmagában nem elegendő. A következő beállítást már az eÁFA webes felületén kell elvégezni.
eÁFA webes felület → Felhasználók → technikai felhasználó — https://eafa.nav.gov.hu/
A NAV Felhasználókezelő „Alkalmazások” funkciójából lépj át az eÁFA webes felületére. Nyisd meg a Felhasználók menüpontot, majd válaszd ki az előző lépésekben beállított technikai felhasználót.
A szükséges feladatok alapján válaszd ki a megfelelő jogosultságokat: bevalláskezelés, bevallásjóváhagyás, valamint kényelmi szolgáltatások és lekérdezések.
Ha a technikai felhasználót a rendszer maga hozta létre a webes XML-feltöltéshez, annál a NAV szerint ez a jogosultságbeállítás nem érhető el.
Eredmény: A technikai felhasználó rendelkezik a kijelölt eÁFA-műveletek végrehajtásához szükséges jogosultságokkal.
Figyelem: A bevallás jóváhagyása külön jogosultság. Bevallásjóváhagyási jogosultság nélkül a szoftver összeállíthatja és feltöltheti a bevallást, de a benyújtást az eÁFA webes felületén kell elvégezni.
A bevallást beküldő program
Rögzítsd az aláíró- és cserekulcsot a bevallást beküldő szoftver biztonságos konfigurációjában. A szoftver ezt követően a technikai felhasználó nevében azonosítja magát a NAV felé.
Eredmény: A hozzáférési adatok rendelkezésre állnak; a kapcsolat működése a tesztkörnyezetben ellenőrizhető.
A beküldő szoftvert illeszted az eÁFA M2M-interfészhez, és a sémákat, tesztkörnyezetet, valamint az adókódokat készíted elő.
Ki végezheti: A technikai illesztést a fejlesztő végzi; képviseleti jogosultság ehhez nem szükséges. A technikai felhasználót az adózó elsődleges felhasználója hozza létre.
Mire jó: A beküldő rendszer felkészítése az aktuális eÁFA-sémára, az adókódok megfeleltetésére és a tesztkörnyezeti kommunikációra.
NAV eVAT GitHub-repó
A NAV eVAT GitHub-repozitóriuma tartalmazza a sémafájlokat, a példa-XML-eket és az aktuális interfészspecifikációt.
Technikai kérdés a repozitórium Discussions felületén tehető fel. Jogértelmezési kérdésben a NAV hivatalos kapcsolattartási felületét kell használni.
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 az éles rendszertől elkülönül. Adózónként külön technikai felhasználót és külön kulcspárt kell létrehozni.
A teszt Felhasználókezelő elérhetősége: https://uam-test.nav.gov.hu/
Az eÁFA tesztfelületén állíthatók be a tesztkörnyezeti eÁFA-jogosultságok: https://eafa-test.nav.gov.hu/home
Figyelem: Az éles környezet belépési adatai a tesztrendszerben nem használhatók. Hozzáférési probléma esetén a NAV az adószámot, a cégnevet és az elsődleges felhasználó adóazonosító jelét kéri.
Készíts egyértelmű megfeleltetést a forrásrendszer adókódjai és a NAV standard adókódjai között. A helyes technikai kapcsolat nem pótolja a pontos és konzisztens törzsadatokat.
Eredmény: A saját adókódjaid le vannak képezve a NAV standard adókódjaira.
Az interfészspecifikáció és a sémák verziózottak. A fejlesztést a NAV által aktuálisan érvényesnek jelölt verzióra kell építeni, a későbbi verzióváltásokat pedig kontrolláltan követni kell.
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 felülete három eÁFA-specifikus jogosultságot különít el. Az alábbi összefoglaló az eÁFA M2M-interfészspecifikáció 2.0 műveletlistájára épül; egyedi jogosultsági kérdésben mindig az aktuális NAV-specifikáció az irányadó.
A NAV korábbi felkészülési tájékoztatója még az Online Számla rendszer Felhasználók menüpontjára hivatkozik. A későbbi NAV-közlemény szerint azonban a másodlagos és technikai felhasználók kezelése 2024. április 25-től a NAV Felhasználókezelőben történik. Ez az útmutató az újabb tájékoztatást követi; a felület változása esetén mindig a NAV aktuális dokumentációja 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