Ez a dokumentum egy előző változata!
Tartalomjegyzék
2. Számla adatszolgáltatás üzelti tartalom
Kötegelt módosító okiratot nem állít ki az eVir és így a batchInvoice nincs implementálva
2.1 Általános jellemzők
2.1.1. invoiceDataTyper
Változott, implementálva
2.1.2. kötelezőség
2.1.3. Címadatok
- Az ország, irányítószám, város adatok az elvárt szerkezetben állnak elő
: Az eVir-ben nincs az adatszolgáltatás szerinti regionmező, így nincs implementálva (V2.0)
2.1.3.1. Egyszerű címadat
- az eVir-ben a partner címében ha nincs kitöltve a
közterület jellegemező, akkor a címet egyszerű címként fogja a rendszer kezelni. - Ekkor minden egyéb mezőt (házszám, épület, lépcsőház, szint, ajtó) hozzáfűz a közterület neve mezőhöz és együttesen kerülnek azadatok beküldésre a
additionalAddressDetailmezőben.
2.1.3.2. Részletes címadat
- a (V2.0)-s adatszerkezet kibővült a 2.1.3 pontnál is említett
region, valamint alotNumber(AKA helyrajzi szám) mezővel. - Ilyen mezők nincsenek az eVirben implementálva.
2.1.4. Adószámok
- A magyar adószámokat a teljes
########-#-##formában kezeljük. - A NAV adatszolgáltatáskor ebből technikailag csak a 8 karakteres törzsszám kötelező minden esetben
- Kivétel: csoportos áfa alanyiság (kavarjunk-e az algoritmuson-e?) V1.1-óta dokumentált eset, V2.0 egyezik
- Adószám mezőben: A csoportazonosító számát
########-5-##' és akkor mellette: * Csoport_adószám mezőben: a csoport tag saját adószáma########-4-##' szerepeltetendő
- Ettől eltérő (pl. rövidebb, csak 8 karakter) esetben hibaüzenetet adunk.
- (lehet-e engedni ebből-e)
További részletes leírás az adószám szerepeltetéséről az API doksiban
2.1.5. Egyéb adatok
Mivel az így megadható adatok megadása nem kötelező, ilyen módon egyelőre semmilyen adatot nem szolgáltatunk.
2.1.6. tizedespont
2.2. Számla shéma
2.2.1. invoiceReference
Módosításkor, stornókor (2.0 változások implementálva)
2.2.2 invoiceHead
implementálva V1.1-V2.0 átálláskor nem változott
- supplierInfo
- customerInfo
- fiscalRepresentativeInfo pénzügyi képviselő ilyen információt az eVir számlázáskor nem kezel és így nem is adatszolgáltat.
- invoiceDetail
2.2.2.1. supplierInfo (Szállító)
V1.1=V2.0
- supplierBankAccountNumber: (company→bank) Banknevet is tartalmaz; nem kötelező mező, gyakorlatilag nem szolgáltatjuk, {ol}→{bankszla} sose kap valid értéket.
- individualExcemption (alanyi adó mentes) {company}→{nav_cimek}→{hucim}→{alanyi_adomenter}-bõl számolva
- exciseLicenceNum (jovedeki_adoraktari_engedely) ilyen információt az eVir nem kezel, és így nem is adatszolgáltat.
2.2.2.2. customerInfo (Vevő)
V1.1=V2.0
- thirdStateTaxId harmadik országbeli adószám nincs implementálva, nem adatszolgáltatjuk
- customerBankAccountNumber nem kerül a számlára, nem adatszolgáltatjuk
2.2.2.3. fiscalRepresentativeInfo
not implemented HA releváns, akkor kell adatszolgáltatni (fejlesztést igényel a számlázáskor)
2.2.2.4. invoiceDetail
- invoiceCategory: NORMAL. Az eVir nem készít egyszerűsített adattartalmú, és gyüjtőszámlákat.
- invoiceAppearance: PAPER. Az eVir nem készít elektronikus számlát, EDI számlát.
- paymentMethod: Fizetési módokhoz a törszadatokban kell beállítani a megfelelő leképezést a NAV által elvárt értékekre.
- additionalInvoiceData Opcionális, nem implementált, de bővítési lehetőség adva van (pl. megj)
Nem kötelező, Nem implementált és így nem adatszolgáltatott :
- invoiceDeliveryPeriodStart
- invoiceDeliveryPeriodEnd
- invoiceAccountingDeliveryDate
- electronicInvoiceHash (1/2018. (VI. 29.) ITM rendelet 7. § szerint használható)
Kötelezősége nem dokumentált (2019-12-05) Issue #92
- periodicalSettlement (V2.0-tól) időszakos elszámolás
- smallBusinessIndicator (V2.0-tól)
Ha releváns, akkor kötelező lenne, de nem implementált, így nem adatszolgáltatott mezők :
- selfBillingIndicator Önszámlázás jelölése
- cashAccountingIndicator Pénzforgalmi elszámolás jelölése (Záradék lehetne)
2.2.3. invoiceLines
2.2.3.1. line
- lineNumber sorszm
- lineModificationReference lásd 2.2.3.1.1.
- advanceIndicator előleg tétel esetén kötelező.
- Az információ a cikktörzsben állítható be, (előleg tétel)
- előlegszámlázáskor csak ilyen tétel használható
- productCodes cikkszám (opcionális) lásd 2.2.3.1.3.
- lineExpressionIndicator (mindig true)
- lineNatureIndicator tipus: termék vagy szolgáltatás tudjuk lásd 2.3.17
- lineDescription megnevezés (kötelező)
- quantity mennyiség (mindig releváns)
- unitOfMeasure mennyiségi egység a NAV dimenzióiban (megfeleltetés törzsadatokból, ha releváns)
- unitOfMeasureOwn mennyiségi egység (eVir szerint, (tudjuk, releváns))
- unitPrice egységár (nettó, számlapénznemben, releváns)
- (lineAmounts csak csoportosítom a következőket)
- lineAmountsNormal (mindig ezt használjuk, mert sose egyszerűsített számla)
- lineAmountsSimplified (Sose használjuk, mert sose egyszerűsített számla)
- intermediatedService közvetített szolgáltatás (ha releváns)
- marginSchemeIndicator Különbözet szerinti szabályozás ( ÁFA tv. 169. § p) q) ha releváns) afatörzs dokumentációba elmélyedni
- additionalLineData nem használjuk, de a bővítés lehetősége (pl. megj, megj2) adva van
NOS unimplemented (ezt ki kell üríteni)
- unitPriceHUF új, ilyenünk még nincs, de lehet hogy nem is lesz.
Nem kötelező, nem implementált és így nem adatszolgáltatott
- aggregateInvoiceLineData (gyűjtőszámlát nem implementáltunk) lásd 2.2.3.4
- ekaerIds
- obligatedForProductFee
- GPCExcise
- dieselOilPurchase
- netaDeclaration
- productFeeClause
- lineProductFeeContent
Ha releváns, akkor kötelező lenne, de nem implementált, így nem adatszolgáltatott mezők
- lineDiscountData tételhez tartozó árengedmény adatok lásd 2.2.3.1.4.
- referencesToOtherLines lásd 2.2.3.1.2.
- newTransportMean (ha releváns AFA tv. 89$ 169$ o)
- depositIndicator (ha releváns (a tétel betétdíj jellegű))
2.2.3.1.1. lineModificationReference
- lineNumberReference 1-től indul mindig az alapszámla soraival kezdve.
- lineOperation csak CREATE műveletet használunk
2.2.3.1.2. referencesToOtherLines
ha releváns ÁFA tv. 70$ (1), adóalapot növelő költségek esetén
eVirben ilyen nincs implementálva
2.2.3.1.3. productCodes
- productCode (multiplicitás lehetséges)
- productCodeCategory
- productCodeValue
- productCodeOwnValue
Csak az OWN (saját) productCode került implementálásra.
bővítési lehetőség KSH mező szerint elvileg lehetséges
2.2.3.1.4. lineDiscountData
Számla tétel engedmény megadásákor lehet ugyan megjegyzés mezőbe ehhez hasonlatos adatokat generálni, de az egységár mezőbe már mindig az engedménnyel csökkentett érték kerül. Így ezt az adatot az eVir nem szolgáltatja.
2.2.3.2. lineAmountsNormal
adatszolgáltatva:
- lineNetAmountData
- lineNetAmount összes nettó, (a számla pénznemében)
- lineNetAmountHUF összes netto HUF-ban (*)
- lineVatRate Áfa mértéke lásd 2.2.3.2.1
- lineVatData (opcionális)
- lineVatAmount összes áfa (a számla pénznemében)
- lineVatAmountHUF összes áfa HUF-ban (*)
- lineGrossAmountData (opcionális)
- lineGrossAmountNormal Összes bruttó (a számla pénznemében)
- lineGrossAmountNormalHUF Összes bruttó HUF-ban (*)
(*) A fentebb jelölt adatok általában nem állnak rendelkezésre tételes esetben.
Az (opcionális)-ként nem jelölt mezők kötelezőek
2.2.3.2.1. vatRate
Az alábbiak közül egy megadandó
- vatPercentage alkalmazott adó mértéke
- vatExemption adómentesség jelölése
- vatOutOfScope ÁFA tv. hatályán kívül
- vatDomesticReverseCharge belföldi fordított adózás
- marginSchemeVat különbözeti adózás (áthárított adót tartalmaz)
- marginSchemeNoVat különbözeti adózás (áthárított adót nem tartalmaz)
Az adatszolgáltatásokhoz szükséges áfakódok összerendelése az áfa törzsadatok href: között lehetséges.
Ennek működése (az összerendelést adatszolgáltatáskor használja) dokumentálandó
2.2.3.3. lineAmountsSimplified
Az eVir nem állít elő egyszerűsített adattartalmú számlát, így nem is szolgáltat ilyenről adatot.
2.2.3.4. aggregateInvoiceLineData
Az eVir nem állít elő gyűjtőszámlát így nem is szolgáltat ilyenről adatot
2.2.3.5. newTransportMean
Az eVir nem kezel ilyen adattartalmú tételsorokat, adatszolgáltatás nem történik.
2.2.3.5.1. vehicle
Az eVir nem kezel ilyen adattartalmú tételsorokat, adatszolgáltatás nem történik.
2.2.3.5.2. vessel
Az eVir nem kezel ilyen adattartalmú tételsorokat, adatszolgáltatás nem történik.
2.2.3.5.3 aircraft
Az eVir nem kezel ilyen adattartalmú tételsorokat, adatszolgáltatás nem történik.
2.2.3.6. ekaerIds
Az eVir nem kezel ilyen adattartalmú tételsorokat, adatszolgáltatás nem történik.
2.2.3.7. dieselOilPurchase
Az eVir nem kezel ilyen adattartalmú tételsorokat, adatszolgáltatás nem történik.
2.2.3.7.1. purchaseLocation
Az eVir nem kezel ilyen adattartalmú tételsorokat, adatszolgáltatás nem történik.
2.2.3.8. productFeeClause
Az adatszolgáltatás nem kötelező, adatszolgáltatás nem történik
2.2.3.8.1. productFeeTakeoverData
2.2.3.8.2. customerDeclaration
2.2.3.9. lineProductFeeContent
Az adatszolgáltatás nem kötelező, adatszolgáltatás nem történik
2.2.3.9.1. productFeeCode
2.2.3.10 additionalLineData
Nem szolgáltatunk adatot ebben a formában
2.2.4. productFeeSummary
Az adatszolgáltatás nem kötelező, adatszolgáltatás nem történik
2.2.4.1. productFeeData
2.2.4.1.2. paymentEvidenceDocumentData
2.2.4.1.2.1. obligatedAddress
2.2.5. invoiceSummary
waitfor 2.2.5.1. WIP
2.2.5.1.
: 2.2.5. WIP
waitfor 2.2.5.1.1
2.2.5.1.1 summaryByVatRate
2.2.5.1. WIP
2.2.5.1.2 vatRate2
Ugyanaz mint a 2.2.3.1.1 :)
2.2.5.2. summarySimplified
Egyszerűsített számlát nem készít, így ilyen adatot nem szolgáltat az eVir
2.3.17 lineNatureIndicator
a mező kötelezősége nemdokumentált
alapvetően kezelni tudjuk a termék és szolgáltatásokat.
A következő esetekben kell figyelmet fordítani az adatokra, illetve az eVir implementációjára
- Ha valaki raktármodul nélkül termékeket kezel (amik belsőleg szolgáltatások) akkor ott false SERVICE lesz az eredmény
- Az adózó nem saját javára szed be díjakat (pl. idegenforgalmi adó) ekkor ez OTHER kategóriába kerülhetne erre az eVir jelenleg nem ad támogatást, és az esetek nincsenek feltérképezve, hogy valaki használná-e
Részletes útmutatás az API doksiban