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 region mező, í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 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

• a (V2.0)-s adatszerkezet kibővült a 2.1.3 pontnál is említett region, valamint a lotNumber (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)

átnézni a modifyWithoutMaster használatának eseteit.

• eredeti számla OLD
• eredeti számla LOW_AFA
• eredeti számla jogelőd volt. (ez új)

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ó)
• smallBusinessIndicator (V2.0-tól)

Ha releváns, akkor kötelező lenne, de nem implementált, így nem adatszolgáltatott mezők :

• periodicalSettlement (V2.0-tól) időszakos elszámolás ezt ellenőrizni kell
• 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
• 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

• 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

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:

• 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 (*)

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

• summaryNormal lásd 2.2.5.1
• summarySimplified nincs implementálva
• summaryGrossData
  • invoiceGrossAmount
  • invoiceGrossAmountHUF

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

• 12345678-12345678-12345678 3*8
• 12345678-12345678 2*8
• AB12 55115530555555 IBAN 2 betű+2szám 11-30 szám

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

• OWN
• cikkszám

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