eÁFA beállítások
Előfeltételek
Az eÁFA használatához az alábbiakra van szükség:
- Technikai felhasználó: a NAV eÁFA felhasználókezelő felületén regisztrálva (bejelentkezési név, jelszó, XML aláírókulcs). A technikai felhasználót a használt környezethez (teszt vagy éles) kell regisztrálni.
- Cégadatok: kitöltött név, cím, irányítószám, ország/régió kód és adószám.
- Számsorozatok: a bevallás és a bevallás-nyilatkozat számozásához.
- Áfateljesítés dátuma: kitöltve az áfatételeken. Az időszaki szűrés a lokalizáció Áfateljesítés dátuma mezője alapján történik, nem a könyvelési dátum alapján.
- Kimenő HTTP-hívások engedélyezése: a Bővítménykezelés lapon engedélyeznünk kell a bővítmény számára a HttpClient kéréseket, különben a rendszer a „Környezet által letiltva” eredményt adja. Erre a licencellenőrzéshez is szükség van: letiltott kimenő hívások esetén a rendszer Ingyenes csomagként működik (lásd: Ingyenes és Prémium csomag).
- eÁFA mértékegység: a fordított adózású melléklapokhoz a Mértékegységek lapon ki kell tölteni az eÁFA mértékegység mezőt (kg, m³, MWh).
Fontos: a HttpClient kérések engedélyezésére sandbox környezetben van szükség.
Jogosultságkészletek
| Jogosultságkészlet | Hozzárendelhető | Tartalom |
|---|---|---|
eVat Admin NAVHU eÁFA adminisztrátor | Igen | Teljes (olvasás, beszúrás, módosítás, törlés) jog a beállításra, a felhasználói beállításra, az adókód-hozzárendelésre, a standard adókódokra, a sablonokra, a bevallás-nyilatkozatokra, a melléklapokra, a csatolmány-hivatkozásokra és a napló tábláira; a bevallás-nyilatkozat sorait csak közvetetten írja. Olvasási jog az országokra/régiókra, az irányítószámokra, a bankszámlákra (a pénzforgalmi rendelkezések kereséséhez) és a Főkönyvi beállításra. Futtathatja a támogatott beállítást. |
eVat Operator NAVHU eÁFA operátor | Igen | A bevallások napi kezelése: teljes jog a bevallás-nyilatkozatokra (a sorokat csak közvetetten írja), a melléklapokra, a csatolmány-hivatkozásokra és a standard adókódokra (így letöltheti és frissítheti az adókód katalógust); olvasás, beszúrás és módosítás az adókód-hozzárendelésen. A beállítás, a felhasználói beállítás és a sablonok csak olvashatók, ahogy az irányítószámok és a bankszámlák is (a pénzforgalmi rendelkezések kereséséhez). A naplót csak közvetetten, a műveleteken keresztül írja. A támogatott beállítást nem futtathatja. |
eVat Objects NAVHU eÁFA objektumok | Nem | Futtatási jog az eÁFA objektumokra és olvasási jog a szükséges alaptáblákra (cégadatok, áfabeállítás és -tételek, könyvelt bizonylatok, vevő, szállító, cikk, mértékegység, vámtarifaszám, cégtisztviselő, számsorozat, felhasználó). A másik két jogosultságkészlet tartalmazza. |
Fontos: a bevallás kezelésére, jóváhagyására és a lekérdezésekre vonatkozó jogokat a NAV oldalán a technikai felhasználó jogosultságai határozzák meg; ezeket a NAV eÁFA felhasználókezelő felületén tudjuk beállítani. Ha a technikai felhasználónak nincs joga a végleges beküldésre, a feltöltés sikerülhet, a benyújtást viszont a NAV elutasítja. A Business Centralon belüli hozzáférést a fenti jogosultságkészletek szabályozzák.
Támogatott beállítás
Az eÁFA beállítása varázsló a Támogatott beállítás listában, a „Készen áll a működésre” csoportban érhető el (becsült idő: 10 perc). Csak az eÁFA beállítás írási jogával rendelkező felhasználó (például eVat Admin NAVHU, eÁFA adminisztrátor) futtathatja; más felhasználónál hibaüzenettel leáll.
A varázsló lépései:
- Üdvözöljük: rövid bevezetés.
- Hitelesítő adatok: a technikai felhasználó neve, jelszava, XML aláírókulcsa és az adószám. A továbblépés előtt a rendszer ellenőrzi a kötelező mezőket és az adószámot.
- Vállalati beállítások: teszt vagy éles környezet, alapértelmezett bevallási gyakoriság és a két számozási kör (mindkettő kötelező).
- Összegzés: a megadott adatok áttekintése a kiválasztott környezet API címével.
A Befejezés gombra kattintva a rendszer alkalmazza a környezet alapértelmezéseit, kitölti az üres mezőket, elmenti a technikai felhasználót az aktuális Business Central-felhasználóhoz (az első felhasználót alapértelmezettként jelöli), majd az adókód katalógus lekérdezésével automatikusan teszteli a kapcsolatot. A kapcsolati teszt eredménye csak tájékoztató üzenet: sikertelen teszt esetén a mentett beállítás megmarad.
Ha az API alap URL, a Hash függvény URL vagy a Hash függvény hitelesítési kulcs kézzel megadott, a kiválasztott környezet szállított értékétől eltérő értéket tartalmaz, a Befejezés előtt a rendszer megerősítést kér a felülírásukhoz. „Nem” válasz esetén a varázsló mentés nélkül leáll: „A varázsló leállt, semmi nem lett mentve. Javítsa a kapcsolati értékeket az eÁFA beállítás lapon, vagy futtassa újra a varázslót, és fogadja el a szállított értékeket.”
eÁFA beállítás
Az eÁFA beállítás lap az eÁFA-hoz kapcsolódó beállítások központi felülete. Innen érhetők el a bevallások, a kommunikációs napló és a konfigurációs lapok is.

