Bizonylat API Interfész változások

[TamasPill]

Elkészült az új Bizonylat API Interfész új verziója.
Ez szolgál az új formátumú bizonylatok beküldésére (XSD + XPATH).
Ennek a jelenlegi verziója csak a tesztkörnyezeten érhető el és egyelőre csak a PEI-s nyomtatványokhoz használható.

Az új verzióban:

• Bevezetésre került az önálló validációs szolgáltatás, aminek a sikeres válaszában található validációs tanúsítvánnyal gyorsított úton beküldhetőek a bizonylatok. Ehhez a meglévő bizonylat beküldést kell használni a validációs tanúsítvány megadásával.
• Bevezetésre került a kalkulációs szolgáltatás, amivel a számított mezőket lehet kiszámoltatni és a válaszban visszaadja a módosított bizonylat xml-t.
• A meglévő bizonylat beküldésen csak minimálisan változtak a lekérdezéskor visszaadott státusz és resultCode enum értékei.

A szerver oldali telepítés hétfő délelőtt várható.
A beküldhető bizonylatok listája a közel jövőben fog bővülni, erről külön tájékoztatás fog érkezni.
Az élesítési terv augusztus eleje.

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

[TamasPill]

Az új Interfész verzióval kompatibilis Bizonylat API kikerült a Tesztkörnyezetre.

[pigator]

Sikerült(?) egy T1042E nyomtatvánnyal a dev környezetben a Validacio. Van ügyazonosító és SIKERES válaszkód. Bár: A foglalkoztatott tajszáma nem megfelelő, kérjük javítsa! (Hibakód=M001) Ez nem igaz, érvényes TAJ került elküldésre - 9 szám elválasztó karakterek nélkül ( <restriction base="string"><minLength value="1"/><maxLength value="9"/><pattern value="[0-9]+"/></restriction>). Az éles környezetben (https://m2m.nav.gov.hu/rest-api/1.0/NavM2mBizonylat/bizonylatService/Validacio) viszont ezt látom: { "message": "The page you're looking for could not be found" }. Valóban nem elérhető még éles környezetben vagy én bénázok valamit?

[TamasPill]

Valóban nem érhető el még az éles környezetben.
Jövő héten bővítjük a tesztkörnyezetben beküldhető nyomtatványok számát és július végén várható az élesítés.
Ezekről lesznek külön közlemények.

[pigator]

Köszönöm.

[TamasPill]

Ma délután terheléses teszteket fogunk végezni a tesztkörnyezeten, ezért időnként nagyobb válaszidők lesznek lehetségesek.

[TamasPill]

Átvezetésre került a Bizonylat API Interfész definíciós fájlokban és dokumentációban egy apró javítás:
-A kalkuláció response állományokból kikerült a tomorites paraméter, mert fixen bzip2 tömörített állományok kerülnek visszaküldésre.
-Pontosított dokumentáció a bizonylatTipus és verzióhoz
changes

[laszlo90]

Egy olyan kérdésem lenne, hogy a M2M ÁNYK bizonylat interfész meddig lesz használható? Most ezt teszteljük a T1041, 2658, 2608, 2665 nyomtatványokkal.
Esetleg használható lesz benne a 2758, 2708, 2765 nyomtatvány is majd vagy ez megszűnik teljes mértékben és az új bizonylat apira szükséges átállni?

[davidspollar]

Kiss Tamás Gábor, én márciusban egyszer már felvetettem hasonló kérdéseket itt #156 de nem kaptam érdemi választ. Ezért most megkérdeztem a ChatGPT-t, hogy mi a jelenlegi tudás erről. Hát, nagyjából az amit márciusban sejtettem. A NAV azt várja el, hogy az egyes ügyviteli programokba feljesszenek saját ÁNYK-funkcionalitást a 2708/2758/stb. nyomtatványok megjelenítéséhez, hibajavításához és a beküldésükhöz. https://chatgpt.com/share/6a634796-bc50-83ed-a1db-bd62d9906d4c Amiért eddig fizetett az állam a Pillér Kft-nek, azt ezentúl csinálják meg az ügyviteli programok fejlesztői ingyen. Ügyes.

Kedves @gbtami!

A NAV lehetőséget biztosít az ONYA-n különböző nyomtatványok kitöltésére, továbbá lehetőséget biztosít a Bizonylat API-n keresztül a nyomtatványok validációjára, kalkulációjára, beküldésére. Az ONYA-n elérhető nyomtatványok köre és az azokhoz kapcsolódó funkciók is bővülnek.
Kérjük, hogy nem informatikai kérdéseiket (például mi/mikor/hol lesz elérhető) az anykkivaltas@nav.gov.hu címen jelezzék. Köszönjük!

[TomcaGitHub]

Kedves Spollár Dávid Úr!

A teljesség kedvéért engedje meg, hogy az alábbiakban leírjam/kiegészítsem az előző bejegyzést és arra kapott választ.

Az Ön által jelzett „áfa 65-ös nyomtatvány, mint szövegrész az új bizonylat interfész dokumentációjából” történő kikerülés kapcsán fontosnak tartom megjegyezni, hogy az Áfa nyomtatvány az interfész dokumentációjának FOGALOMTÁR szekciójában szerepelt definícióként, hogy mit is jelent az a szó, hogy bizonylattípus. Más példát is használhattunk volna, nem gondoltuk, hogy ez félreértésre adhat okot, ezért elnézést kérünk.

Szeretném hangsúlyozni, hogy az eÁFA konzultáció/bemutató alkalmával feltett 2 kérdésünkre az alábbi szóbeli - hivatalosnak tekinthető - válasz érkezett:
-"Áfa bevallás teljesítésére - eÁFA rendszerre át nem térő adózók számára - mi a járható út a bevallás teljesítésére?" - amelyre Czöndör Szabolcs Úr egyértelműen a NAV M2M kapcsolatot jelölte meg.
-második kérdés az volt: "Mikor lesz NAV M2M konzultáció/fórum?" - Erre anno még nem tudtak pontos választ adni; azóta 2026. Július elején ez "megtörtént".

Fentiek alapján megalapozott volt tehát azon várakozás, miszerint az NAV M2M rendszer hivatott támogatni a 65-ös bevallást, pláne úgy hogy a fejlesztői dokumentáció 4-ik oldala rögtön az áfa bevallást nevesítette példaként.

Ezt követően a fejlesztői fórumon olyan hírt közöltek, amely megrendítette az addigi reménykedő várakozást:
-az új bizonylat interfész / xsd / xpath, stb. nem vonatkozik az áfa bevallásra
-ráadásul Rencenji Dénes Úr által bemutatott alkalmazás - ami grafikus felületet, validációt, nyomtatási elrendezést biztosít is egyértelműen az áfa bevallástól elhatárolták, mint nem támogatott bevallás felület.

A most érkezett válaszában szeretnék néhány pontosítást kérni:

a)

