NAV M2M regisztráció kliensprogramokhoz és felhasználókhoz

Az M2M regisztráció a NAV Ügyfélportálon (ÜPO) történik. A NAV M2M használatához előbb a kliensprogramot kell regisztrálni, majd ehhez kapcsolódhat a természetes személy vagy szervezet. A felhasználói regisztráció után kapott API-kulcsot 72 órán belül aktiválni kell.

Melyik M2M regisztráció kell neked?

A NAV-nál két külön gépi csatorna van, két külön regisztrációval. Az egyik nem helyettesíti a másikat.

Kliensprogram-regisztráció

Ügyviteli vagy könyvelőprogramot kapcsolsz a NAV M2M csatornához, és még nincs kliensprogram-azonosítód.

Ki végezheti: A regisztrációt egyéni vállalkozó vagy a kliensprogram fejlesztéséért felelős szervezet törvényes képviselője végezheti el. A NAV nem köti meghatározott tevékenységi körhöz, ezért saját célra fejlesztő szervezet is regisztrálhat.

Mire jó: A kliensprogram és a fejlesztésért felelős adózó NAV-oldali azonosítása, valamint a felhasználói regisztrációhoz szükséges kliensprogram-azonosító létrehozása.

  1. 1. Jelentkezz be a megfelelő ÜPO-profillal

    NAV Ügyfélportál (ÜPO)

    Ha szervezet képviselőjeként regisztrálsz, bejelentkezés után válaszd ki a képviselt szervezet profilját, és abból indítsd el a kliensprogram-regisztrációt.

    Figyelem: Ha nem a megfelelő ÜPO-profilból indítod a folyamatot, a regisztráció másik adózóhoz kapcsolódik. Indítás előtt ellenőrizd a kiválasztott profilt.

  2. 2. Nyisd meg az M2M regisztrációt

    ÜPO kezdőoldal → További ügyintézési lehetőségek → M2M regisztráció

    Az M2M regisztráció csempét az ÜPO kezdőoldalán, a „További ügyintézési lehetőségek” között találod. Eléréséhez lejjebb kell görgetned az oldalon.

  3. 3. Válaszd a „Fejlesztők számára” lehetőséget

    M2M regisztráció → Fejlesztők számára → Regisztráció kezelése

    A megjelenő lehetőségek közül válaszd a „Fejlesztők számára” csempét, majd kattints a „Regisztráció kezelése” gombra.

    Figyelem: Ez nem azonos a „Felhasználó regisztráció” csempével. A kettő két külön regisztráció, két külön eredménnyel.

  4. 4. Indíts új kliensprogram-regisztrációt

    „Új regisztráció” lap

    A felület először a korábbi regisztrációkat mutatja. Új kliensprogram rögzítéséhez válts az „Új regisztráció” lapra.

    A kliensprogram fejlesztéséért felelős adózó neve és adószáma automatikusan megjelenik az ÜPO-profil alapján. Csak a szabadon megadható „Regisztráció elnevezése” mezőt kell kitöltened.

  5. 5. Fogadd el a feltételeket, majd küldd be

    Tekintsd át és fogadd el az Általános szerződési feltételeket, a nyilatkozatokat és az Adatvédelmi tájékoztatót, majd küldd be a regisztrációt.

    Eredmény: A regisztrációt végrehajtó természetes személy tárhelyére értesítés érkezik a regisztrációról és a szükséges jelszavakról.

  6. 6. Vedd át az azonosítót és a jelszót

    A kliensprogram-jelszó az a titkos kód, amely a NAV M2M API-szolgáltatásában egyedileg azonosítja a kliensprogramot.

    A kliensprogram-azonosító ezzel szemben megosztható: erre fog hivatkozni minden végfelhasználó a saját felhasználói regisztrációja során.

    Figyelem: A NAV soha nem kéri el a kliensprogram-jelszót — sem ügyintézéskor, sem más esetben. A jelszó biztonságos kezelése annak a feladata és felelőssége, aki a regisztrációt elvégezte.

Felhasználói regisztráció

Természetes személyként vagy szervezet képviselőjeként már regisztrált kliensprogramon keresztül szeretnél bizonylatot beküldeni.

Ki végezheti: Bármely természetes személy regisztrálhat. Szervezet esetén a regisztrációt a szervezet képviselője indíthatja el a képviselt szervezet ÜPO-profiljából.

