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
2.1.3.1. Egyszerű címadat
az eVir-ben a partner címében ha nincs kitöltve a közterület jellege
mező, 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 additionalAddressDetail
mezőben.
2.1.3.2. Részletes címadat
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
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)
átnézni a modifyWithoutMaster használatának eseteit.
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
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ó)
smallBusinessIndicator (V2.0-tól)
Ha releváns, akkor kötelező lenne, de nem implementált, így nem adatszolgáltatott mezők :
2.2.3. invoiceLines
2.2.3.1. line
lineNumber sorszm
-
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ó
-
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
unitPriceHUF (*) Ez az adat adatszolgáltatás időben kerül kiszámításra
lásd 2.2.3.2
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
-
-
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
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
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
A (*)-gal jelölt mezők adatszolgáltatás időben (tehát nem számla készítés időben) kerülnek megképzésre.
Indoklás: Ezen adatok a bizonylaton (HUF-tól eltérő pénznem esetén) NEM kerülnek a számlára, és a számlázás folyamatában sem kerülnek előállításra, de az adatok szolgáltatása kötelező.
adatszolgáltatva:
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
2.2.5.1. summaryNormal
Összesítés
summaryByVatRate
invoiceNetAmount
invoiceNetAmountHUF
invoiceVatAmount
invoiceVatAmountHUF
2.2.5.1.1 summaryByVatRate
Adókulcsok szerinti bontás
vatRate lásd 2.2.5.1.2
vatRateNetData
vatRateNetAmount
vatRateNetAmountHUF
vatRateVatData
vatRateVatAmount
vatRateVatAmountHUF
vatRateGrossData
vatRateGrossAmount
vatRateGrossAmountHUF
2.2.5.1.2 vatRate2
Ugyanaz mint a 2.2.3.2.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 Adattipusok
2.3.1 BankAccountNumberType
Nem kötelező mező, nem szolgáltatjuk
2.3.2 Boolean
2.3.3 DateType
2.3.4 ExchangeRateType
numeric(14,6)
nincs kerekítés, DB-ben pedig csak „NUMERIC”
2.3.5 InvoiceAppearanceType
Az eVir esetén jelenleg implementáltan mindig PAPER
2.3.6 InvoiceCategoryType
Az eVir esetén jelenleg implementáltan mindig NORMAL
2.3.7 MarginSchemeType
Kezelése az áfa törzsadat szerint
2.3.8 MonetaryType
Az eVir jelenleg implementáltan numeric(11,2)-t használ. Ez belefér a numeric(18,2)-be
2.3.9 PaymentMethodType
Kezelése a fizetési mód törzsadat szerint
2.3.10 ProductCodeCategoryType
Jelenleg implementált
Bővítés lehetséges, a ksh mező tartalma nem kötelez
Nem kötelező mező
2.3.11 ProductStreamType
Lásd: 2.2.3.8 Nem szolgáltatunk ilyet, nem kötelező
2.3.12 QuantityType
Numeric(22,6)
Ebbe elfér az egységár Numeric(20,5)
Majdnem belefér a mennyiség Numeric(25,5) (gyakorlati problémára nem számítunk
2.3.13 RateType
Áfakulcs számára pl: 0.27 Numeric(5,4)
2.3.14 TakeoverType
Lásd 2.2.3.8 Nem szolgáltatunk ilyet, nem kötelező
2.3.15 TimestampType
nav_timestamp()
2010-01-01 előtti érték nem adható meg. Ilyen régi számlák adatszolgáltatása
a pretext='OLD' (túl régi számla) kifogással indokolva nem történt meg.
2.3.16 UnitOfMeasureType
nav_uomt alaptábla
megys_uomt kapcsolótábla
A 'mennyiségi egységek' törzsadat használatával kezelhető.
Régi konvertált adatszerkezet esetén (bevezetés előtti adatok) ezen törzsadatok emberi átnézése volt szükséges.
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
pl. IFA (idegenforgalmi adó) gyüjtése esetén az OTHER lenne a helyes, erre viszont nincs támogatásunk (már cikktörzs szinten sem) TODO …
2.4 Korábbi adatszolgáltatás érvénytelenítése
A funkció implementálása nem kötelező.
Implementálása alacsony prioritás és specifikáció váltás miatt nem került frissítésre/kivezetésre.
2.5 Storno/Helyesbítő (Számlával egy tekintet alá eső okirat)
implementáció átnézése, tesztelése
megfelelőség dokumentálása
2.5.1 Érvénytelenítés (STORNO)
2.5.2 Módosítás (MODIFY)
2.5.3 Tételsorok módosulása (CREATE/MODIFY)
Az eVir mindig CREATE módon új (negatív) tételek hozzáadásával módosít.
2.5.4 Módosításkori adatok
2.5.5 Összegzés szabályai
2.5.6 Több számla módosítása
Az eVir ilyen módosító funkciót nem implementált, így ilyen adatot nem szolgáltat.
2.5.7 Többszöri módosítás