Ugrás a fő tartalomhoz

Napló, lekérdezések, hibakezelés

Bevallási napló​

Az eÁFA bevallási napló a bevallásokhoz kapcsolódó teljes M2M kommunikációt tartalmazza: állapotok, állapotüzenetek, feltöltési és feldolgozási azonosítók, Bevallás verziója, jelleg, partíciószám, környezet, időpontok (köztük a Véglegesítés ideje, amelytől a 30 napos beküldési határidő számít) és a beküldő felhasználó.

  • Adattartalom: a rendszer minden kérés és válasz XML-jét, valamint a bevallás tartalmát eltárolja; ezek a Kérés XML letöltése és a Válasz XML letöltése funkcióval tölthetők le. A jelszókivonatot és az aláírást a rendszer tárolás előtt kitakarja. Minden írás azonnal véglegesítődik, így a napló megszakadt folyamat után is megmarad.
  • Ellenőrzési üzenetek: a NAV által visszaadott technikai és üzleti üzenetek (csatorna, hibakód, üzenet, hivatkozott sor, mező, érték). Az üzenetet és a hivatkozott értéket a rendszer teljes hosszukban (legfeljebb 1024 karakter) tárolja.
  • Összehasonlítás a NAV-val: az ezzel a feltöltéssel beküldött összesítő adatokat (Beküldött érték) veti össze a NAV által ugyanerre a bevallásra nyilvántartott értékekkel (előző időszakról áthozott adó, elszámolt adó, fizetendő adó, kiutalásra igényelt levonható adó, átvihető adó). A beküldött példányt a napló tárolja; ha hiányzik, a funkció hibát ad. A NAV-értékeket a napló eltárolja; az önellenőrzés ellenőrzése ezekkel veti össze az eredeti összesítést (lásd: Ellenőrzések).
  • Bevallás újraküldése: megnyitja a forrás bevallás-nyilatkozatot az újbóli beküldéshez.
  • Ismeretlen feltöltés feloldása: ha egy feltöltés véglegesítési eredménye ismeretlen, és a NAV bevalláslistája nem tartalmazza, a bevallás zárolva marad. A feltöltési azonosító lejártakor (a NAV által adott érvényesség végén, ennek hiányában a feltöltés után 72 órával) a rendszer a következő állapotlekérdezéskor vagy új beküldési kísérletkor automatikusan feloldja (az ütemezett állapotlekérdezés ezeket nem veszi fel); akkor is feloldja, ha egy újabb feltöltésre adott NAV-válasz ezt a feltöltést érvénytelenítettként jelzi; előtte ezzel a funkcióval kézzel oldhatjuk fel, megerősítés és kötelező indoklás (Feloldás oka) után. Ehhez a bevallási naplóra írási jog szükséges, és egy bejegyzés csak egyszer oldható fel. A feloldás után a bevallás újra feltölthető. Az Ismeretlen eredmény feloldásának időpontja, az Ismeretlen eredményt feloldotta (automatikus feloldásnál üres), az Ismeretlen eredmény feloldási megjegyzése és az Ismeretlen eredmény rendezési megjegyzése mező rögzíti, mi történt. Ha a NAV később mégis befejezettként listázza, a bejegyzés „Felülírva / nem beküldendő” megjegyzést kap.
ÁllapotJelentés
Beérkezett (RECEIVED)Véglegesítés után; folyamatban, új feltöltést blokkol.
Feldolgozás alatt (PROCESSING)Folyamatban, új feltöltést blokkol.
Adóhatósági ellenőrzés (BEVFELD_CHECK)Folyamatban, új feltöltést blokkol.
Befejezve (FINISHED)Csak ebből indítható a végleges beküldés (30 napon belül).
Benyújtva (SUBMITTED)Végállapot, nem változik.
Megszakítva (ABORTED)A NAV elutasította; javítás után újra beküldhető. A nyilatkozat állapota „Elutasítva”.
Érvénytelenítve (CANCELLED)Egy újabb feltöltés érvénytelenítette ezt a feltöltést; új feltöltést nem blokkol, a nyilatkozat állapota „Elutasítva”, újra beküldhető.
IsmeretlenA NAV nem válaszolt, vagy a válasz nem értelmezhető; újrapróbálás előtt le kell kérdezni az állapotot. Érvényes feltöltési azonosító mellett új feltöltést blokkol (új beküldéskor a rendszer megerősítést kér). Ismeretlen véglegesítési eredménynél az Állapot lekérdezése a NAV bevalláslistájából keresi meg a feldolgozási azonosítót; ha nem találja, semmi nem változik, kivéve ha a feltöltési azonosító lejárt: ilyenkor a bevallást feloldja. Ha a végleges beküldésre nem jött válasz, a rendszer addig nem engedi újra beküldeni, amíg az állapotlekérdezés nem mutatja, hogy a NAV nem fogadta be.
Nem felismertA NAV ismeretlen állapotkódot adott; új feltöltést blokkol.

Analitikai szolgáltatások​

