Ugrás a tartalomra

3525 Miskolc, Bodótetői út 1. 3. em. 9.

2021 Lorz Kft.

Számlázás és NAV

NAV Online Számla integráció: számlaadat-szolgáltatás gépi kapcsolattal

A NAV Online Számla rendszerébe minden áfaalany számláinak adatai bekerülnek — a legtöbb cégnél ezt a számlázóprogram intézi a háttérben. Saját fejlesztésű számlázó vagy ügyviteli rendszer, illetve a bejövő számlák automatikus feldolgozása esetén viszont közvetlen kapcsolat kell a NAV számlaadat-szolgáltatási felületével.

Automatizálás

Mit lehet automatizálni egy NAV Online Számla-integrációval?

  • A saját fejlesztésű számlázó vagy ügyviteli rendszer számláinak valós idejű adatszolgáltatása a NAV felé — emberi beavatkozás nélkül, ahogy a szabály előírja.
  • A beküldések feldolgozási eredményének követése, és az elakadt vagy hibás számlák automatikus jelzése.
  • A bejövő (szállítói) számlák adatainak lekérdezése, hogy a könyveléshez és a kifizetésekhez ne kelljen kézzel begépelni őket.
  • Adószám-ellenőrzés a vevő felvitelekor, a hibás partneradatok elkerülésére.
  • Számlamódosítás, sztornó és technikai érvénytelenítés kezelése a szabályoknak megfelelő számlaláncban.
Hogyan működik?

Így működik a NAV Online Számla-integráció

01Kinek kell adatot szolgáltatnia, és mikor?

2021. január 4. óta gyakorlatilag minden, az áfatörvény szerint kiállított számla adatát jelenteni kell — magánszemély, külföldi és EU-s vevő esetén, valamint exportnál is (a más tagállamban teljesített, OSS-szabályok alá eső ügyletek kivételével). Számlázóprogramból a jelentés a kiállításkor, azonnal és emberi beavatkozás nélkül történik; az előre nyomtatott papírszámlákat kézzel kell rögzíteni a megadott határidőn belül.

A felelősség akkor is a számlakibocsátóé marad, ha a beküldést egy számlázó szolgáltatás — például a Billingo vagy a Számlázz.hu — végzi helyette. Ezért a beküldések eredményét akkor is érdemes figyelni, ha a technikai részt nem magunk végezzük.

02Hogyan működik az interfész?

A számlaadat-szolgáltatás XML-üzenetekkel dolgozó HTTPS-felület; a jelenlegi interfészverzió a 3.0. A kérések egy technikai felhasználó nevében, aláírva mennek: a jelszó mellé egy aláírókulcs és egy cserekulcs tartozik, a beküldéshez pedig egy néhány percig érvényes token kell.

A feldolgozás aszinkron: a sikeres HTTP-válasz még nem jelenti, hogy a számla rendben van. A beküldés csak akkor tekinthető teljesítettnek, ha a számlánkénti eredmény is sikeres — ezt külön lekérdezéssel ellenőrizzük. A fontosabb műveletek:

  • számla beküldése, módosítása és sztornója (kérésenként legfeljebb 100 számla);
  • a beküldések feldolgozási eredményének és listájának lekérdezése;
  • kimenő és bejövő számlák kivonatos és részletes lekérdezése;
  • adószám-ellenőrzés.

03Technikai felhasználó és tesztkörnyezet

A technikai felhasználót csak az elsődleges felhasználó hozhatja létre — 2024 áprilisa óta a NAV Felhasználókezelőben. Már ekkor érdemes eldönteni, kap-e lekérdezési jogot is: a bejövő számlák letöltéséhez erre szükség van.

A NAV-nak külön teszt- és éles környezete van, külön regisztrációval, technikai felhasználóval és kulcsokkal — a tesztkörnyezet adatai élesben nem működnek. Fejlesztésnél mindig a tesztkörnyezetben kezdünk, és csak az átadáskor kötünk át élesre.

04Nyugták: új adatszolgáltatás 2026-tól

2026. szeptember 1-jétől a kézi és a számítógéppel előállított nyugták adatait is jelenteni kell, napi, áfakulcsonkénti összesítésben, 3 naptári napon belül (a pénztárgépes, e-pénztárgépes és e-nyugtás nyugták kivételével). 2026. december 31-ig a NAV szankciómentes átállási időszakot hirdetett. A beküldés gépi felületen is lehetséges — ha saját rendszer állít ki nyugtát, ezt is be kell kötni.

05Fejlesztőknek: Online Számla API 3.0 gyorsreferencia