Az XML állomány importálására lehetőség van ONYA, M2M és eÁfa oldalon.

Ez újabb érdekes információ: az ONYA szintén nem kezeli az áfát. Az M2M-nek nincs grafikus felülete, dokumentációban sehol nem említik az ÁNYK XML importálás lehetőségét. eAFA-ban eAFA kompatibilis xml beolvasására van lehetőség, ami nem egyenlő az ÁNYK xml-el. Az eVAT tool a leírása szerint is kizárólag csak egyszerű esetek kezelésére alkalmazható, ráadásul parancssorból történő vezérlése eddig nem ismert.

Kérem szíves felvilágosítását: létezik olyan "modern" felület, amely áfa bevallás ÁNYK.xml -t be tud olvasni, validálni és beküldeni képes, amelyet oda lehet adni a végfelhasználónak vagy legalább annyira alkalmas lehet ügyviteli rendszer => NAV bevallás kezelésére, mint az ÁNYK volt (nyomtatási képet is biztosít a könyvelőknek) és 2027-től is teljesíthető vele az ÁFA bevallás?

Ha az xsd/xpath/új bizonylat api körbe felveszik az áfát (65) és EU összesítő nyilatkozatot (A60), töredékére csökkennek az ilyen jellegű aggodalmak. Kérem, szíves útmutatásukat ezen a fejlesztési vonalon.

b)

A Document API „alól” folyamatosan kopnak ki a nyomtatványok, ezért ahhoz fejlesztést nem tervezünk. A régi formátum kivezetése lassú lépésekben az ÁNYK kiváltásával párhuzamosan halad előre.

Ez a megállapítás, miszerint "kopnak ki a nyomtatványok" teljesen ellentmond azon korábbi nyilatkozatukkal, hogy a "régi" document interfészen keresztül továbbra is beküldhetők lesznek az adatok. Bízom benne, hogy ezt egyikünk sem kezeli hivatalos közleményként / tényként, mert itt a GitHUB korábbi kérdéseire adott válaszaik alapján értelmezhetetlen.

c)

A NAV lehetőséget biztosít a bizonylat offline kalkulációjára és validációjára (XPath-ok segítségével), online validációjára és kalkulációjára (API hívás segítségével) és természetesen a beküldésre is. A felhasználói felület természetesen az ügyviteli program felelőssége, ahogy az ahhoz kapcsolódó folyamatok felépítése/meghatározása is. Az XML megnyitása, módosítása nem elvárás, pusztán lehetőség nyílik a tesztelés gördülékenyebbé tételére, esetlegesen programkódok átvételére, ha az ügyviteli rendszerek esetén kialakított folyamatok ezt mégis megkívánják.

Maradjunk kérem az áfa bevallásnál, végig ezt a kontextust szerettem volna megcélozni.
Válaszát értelmezhetjük úgy, hogy mégis lesz áfa-ra kiadott xsd, xpath, stb?
Amennyiben nem, úgy ez a kapott válasz ismét ellentmondásos.

---

