NAV M2M: gépi kapcsolat a NAV rendszereivel

A NAV M2M API: a NAV által fejlesztett, interneten webszolgáltatásként elérhető, gépi hozzáférésre tervezett publikus és nem publikus szolgáltatások gyűjteménye.

A NAV M2M API a NAV által fejlesztett, interneten webszolgáltatásként elérhető, gépi hozzáférésre tervezett szolgáltatások gyűjteménye. Nem közvetlen emberi használatra készült: kliensprogram csatlakozik hozzá.

Szakmai szerző: Kovács András

Gyakori félreértés: Nem azonos az eÁFA M2M-mel. Külön a fogalomkészletük is: a NAV M2M nem ismeri a „technikai felhasználó” fogalmát, itt kliensprogram-regisztráció és felhasználói regisztráció van.

Mi csatlakozik hozzá

A kliensprogram lehet ERP-rendszer, könyvelő-, bérszámfejtő vagy személyügyi program — a NAV fogalomtára nem köti technikai kialakításhoz. Ez azt is jelenti, hogy a gépi csatorna nem feltétlenül igényel saját fejlesztést: egy erre felkészített program is használható.

Hogyan lesz hozzáférés — a NAV sorrendje

A kliensprogram fejlesztője elvégzi a kliensprogram-regisztrációt, és a kliensprogram-azonosítót eljuttatja az ügyfeleinek
Az ügyfél ezzel az azonosítóval elvégzi a felhasználói regisztrációt, és megkapja az API Key-t
Az API Key-t rögzíti a kliensprogramban; a program ebből és a nonce beváltásából állítja össze az aláíró kulcsot
Az ügyfél rendelkezik a megfelelő képviseleti jogosultsággal arra az adózóra, akinek a nevében eljár

Itt nincs technikai felhasználó

A „technikai felhasználó” az eÁFA-rendszer fogalma: ott az elsődleges felhasználó hozza létre a felhasználókezelőben. A NAV M2M interfész-specifikációi ezt a kifejezést nem használják.

A NAV M2M-ben a megfelelője a felhasználói regisztráció és az abból származó API Key. Ha egy leírás a NAV M2M-hez technikai felhasználót emleget, az az eÁFA fogalmait keveri ide.

Bizonylatfogalmak

A NAV M2M-ben a beküldés tárgya a bizonylat: a kliensprogramban kitöltött, a felhasználó nevében beküldött nyomtatvány. Egy bizonylat részbizonylatokra bontható — nagyjából úgy, ahogy egy papírnyomtatványnak lapjai vannak —, és csatolmány részbizonylatonként kapcsolható hozzá.

A típusok kóddal azonosítottak. A NAV példái: bizonylattípusra a T1042E, részbizonylat-típusra az áfabevallás főbizonylatának 65A kódja.

Régi és új formátumú bizonylatok

A régi formátumúak — amelyek az ÁNYK-n keresztül is beküldhetők — minden bizonylatra nézve egy közös XSD-n alapulnak, és mezőkódlistát tartalmaznak. Az új formátumúak bizonylatonként egyedi XSD-vel rendelkeznek, és a számított mezők kalkulációját, valamint a validációt XSLT-alapú műveletek támogatják, amelyek akár a kliens gépén is lefuttathatók.

A nyomtatvány repository nyilvános tárhely: nyomtatványtípusonként és -verziónként tartalmazza az XSD-, kalkulációs és validációs fájlokat. Fejlesztésnél ez az elsődleges hivatkozási pont.

Gyakori kérdések

A NAV M2M ugyanaz, mint az eÁFA M2M?

Nem. A NAV M2M az általános gépi űrlap- és adatkapcsolat, az eÁFA M2M pedig kifejezetten az áfabevallás interfésze. Külön fogalomkészlettel és külön dokumentációval.

Kell-e technikai felhasználó a NAV M2M-hez?

Nem. A technikai felhasználó az eÁFA-rendszer fogalma. A NAV M2M-ben kliensprogram-regisztráció, majd felhasználói regisztráció történik, amelynek eredménye az API Key.

Hol érhető el a dokumentáció?

A NAV nyilvános tárhelyén: az interfész-specifikációk a docs/spec, a REST OpenAPI-leírások az src/REST könyvtárban.

Csökkenti-e a gépi csatorna a szakmai felelősséget?

Nem. Az adat előkészítése, ellenőrzése és jóváhagyása az adózó oldalán marad; a gépi kapcsolat a beküldés módját változtatja meg, nem a felelősséget.

Kapcsolódó fogalmak

Kapcsolódó útmutatók

Forrás: NAV: M2M általános interfész-specifikáció 0.4 — fogalomjegyzék

A leírás tájékoztató jellegű, nem minősül adótanácsadásnak.