NAV Online Számla integráció saját rendszerhez 2026 · útmutató

A NAV Online Számla v3 már nem opció — minden magyar B2B számlát ide kell beadni 4 napon belül. A v3 séma 2024 óta él, és 2026-ra már a régebbi rendszerek is elavultak. Ez az útmutató bemutatja, hogyan integrálj saját rendszert (webshop, ERP, számlázó) a NAV Online Számlához.

1. lépés · Technikai felhasználó regisztráció

Ez nem ugyanaz, mint az ügyfélkapu! A NAV Online Számla rendszerében külön kell technikai felhasználót regisztrálnod. Belépés cégkapus aláírással, majd „Adóügyek > Online Számla > Felhasználók” menü, „Technikai felhasználó hozzáadása”. Kapsz egy felhasználónevet, jelszót, aláírókulcsot és cserekulcsot. Ezeket a fejlesztő rendszer használja a beadáshoz. Tárold biztonságosan.

2. lépés · Teszt-környezet

A NAV ad egy teszt-környezetet (api-test.onlineszamla.nav.gov.hu), ami minden élesben létező funkciót tud, de nem kerül be a rendszerbe. Itt teszteld a beadást, az aláírást, a hibakezelést. Mielőtt élesbe mész, a teszt-környezetben legyen 100 sikeres beadás és minden hibakód kipróbálva. A v3 séma szigorú, az XSD-validáció nem bocsát meg.

3. lépés · A beadási folyamat

1. Számla XML összerakás (v3 séma szerint). 2. SHA3-256 hash kiszámítás. 3. SHA-512 aláírás a fejlesztő-aláírókulccsal. 4. POST küldés a /tokenExchange végpontra (token kérés, 5 perces érvényesség). 5. POST küldés a /manageInvoice végpontra (max 100 számla egy kötegben). 6. Tranzakció-ID megérkezik. 7. POST a /queryTransactionStatus-ra (a NAV 2-30 másodperc alatt visszaadja a státuszt). 8. Ha hibás, javítsd, ha jó, mentsd el a tranzakció-ID-t és a státuszt.

4. lépés · Hibakezelés

A NAV gyakori hibakódjai: TAXNUMBER_INVALID (rossz adószám), CUSTOMER_VAT_STATUS_INVALID (rossz vevő-adóstátusz), INVOICE_NUMBER_NOT_UNIQUE (duplikált számlaszám), DOCUMENT_DATE_INVALID (rossz teljesítési dátum). Mindegyikre legyen automatikus újra-próbálkozás vagy emberi figyelmeztetés. A hibás számlát 4 napon belül javítani és újra beadni kell.

5. lépés · Élesedés és felügyelet

Élesben (api.onlineszamla.nav.gov.hu) ugyanaz a folyamat. Mindenképp legyen monitorozás: ha a NAV API 5+ percig nem válaszol, riasztás megy. Ha 4 napon belül nincs sikeres beadás, automatikus emberi figyelmeztetés. A NAV szolgáltatás 99.5%-os elérhetőséggel dolgozik — gyakran van karbantartás éjszaka.

Reális költségek 2026-ban

• Egyszerű webshop NAV-integráció (Shopify, WooCommerce): 800 000 – 1 600 000 Ft, 3-5 hét
• Saját SaaS / ERP NAV-integráció (összetettebb folyamat): 1 600 000 – 3 200 000 Ft, 5-8 hét
• Vállalati ERP NAV-integráció (több-cégű, multi-currency): 3 000 000 – 6 000 000 Ft, 8-12 hét
• Évi karbantartás (NAV séma-frissítések, hibajavítás): 200 000 – 600 000 Ft / év

Tippek a buktatókhoz

• A v3 séma minden évben kicsit változik (2024, 2025, 2026 mind eltér). Tervezd be a karbantartást.
• A teljesítési dátum nem ugyanaz, mint a számla-kelte. Sokszor összekeverik.
• EU-fordított áfás (reverse-charge) számláknál különleges mezők kellenek.
• Sztornó és módosító számláknál a hivatkozott számlaszám kötelező.
• Az aláíró-kulcs lejár — figyelni kell a frissítést.

Tovább

Ha a saját rendszerednek NAV-integráció kell, foglalj egy 30 perces hívást — átnézzük a folyamatodat, és írásban kapsz reális becslést scope-pal és határidővel együtt.