Új Interfész publikálás - Adózói adatlekérdezési funkciók

[TamasPill]

Új funkciócsomag került publikálásra a tesztkörnyezetre, amivel az alábbi adatokat lehet lekérdezni egy adózóról:

• Összesített adószámla
• Tételes adószámla
• Köztartozás egyenleg
• Hiányzó bevallások listája
• Biztosítotti jogviszony lekérdezés

A lekérdezések indításakor képviseleti jogosultsággal kell rendelkezni a kezdeményező M2M usernek a lekérdezni kívánt adózóra, hasonlóan az Ügyfélportálos lekérdezésekhez.
A tesztkörnyezeten anonimizált adózókat lehet lekérdezni egy előre meghatározott halmazból, ehhez segítséget nyújt a Postman tesztcsomagba előre beállított paraméterek.

Dokumentáció: link
Interfész leíró: REST SOAP
Tesztállomány: link

A Biztosítotti jogviszony lekérdezése május 21-től fog teljes mértékben működni.

[kdenes6500]

Az új funkciók esetén mindig érvénytelen aláírás üzenetet kapunk vissza. A korábbi funkcióknál (beküldés) nincs ilyen probléma.

[TamasPill]

Az "operation" mint az aláírás képzés egyik összetevője melyik dokumentumból lett véve?
A régi és az új interfész specifikációban sem találom nyomát.

Az újonnan feltöltött specifikációban egyértelműen le van írva:
Aláírás. Felépítése: SHA256(++)

[sinick2]

Bocs! Inkább töröltem a hibás hozzászólást. (Nekem az aláírás harmadik tagjára egy közös változó van és hibás volt a kopipaszte.)

[kdenes6500]

Az adószámla lekérésénél csak az időszak vége adható meg (pl. 2025.06.10.). Ez alapján automatikusan kerül beállításra az időszak (pl. 2025.01.01.-2025.06.10.).
Lehetséges-e, hogy a lekérdezésben meg tudjuk adni a kezdő dátumot is? Pl. ha 2024.01.01.-2025.06.10. időszakra szeretném lekérni a folyószámlát.

[TamasPill]

Az időszak kezdete mindig automatikusan beállításra kerül az időszak vége szerinti év január 1-re.
Ahhoz, hogy több év adata kerüljön lekérdezésre, ahhoz több lekérdezést kell indítani, a fenti példa szerint lesz egy lekérdezés 2024.12.31. időszak végével és egy másik 2025.06.10. véggel.

[Szildiko]

A könyvelőknek szándékosan kell hogy 2024.01.01-től 2025.02.25-ig (de vége akár bármi), hogy a zárási folyamatok miatt, lássák a decemberi bevallásokat és a januári befizetéseket egy nyomtatási képen. Nagyon szeretik úgy lekérni, hogy az év eleje még rajta van az év végével!

[kmolitorisz]

Igaz, akor lenne igazán jól használható a lekérdezés, ha éven átnyúló időszak is lehetséges lenne...

[kdenes6500]

Időközben az ÜPO-n elérhetővé vált egy olyan beállítás, hogy akár egyben max. 5 évre visszamenőleg lehet lekérni a tételes adószámlát.
Ez a hasznos módosítás átvezetésre kerül-e az M2M-ben?

[kmolitorisz]

A "26892920" adóalany azonosítón kívül másra is lehet teszt lekérdezéseket csinálni az új inrterfésznél. Különösen a tételes adószámla érdekelne több lehetséges teszt adattal.

[sinick2]

Letölthető tesztcsomag van még egy "12452284" adóalany, de az még kevesebb adatot tartalmaz.

Engem olyan teszt adóalany érdekelne még, amiben van

elsősorban:

• kodLista
• konyvelesreVaroTetel

másodsorban:

• bhtlUzenet
• tetel-ben kitöltött aladonem, ellenszamlaKod, kotelezettsegAtvezetveForrasKod, teljesitesiDatum, tipus, penzforgalomAtvezetveForrasKod, penzforgalom

Köszönöm!

[kmolitorisz]

Köszi

[sinick2]

Köszönöm!

[noelbank00]

@TamasPill esetleg könyvelésre váró tétel-es adószám, illetve több amivel tesztelni lehet készült azóta?

[noelbank00]

Illetve, sajnos a fent említett adószámok egyikére sem fut le sajnos a kérés, minden esetben az alábbi hiba jön: {"resultMessage":"CEF-000-000 - [Nincs a feltételnek megfelelő tétel az adatbázisban!]","resultCode":"EGYEB_HIBA","tetelesAdoszamla":null}}

