Ugrás a fő tartalomhoz

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észletHozzárendelhetőTartalom
eVat Admin NAVHU eÁFA adminisztrátorIgenTeljes (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átorIgenA 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 objektumokNemFuttatá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:

  1. Üdvözöljük: rövid bevezetés.
  2. 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.
  3. 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ő).
  4. Ö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.

eÁFA beállítás

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ójaa bővítmény neve, illetve fő verziószáma (például 28)
Szoftver működés típusaHelyi 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ámAppVision 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őÚtvonalCsomag
Bevallás feltöltési végpontmanageDeclarationUploadPrémium
Bevallás partíció feltöltési végpontmanageDeclarationPartitionPrémium
Bevallás véglegesítési végpontmanageDeclarationFinalizePrémium
Bevallás állapot végpontqueryDeclarationProcessingStatusPrémium
Bevallás beküldési végpontmanageDeclarationSubmissionPrémium
Melléklet feltöltési / törlési / lista végpontmanageAttachmentUpload, purgeAttachment, queryAttachmentListPrémium
Vámáru-nyilatkozat kivonat lekérdezési végpontqueryCustomsDeclarationDigestPrémium
Vámáru adókód keresési végpontqueryCustomsDeclarationTaxCodePrémium
Bevallás/nyilatkozat lista lekérdezési végpontqueryDeclarationListPrémium
Aszinkron dokumentumlista (eredmény) lekérdezési végpontqueryDocumentList, queryDocumentListResultPrémium
Számla adókód lekérdezési végpontqueryInvoiceTaxCodePrémium
Adókód katalógus lekérdezési végpontqueryTaxCodeCatalogIngyenes
Bevallás adat / Áfabevallás adat lekérdezési végpontqueryDeclarationData, queryVatDeclarationDataPré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éseEllenő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éseAz ü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ásaMegerő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éseLeké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éseEgy 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éseAzonnal 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 beállítás

-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.

Visszajelzés