Az AdózóSegédnek van egy úgynevezett API-ja: ezen keresztül egy másik program (például a webshopod, a könyvelőprogramod vagy egy saját táblázat) le tudja kérdezni az adataidat, és ha megengeded, számlát is kiállíthat a nevedben. Így például a webshopod minden rendelés után magától kiállíthatja a számlát az AdózóSegédben, és az rögtön bekerül a keretedbe és a NAV-hoz.

Ehhez a programnak egy API-kulcs kell. A kulcsot te készíted, és bármikor visszavonhatod.

Kulcs készítése

Lépj be az AdózóSegédbe, és nyisd meg a Beállítások → API-kulcsok oldalt.
Kattints az Új kulcs gombra.
Adj neki nevet, hogy később tudd, melyik programé (például „Webshop”).
Ha a program számlát is kiállít, kapcsold be a Számlát is kiállíthat kapcsolót. Ha csak adatot kérdez le, hagyd kikapcsolva.
Kattints a Létrehozás gombra, majd a Másolás gombbal másold ki a kulcsot, és add meg a programban (vagy küldd el a program készítőjének).

A kulcs csak egyszer jelenik meg. Ha elveszted, vond vissza, és készíts újat. Programonként érdemes külön kulcsot készíteni: így egyenként vonhatod vissza őket.

Mit lát és mit tehet a program?

Amit lekérdezhet: a vállalkozásod alapadatait és adózási módját, a számláidat (a NAV-ból letöltötteket és az AdózóSegédben kiállítottakat), a vevőidet, a bevételi nyilvántartásodat, a kereteidet és az adóidat, a kézi bevételeidet, az Adónaptár befizetéseit az utalási adatokkal, és a határidőket.

Amit nem lát: a jelszavadat, a NAV technikai felhasználó adatait és kulcsait, a NAV-adószámla kulcsát, és a bevallás fejlapjához megadott személyes adataidat (születési adatok, anyja neve, adóazonosító jel).

Amit tehet, ha bekapcsoltad: számlát állíthat ki, ugyanazokkal az ellenőrzésekkel, mint itt a felületen. A számlán a te adataid szerepelnek, sorszámot kap, rögtön beküldjük a NAV-nak, és ha a program kéri, e-mailben elküldjük a vevőnek. Ha régi KATA alatt a vevő cégnek vagy egyéni vállalkozónak számít, a programnak külön jeleznie kell, hogy tudomásul vette a figyelmeztetést.

Amit nem tehet: számlát nem sztornózhat és nem módosíthat, bevallást nem küldhet be, a beállításaidhoz, a NAV-kapcsolathoz és az előfizetésedhez nem nyúlhat. A kiállított számlát a felületen, a számla adatlapján tudod sztornózni.

Mindig csak a te vállalkozásodhoz fér hozzá. Más felhasználó adatát a kulcs semmilyen módon nem éri el.

Mire figyelj?

A kulcs olyan, mint egy jelszó: aki ismeri, a programodként fér hozzá az adataidhoz. Ne tedd közzé, és ne küldd el olyannak, akiben nem bízol.
A számlakiállítási jogot csak olyan programnak add meg, amelyikben megbízol: a kiállított számla rögtön a NAV-hoz kerül, és utána csak sztornózni lehet.
Ha a kulcs illetéktelen kezébe kerülhetett, azonnal vond vissza.

A kulcs visszavonása

A Beállítások → API-kulcsok oldalon a kulcs mellett a Visszavonás gombbal. A visszavonás azonnal hat: a program onnantól nem fér hozzá az adataidhoz.

A kulcsaid magától is megszűnnek, ha új jelszót állítasz be (vagy elfelejtett jelszót állítasz vissza), és ha a fiókod törlését kéred. Ilyenkor a programokhoz új kulcsot kell készítened.

Ha lejár az előfizetésed

A kulcsaid előfizetés nélkül nem működnek: minden kérésre 402-es választ kapnak, és új kulcsot sem készíthetsz. A kulcsok megmaradnak, előfizetés után ugyanazok működnek tovább.

A program készítőjének

Az API leírása, a példákkal együtt, az Integráció oldalon és az API-dokumentációban van. Ezt a két linket küldd el a programod készítőjének: minden rajta van, amiből az összekötés elkészíthető.

Gyakori kérdések

Kerül valamibe az API? Nem, az előfizetés része.

A bemutató fiókhoz is készíthetek kulcsot? Nem. A bemutató fiók közös és csak nézhető; kulcsot a saját fiókodhoz készíthetsz.

Mi a különbség az API és az AI-asszisztens között? Az AI-asszisztens (ChatGPT, Claude) kulcs nélkül, bejelentkezéssel kapcsolódik, és csak kérdezni lehet tőle. Az API programoknak szól, kulccsal működik, és számlát is kiállíthat.

Mi történik, ha a program kétszer küldi el ugyanazt a számlát? Ha a program jól van megírva (minden számlához saját azonosítót küld), a második kérésből nem lesz második számla. Ha mégis kétszer került ki egy számla, az egyiket sztornózd a felületen.