Az eÁFA analitikai szolgáltatások lapról a NAV kényelmi lekérdezéseit futtathatjuk. A paramétereket egy párbeszédablak kéri be. Az adókód katalógus kivételével mind Prémium funkció. A dátumtartományos lekérdezések legfeljebb 35 napot fedhetnek le, és egyik sem kezdődhet a legkorábbi elfogadott teljesítési dátum (2021. január 1.) előtt; ez a bevallás- és nyilatkozatlistára is vonatkozik.

FunkcióMűveletParaméterekEredmény
Adókód katalógusqueryTaxCodeCatalogTeljesítési dátumeÁFA adókód katalógus
Bevallás- és nyilatkozatlistaqueryDeclarationListDátumtól–dátumig (a kezdő dátum nem lehet a mai napnál későbbi)eÁFA bevallás/nyilatkozat tételek; 100 tételnél a rendszer jelzi, hogy a lista hiányos lehet, és szűkebb dátumtartományt kell megadni
BevallásadatqueryDeclarationDataFeldolgozási azonosítóeÁFA bevallás adatai
Eredeti áfabevallás-adatqueryVatDeclarationDataFeldolgozási azonosítóLetölthető XML (<azonosító>-original.xml)
Számla adókódqueryInvoiceTaxCodeSzámlaszám, irány, szállító adószáma, köteg, tételsorSzámlakivonat, adókódok, adózási pozíciók, figyelmeztetések
Dokumentumlista lekérdezés beküldésequeryDocumentListDátumtól–dátumigLekérdezés-azonosító (aszinkron)
Dokumentumlista lekérdezés eredményequeryDocumentListResultLekérdezés-azonosítóSzámla- és vámkivonatok
Vámáru határozat kivonatqueryCustomsDeclarationDigestDátumtól–dátumig, irány, oldalszámLapozott kivonatlista
Vámáru határozat adókódjaiqueryCustomsDeclarationTaxCodeHatározat-azonosítók, irányAdókód adatok, adózási pozíciók
Csatolmány feltöltése, Csatolmány törlése, CsatolmánylistamanageAttachmentUpload, purgeAttachment, queryAttachmentListFájl, illetve csatolmány-azonosítóCsatolmány-azonosító és érvényesség, illetve a NAV-nál lévő csatolmányok

Hibakezelés​

Kommunikációs eredmények​

EredményJelentés
SikeresA NAV válaszolt. funcCode = OK esetén siker; ERROR esetén üzleti elutasítás (a hibakód és az üzenet a naplóban látható).
HTTP-hibaA NAV HTTP hibakódot adott. 429: túl sok kérés; 503: tervezett karbantartás. Ha a NAV megadja (Retry-After), az üzenet azt is közli, mikor próbálható újra. 500 OPERATION_FAILED: átmeneti szerveroldali hiba; később újra kell próbálni, tartós hibánál a NAV portál közleményeit kell ellenőrizni.
Átviteli hibaNem érkezett válasz a NAV-tól; a beküldés állapota ismeretlen. A véglegesítési és a végleges beküldési műveletnél a NAV szerverhibája (5xx, kivéve a 500 OPERATION_FAILED választ) is ismeretlen állapotot eredményez (az eredmény ilyenkor HTTP-hiba, a naplóbejegyzés ismeretlen állapotú). Újrapróbálás előtt le kell kérdezni az állapotot.
Környezet által letiltvaA Business Central nem engedi a HTTP-hívást; a Bővítménykezelés lapon engedélyezni kell.
Hibás formátumú válaszA válasz nem felel meg a protokollnak. Ez nem adóhatósági elutasítás. Üzenet: „Az adóhatóság olyan választ adott, amely nem olvasható fel.”, vagy a válaszból kiolvasható részletek.
Nem futott leA kérés el sem indult (például egy előzetes lépés megszakította). Üzenet: „A kérés nem lett elküldve az adóhatóságnak.”

Ha az eÁFA beállítás hiányzik vagy hiányos, a hibaüzenetben az eÁFA beállítás megnyitása művelettel közvetlenül megnyithatjuk a beállítás lapot.

Időtúllépés és újrapróbálás​

  • Időtúllépés: 60 másodperc. Csak HTTPS végpont használható.
  • A lekérdezések (például az állapotlekérdezés) 429-es, 503-as vagy 500 OPERATION_FAILED válasz esetén összesen legfeljebb háromszor próbálkoznak (legfeljebb 2 újrapróbálás). A várakozás a Retry-After fejléc szerinti, ennek hiányában növekvő (legfeljebb 30 másodperc). Ha a Retry-After felhasználói munkamenetben 60, háttérben 120 másodpercnél hosszabb, a rendszer nem vár, hanem hibát ad, és közli, mikor próbálható újra. Minden új próbálkozás új kérésazonosítót, időbélyeget és aláírást kap.
  • A feltöltés, a partíciók, a véglegesítés és a végleges beküldés nem ismétlődik automatikusan, hogy ne jöjjön létre kettős beküldés. A csatolmány feltöltése és törlése, valamint az eredeti áfabevallás-adat letöltése sem ismétlődik.

A hash szolgáltatás hibái​

  • A szolgáltatásnak pontosan 128 hexadecimális karakteres SHA3-512 kivonatot kell visszaadnia, különben a kérés nem indul el.
  • A kapcsolatot a Hash függvény ellenőrzése funkcióval tesztelhetjük.
Visszajelzés