Amire hiba nélkül lefut: 26892920

[TamasPill]

Pedig hoznak adatokat a fenti teszt adózók.
Például a 8466704221, tetelTipus: KONYVELT_ES_KONYVELESRE_VARO, idoszakVege: 2025-08-25
hoz konyvelesreVaroTetel adatot is.

[kmolitorisz]

A kodLista listáinál a "kod" egyedi, vagy előfordulhat, hogy a különböző listákban ugyanaz a kód szerepel? Pl.: ha a "Pénzforgalmi tétel típusának megnevezése:" listában van "11"-es kód, akkor előfordulhat, hogy másik listában is lesz "11"-es kód?

[TamasPill]

Igen, ilyen előfordulhat a 10-es, 11-es érték esetén.

[kmolitorisz]

A közvetkező mezők hivatkoznak a kódlistára:
ellenszamlaKod, kotelezettsegAtvezetveForrasKod, penzforgalomAtvezetveForrasKod
Honnan tudom, hogy egy adott kódot melyik listában keressek? (a "név" mezőből?)

[sinick2]

Tisztelt Fejlesztők!

Az EGYEB_HIBA-król kérhetnék egy listát? Legalább azokról, amelyek bemenő paraméterezésből eredhetnek (adóazonosító, dátumok, tétel típusok, adónemkód, stb.). A dokumentációban nem találok erről infót. Most fontos hibák jönnek egyéb hibaként, pl. adózó nem található (CEF-000-004) vagy adott időszakban nincs tétel (CEF-000-000).

Köszönöm!

[TamasPill]

Hibakódok a tetelesAdoszamlaAdatatadas műveletek esetén:
CEF-000-001 Adóazonosító nincs megadva!
CEF-000-002 Ig dátum nincs megadva!
CEF-000-003 Hibás dátum!
CEF-000-004 ANYK vizsgálat hibaüzenetei, melyek továbbításra kerülnek.
CEF-000-005 A feldolgozás technikai okokból szünetel.
CEF-000-006 Nincs a feltételnek megfelelő könyvelt tétel az adatbázisban, a könyvelésre váró tételek lekérdezése technikai okokból nem lehetséges.
CEF-001-001 – Általános hibaüzenet

Hibakódok az osszesitettAdoszamlaAdatatadas művelete esetén:
CEF-001-001 – Általános hibaüzenet
CEF-000-002 Jelenleg a könyvelésre váró tételek lekérdezése technikai okokból nem lehetséges.
CEF-000-004 ANYK vizsgálat hibaüzenetei, melyek továbbításra kerülnek

[sinick2]

Köszönöm! Kérhetnék ilyen listát a többi végpontra is? Legfontosabb a BiztositottiJogviszonyFoglalkoztatoAdat végpont lenne most.

[TamasPill]

A többi interfész esetén a szakrendeszeri hibakódok egyértelműen vannak mappelve az M2M API-n definiált resultCode-dokkal, tehát elég azokat nézni.
Azért leírom a BiztositottiJogviszonyFoglalkoztatoAdat esetén mik lehetnek:
NINCS_ADAT ANK001 Nincs a szűrési paraméternek megfelelő jogviszony
FOGLALKOZTATO_NEM_TALALHATO ANK002 A foglalkoztató nem található
NINCS_BEJELENTETT_JOGVISZONY ANK004 A foglalkoztató az adott időszakra nem jelentett be jogviszonyt
NINCS_BENYUJTOTT_ADATLAP ANK009 A foglalkoztató nem nyújtott be egészségügyi szolgáltatási járulékfizetési kötelezettséggel kapcsolatos adatlapot

[sinick2]

Köszönöm!

[sinick2]

Tisztelt Fejlesztők!

A BiztositottiJogviszonyFoglalkoztatoAdat illetve BiztositottiJogviszonyFoglalkoztatoAdatStatusz végpontok teszteléséhez kérhetek olyan adóazonosítókat, ahol a válaszkód "folyamatban" és/vagy ahol használható a többlapos lekérdezés "pageNumber" paraméterezése?

Köszönöm!

[kmolitorisz]

