NAV Részletes számlaadatok letöltése¶

A modul célja¶

A NAV Részletes számlaadatok letöltése modul célja, hogy a korábban letöltött NAV számlafej adatokhoz a részletes számlaadatokat és számlasorokat is letöltse a NAV Online Számla rendszerből.

Ez a modul a számlaösszesítő adatokon túl a részletes, számlánkénti XML tartalmat dolgozza fel, majd eltárolja:

a számlasorokat,
egyes kiegészítő fejléc adatokat,
a részletes letöltés státuszát,
valamint a sikeres és sikertelen feldolgozások állapotát.

Lényeg röviden

Ez a képernyő arra szolgál, hogy a már ismert NAV számlákhoz részletes, sor szintű adatokat töltsön le, és lehetővé tegye a nagyobb részletességű elemzést, keresést és egyeztetést.

Hol érhető el?¶

A modul az alkalmazás felső menüsorából nyitható meg:

Fájl > NAV letöltések > NAV Részletes számlaadatok letöltése

Előfeltételek¶

A modul használatához az alábbi feltételeknek kell teljesülniük:

legyen megnyitott cég,
legyen beállítva NAV technikai felhasználó,
az alap NAV számlaadatok már legyenek letöltve a rendszerbe,
működjön a NAV kapcsolat,
a részletes számlaadatok eléréséhez szükséges NAV jogosultságok rendelkezésre álljanak.

Fontos

Ez a modul nem önmagában a nulláról tölti le a számlákat, hanem a már eltárolt NAV számlafej rekordokhoz kér le részletes adatokat. Ha még nincs mit részletesen feldolgozni, a letöltendő számlák száma nulla lesz.

Mire használható a modul?¶

A NAV Részletes számlaadatok letöltése képernyő az alábbi feladatokat támogatja:

a részletesen feldolgozandó számlák mennyiségének áttekintése,
a letöltés irány szerinti szűrése,
a részletes letöltés indítása,
a letöltés szüneteltetése,
a hibásan feldolgozott számlák újrapróbálása,
a feldolgozás előrehaladásának és sebességének követése,
a sor szintű NAV adatok adatbázisba mentése.

A képernyő felépítése¶

NAV részletes számlaadatok letöltése főképernyő

A képernyőképen a felhasználó jellemzően az alábbi fő részeket látja:

a felső fejlécet a modul címével és rövid leírásával,
a statisztikák és beállítások blokkot, ahol a számlairány választható és a fő darabszámok láthatók,
a jobb felső NAV környezet jelzést, amely mutatja az aktív TEST vagy éles környezetet,
a középső folyamat panelt, ahol az előrehaladás, a queue állapota, a sebesség és a becsült hátralévő idő jelenik meg,
az alsó műveleti gombsort, ahol az indítás, szünet és hibás újrapróbálás érhető el,
az alsó információs láblécet, amely a részletes letöltés működésére ad rövid magyarázatot.

A fő részek röviden¶

Képernyőrész	Leírás
Fejléc	A modul megnevezése és rövid ismertetése
Statisztikák	A részletes feldolgozás összesített számai
Számlairány választás	Meghatározza, mely számlakörre fusson a letöltés
Folyamat panel	Előrehaladás, queue, sebesség és státusz megjelenítése
Műveleti gombok	Indítás, szüneteltetés és hibás újrapróbálás
Lábléc	Fontos működési információk és bezárás

Milyen adatokkal dolgozik a modul?¶

A modul a már letöltött NAV számlafej rekordokra és a NAV részletes számla API válaszaira épít.

Adatforrás	Mire használja?
`nav_invoice` tábla	ebből választja ki a részletesen feldolgozandó számlákat
`nav_invoice_lines` tábla	ide menti a számlasorokat
NAV technikai felhasználó beállításai	a NAV kapcsolat létrehozására
NAV részletes számla XML válasz	ebből nyeri ki a sor- és fejlécadatokat
részletes letöltési státuszmezők	ezek alapján számolja a pending, completed és failed állapotokat

Milyen input adatokkal dolgozik?¶

A modul működéséhez az alábbi inputok a legfontosabbak:

a kiválasztott számlairány,
a korábban letöltött NAV számlák listája,
az egyes számlák státusza,
a számlák azonosító adatai, például számlaszám, irány, batch index és szállítói adószám,
a NAV rendszerből visszaadott részletes invoiceData XML.

Milyen feldolgozást végez a rendszer?¶

A modul a háttérben az alábbi fő lépéseket hajtja végre:

betölti az adott irányhoz tartozó statisztikákat,
kiválasztja azokat a számlákat, amelyek részletes státusza pending vagy még nincs kitöltve,
a számlákat párhuzamos NAV lekérésekkel dolgozza fel,
a részletes XML-ből fejléc- és számlasor adatokat állít elő,
a számlasorokat kötegekben menti az adatbázisba,
a számlafej rekordokhoz frissíti a részletes letöltési státuszt,
hiba esetén failed állapotot és hibaüzenetet rögzít,
szükség esetén lehetőséget ad a hibás rekordok újrapróbálására.

Miért külön modul a részletes letöltés?

Mert a részletes számlaadatok letöltése jóval erőforrásigényesebb, mint az összesítő számlaadatok lekérése. Minden számlához külön NAV kérés és külön XML feldolgozás tartozik.

Mit jelentenek a statisztikai kártyák?¶

A modul a részletes letöltés állapotát több összesítő mutatóval jeleníti meg.

Mutató	Jelentés
`Összes számla`	az adott irányhoz tartozó összes NAV számla a helyi adatbázisban
`Letöltendő`	azok a számlák, amelyekhez még nincs kész részletes adatletöltés
`Letöltve`	azok a számlák, amelyek részletes adatai sikeresen lementődtek
`Sikertelen`	azok a számlák, amelyek részletes letöltése hibával végződött

Állapotlogika¶

A rendszer a részletes letöltési státuszt az alábbi logika szerint értelmezi:

Státusz	Jelentés
`NULL` vagy `pending`	még letöltendő
`completed`	sikeresen feldolgozott
`failed`	hibás feldolgozás

A számlairány hatása¶

A részletes letöltés irány szerint külön szűrhető.

Irány	Jelentés	Hatása
`OUTBOUND`	kimenő számlák	csak a kibocsátott számlák részletes adatai töltődnek le
`INBOUND`	bejövő számlák	csak a bejövő számlák részletes adatai töltődnek le
`BOTH`	mindkettő	a rendszer külön körben dolgozza fel az outbound és inbound számlákat

Mit jelent a `BOTH` mód?¶

Ebben az esetben a rendszer:

először a kimenő számlák részletes adatait tölti le,
majd a bejövő számlák részletes adatait,
végül összesített statisztikát mutat a két irány együttese alapján.

A folyamat panel értelmezése¶

A középső rész a feldolgozás aktuális állapotát mutatja.

Feldolgozás előrehaladása¶

A felső progress bar azt mutatja, hogy a részletes feldolgozás a kiválasztott számlakörben hány százaléknál tart.

Adatpuffer állapota¶

A queue kijelző azt mutatja, hogy:

hány elem vár éppen adatbázisba írásra,
mekkora a pufferkapacitás,
mennyire terhelt az írási csatorna.

Sebesség és becsült hátralévő idő¶

A rendszer folyamatosan becsli:

az aktuális feldolgozási sebességet számla/perc mértékben,
a hátralévő időt az eddigi átlagsebesség alapján.

Workflow állapot¶

A háttérben a modul több belső állapotot is figyelembe vesz. A felhasználó ebből jellemzően azt látja, hogy:

a letöltés fut,
a rendszer adatbázisba ír vagy várakozik,
a szüneteltetés folyamatban van,
vagy a modul készen áll.

Hogyan működik a letöltés technikailag?¶

A modul párhuzamos letöltési és kötegelt mentési logikát használ.

Párhuzamos NAV lekérések¶

A rendszer egyszerre több számlát is feldolgozhat. A párhuzamosság dinamikusan változhat:

induláskor kisebb párhuzamossággal kezd,
több egymást követő siker után növelheti a párhuzamosságot,
NAV kapacitás jellegű hiba esetén csökkentheti azt.

Kötegelt adatbázisírás¶

A letöltött részletes adatok nem feltétlenül egyesével kerülnek mentésre. A rendszer:

először puffereli az elkészült eredményeket,
ezeket kötegekben írja az adatbázisba,
tranzakcióban menti a soradatokat és a számlafej státuszfrissítéseket.

Miért hasznos ez?¶

Ez a megközelítés:

gyorsabbá teszi a nagyobb mennyiségű részletes letöltést,
csökkenti a fölösleges adatbázis-terhelést,
biztonságosabb státuszkezelést tesz lehetővé.

Milyen adatokat ment a rendszer?¶

A részletes XML válaszból a rendszer többféle adatot is eltárol.

Számlasor adatok¶

A nav_invoice_lines táblába többek között az alábbi jellegű adatok kerülnek:

sorszám,
termékkódok,
megnevezés,
mennyiség,
mértékegység,
egységár,
nettó, áfa és bruttó összeg,
HUF értékek,
áfakulcs vagy mentességi adatok,
közvetített szolgáltatás jelző.

Kiegészítő fejléc adatok¶

A számlafej rekordhoz a rendszer frissítheti például:

a szállító és vevő egyes címadatait,
a szállító bankszámlaszámát,
a részletes letöltésből pontosított összegeket,
a sorok számát,
a részletes letöltés státuszát és hibaüzenetét.

Fontos sajátosság¶

Bizonyos számlatípusoknál a részletes XML pontosabb összegeket tartalmazhat, mint az összesítő digest válasz. Ilyenkor a rendszer a részletes adatból frissíti a számla összegmezőit is.

A használat folyamata lépésről lépésre¶

Nyissa meg a NAV Részletes számlaadatok letöltése modult.
Ellenőrizze a statisztikai kártyákon, hogy hány számla vár feldolgozásra.
Válassza ki a kívánt számlairányt.
Kattintson az Indítás / Folytatás gombra.
Kövesse a folyamat panelen az előrehaladást, a queue állapotát és a sebességet.
Ha szükséges, használja a Szünet gombot.
Ha maradnak hibás számlák, a folyamat után kattintson a Hibás újrapróbálása gombra.
A művelet befejezése után ellenőrizze a frissített statisztikákat.

Mezők és műveletek hatása¶

Elem vagy művelet	Mire való?	Hatása
`Számla irány`	meghatározza a feldolgozandó számlakört	csak az adott irányhoz tartozó számlák kerülnek részletes feldolgozásra
`Indítás / Folytatás`	a részletes letöltési folyamat indítása vagy folytatása	a rendszer megkezdi a pending számlák részletes NAV lekérését
`Szünet`	a folyamat megállítása kontrollált módon	az új lekérések leállnak, a futó műveletek még lezáródnak
`Hibás újrapróbálása`	a failed rekordok visszaállítása újrafeldolgozásra	a hibás számlák státusza újra `pending` lesz
progress bar	az előrehaladás mértéke	megmutatja, hol tart a feldolgozás
queue kijelző	az adatbázis-írási puffer állapota	megmutatja az írási háttérterhelést
sebesség kijelzés	aktuális feldolgozási tempó	segít felmérni a folyamat teljesítményét
hátralévő idő	becsült befejezési idő	tájékoztat a várható futási időről

Az `Indítás / Folytatás` működése¶

A gomb csak akkor használható, ha van még letöltendő számla és a rendszer éppen nem futtat aktív folyamatot.

A `Szünet` működése¶

A szüneteltetés nem hirtelen megszakításként működik, hanem kontrollált leállásként:

az új NAV kérések leállnak,
a már futó műveletek lezáródnak,
a rendszer visszajelzi, hogy a szüneteltetés folyamatban van.

A `Hibás újrapróbálása` működése¶

Ez a művelet a hibás számlákat nem azonnal tölti le újra, hanem visszaállítja őket újra letölthető állapotba. Ezután az Indítás / Folytatás gombbal indulhat új kör.

Milyen paraméter milyen hatással van az eredményre?¶

Paraméter vagy állapot	Várható hatás
számlairány	meghatározza, mely rekordkörre fut a részletes feldolgozás
pending számlák száma	ettől függ, hogy indítható-e a letöltés
failed számlák száma	ettől függ, hogy elérhető-e az újrapróbálás gomb
NAV környezet	meghatározza, melyik NAV rendszerből történik a részletes lekérés
aktív munkaszálak száma	befolyásolja a feldolgozás sebességét és a NAV terhelést
queue terheltsége	befolyásolja az adatbázis-írási háttérfolyamat állapotát
NAV/API hibák	csökkenthetik a párhuzamosságot és növelhetik a failed számlák számát

