Az XCZ állományok kezelése az ÁNYK-ban

XCZ állományok kezelése az ÁNYK programbanAz Általános Nyomtatványkitöltő (ÁNYK) program a 2.31.0-ás verziójától elfogadolyan bemeneti állományokat, melyek az adattartalom (XML) mellett,csatolmányokat is tartalmaznak.Új csomag formátum került definiálásra. Ezt a formátumot az ÁNYK minden olyanfunkciónál elfogadja, ahol importot kezel. Az új állománytípus társításra kerül azÁNYK-val.Ezeknek az állományoknak a kiterjesztése XCZ az XKR mintájára. Az XCZ egyZIP formátumú tömörített állomány, amely tartalmaz az XML állomány mellettegy csatolmányleíró állományt és a beküldésre kerülő csatolmányokat.XCZ állomány szerkezeteAz állomány tartalma:1. xml állomány2. atc állomány3. csatolmányokAz XCZ állományban szereplő állományok nevének UTF-8 kódolásúnak kelllennie. Probléma esetén használjon ékezet nélküli állományneveket.1. xml állományPélda .XCZ állomány tartalmáraAz xml állomány az ÁNYK programban használatos formátum. Részletesleírást xml állomány készítéséről ahttp://www.nav.gov.hu/nav/ebevallas/abevjava/javakitolto.html oldalontalálható nyomtatvanyok_xml_szerkezete.pdf állományban olvashat.Példa, xml állomány nevére: teszt.xml2. atc állományA nyomtatványhoz csatolt állományok nevét és csatolmány típusáttartalmazza. Szöveges állomány. Kiterjesztése: .atc.

Az atc állomány nevének és szerkezetének kialakítása kötött. Az atcállomány neve a xml állomány neve (kiterjesztés nélkül) kiegészítve az xmláltal tartalmazott nyomtatvány típusának nevével.Példa atc állomány nevére: teszt_IRMCEGINFO_10EB_02.atcahol a teszt az xml állományneve,az IRMCEGINFO_10EB_02 pedig nyomtatvány típus neve.Az atc file szerkezete:Első sor:- Karakter kódolás (pl. encoding=”utf-8”)További sorok:- Csatolmány állományok paraméterei a fent megadott karakter kódolással.Az egyes mezők ”;” (pontosvesszővel) elválasztva.„elérési úttal a beküldésre szánt file;megjegyzés;csatolmány típusa”Mezőelérési úttal a beküldésreszánt filemegjegyzéscsatolmány típusLeírásA beküldésre szánt állomány neve azarchívumon belüli relatív elérési úttalA csatolmányhoz fűzött megjegyzésA csatolmány típusaPélda ATC állomány tartalmáraAzt az információt, hogy az adott nyomtatványhoz milyen csatolmánytípusok tartoznak, azt a Szerviz/Fejlesztőknek -> Csatolmány paraméterekmenüpont elindításával megjelenő ablakban találja. Nyomtatványonkéntkülönbözőek a típusok.Csatolmány típusok és jellemzőik

3. CsatolmányokAz alkönyvtár neve megegyezik a nyomtatvány nevévelpld: IRMCEGINFO_10EB_02Csatolmányokat tartalmazó alkönyvtár tartalmaAz XCZ állományban szereplő állományok nevének UTF-8 kódolásúnak kelllennie vagy használjon ékezet nélküli állományneveket.Példa XCZ állományt tud készíteni megnyitott nyomtatványból, a Szerviz-> XML-t és csatolmányt tartalmazó csomag készítése menüpontsegítségével.XCZ állomány felépítése kötegelt nyomtatvány eseténKötegelt nyomtatvány esetében alnyomtatvány típusonként lehet állományokatcsatolni a nyomtatványhoz. Az adott nyomtatvány határozza meg, hogy milyenalnyomtatvány típushoz lehet csatolni. A példában szereplő 11ELEKAFAnyomtatvány esetében mind a két alnyomtatvány típushoz (11ELEKAFA_K és11ELEKAFA_SZ) lehet file-okat csatolni.Az XCZ állománynak az alábbi állományokat kell tartalmaznia:1. xml állomány2. atc állomány/atc állományok3. alkönyvtárban/alkönyvtárakban a csatolmányokPélda .XCZ állomány tartalmára kötegelt nyomtatvány esetében, ha mind a kétalnyomtatvány típushoz van csatolmány

1. xml állományAz xml állomány az ÁNYK programban használatos állomány Részletes leírástxml állomány készítéséről ahttp://www.nav.gov.hu/nav/ebevallas/abevjava/javakitolto.html oldalontalálható nav_nyomtatvanyok_xml_szerkezete.pdf állományban olvashat.Példa xml állomány neve: teszt.xml2. atc állományA nyomtatványhoz csatolt állományok nevét és csatolmány típusáttartalmazza. Szöveges állomány. Kiterjesztése: .atc.Az atc állomány nevének és szerkezetének kialakítása kötött. Az atc állományneve a xml állomány neve (kiterjesztés nélkül) kiegészítve az xml általtartalmazott nyomtatvány típusának nevével.Annyi .atc állományt kell készíteni, ahány alnyomtatványtípushoz csatolnikíván állományokat.Példa atc állományok nevére:- teszt_11ELEKAFA_K.atc- teszt_11ELEKAFA_SZ.atcahol a teszt az xml állományneve,az 11ELEKAFA_K és a 11ELEKAFA_SZ pedig az alnyomtatványok típusa,Ha csak az egyik alnyomtatványhoz csatol, akkor csak annak azalnyomtatványnak a típusával kell elkészíteni az atc állományt.Az atc file szerkezete:Első sor:- Karakter kódolás (pl. encoding=”utf-8”)További sorok:- Csatolmány állományok paraméterei a fent megadott karakter kódolással.Az egyes mezők ”;” (pontosvesszővel) elválasztva.„elérési úttal a beküldésre szánt file;megjegyzés;csatolmány típusa”Mezőelérési úttal a beküldésreszánt filemegjegyzéscsatolmány típusLeírásA beküldésre szánt állomány neve azarchívumon belüli relatív elérési úttalA csatolmányhoz fűzött megjegyzésA csatolmány típusa

Példa ATC állomány tartalmáraAzt az információt, hogy az adott nyomtatványhoz milyen csatolmány típusoktartoznak, azt a Szerviz/Fejlesztőknek -> Csatolmány paraméterek menüpontelindításával megjelenő ablakban találja. Nyomtatványonként különbözőek atípusok.Egyszerre csak a betöltött alnyomtatvány típushoz tartozó jellemzők kérhetőkle.3. alkönyvtárakban a csatolmányokCsatolmány típusok és jellemzőikAz alkönyvtár neve megegyezik az alnyomtatvány nevévelPld: 11ELEKAFA_SZ vagy 11ELEKAFA_KCsatolmányokat tartalmazó alkönyvtár tartalmaPélda XCZ állományt tud készíteni megnyitott nyomtatványból, a Szerviz ->XML-t és csatolmányt tartalmazó csomag készítése menüpont segítségével. Afunkció abból az alnyomtatvány típusból készít csak példa XCZ állományt,amelyik be van töltve.