Idegenforgalmi adó bevallás — rendszerleírás
Az IFA-bevallás fej- és szálláshely-sorainak adatmodellje, a mentés validációja, az XML- és PDF-előállítás feltételei és mellékhatásai, a törlés két módja és a tartalmi hatókör.
Áttekintés
Havi idegenforgalmi adó bevallás ügyfelenként: egy sor egy bevallás (client + önkormányzati beállítás + év + hónap + típus), szálláshelyenkénti vendégéjszaka- és mentesség-adatokkal. A számítást és a portálra feltölthető XML-t a rendszer IFA-szolgáltatása készíti, a PDF-et a PDF-sablon motor; mindkettő a dokumentumtárba kerül (objektum nav_ifa, kategória tax_return).
Adatmodell
A táblanevek a telepítés saját előtagjával állnak az adatbázisban.
| Tábla | Szerep | Fő mezők |
|---|---|---|
ifa_return | bevallás-fej | client, beállítás, év, hónap, típus, kitöltő és beküldő adatai, aláírás, xml_doc_id, pdf_doc_id, date_generated, státusz (9 = kuka) |
ifa_return_line | szálláshely-sor | ingatlan, cím-pillanatkép, 1–8. sor és részsorai |
ifa_setting | önkormányzati beállítás | adómérték, üres portál-űrlap |
company | client és beküldő cég | adószám, székhely, statisztikai számjel |
Az üzemeltetett ingatlanok a masterdata/property modellből jönnek (üzemeltető-oszlop migrációval).
Folyamat
- Lista: szűrő cégcsoport és client, ingatlan, időszak (gyors időszak); soronként client, önkormányzat, időszak, típus, adómérték, vendégéjszakák, adóköteles éjszakák, számított adó, kedvezmény, fizetendő, generálás dátuma, XML/PDF dokumentum, „elavult fájl” jelzés (módosítás a generálás után), hiányzó adatok listája; összesítő.
- XML letöltés: a mentett adatokból azonnal épül és letöltésként jön, a dokumentumtártól függetlenül (a gomb csak akkor látszik, ha nincs iktatott XML).
- Segéd-végpontok: a client székhelye, statisztikai számjele (törzs, ennek híján a legutóbbi bevallás) és üzemeltetett ingatlanai; a beküldő cég e-mailje, telefonja és tagjai.
- Mentés: beállítás hiányában a szálláshely településéből és az évből keresi; a szálláshely-sorok a client üzemeltetett, aktív ingatlanaiból jönnek, a cím pillanatképként; számítás az IFA-szolgáltatással; a beküldő e-mail/telefon a kapcsolattartókból töltődik, ha üres. Csak adatbázisba ír; a válasz kiírja a hiányzó adatokat; mentés után visszaolvasás.
- Generálás: hiányos adatnál (adószám, székhely, 17 jegyű statisztikai számjel, kitöltő neve, e-mail, telefon, aláírás, beküldő, meghatalmazás típusa, ingatlan) nem generál, és megnevezi a hiányt; a beállítás üres űrlapjából XML-t épít, PDF-et a
nav_ifa_returnsablonnal (magyar feliratokkal, ha van magyar nyelvi fájl); a régi XML/PDF-et a dokumentumtár takarító műveletével törli, az újakat a client tárhely-szabálya (nav, ennek híjándocument) szerint iktatja; csak ha mindkét dokumentum létrejött, ad sikert. A fájl-eltávolítás egy generált fájlt töröl a dokumentumtárból és a fejről. - Küldés e-mailben: átirányítás a levélküldő modulba, a mellékletek a dokumentumtár
nav_ifakapcsolatából. - Törlés:
deletejoggal a generált XML/PDF takarítása és a bevallás fizikai törlése; csakstatusdeletejoggal 9-es státusz (kuka).
Validáció
- Client és beállítás kötelező; a beállítás éve egyezzen a bevallás évével; év 2000–2100, hónap 1–12; aláírás dátuma érvényes formátum.
- Az ingatlan a client üzemeltetett ingatlana, egyszer szerepelhet; irányítószám/település és utca vagy helyrajzi szám kötelező; a beállítás településén legyen; legalább egy ingatlan.
- Duplikátum-tilalom: client + beállítás + év + hónap + típus.
- A 2. + 3. + 4. sor nem haladhatja meg az 1. sort; a 7. sor nem haladhatja meg a 6. sort.
Jogosultság
- 2. réteg:
list(lista, XML, segéd-végpontok),add/edita mentésen (új rekordnáladd; a form jog nélkül csak olvasható),generate,sendmail,delete,statusdelete,debug. - 3. réteg: a lista, az XML (más cég bevallása nem tölthető le), a segéd-végpontok cég-azonosítója, a mentés (a meglévő sor ÉS a beküldött client, valamint a beküldő cég), a generálás és a törlés a tartalmi jogon belül; a kuka-sorok a kuka-láthatóság szabálya szerint.