A kiválasztott változat és az aktuális verzió közötti különbségek a következők.
Előző változat mindkét oldalonElőző változatKövetkező változat | Előző változatKövetkező változatKövetkező változat mindkét oldalon | ||
spec:nav_onlineszamla_data [2019/12/03 14:59] – delfin | spec:nav_onlineszamla_data [2020/03/04 22:53] – [2.2.5. invoiceSummary] delfin | ||
---|---|---|---|
Sor 5: | Sor 5: | ||
===== 2.1 Általános jellemzők ===== | ===== 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, | ||
+ | * FIXME: Az eVir-ben nincs az adatszolgáltatás szerinti '' | ||
+ | |||
+ | ===== 2.1.3.1. Egyszerű címadat ===== | ||
+ | |||
+ | * az eVir-ben a partner címében ha nincs kitöltve a '' | ||
+ | * Ekkor minden egyéb mezőt (házszám, épület, lépcsőház, | ||
+ | |||
+ | ===== 2.1.3.2. Részletes címadat ===== | ||
+ | |||
+ | * FIXME a (V2.0)-s adatszerkezet kibővült a 2.1.3 pontnál is említett '' | ||
+ | * Ilyen mezők nincsenek az eVirben implementálva. | ||
+ | |||
+ | ===== 2.1.4. Adószámok ===== | ||
+ | |||
+ | * A magyar adószámokat a teljes ''######## | ||
+ | * 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 FIXME (kavarjunk-e az algoritmuson-e? | ||
+ | * Adószám mezőben: A csoportazonosító számát ''######## | ||
+ | * Csoport_adószám mezőben: a csoport tag saját adószáma ''######## | ||
+ | * Ettől eltérő (pl. rövidebb, csak 8 karakter) esetben hibaüzenetet adunk. | ||
+ | * FIXME (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, | ||
+ | |||
+ | FIXME á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ő FIXME 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: | ||
+ | * individualExcemption (alanyi adó mentes) {company}-> | ||
+ | * exciseLicenceNum (jovedeki_adoraktari_engedely) FIXME 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, | ||
+ | * customerBankAccountNumber nem kerül a számlára, nem adatszolgáltatjuk FIXME | ||
+ | |||
+ | ===== 2.2.2.3. fiscalRepresentativeInfo ===== | ||
+ | |||
+ | FIXME not implemented HA releváns, akkor kell adatszolgáltatni (fejlesztést igényel a számlázáskor) | ||
+ | |||
+ | ===== 2.2.2.4. invoiceDetail ===== | ||
+ | |||
+ | * invoiceCategory: | ||
+ | * invoiceAppearance: | ||
+ | * paymentMethod: | ||
+ | * additionalInvoiceData Opcionális, | ||
+ | |||
+ | Nem kötelező, Nem implementált és így nem adatszolgáltatott FIXME: | ||
+ | |||
+ | * invoiceDeliveryPeriodStart | ||
+ | * invoiceDeliveryPeriodEnd | ||
+ | * invoiceAccountingDeliveryDate | ||
+ | * electronicInvoiceHash (1/2018. (VI. 29.) ITM rendelet | ||
+ | * smallBusinessIndicator (V2.0-tól) | ||
+ | |||
+ | Ha releváns, akkor kötelező lenne, de nem implementált, | ||
+ | |||
+ | * periodicalSettlement (V2.0-tól) időszakos elszámolás FIXME FIXME 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 [[# | ||
+ | * 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) [[# | ||
+ | * lineExpressionIndicator (mindig true) | ||
+ | * lineNatureIndicator tipus: termék vagy szolgáltatás tudjuk [[# | ||
+ | * 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, | ||
+ | * unitOfMeasureOwn mennyiségi egység (eVir szerint, (tudjuk, releváns)) | ||
+ | * unitPrice egységár (nettó, számlapénznemben, | ||
+ | * (lineAmounts csak csoportosítom a következőket) | ||
+ | * lineAmountsNormal (mindig ezt használjuk, | ||
+ | * lineAmountsSimplified (Sose használjuk, | ||
+ | * 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) FIXME afatörzs dokumentációba elmélyedni | ||
+ | * additionalLineData nem használjuk, | ||
+ | |||
+ | NOS unimplemented FIXME (ezt ki kell üríteni) | ||
+ | |||
+ | * unitPriceHUF FIXME ú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) [[# | ||
+ | * ekaerIds | ||
+ | * obligatedForProductFee | ||
+ | * GPCExcise | ||
+ | * dieselOilPurchase | ||
+ | * netaDeclaration | ||
+ | * productFeeClause | ||
+ | * lineProductFeeContent | ||
+ | |||
+ | Ha releváns, akkor kötelező lenne, de nem implementált, | ||
+ | |||
+ | * lineDiscountData tételhez tartozó árengedmény adatok [[# | ||
+ | * referencesToOtherLines [[# | ||
+ | * newTransportMean (ha releváns AFA tv. 89$ 169$ o) FIXME | ||
+ | * depositIndicator (ha releváns (a tétel betétdíj jellegű)) FIXME | ||
+ | |||
+ | ===== 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. | ||
+ | |||
+ | FIXME 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 FIXME (*) | ||
+ | * lineVatRate Áfa mértéke [[# | ||
+ | * lineVatData (opcionális) | ||
+ | * lineVatAmount összes áfa (a számla pénznemében) | ||
+ | * lineVatAmountHUF összes áfa HUF-ban FIXME (*) | ||
+ | * lineGrossAmountData (opcionális) | ||
+ | * lineGrossAmountNormal Összes bruttó (a számla pénznemében) | ||
+ | * lineGrossAmountNormalHUF Összes bruttó HUF-ban FIXME (*) | ||
+ | |||
+ | (*) 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: FIXME között lehetséges. | ||
+ | |||
+ | Ennek működése (az összerendelést adatszolgáltatáskor használja) dokumentálandó FIXME | ||
+ | |||
+ | ===== 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 ===== | ||
+ | |||
+ | FIXME Az eVir nem kezel ilyen adattartalmú tételsorokat, | ||
+ | |||
+ | ==== 2.2.3.5.1. vehicle ==== | ||
+ | |||
+ | Az eVir nem kezel ilyen adattartalmú tételsorokat, | ||
+ | |||
+ | ==== 2.2.3.5.2. vessel ==== | ||
+ | |||
+ | Az eVir nem kezel ilyen adattartalmú tételsorokat, | ||
+ | |||
+ | ==== 2.2.3.5.3 aircraft ==== | ||
+ | |||
+ | Az eVir nem kezel ilyen adattartalmú tételsorokat, | ||
+ | |||
+ | ===== 2.2.3.6. ekaerIds ===== | ||
+ | |||
+ | Az eVir nem kezel ilyen adattartalmú tételsorokat, | ||
+ | |||
+ | ===== 2.2.3.7. dieselOilPurchase ===== | ||
+ | |||
+ | Az eVir nem kezel ilyen adattartalmú tételsorokat, | ||
+ | |||
+ | ==== 2.2.3.7.1. purchaseLocation ==== | ||
+ | |||
+ | Az eVir nem kezel ilyen adattartalmú tételsorokat, | ||
+ | |||
+ | ===== 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 ===== | ||
+ | |||
+ | Mivel csak NORMAL számlát állítunk elő, ezért csak az ennek megfelelő adatok kerülnek előállításra | ||
+ | |||
+ | (Tehát egyszerűsített számla adat nem) | ||
+ | |||
+ | |||
+ | ===== 2.2.5.1. ===== | ||
+ | |||
+ | Implementálva | ||
+ | |||
+ | ===== 2.2.5.1.1 summaryByVatRate ===== | ||
+ | |||
+ | Implementálva, | ||
+ | ===== 2.2.5.1.2 vatRate2 ===== | ||
+ | |||
+ | Ugyanaz mint a [[# | ||
+ | |||
+ | ===== 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 | ||
+ | * AB55115530555555 IBAN 2 betű 11-30 szám | ||
+ | |||
+ | ===== 2.3.2 Boolean ===== | ||
+ | ===== 2.3.3 DateType ===== | ||
+ | ===== 2.3.4 ExchangeRateType ===== | ||
+ | |||
+ | numeric(14, | ||
+ | |||
+ | FIXME nincs kerekítés, | ||
+ | |||
+ | ===== 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.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, | ||
+ | |||
+ | 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, | ||
+ | |||
+ | * Ebbe elfér az egységár Numeric(20, | ||
+ | * Majdnem belefér a mennyiség Numeric(25, | ||
+ | |||
+ | ===== 2.3.13 RateType ===== | ||
+ | |||
+ | Áfakulcs számára pl: 0.27 Numeric(5, | ||
+ | |||
+ | ===== 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=' | ||
+ | |||
+ | ===== 2.3.16 UnitOfMeasureType ===== | ||
+ | |||
+ | * nav_uomt alaptábla | ||
+ | * megys_uomt kapcsolótábla | ||
+ | |||
+ | A ' | ||
+ | |||
+ | 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 ===== | ||
+ | |||
+ | FIXME 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) FIXME 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 FIXME erre az eVir jelenleg nem ad támogatást, | ||
+ | |||
+ | Részletes útmutatás az API doksiban | ||
+ | |||
+ | FIXME 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ő. FIXME | ||
+ | |||
+ | Implementálása alacsony prioritás és specifikáció váltás miatt nem került frissítésre/ | ||
+ | |||
+ | ===== 2.5 Storno/ | ||
+ | |||
+ | FIXME implementáció átnézése, | ||
+ | |||
+ | FIXME 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/ | ||
+ | |||
+ | 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, | ||
+ | |||
+ | ===== 2.5.7 Többszöri módosítás ===== | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||