Tanácsát megfogadva kérdéseinket összegyűjtjük és a megadott e-mail címre is továbbítani fogjuk.
Közeleg az ÁNYK kivezetésének dátuma és még mindig nincs egyértelmű válasz arra vonatkozóan, hogy az eddig ÁNYK-ban teljesített 65-ös bevallás adatait hogyan lehet bevallani 2027 01. vagy későbbi időszak vonatkozásában.

Amíg nincs törvénybe iktatva / jogforrással alátámasztva az eÁFA kötelező használata, addig
-vagy maradnia kell az ÁNYK-nak
-vagy a korszerűbb bevallási formátumok (Új bizonylat interfész) használatát ki kell terjeszteni az áfa és EU bevallás kezelésére is.

Egyértelmű útmutatást, állásfoglalást és segítséget kérünk Önöktől erre a kérdésre.
Köszönjük.

Tisztelettel:
Kiss Tamás Gábor

[Szildiko]

bocsánat hogy beleszólok, nem értem ezt az e-áfa ellenességet
2.0 e-áfa már sokkal jobban dokumentált és kifejlett mint az m2m nyomtatványok kezelése
sokkal barátságosabb, hogy az osa rendszerre hasonlít.

személy szerint nem látom értelmét két rendszert üzemeltetni a nav oldaláról hogy e-áfa és m2m hosszútávon.
ha lenne m2m xpath dolog akkor az megint visszalépés volna, mert nem analitika szintű adatokat kapnának.

az ellenőrzési rendszerüket úgy érzem az analitika szintű adatokra akarják alapozni.

én nem szeretném ha mindkét rendszer lenne, mert az jelentené, hogy az ügyfél programban mindkét rendszert fent kell tartani az áfára. Ráadásul a másiknál ott lenne az M lap, amit mindenki utál.

[Vanek1966]

laszlo90 kérdése ez volt: "Esetleg használható lesz benne a 2758, 2708, 2765 nyomtatvány is majd vagy ez megszűnik teljes mértékben és az új bizonylat apira szükséges átállni?

TamasPill válasza: "Ugyanúgy beküldhetőek lesznek utána is a nyomtatványok az M2M Document API-n."

Nem igazán értem a választ. A Document API az ÁNYK-s nyomtatványokon alapul. Ha 2027.01.01-től nem lesz ÁNYK (már pedig jelen állás szerint nem lesz), akkor abból következően ÁNYK-s 2708, 2758 stb. sem lesz, hogyan lehet akkor ezeket Document API-n beküldeni?

A 2765-öt nem is írtam bele, annak a NAV kommunikációja szerint, nem hogy ÁNYK-s, de még ONYA-s változata sem lesz, ezt csak a eÁfa webes felületén (ami szerintem egy olyan cégnél, ahol havonta 5-nél több számla van, gyakorlatilag kivihetetlen) vagy az eÁfa M2M-en lehet beadni.

[TamasPill]

Az ÁNYK-ban szerkeszthető nyomtatványokat lehet beküldeni a Document API-n idén és jövőre is.
Bővebb tájékoztatást az anykkivaltas@nav.gov.hu címen lehet kérni.

[TamasPill]

Jelenleg a nav-gov-templates oldalon lévő sablonok közül az alábbiak használhatóak a tesztkörnyezet Bizonylat API-n:
- name: NAV_PMT25
version: "0.25"
- name: NAV_PMT25MEG
version: "0.5"
- name: VPOP_KIT17
version: "1.10"
- name: VPOP_KIT17MEG
version: "1.9"
- name: VPOP_KSZ17
version: "1.11"
- name: T1042E
version: "1.0"
- name: NAV_F04
version: "2.7"
- name: NAV_F07
version: "1.10"
- name: NAV_F10
version: "1.12"
- name: NAV_F11
version: "1.9"
- name: NAV_F12
version: "1.5"
- name: NAV_J07
version: "2.19"
- name: NAV_J24
version: "2.13"
- name: NAV_J46
version: "1.11"
- name: NAV_J49
version: "1.10"
- name: NY
version: "54.0"

[Szildiko]

ezekből egyik se olyan amire kalkulációt kéne futtatni, a többségét még ányk-ba se tudtam megszerezni, hogy tartozik-e hozzá számított mező, nekünk is szükségünk lenne arra, hogy a kalkulációt hogyan működik, hogyan lehet meghívni, de egy ilyen nyomtatványt se találok, amivel lehetne próbálkozni

[Szildiko]

Másik topicban kaptam választ, hogy a NAV_F10 használható kalkulációra, köszi!

[BeGabor]

Kedves Tamás! A NAV_F10-re én is ráugrottam, de 1.12, és 1.12.1 verzióval is próbáltam, és ERVENYTELEN_BIZONYLAT_VERZIO, mi a pontos verziója ami működik?

[Szildiko]

nekem úgy működött, hogy típus = NAV_F10 és verzió 1.12
kalkuláció: ResultCodeString: SIKERES
ResultMessageString: Sikeres művelet

[BeGabor]

Köszönöm, a NAV_ részt levágtam ez lesz a baj.