Mit jelent a hibás állapot és az újrapróbálás?¶

Ha egy számla részletes letöltése sikertelen, a rendszer:

failed státuszt állít be,
eltárolja a hibaüzenetet,
a számlát kiveszi a sikeresen befejezett körből.

Mikor lehet hibás egy számla?¶

Például akkor, ha:

a NAV válasz hibát ad,
a részletes invoiceData XML hiányzik,
a számlasorok nem dolgozhatók fel,
átmeneti kapacitás vagy kommunikációs hiba történik.

Mit csinál az újrapróbálás?¶

Az újrapróbálás:

visszaállítja a hibás számlákat pending állapotba,
törli a korábbi részletes letöltési hibajelzést,
új letöltési körben ismét feldolgozhatóvá teszi őket.

Mikor hasznos az újrapróbálás?

Például akkor, ha a letöltés közben átmeneti NAV kapcsolatprobléma történt, vagy egy ideiglenes kapacitáshiba miatt néhány számla nem töltődött le elsőre.

Fontos működési sajátosságok¶

A modul a korábban letöltött számlafej rekordokra épül.
A részletes letöltés jellemzően lassabb, mert minden számlához külön NAV kérés tartozik.
A rendszer párhuzamos lekérést és kötegelt adatbázisírást használ.
A már sikeresen feldolgozott számlák nem kerülnek újra részletes letöltésre.
A hibás letöltések külön újrapróbálhatók.
A folyamat kontrolláltan szüneteltethető.

Használati javaslatok¶

A részletes letöltést célszerű az alap NAV számlaletöltés után futtatni.
Nagy számlamennyiségnél számítson hosszabb feldolgozási időre.
Ha sok hibás rekord marad, ellenőrizze a NAV kapcsolatot és futtasson újrapróbálást.
A queue és sebesség kijelző segítségével jól követhető, hogy a folyamat inkább NAV oldalon vagy adatbázisírás oldalon terhelt.
Érdemes a folyamatot teljesen lefuttatni, mielőtt a részletes NAV adatokra épülő elemzéseket használja.

Gyakori kérdések¶

Miért nulla a letöltendő számlák száma?

Ennek oka lehet, hogy még nincs letöltött NAV számlafej adat, vagy a korábbi számlák részletes feldolgozása már megtörtént.

Mit jelent, hogy a részletes letöltés lassú?

A rendszer minden számlához külön NAV hívást végez, majd a részletes XML-t külön feldolgozza és adatbázisba menti. Ez jóval időigényesebb, mint az összesítő számlaadatok letöltése.

Mi történik, ha szüneteltetem a folyamatot?

Az új NAV lekérések leállnak, de a már futó műveletek még lezárulnak, ezért a megállás nem mindig azonnali.

A már letöltött számlák újra feldolgozódnak?

Nem. A rendszer csak a pending vagy még státusz nélküli számlákat dolgozza fel, a már completed állapotú rekordokat nem tölti le újra.

Mikor használjam a Hibás újrapróbálása gombot?

Akkor, ha a failed számlák száma nem nulla, és valószínűleg átmeneti hiba miatt maradtak feldolgozatlanul.

Összefoglalás¶

A NAV Részletes számlaadatok letöltése modul abban segít, hogy a felhasználó a NAV számlafej adatok mögé a teljesebb, sor szintű részleteket is betöltse és elérhetővé tegye az adatbázisban.

Különösen hasznos akkor, ha:

a NAV számlák tételszintű vizsgálata szükséges,
sor szintű termék- vagy szolgáltatásadatokra van szükség,
részletes összegek, áfakulcsok vagy számlasorok alapján kell elemezni,
a NAV számlákat más adatforrásokkal részletesen szeretné összevetni.

A modul használatával a NAV számlák jóval mélyebb adatmélységben válnak elérhetővé, ami támogatja az egyeztetést, az ellenőrzést és a részletes elemzési munkát.