NAV technikai felhasználó beállítása (lépésről lépésre)

Áttekintés

A TACITo a NAV Online Számla API-n keresztül küldi be a számlaadatokat. Ehhez a NAV rendszerében létre kell hoznod egy technikai felhasználót (API felhasználó), és a hozzá tartozó kulcsokat be kell másolnod az alkalmazásba.

1) Technikai felhasználó létrehozása a NAV Online Számla felületen

1. Lépj be a NAV Online Számla felületére a megfelelő környezetben (teszt vagy éles).
2. Válaszd ki a vállalkozást/adóalanyt, amelyhez a számlázást szeretnéd bekötni.
3. Nyisd meg a Technikai felhasználók menüpontot, majd kattints az Új technikai felhasználó létrehozására.
4. Add meg a technikai felhasználó login nevét (felhasználónév) és állíts be egy erős jelszót.
5. Jogosultságoknál engedélyezd a számlaadat-szolgáltatáshoz szükséges hozzáféréseket (a NAV felületen elérhető opciók szerint).

2) Kulcsok kimentése (aláíró kulcs és cserekulcs)

1. A technikai felhasználó létrehozásakor (vagy a részleteinél) a NAV megjelenít két kulcsot:
   • Aláíró kulcs (Signing key)
   • Cserekulcs (Exchange key)
2. Másold ki és mentsd el biztonságos helyre mindkettőt. Ezeket a kulcsokat titokként kell kezelni.

3) Beállítás a TACITo-ban

1. Nyisd meg: Beállítások (fogaskerék) → NAV Online Számla.
2. Állítsd be a Környezet mezőt:
   • test: NAV teszt technikai felhasználó adataival
   • production: NAV éles technikai felhasználó adataival
3. Töltsd ki a mezőket (NAV-ból másolva):
   • Technikai login (felhasználónév): a NAV technikai user login
   • Technikai jelszó: a NAV technikai user jelszó
   • XML aláírókulcs (signing key): NAV aláíró kulcs
   • XML cserekulcs (exchange key): NAV cserekulcs
4. Kattints: Mentés.
5. Megjegyzés: Mentés után a jelszó és kulcsok nem jelennek meg vissza (titkos adatok). Ha meg vannak adva, a mezőkben xxxxxxxx placeholder látszik.
6. Majd kattints: Kapcsolat teszt (tokenExchange). Siker esetén megjelenik a “NAV kapcsolat OK” és az érvényességi idő.

Gyakori hibák

• Rossz környezet: a teszt kulcsok nem működnek élesben és fordítva.
• Elgépelés: a jelszó/kulcsok pontosan, szóköz nélkül legyenek bemásolva.
• Nincs beállítva titkosítás a szerveren: ha a rendszer jelzi, hogy a NAV adatok titkos tárolásához nincs beállítva a kulcs, jelezd az üzemeltetőnek (szerver oldali TACIT_MASTER_KEY szükséges).
• „Magánszemély vevő adatai nem adhatóak meg”: ha a vevőnek nincs adószáma (magánszemély), a NAV felé nem küldhetünk vevő nevet/címet. A TACIT ezt automatikusan kezeli, de ha régebbi számlánál ilyen hibát látsz, hozz létre új számlát és próbáld újra.