DimNAV számlabeolvasó program A DimNAV számlabeolvasó program alkalmas arra, hogy a számlázórendszerrel kiállított számlákat továbbítsa a NAV-nak, illetve megjeleníti a NAV-tól kapott választ. Segíti a felhasználót a kapott válaszüzenetek értelmezésében. Korrekt működésének feltétele, hogy a számlázó program a 100.000 Ft és 100.000 Ft-nál nagyobb ÁFA tartalmú számlákat helyes XML formátumban adja át (azt tudja továbbítani, amit a számlázó program XML-ben átad). Tartalomjegyzék I. TELEPÍTÉS... 1 II.BEÁLLÍTÁSOK... 2 II.1. Licensz... 3 II.2. Technikai felhasználók... 3 II.3. Egyéb... 5 III.DimNAV MENÜJE... 7 III.1. Ablak megnyitása... 7 III.2. Beállítások... 7 III.3. Hibás számlák fájlba mentése... 7 III.4. Napló megtekintése... 7 III.5. Segítség... 8 III.5. Program bezárása... 10 IV.ABLAK MEGNYITÁSA... 11 I. TELEPÍTÉS Rendszerkövetelmények: minimum Windows 7 operációs rendszer és állandó internet kapcsolat. DimDOS program (vagy nem Dimenzió Kft. által készített számlázó szoftver esetében) az online adatszolgáltatást tartalmazó verzió telepítésekor a szoftverkövetési szolgáltatást ellátó munkatársak végzik el a számlabeolvasást biztosító segédprogram bemásolását a számlázó szoftver mappájába (DimNAV.exe, sqlite3.dll). Ennek megtörténte után létre kell hozni ugyanitt a DimNAV.ini fájlt a következő tartalommal: [SOFTWARE] ID=012345678901234567 tetszőleges 18 karakter - 1 - www.dimenzio-kft.hu
NAME=DimDOS MAINVERSION=6.08 DEVNAME=Dimenzió Kft. DEVCONTACT=iroda@dimenzio-kft.hu DEVCOUNTRYCODE=HU DEVTAXNUMBER=10217829 Számlázó program neve Számlázó program verziószáma Számlázó szoftvert készítőjének neve Számlázó szoftvert készítő cég e-mail címe Számlázó szoftvert készítő cég országkódja Számlázó szoftvert készítő cég adószáma [STATUS_FILE] DBF=1 A DimNAV program biztosítja a Számlázó program (DimDOS) és a NAV szerver közötti kommunikációt. Az első adatszolgáltatással érintett számla kiállítása előtt néhány beállítást el kell végezni. A számlázó szoftverben be kell állítani az online adatszolgáltatással érintett számlák útvonalát. Az elvégzett beállítás mentése után a képernyő alsó sorában (tálcán) megjelenő ikonra jobb egér gombbal történő kattintás után elvégezhetjük a DimNAV program szükséges beállításait. (Az ikon a számítógép beállításaitól függően lehet a rejtett ikonok között is.) II. BEÁLLÍTÁSOK ikonra történő jobb egér gomb kattintással a DimNAV menürendszere jelenik meg,, itt a Beállítások kiválasztása után a következő képernyőkép jelenik meg: - 2 - www.dimenzio-kft.hu
II.1. Licensz A Licensz fülön a számítógép azonosító adatai jelennek meg. Amit be kell írni, ill. ellenőrizni kell: Partner azonosító: 544 Szoftver kulcs: a számítógép azonosító alapján generált kulcs. A számítógép azonosítója alapján a Dimenzió Kft. biztosítja, kérhető telefonon vagy e-mailben. (Gépcsere esetén megváltozik a számítógép azonosító, ezért új szoftver kulcsot kell kérni a Dimenziótól.) A számítógépre vonatkozó információk automatikusan kerülnek kitöltésre. II.2. Technikai felhasználók A technikai felhasználó annak a számítógépnek a beazonosítását jelenti, amelyen történik a számlázás, illetve az adatszolgáltatás. Ezen a fülön azokat az azonosító adatokat kell rögzíteni, melyeket az Online számla felületen (onlineszamla.nav.gov.hu, illetve ennek teszt felületén) elvégzett elsődleges regisztrációt (adatszolgáltatásra kötelezett törvényes képviselője vagy állandó meghatalmazottja) követően létrehozott technikai felhasználóra vonatkozóan generált a rendszer. (Ha még nem történt meg az említett oldalon a regisztráció, figyelmébe ajánljuk honlapunkon Az online számla regisztráció lépésről lépésre c. leírást: https://www.dimenzio-kft.hu/online-szamla-hirek/. - 3 - www.dimenzio-kft.hu
A szükséges mezők kitöltését elvégezni. ikonra történő kattintás után az ablak jobb oldali részén tudjuk Adószám első 8 karaktere Adatszolgáltatásra kötelezett cég neve (elég a cég rövid neve) Technikai felhasználóra vonatkozó felhasználó név (technikai felhasználó regisztrációjakor kapott) Technikai felhasználóra vonatkozó jelszó (technikai felhasználó regisztrációjakor megadott) XML aláíró kulcs (technikai felhasználó regisztrációjakor kapott) XML cserekulcs (technikai felhasználó regisztrációjakor kapott) A felhasználó nevet, aláíró kulcsot, csere kulcsot másolás-beillesztés funkcióval javasoljuk elvégezni (természetesen amennyiben erre lehetőségünk van). A gombra történő kattintás után az adószám és cégnév bekerül a bal oldali ablakba. (Ha ugyanarról a gépről több cégre vonatkozóan teljesítünk adatszolgáltatást pl. könyvelőirodák esetén -, egyenként el kell végezni mindegyik céghez a regisztrált technikai felhasználó adatainak felvitelét a gombbal.) - 4 - www.dimenzio-kft.hu
Későbbiekben, ha változnak a technikai felhasználó adatai (az elsődleges felhasználó a cég ügyfélkapus eléréssel rendelkező vezetője vagy meghatalmazott törli a technikai felhasználót, ill. újat hozott létre), a következő ikonokra való kattintással tudja a módosításokat elvégezni: kiállítására) - technikai felhasználó törlése (Pl. könyvelőiroda megbízása megszűnt a számlák - szerkesztéssel új technikai felhasználó adatainak felvitele (cég neve, adószáma változatlan maradt). II.3. Egyéb Az Egyéb fülre átkattintással beállíthatjuk az online adatszolgáltatással érintett számlák mentésének helyét. Ez bárhol lehet a gépen, nem szükséges a számlázó program mappáját kijelölni. Meg kell egyeznie a DimDOS programban beállított hellyel. Szükséges a NAV szerver adatainak beállítása a legördülő menüből kiválasztható a teszt szerver helyett az éles szerver. Ha felhasználó július 1. után is szeretné megtartani a tesztelés lehetőségét és erre a célra létrehozott egy számlázás teszt állományt ott továbbra is a NAV szerver online számla teszt címét kell megjelölni. Időtúllépés: lassú internet esetén javasolt a kurzort jobbra mozgatni, így tovább vár a NAV válaszára max. 20 mp-ig növelhető. Felugró értesítések engedélyezése: bekapcsolása esetén ebben a formában is visszajelzést kapunk a NAV-val történő kommunikációról: - 5 - www.dimenzio-kft.hu
DimNAV program indítása: ezen a fülön beállítható, hogy a DimNAV a Windows programmal (és nem a DimDOS programmal) induljon. Ez a funkció azért hasznos, mert ha technikai hiba miatt nem valósult meg az adattovábbítás, a számítógép következő bekapcsolásánál automatikusan megtörténik az adatok küldése, nem kell hozzá a számlázó modult indítani. (Fontos tudni, hogy a jelenlegi előírás szerint technikai hiba esetén annak megszűnését követően 24 órán belül meg kell történnie az adatszolgáltatásnak!) Indítás minimalizálása a tálcán: bekapcsolása esetén a Windows vagy DimDOS (előzőekben leírt beállítástól függően) indítása után a DimNAV működését a tálcán az Befogadott, de figyelmeztetést tartalmazó számlák jelölése: NAV által befogadott számlák DONE jelölést kapnak, de előfordulhat, hogy a NAV válaszüzenetei olyan figyelmeztetéseket tartalmaznak, melyek felhívják a felhasználó figyelmét hibás adatkezelésre, adatbeviteli hibákra stb. Bepipálása esetén ezen számláknál a válaszüzenet sárgával jelölt. jelzi. Lehetőség van útvonalat elrontottuk és nem tudjuk mi volt ott. alkalmazására, ha pl szervert és A Beállítások mentése ( ) után a képernyő alsó menüsorából eltűnik a ikon, helyette megjelenik:. (A DimNAV ikonja: a képernyőn:.) - 6 - www.dimenzio-kft.hu
A DimNAV-ra vonatkozó fentiekben leírt beállításokat egyszer kell elvégezni, továbbiakban (ha nem szükséges a technikai felhasználóra vonatkozó adatot módosítani vagy nem történt új gépre telepítés) csak arra kell figyelni, hogy ne zárjuk be indokolatlanul. a programot. III. DimNAV MENÜJE ikonra történő jobb egér gomb kattintással jelenítjük meg. III.1. Ablak megnyitása Megjeleníti az adattovábbítás eredményét, a NAV-tól kapott válaszüzeneteket. Részletesen lásd a IV. pontban. III.2. Beállítások Bővebben a II. menüpontban leírtak szerint. III.3. Hibás számlák fájlba mentése Ennek segítségével végezhetjük el az adatszolgáltatás hibás számláinak mentését. Alkalmazása akkor indokolt, ha a szoftverfejlesztőnek át kell küldeni a NAV hibajelzésével ellátott számlákat a hiba felderítésének céljából. Az ABORTED jelzéssel visszaérkezett számlák mentési helyét kiválaszthatjuk, a mentés zip fájlban történik. Későbbiekben beállítható lesz, hogy mely számlákra vonatkozzon a mentés. III.4. Napló megtekintése - 7 - www.dimenzio-kft.hu
Naplózza a DimNAV programban történt eseményeket, szintén a szoftverfejlesztő számára nyújt hasznos információkat. A zip fájl menthető. III.5. Segítség A Segítség gombra kattintva megjelenő ablak: Választhatunk: a program használatára vonatkozóan szeretnénk további információt olvasni, a Dimenzió Kft. honlapján az Online számla hírekhez szeretnénk navigálni, vagy a NAV Online számla weboldalára szeretnénk eljutni. Kommunikáció teszt: NAV szerverrel történő kapcsolatfelvételt mutatja. Pl. ha a NAV szerverrel történő kommunikáció felfüggesztve jelzést kaptunk (pl. üzemzavar esetén), a teszt ablaka üres: - 8 - www.dimenzio-kft.hu
Normál kapcsolat esetén a Teszt indítása után megjelenő képernyő: - 9 - www.dimenzio-kft.hu
Névjegy: A DimNAV program fejlesztőjére és a használt számlázó program azonosítására szolgáló adatokat jeleníti meg: III.5. Program bezárása DimNAV programból kilépés. Csak nagyon indokolt esetben alkalmazzuk!!! A program bezárása megakadályozza a NAV-val történő kommunikációt. A program bezárása esetén elmaradhat a kötelező, időben történő adatszolgáltatás. (A DimNAV új verzióra automatikusan frissül. Előfordulhat, hogy szükséges kézi frissítés, ekkor előbb be kell zárni a programot. A frissítés elvégzése után újra kell indítani a DimNAV programot!) A DimNAV beállításainak elvégzése után a felhasználónak továbbiakban már csak a törvényeknek megfelelő számlakiállításra kell koncentrálni, illetve figyelemmel kísérni, hogy az adatszolgáltatással érintett számlák rögtön a számla lezárása után (tovább már nem lehet változtatni a számla adatain, - 10 - www.dimenzio-kft.hu
tehát megtörtént a nyomtatás vagy PDF-ben mentés, stb.) továbbításra kerüljenek, illetve értelmezni kell a NAV válasz üzeneteit. A DimNAV a DimDOS számlázó moduljában történő belépés után folyamatosan vizsgálja, van-e felküldendő számla. Amennyiben van, ezek automatikusan bekerülnek az erre kijelölt mappába ill. DimNAV programba beállított útvonalon), de továbbítás után ki is ürülnek onnan. A folyamatot a DimNAV Ablak Számlák állapota ablak mutatja. IV. ABLAK MEGNYITÁSA A számlázó program indítása automatikusan indítja a DimNAV programot, és a számítógép kikapcsolásáig (DimNAV program bezárásáig) folyamatosan vizsgálja, van-e felküldendő számla. Elvégzi a számla adatainak továbbítását, fogadja a NAV-tól kapott választ. Segítségével megjeleníthető a válaszüzenet tartalma. Mivel a beküldött számlára max. 5 percen belül kapunk visszajelzést, ezért a számlázó programból ne lépjünk ki addig, míg az utoljára felküldött számlára nem kapunk visszajelzést. A kiállított és beküldendő (beküldött) számlákra vonatkozó információkat megjeleníthetjük a DimNAV programmal a ikonra dupla kattintással (vagy jobb egérgomb - Ablak megnyitás). Listázási időszak: a beküldött számlák listáját szűrhetjük o o o Mai napra Elmúlt 7 napra Elmúlt 30 napra - 11 - www.dimenzio-kft.hu
o Összes számlára Szűrés a beküldő adószámára: ha egy gépen több cégre vonatkozóan állítunk ki számlát, lehetőség van a beküldő adószámára szűrni (természetesen előfeltétel, hogy az adószám szerepeljen a DimNAV technikai felhasználóknál). A színek jelzik a NAV-nak továbbított számlákra vonatkozó feldolgozás státuszát: Hiányzó technikai felhasználó: csak az adószám, számlaszám és beolvasás ideje oszlop kitöltött, a többi üres. (Előfordulhat pl. könyvelőirodák esetében, amikor átlépünk egy másik cég adatbázisába, elkészül az adatszolgáltatásra kötelezett számla, de még nem történt meg a technikai felhasználó regisztrációja.) Feldolgozás alatt: megtörtént a továbbítás a NAV szervere fele, de még folyamatban van a számla feldolgozása (adatszolgáltatás követelményeinek ellenőrzése), a feldolgozás státusza: PROCESSING. Hibás számla: a számla adattartalma hibás, ABORTED Figyelmeztetés: az elfogadott számlákhoz a NAV megjegyzéseket fűzhet: Ezek az üzenetek az adatszolgáltatásra kötelezett tájékoztatását szolgálják. Célja, hogy segítsen az adózó oldalán jelentkező adatbeviteli hibák, hibás gyakorlatok, szoftverhibák észlelésében és javításában. A figyelmeztetések ellenére az adatszolgáltatás teljesítettnek minősül, DONE. Elfogadott számla: DONE, rendben megtörtént az adatszolgáltatás. Eben az esetben további teendő nincs. Az alábbi képernyőképek a tesztelés során készült számlákra vonatkoznak, a kommunikációs program működését segítenek megérteni: - 12 - www.dimenzio-kft.hu
RECEIVED: Küldés folyamatban van PROCESSING: Feldolgozás folyamatban van ABORTED esetén hibás volt a számla. A számla sorára történő dupla kattintással megnyitható a Kommunikációs XML. A megjelenő ablakban a Számla ellenőrzés (Válasz) fül tartalmazza a NAV válaszát, ebben magyarul is megtalálható az üzenet. (Az alábbi üzenet a teszt időszakban készült, gyakorlatban ugyanazzal a sorszámmal nem történhet kétszer adatszolgáltatás.) - 13 - www.dimenzio-kft.hu
A DONE státusszal (Rendben) befogadott számláknál is érdemes a kommunikációs XML megtekintése. Ha elmarad a DimNAV / Beállítások / Egyéb fülön a Befogadott, de figyelmeztetést tartalmazó számlák jelölése, akkor a DONE státuszú számlák is tartalmazhatnak figyelmeztetést. Alábbi esetben a számla befogadása megtörtént, bár a vevő adószáma helytelen. Ezeknek az üzeneteknek a megfelelő módon történő kezelése felhasználó feladata. Nyilván ebben az esetben az eredeti számla módosítása szükséges. - 14 - www.dimenzio-kft.hu
Figyelmeztető üzenet nélküli NAV válasz: Ha a technikai felhasználót helytelenül regisztráltuk be a DimNAV-ba, vagy több cég nevében történt számlázás esetén még nem történt meg a technikai felhasználó adatainak rögzítése ugyanitt, az adatszolgáltatás nem lesz eredményes: Ebben az esetben csak az adószám, számlaszám és a beolvasás ideje jelenik meg, a többi mező üres. - 15 - www.dimenzio-kft.hu
A hiba javítása után automatikusan megtörténik a számlák beküldése: Az alábbi képernyőképen olyan számlabefogadások látszanak, melyek eredményesek, de a sárga szín jelzi, hogy a sikeres adatszolgáltatáshoz figyelmeztető üzenetek tartoznak: A kiválasztott sárga sorra történő dupla kattintással megjelenik a kommunikációs XML: - 16 - www.dimenzio-kft.hu
A megjelenő figyelmeztetés szerint javasoljuk, hogy a DimDOS zámlázás modulban a Terméktörzs táblát a kiszámlázott termék, vagy szolgáltatást szerkesztéssel javítsuk: a mennyiségi egységnél válasszuk ki a darabot! (A NAV várja a mennyiséget és mennyiségi egységet is, ha a számlán szerepel az egységár. A következő hasonló tartalmú számla már figyelemeztetés nélkül fog bemenni!) Az adatszolgáltatást megismételni nem kell. A kommunkációs XML-ek megtekintése ablakban látható még az elkészült számla XML formátuma, valamint a NAV válaszok. Igény esetén a kapott kommunikációs XML elmenthető továbbítható a szoftverfejlesztőnek. gombbal, és FONTOS!!!!! Amíg az utolsó adatszolgáltatásra kötelezett számláról nem érkezett meg a NAV válasz üzenete, nem szabad megszakítani a DimNAV működését! https://www.dimenzio-kft.hu/online-szamla-hirek/ https://onlineszamla-test.nav.gov.hu/tajekoztatas_a_regisztraciorol https://onlineszamla-test.nav.gov.hu/kerdesek_es_valaszok - 17 - www.dimenzio-kft.hu