Mire jó: A természetes személy vagy szervezet összekapcsolása azzal a regisztrált kliensprogrammal, amelyen keresztül a NAV M2M bizonylatbeküldés történik.

  1. 1. Kérd el a kliensprogram-azonosítót

    A felhasználói regisztrációhoz szükséged lesz a kliensprogram tulajdonosától vagy a szoftverszállítódtól kapott kliensprogram-azonosítóra.

    Figyelem: A kliensprogram-azonosítóra van szükséged, nem a jelszóra. A bizalmas kliensprogram-jelszó a fejlesztőnél vagy az üzemeltetőnél marad.

  2. 2. Jelentkezz be a megfelelő ÜPO-profillal

    NAV Ügyfélportál (ÜPO)

    Szervezeti regisztrációhoz bejelentkezés után válaszd ki a képviselt szervezet profilját, és abból indítsd el a folyamatot.

  3. 3. Nyisd meg az M2M regisztrációt

    ÜPO kezdőoldal → További ügyintézési lehetőségek → M2M regisztráció

    Az M2M regisztráció csempét az ÜPO kezdőoldalán, a „További ügyintézési lehetőségek” között találod. Eléréséhez lejjebb kell görgetned az oldalon.

  4. 4. Válaszd a „Felhasználó regisztráció” lehetőséget

    M2M regisztráció → Felhasználó regisztráció → Regisztráció kezelése

    A felület először a korábbi regisztrációkat mutatja. Új kapcsolat létrehozásához válts az „Új regisztráció” lapra.

  5. 5. Add meg a kliensprogram-azonosítót

    „Új regisztráció” lap

    Másold be a kliensprogram-azonosítót a megfelelő mezőbe. A rendszer ezután automatikusan megjeleníti a kliensprogramért felelős adózó adatait.

    A regisztrációnak szabadon választható nevet adhatsz.

    Figyelem: A kliensprogram-azonosítót add meg, ne a jelszót. A két érték nem helyettesíti egymást.

  6. 6. Hivatali regisztrációnál add meg a KRID-et

    Ha hivatali tárhellyel rendelkező szervezet képviselőjeként regisztrálsz, jelöld be a „Hivatalként regisztrál” mezőt, majd add meg a szervezet KRID-azonosítóját. A KRID-hez tartozó hivatal adatai automatikusan megjelennek.

    Erre a hivatali tárhelyre küldi a NAV az M2M csatornán beküldött elektronikus űrlapok elfogadó nyugtáit. Az űrlapbeküldési tranzakció során ettől eltérő KRID is megadható — ilyenkor a nyugta arra a tárhelyre megy, nem a regisztrációkor megadottra.

  7. 7. Fogadd el a feltételeket, majd küldd be

    Tekintsd át és fogadd el az Általános szerződési feltételeket, az Adatvédelmi tájékoztatót és a nyilatkozatot, majd küldd be a regisztrációt.

    Eredmény: A regisztrációt kezdeményező természetes személy vagy szervezet tárhelyére a NAV értesítést küld, amely tartalmazza a 72 órán belül aktiválandó API-kulcsot.

  8. 8. Aktiváld a hozzáférést 72 órán belül

    Add meg az API-kulcsot abban a kliensprogramban, amelyre a felhasználói regisztráció hivatkozik. A kliensprogram automatikusan elvégzi az aktiválást, majd használhatóvá válik a NAV M2M kapcsolat.

    Figyelem: A NAV soha nem kéri el az API-kulcsot. Ha a regisztrációt követő 72 órán belül nem történik meg az aktiválás, a regisztráció „lejárt aktiválási határidő” státuszt kap, és a felhasználói regisztrációt meg kell ismételni.

Az API-kulcs megadásától az aktív kapcsolatig

  1. 1. Az API-kulcs rögzítése A felhasználó rögzíti az API-kulcsot az ügyviteli szoftverben. A kulcs négy részből áll: felhasználóazonosítóból, felhasználói jelszóból, az aláírókulcs első feléből és a nonce-ból. A nonce egyszer használatos kód, amelyet az aláírókulcs második felére kell beváltani. Ettől a ponttól a folyamat automatikus.
  2. 2. Azonosítási token igénylése A szoftver tokent igényel a NAV szerverétől. A kapott úgynevezett phantom token kizárólag a nonce beváltására használható. A műveletet csak a felhasználói regisztrációban megadott kliensprogram végezheti el.
  3. 3. A nonce beváltása A phantom token birtokában a szoftver beváltja a nonce-ot. A NAV válasza tartalmazza az aláírókulcs második részét.
  4. 4. Az aláírókulcs összeállítása A szoftver összekapcsolja a NAV-tól kapott kulcsrészletet az API-kulcsban szereplő résszel. Az így létrejövő végleges aláírókulcsot bizalmasan kell tárolni: nem adható át a felhasználónak, harmadik félnek vagy a NAV-nak.
  5. 5. Az aktiválás lezárása A kliensprogram az összeállított kulccsal aláírja az aktiváló hívást. Sikeres hitelesítés után a kapcsolat aktívvá válik, a NAV pedig érvényteleníti a nonce-ot és az azonosítási tokent.

Tipikus hibák és közvetlen megoldásuk

Források

NAV M2M útmutató

NAV M2M eredmény- és hibakódok