Tisztelt Fejlesztők!
Elkezdtem tesztelni a BiztositottiJogviszonyFoglalkoztatoAdat és BiztositottiJogviszonyFoglalkoztatoAdatStatusz végpontokat. Nekem vagy sikerült letölteni az összes jogviszont a BiztositottiJogviszonyFoglalkoztatoAdat-al, vagy itt semmi nem jött és utána a BiztositottiJogviszonyFoglalkoztatoAdatStatusz -al egyeben az összes. Hogyan kell elképzelni a "pageNumber"- használatát, milyen esetek lehetségesek?

[TamasPill]

Ezt a folyamatot az M2M adózói adatok lekérdezése interfész specifikáció 4.2. Lekérdezés eredmény státusz lekérdezéssel fejezet tartalmazza.
Ha fél percen belül megérkezik a válasz, akkor a BiztositottiJogviszonyFoglalkoztatoAdat végpont visszaad egyben minden adatot.
Ha tovább tart a lekérdezés, akkor a request_id-t megadva a BiztositottiJogviszonyFoglalkoztatoAdatStatusz adja vissza az adatokat.
Ebben az esetben 1000 elemből álló oldal méret van használva. Tehát ennél több sorból kellene, hogy álljon a válasz, hogy több oldalt kelljen lekérdezni.

[kmolitorisz]

Köszönöm a választ.Sajnos nekem nem sikerült tesztelnem azt az esetet, amikor 1000 felett van a válaszban az elemek száma. A 10384345 adószámra max 1000 eem jön vissza (2000.01.01-2025.5.5), ha a 15939414 adószámot használom ugyanerre az periódusra, akkor viszont végig "FOLYAMATBAN"-t kapok vissza (legalábbis 15 percig). Milyen teszt paraméterekkel tudnám az 1000 feletti elemszámot tesztelni?

[TamasPill]

Ha az 10384345-ös adózóra lekérdezésre kerül ezekkel a paraméterekkel: ?lekerdezesiIdoszakKezdete=2000-01-01&lekerdezesiIdoszakVege=2025-11-05&jogviszonyTipus=MIND
Akkor 1002 elemű lista lesz a válasz, aminek a requesdId-jával meghívva a statusz lekérdezést pageNumber 1 értékkel, akkor úgy le fogja hozni azt a bizonyos 2 elemet.

[kmolitorisz]

OK, köszönöm, működik.

[treb00]

Mikorra várható az adófolyószámlánál a többéves lekérdezés?

[TamasPill]

A több éves lekérdezés az Ügyfélportálon úgy működik, hogy az éveken átívelő riport külön lekérdezésenként fut az eredmény pedig excel esetében évenként külön munkafüzeti lapokon, xml esetében évenként külön fájlként áll elő.
Ezt a fajta megoldást az M2M-en is meg lehet tenni, de az adatok összefűzése már a kliens feladata.
Tehát ezt az igényt nem támogatta a szakmai oldal.

[Szildiko]

A dokumentációban a 6.3.2. Tételes adószámla lekérdezés művelet fejezetben találtam olyan részt, hogy Penzforgalom attribútumai deviza és Deviza attribútumai. Erről szeretnék bővebb információt kapni, hogy a lekérdezés vissza adja, hogy milyen devizában történt valami? Ha igen erre lehet kapni minta adószámot lekérdezéshez? Ez arra készült, hogy a TAO-t lehet devizában utalni?

[sinick2]

Rendben, köszönöm! (Nekem most az volt a lényeg, hogy a deviza esetén a külső összeg forint, a belső meg deviza és nem fordítva.)

[Szildiko]

A tesztkörnyezeten az alábbi adózókkal lesznek devizás adatok is: 25022870, 12380880.
én ma megpróbáltam megint lekérni a 25022870-es adószámot lekérni, ezt kapom vissza:

Hiba történt az adózó összesített adószámla lekérdezése során:

EGYEB_HIBA - CEF-000-004 - [A116, A törzsszám nem található a Partner-SBANK-ban!]

Visszakaphatom a teszt adatot? A devizás dolgok miatt és mert ennek a pénzforgalmi tétel típusában betű volt, szám helyett.

[TamasPill]

A tesztkörnyzeten jelenleg a 12380880, 10609112-es adózóval lehet deviza adatokat lekérdezni a 2026-os évre.
A 25022870-es nem fog még működni.
Ez frissítésre fog kerülni a Postman tesztcsomagban is.

[Ferenc-Piller]

Amennyiben megadtam a signature paramétert is, úgy kaptam választ.

[Szildiko]

