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.
NAV feldolgozási állapotok
| Állapot | Jelenté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ő. |
| Ismeretlen | A 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 felismert | A 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űvelet | Paraméterek | Eredmény |
|---|---|---|---|
| Adókód katalógus | queryTaxCodeCatalog | Teljesítési dátum | eÁFA adókód katalógus |
| Bevallás- és nyilatkozatlista | queryDeclarationList | Dá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ásadat | queryDeclarationData | Feldolgozási azonosító | eÁFA bevallás adatai |
| Eredeti áfabevallás-adat | queryVatDeclarationData | Feldolgozási azonosító | Letölthető XML (<azonosító>-original.xml) |
| Számla adókód | queryInvoiceTaxCode | Számlaszám, irány, szállító adószáma, köteg, tételsor | Számlakivonat, adókódok, adózási pozíciók, figyelmeztetések |
| Dokumentumlista lekérdezés beküldése | queryDocumentList | Dátumtól–dátumig | Lekérdezés-azonosító (aszinkron) |
| Dokumentumlista lekérdezés eredménye | queryDocumentListResult | Lekérdezés-azonosító | Számla- és vámkivonatok |
| Vámáru határozat kivonat | queryCustomsDeclarationDigest | Dátumtól–dátumig, irány, oldalszám | Lapozott kivonatlista |
| Vámáru határozat adókódjai | queryCustomsDeclarationTaxCode | Határozat-azonosítók, irány | Adókód adatok, adózási pozíciók |
| Csatolmány feltöltése, Csatolmány törlése, Csatolmánylista | manageAttachmentUpload, purgeAttachment, queryAttachmentList | Fá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ény | Jelentés |
|---|---|
| Sikeres | A 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-hiba | A 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 hiba | Nem é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 letiltva | A Business Central nem engedi a HTTP-hívást; a Bővítménykezelés lapon engedélyezni kell. |
| Hibás formátumú válasz | A 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 le | A 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_FAILEDválasz esetén összesen legfeljebb háromszor próbálkoznak (legfeljebb 2 újrapróbálás). A várakozás aRetry-Afterfejléc szerinti, ennek hiányában növekvő (legfeljebb 30 másodperc). Ha aRetry-Afterfelhaszná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.