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áltozat | ||
spec:nav_onlineszamla_data [2019/12/06 14:08] – [2.2.2.2. customerInfo (Vevő)] delfin | spec:nav_onlineszamla_data [2020/03/04 23:19] (aktuális) – [2.3.1 BankAccountNumberType] delfin | ||
---|---|---|---|
Sor 50: | Sor 50: | ||
Módosításkor, | 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 ===== | ===== 2.2.2 invoiceHead ===== | ||
Sor 81: | Sor 88: | ||
===== 2.2.2.4. invoiceDetail ===== | ===== 2.2.2.4. invoiceDetail ===== | ||
- | Nem implementált és így nem adatszolgáltatott FIXME: | + | * invoiceCategory: |
+ | * invoiceAppearance: | ||
+ | * paymentMethod: | ||
+ | * additionalInvoiceData Opcionális, | ||
+ | |||
+ | Nem kötelező, | ||
* invoiceDeliveryPeriodStart | * invoiceDeliveryPeriodStart | ||
* invoiceDeliveryPeriodEnd | * invoiceDeliveryPeriodEnd | ||
* invoiceAccountingDeliveryDate | * invoiceAccountingDeliveryDate | ||
- | * periodicalSettlement | + | * electronicInvoiceHash |
* smallBusinessIndicator (V2.0-tól) | * 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, | ||
+ | * unitPriceHUF (*) Ez az adat adatszolgáltatás időben kerül kiszámításra [[# | ||
+ | |||
+ | 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 ===== | ||
+ | |||
+ | 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, | ||
+ | |||
+ | adatszolgáltatva: | ||
+ | |||
+ | * lineNetAmountData | ||
+ | * lineNetAmount összes nettó, (a számla pénznemében) | ||
+ | * lineNetAmountHUF összes netto HUF-ban (*) | ||
+ | * lineVatRate Áfa mértéke [[# | ||
+ | * 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: 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 ===== | ||
+ | |||
+ | * summaryNormal [[# | ||
+ | * < | ||
+ | * 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.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 | ||
+ | |||
+ | ===== 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 ===== | ||