NAV Online Számla integráció — gyakorlati útmutató

Mi a NAV Online Számla?

A NAV Online Számla (OSA) egy valós idejű adatszolgáltatási rendszer: minden 100 000 Ft áfatartalom feletti belföldi B2B számlát kötelező bejelenteni a NAV szerverének a kiállítástól számított 5 napon belül (az eredeti szabályozás 24 és 4 napos határidőket is tartalmazott, a hatályos küszöb 2026-ban ellenőrizze a nava.gov.hu oldalon).

Gyakorlatilag: ha a számlázóprogram vagy a könyvelőprogram nincs összekötve a NAV API-val, manuálisan kell feltölteni az adatokat — ami időigényes és hibalehetőséges.

Hogyan működik az API?

A NAV Online Számla API (jelenleg 3.0-s verzió) XML-alapú REST interfész. A számlabejelentés menete:

1. XML generálás — a számlaadat egy XSD-sémának megfelelő XML-fájlba kerül.
2. Aláírás — az XML-t SHA3-512 hash-sel kell aláírni a technikai felhasználó jelszavával.
3. Token igénylés — a NAV szervere egyszeri tokent ad ki.
4. Beküldés — a token segítségével elküldhető a számlacsomag (1–100 számla egyszerre).
5. Visszajelzés polling — aszinkron visszajelzés: a rendszer néhány másodperc múlva lekérdezi a feldolgozás eredményét.

Az integráció megvalósítása tapasztalt fejlesztőnek 2–5 nap, de érdemes figyelembe venni a NAV sandbox és éles környezet közötti különbségeket, a hibakezelési és újraküldési logikát.

Mit kell tudni az adatszolgáltatásról?

• Küszöbösszeg: minden belföldi B2B számlát be kell jelenteni (az áfatartalom összegétől függetlenül az előírás pontosítódott, 2026-ban szintén ellenőrizze a hatályos jogszabályt).
• Módosítás és sztornó: ha a számlát módosítják vagy sztornózzák, azt is be kell küldeni.
• Lekérdezés: a vevő is le tudja kérdezni a NAV rendszeréből, mit adott be a szállítója — ami átláthatóbbá teszi az üzleti kapcsolatokat.

Hogyan integrálható a könyvelőprogram?

Három megközelítés létezik:

1. Beépített integráció

A modern könyvelőprogramok (pl. a DevTools könyvelőprogramja) rendelkeznek beépített NAV Online Számla integrációval — a számla rögzítésekor vagy jóváhagyásakor automatikusan beküldik az adatot a NAV szervere felé, és visszajelzést adnak a sikeres feldolgozásról.

2. Közvetítő szoftver (middleware)

Ha a könyvelőprogram nem rendelkezik NAV integrációval, közvetítő szoftverre van szükség, amelyik az exportált számlafájlokat (jellemzően XML vagy CSV) feldolgozza és bejelenti.

3. Egyedi integráció fejlesztése

Ha egyedi ERP-rendszerből vagy webáruházból kell számlákat bejelenteni, a fejlesztőcsapatnak kell implementálni a NAV API-t. Ez nem bonyolult, de precíz XML-sémát és hibakezelést igényel.

Tipikus hibák és hogyan kerülje el

• Schema-validációs hiba — az XML nem felel meg a NAV XSD-sémájának. Megoldás: automatizált validáció a beküldés előtt.
• Duplikált beküldés — ugyanaz a számlaszám kétszer kerül be. Megoldás: idempotens beküldési logika, számlaszám alapú dedup.
• Token lejárat — a token csak néhány percig érvényes, lekéréstől a beküldésig gyorsan kell haladni.
• Hibás adatszolgáltatás — ha a mező kitöltése nem egyezik a számla tartalmával. Megoldás: szigorú tesztelés sandbox környezetben.

Összefoglalás

A NAV Online Számla integráció ma már alapkövetelmény minden vállalati szintű könyvelőprogramban. Ha a jelenlegi rendszere nem kezeli automatikusan, érdemes vagy frissíteni, vagy egyedi integrációt fejlesztetni.

Vegye fel velünk a kapcsolatot — megnézzük, hogyan lehet a meglévő rendszeréhez a legegyszerűbben csatlakoztatni a NAV API-t.

Kapcsolódó oldalak:

• Könyvelőprogram részletes leírás
• Egyedi szoftverfejlesztés