Még egy kis segítséget szeretnék kérni. Kicsit zavaros nekem az M2M.
A bevallások beküldésére, ha jól értem csak a cég regisztrálhat és csak a saját bevallásait kezelheti, a bevallás beküldésnél nincs "könyvelői szervezet" regisztráció, hogy a könyvelő iroda a könyvelt cégeinket a bevallását beküldhesse?

Viszont az adózói lekérdezés funkciónál elég a könyvelő irodának megcsinálni az M2M regisztrációt, és akkor ő az adózói lekérdezéseket bármelyik könyvelt cégére lekérheti? Ennél nem kell a könyvelt cégnek is M2M regisztrációt csinálnia?

[TamasPill]

A bevallások beküldését is lehet képviseleti jog/meghatalmazás alapján végezni, tehát a könyvelő iroda közvetlenül megteheti az ügyfelei nevében.
https://nav.gov.hu/ugyfeliranytu/eljarasi-kerdesek/a-nav-elotti-kepviselet-bejelentese

[noelbank00]

Egyéni vállalkozó adatait (biztosítotti jogviszony, adófolyószámla) lekérdezése nem működik adószám alapján, NINCS_JOGOSULTSAG hibára fut a válassz, viszont ha az egyéni vállalkozó magánszemély adóazonosító jelével indítom a lekérdezést akkor megjön a tökéletes válassz, ez miért van?

[Szildiko]

Pont mi is most néztük egy könyvelő ismerőssel az ÜPO felületét, ő olyasmit mondott ha meghatalmazást ad le egyéni vállalkozóra, akkor csak az adóazonosító jelére tudja leadni, és így az ÜPO-s lekérdezésekben is az adóazonosító jele szerepel.

[noelbank00]

@TamasPill esetleg ha van időd kérlek nézz rá erre is.

[TamasPill]

A fenti jelenség abból a körülményből fakad, hogy a meghatalmazás egyéni vállalkozó esetén is magánszemélyként van kezelve.
Ettől függetlenül az adatok teljeskörűek és használhatóak.

[Macskafarka]

Kedves @TamasPill Akkor ezt sürgősen meg kell oldani, mert ez GDPR incidens. Ugyanis az egyéni vállalkozónak az egyéni vállalkozói minőségével kapcsolatos dolgai és adatai elkülönített kezelést igényelnek, sőt a nem vállalkozói minőségében végzett dolga és adatai pedig GDPR védelmet élveznek. Erre az elkülönítésre való az adószám is. Indokolatlan jogsérelmet okoz, és GDPR incidens az, ha az egyéni vállalkozó csak úgy tud másokat meghatalmazni a vállalkozásával kapcsolatos dolgokra, és adatok kezelésére, ha a teljes magánszemélyi dolgaira és adatainak kezelésére is meghatalmazza. Ezt a kényszerítető NAV gyakorlatot mihamarabb meg kell változtatni. Ha jogszabályon alapulna, akkor a jogszabály ezen részét kell hatályon kívül helyezni sürgősen.

[TamasPill]

Annyit pontosítanék, hogy a meghatalmazást az UJEGYKE adatlapon a magánszemély csak az adóazonosítójelén tudja bejelenteni, adószám alapján nem. Ez azért van, mert egy magánszemélynek több adószáma is lehet idővel, de így lehet csak folytonosságot teremteni.
A jogosultságok beállításánál lehetőség van részletesen megadni, hogy információkhoz férhet hozzá a meghatalmazott.

[laszlo90]

Üdvözlöm!
Az Adózói adatlekérdezési funkciók működnek már éles környezetben is vagy még nem?

[TamasPill]

Már élesen is elérhetőek.

[bertalanv]

Kedves Tamás!
Elkérhetnénk a tételes adószámla „Pénzforgalmi tétel típusának" tipus kódok teljes listáját (különsképp a 05-ös és 06-os kód jelentését), mivel azok a dokumentációban nem találhatóak, az éles rendszerből érkező válaszokban pedig eddig csak a 01, 02, 03, 04, 07, 08, 10 és 11 kódot látjuk.
Köszönöm!

[TamasPill]

01 befizetés
02 kiutalás
03 átvezetés másik adónemről
04 átvezetés másik adónemre
05 befizetés letéti számláról
06 köztart. címén visszatart. összeg átutalása más szervhez
07 átvezetés más folyószámláról
08 átvezetés más folyószámlára
09 ellátás
10 kiutalt összeg visszaérkezése
11 Rendezés, módosítás
DE Devizabefizetés