Vállalati beállítások gyorslap
Teszt környezet használata: Bekapcsolva a teszt, kikapcsolva az éles NAV-környezetet használja. Módosításkor a rendszer megerősítést kér, majd felülírja az API alap URL, a Hash függvény URL és a Hash függvény hitelesítési kulcs mezőt. Ha már vannak felhasználói beállítások, figyelmeztet, hogy a technikai felhasználó hitelesítő adatai egy környezethez tartoznak, ezért azokat ellenőriznünk vagy újra meg kell adnunk az új környezethez. Alapértéke: bekapcsolva.
Alapértelmezett bevallási gyakoriság: „Havi”, „Negyedéves” vagy „Éves”. Alapértéke: „Havi”. Új bevallás-nyilatkozat létrehozásakor ez kerül a nyilatkozat Bevallási gyakoriság mezőjébe; a már létrehozott nyilatkozatokat a módosítása nem érinti. Az Áfabevallás előkészítése ez alapján javasolja az időszakot a munkadátumhoz.
Bevallás számozása: A NAV-val folytatott kommunikáció belső számozása. A NAV oldalán nem jelenik meg.
Bevallás-nyilatkozat számozása: A Business Centralban létrehozott eÁFA bevallás-nyilatkozatok számsorozata. A NAV oldalán nem jelenik meg.
Előfizetés: „Ingyenes” vagy „Prémium”: a licenckiszolgáló döntése alapján számított, nem szerkeszthető érték (lásd: Ingyenes és Prémium csomag).
Kapcsolat gyorslap
API alap URL: A NAV eÁFA szolgáltatás alapcíme; csak https cím adható meg.
Teszt: https://api-test.eafa.nav.gov.hu
Éles: https://api.eafa.nav.gov.hu
Kézi módosításra csak akkor van szükség, ha az adóhatóság megváltoztatja az elérést. A technikai felhasználót mindig a beállított környezethez kell regisztrálni.
Titkosítás gyorslap
Hash függvény URL: Az aláíráshoz használt SHA3-512 kivonatot számító szolgáltatás címe (alapértéke: https://oniavfunctions.businesscentral.hu/api/sha3_512Encode); csak https cím adható meg. Az Alapértelmezések kitöltése funkció tölti ki.
Hash függvény hitelesítési kulcs: A szolgáltatás hitelesítési kulcsa, maszkolva jelenik meg. Az Alapértelmezések kitöltése funkció tölti ki.
Szoftver jellemzők gyorslap
Az M2M adatkommunikációt végző szoftver adatai. Ezek minden kérés fejlécében szerepelnek; a rendszer tölti ki őket, és nem szerkeszthetők. Kivétel a három verziószám, amelyet csak akkor kell módosítani, ha a NAV új verziót vezet be. A Szoftver fő verzióját az Alapértelmezések kitöltése funkció (és a támogatott beállítás befejezése) állítja a telepített bővítmény verziójára; a lokalizáció frissítése egyik mezőt sem módosítja automatikusan.
| Mező | Alapérték |
|---|---|
| Szoftver azonosító | HU26500919XXXXXXXX |
| Szoftver neve, Szoftver fő verziója | a bővítmény neve, illetve fő verziószáma (például 28) |
| Szoftver működés típusa | Helyi szoftver (LOCAL_SOFTWARE); a másik lehetséges érték: Online szolgáltatás (ONLINE_SERVICE) |
| Szoftver kereskedői azonosító | üres |
| Szoftver fejlesztő neve, e-mail, országkód, adószám | AppVision Kft., appvision@appvision.hu, HU, 26500919 |
| Kérés verzió / Fej verzió | 1.0 / 1.0 |
| XSD verzió | eardata_2.0 |
Végpont útvonalak gyorslap
Az eÁFA műveletek végpontjai. A teljes cím az API alap URL és az útvonal összefűzése. Üres mező esetén a rendszer a beépített alapértéket használja. Minden útvonal előtagja /analyticsService/v1/.
| Mező | Útvonal | Csomag |
|---|---|---|
| Bevallás feltöltési végpont | manageDeclarationUpload | Prémium |
| Bevallás partíció feltöltési végpont | manageDeclarationPartition | Prémium |
| Bevallás véglegesítési végpont | manageDeclarationFinalize | Prémium |
| Bevallás állapot végpont | queryDeclarationProcessingStatus | Prémium |
| Bevallás beküldési végpont | manageDeclarationSubmission | Prémium |
| Melléklet feltöltési / törlési / lista végpont | manageAttachmentUpload, purgeAttachment, queryAttachmentList | Prémium |
| Vámáru-nyilatkozat kivonat lekérdezési végpont | queryCustomsDeclarationDigest | Prémium |
| Vámáru adókód keresési végpont | queryCustomsDeclarationTaxCode | Prémium |
| Bevallás/nyilatkozat lista lekérdezési végpont | queryDeclarationList | Prémium |
| Aszinkron dokumentumlista (eredmény) lekérdezési végpont | queryDocumentList, queryDocumentListResult | Prémium |
| Számla adókód lekérdezési végpont | queryInvoiceTaxCode | Prémium |
| Adókód katalógus lekérdezési végpont | queryTaxCodeCatalog | Ingyenes |
| Bevallás adat / Áfabevallás adat lekérdezési végpont | queryDeclarationData, queryVatDeclarationData | Prémium |
Funkciók a lapon
| Funkció | Működés |
|---|---|
| Áfabevallás előkészítése | Új bevallás-nyilatkozatot hoz létre az eÁFA áfabevallás előkészítése jelentéssel, majd megnyitja. Prémium csomagban az Automatikus beküldés bekapcsolásával megnyitás helyett rögtön feltölti és véglegesíti (lásd: Bevallás létrehozása). |
| Beállítás ellenőrzése | Ellenőrzi a kapcsolati és szoftveradatokat, a két számsorozatot, az aktuális felhasználó hitelesítő adatait (a jelszót is), valamint a cégadatokat (név, cím, irányítószám, ország, adószám). Figyelmeztet, és felsorolja, ha a kg, m³ vagy MWh eÁFA mértékegység valamelyikéhez nincs mértékegység rendelve. |
| Alapértelmezések kitöltése | Az üres mezőket tölti ki az alapértékekkel, a kitöltött mezőket nem módosítja. Kivétel a Szoftver fő verziója: ezt mindig a telepített bővítmény verziójára állítja. |
| Környezeti alapértelmezések újraalkalmazása | Megerősítés után felülírja az API alap URL-t, a hash függvény URL-jét és kulcsát a kiválasztott környezet alapértékeivel. |
| Kapcsolat tesztelése | Lekérdezi az adókód katalógust a munkadátumra. Sikeres válasz esetén a felhasználó, a környezet és az azonosítók összetartoznak. |
| Hash függvény ellenőrzése | Egy rögzített értékből (eVatHashFunctionCheck) kivonatot kér a hash szolgáltatástól, és megjeleníti az eredményt. |
| Licenc ellenőrzése | Azonnal lekérdezi az AppVision licenckiszolgálótól, hogy a vállalat rendelkezik-e eÁFA Prémium előfizetéssel, frissíti az Előfizetés mezőt, és megjeleníti az érvényes csomagot. |
Az Alapértelmezések kitöltése és a Környezeti alapértelmezések újraalkalmazása funkció csak annak a felhasználónak jelenik meg, akinek írási joga van az eÁFA beállításra.
A lap menüsávjáról elérhető további lapok:
- Bevallások: eÁFA bevallások, eÁFA bevallási napló, eÁFA-csatolmányok az adóhatóságnál (utóbbi csak Prémium csomagban).
- Konfiguráció: eÁFA felhasználói beállítások, eÁFA adókód-hozzárendelés, eÁFA standard adókódok, eÁFA bevallási sablonok.
- Analitika: eÁFA analitikai szolgáltatások.
Felhasználói beállítások
Az eÁFA felhasználó beállítása lapon (az eÁFA beállítás lapról az eÁFA felhasználói beállítások funkcióval nyitható) a NAV technikai felhasználóját tudjuk Business Central-felhasználóhoz rendelni.

-Felhasználói azonosító: A Business Central-felhasználó.
-Technikai felhasználó bejelentkezési neve: 6–15 karakter, csak betű és szám.
-Technikai felhasználó jelszava: A jelszót a rendszer nem tárolja. Megadáskor SHA-512 kivonatot képez belőle (nagybetűs hexadecimális formában), és csak ezt menti; a lapon a ******** jelzi, hogy van mentett jelszó. A mező törlése a mentett jelszót is törli; jelszót csak a felhasználó kiválasztása után lehet megadni.
-XML aláírókulcs: A NAV felületén generált aláírókulcs, a kérések aláírásához szükséges. Maszkolva jelenik meg.
-Adózó adószáma: A vállalat adószámának törzsszáma (8 számjegy); ha a cégadatokban van adószám, egyeznie kell annak első 8 jegyével.
-Alapértelmezett felhasználó: Csak egy tétel jelölhető meg alapértelmezettként (a jelölés a többi tételről törlődik). Ha az aktuális Business Central-felhasználónak nincs saját tétele, a rendszer az alapértelmezettet használja; ha alapértelmezett sincs, hibát ad.
Telepítés és vállalatmásolás
- Első telepítés: a rendszer vállalatonként létrehozza az eÁFA beállítást az alapértékekkel (URL-ek, hash szolgáltatás, verziók, szoftveradatok, végpontok). Számsorozatot, adókód katalógust és sablont nem hoz létre.
- Új vállalat: ugyanez az alapértelmezett beállítás jön létre.
- Vállalat másolása: az új vállalat teszt környezetre áll, a hash szolgáltatás címe és kulcsa, valamint a felhasználói beállítások (technikai felhasználók) törlődnek. Éles használat előtt a beállítást és a technikai felhasználót újra meg kell adni.
Elérés a keresőből
- eÁFA beállítás, eÁFA felhasználó beállítása, eÁFA standard adókódok, eÁFA adókód-hozzárendelés: adminisztráció
- eÁFA áfabevallások: feladatok
- eÁFA beállítása: támogatott beállítás
A többi lapot az eÁFA beállítás lapról vagy a bevallás-nyilatkozatról nyithatjuk meg.