A leggyakoribb technikai kérdések röviden, a NAV hivatalos GitHub-tárában közzétett sémák és változásnapló alapján (ellenőrizve: 2026. november 3.). A teljes specifikáció és a fejlesztői napló a NAV Online Számla oldalán és a GitHub-tárban érhető el; élesítés előtt mindig a legfrissebb változatot kell követni.

  • Környezetek: tesztrendszer — api-test.onlineszamla.nav.gov.hu, éles rendszer — api.onlineszamla.nav.gov.hu. A 3.0-s interfész útvonalai a v3 jelölést használják.
  • Műveletek (mind POST): tokenExchange, manageInvoice, manageAnnulment, queryTransactionStatus, queryTransactionList, queryInvoiceData, queryInvoiceDigest, queryInvoiceCheck, queryInvoiceChainDigest, queryTaxpayer.
  • Hibakódok: mind a 280 technikai hibakód, blokkoló validáció, figyelmeztetés és státusz magyarul, a NAV hivatalos teendőjével, kereshetően: NAV Online Számla hibakódok. A 2026. augusztus 11-i specifikáció új kódja a TOO_MANY_REQUESTS (HTTP 429, Retry-After fejléccel).
  • Kötegméret: egy manageInvoice hívásban legfeljebb 100 számlaművelet, egy manageAnnulment hívásban legfeljebb 100 technikai érvénytelenítés küldhető.
  • Hash-ek: a kérés aláírása (requestSignature) SHA3-512, a jelszó-hash (passwordHash) SHA-512; a 3.0-ban a cryptoType attribútum kötelező.
  • Kulcsok: a technikai felhasználóhoz XML aláírókulcs (a kérések aláírásához) és XML cserekulcs (a token visszafejtéséhez) tartozik; ezeket a technikai felhasználó létrehozásakor kell generálni.
  • 2026-os validációs változások: a NAV 2026. január 1-jétől új hibát (79 — szóköz az eredeti számla sorszámának elején vagy végén) és szigorításokat vezetett be: a 691-es figyelmeztetésből hiba lett, a 11401-es új figyelmeztetés később hibává válik. Egy két évvel ezelőtt írt integráció ezeken elakadhat.
Tipikus megoldások

Amit leggyakrabban építünk

  1. 01

    Saját ügyviteli rendszer + NAV

    Egyedi ügyviteli rendszerből kiállított számlák automatikus beküldése, státuszkövetéssel és hibajelzéssel.

  2. 02

    Bejövő számlák automatikus feldolgozása

    A szállítói számlák adatainak napi lekérdezése, összevezetése a megrendelésekkel, és továbbítása a könyvelés felé.

  3. 03

    Számlázó szolgáltatás + felügyelet

    Ha a beküldést a számlázó szolgáltatás végzi, egy háttérfolyamat figyeli a NAV-státuszokat, és jelez, ha valamelyik számla elakadt.

Buktatók

Amire egy NAV Online Számla-integrációnál figyelünk

  1. 01

    A sikeres válasz még nem siker

    A HTTP 200-as válasz akkor is megjöhet, ha az üzenetben üzleti hiba van; a teljesítést a számlánkénti feldolgozási eredmény igazolja.

  2. 02

    Időtúllépés és dupla beküldés

    Időtúllépés után nem szabad vakon újraküldeni: előbb ellenőrizni kell, hogy a beküldés megérkezett-e, és csak akkor ismételni, ha hiányzik.

  3. 03

    Szigorodó ellenőrzések

    A NAV a 2026-os rendszerkiadásokkal szigorított: egy korábbi figyelmeztetésből blokkoló hiba lett, és új blokkoló hiba szűri a hibás eredeti számlaszámra hivatkozó módosításokat. A régebbi integrációkat érdemes átnézni.

  4. 04

    Adatminőség és eÁFA

    A NAV a számlaadatokból készíti az eÁFA-bevallási tervezeteket, ezért a hibás vagy hiányos adatok később a bevallásnál ütnek vissza.

  5. 05

    Kulcsok kezelése

    A teszt- és éles kulcsok nem cserélhetők fel; a kulcsokat titkosítva, a kódtól elkülönítve tároljuk.

Gyakori kérdések

Kell saját NAV-kapcsolat, ha számlázóprogramot használunk?
Általában nem: a legtöbb számlázó szolgáltatás maga küldi be az adatokat, ha összekötöd a NAV-fiókoddal. Saját kapcsolat akkor kell, ha saját fejlesztésű rendszer állít ki számlát, vagy a bejövő számlákat szeretnéd automatikusan feldolgozni.
Létezik már új, 4.0-s interfész?
A NAV hivatalos dokumentációja szerint a jelenlegi interfészverzió a 3.0, és új verziót csak jogszabályváltozás vagy jelentős igény esetén terveznek. A 3.44-hez hasonló számok rendszerkiadások, nem új interfészverziók.
Ki felel a beküldésért, ha a számlázó szolgáltatás küldi?
A számlakibocsátó. A szolgáltató végzi a technikai beküldést, de a felelősség a tiéd marad — ezért érdemes figyelni a beküldések eredményét.

NAV Online Számla-integráció: kérj ajánlatot

Írd meg, milyen rendszereket használsz és mit szeretnél automatizálni — egy rövid, ingyenes egyeztetés után írásos, tételes ajánlatot adunk.

Ajánlatot kérek