Felhasználói eszközök

Eszközök a webhelyen


spec:nav_onlineszamla_data

Ez a dokumentum egy előző változata!


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ő
  • FIXME: 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

  • FIXME 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 FIXME (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.
  • 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, 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ő 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: (company→bank) Banknevet is tartalmaz; nem kötelező mező, gyakorlatilag nem szolgáltatjuk, {ol}→{bankszla} sose kap valid értéket. FIXME
  • individualExcemption (alanyi adó mentes) {company}→{nav_cimek}→{hucim}→{alanyi_adomenter}-bõl számolva
  • 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, nem adatszolgáltatjuk FIXME
  • 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: 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) FIXME

Nem kötelező, Nem implementált és így nem adatszolgáltatott FIXME:

  • 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 FIXME

  • 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 FIXME:

  • 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) FIXME 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 FIXME

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) 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) 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 lásd 2.2.3.2.1
  • 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, 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.

FIXME: 2.2.5. WIP waitfor 2.2.5.1.1

2.2.5.1.1 summaryByVatRate

FIXME 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

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, és az esetek nincsenek feltérképezve, hogy valaki használná-e

Részletes útmutatás az API doksiban

spec/nav_onlineszamla_data.1576189654.txt.gz · Utolsó módosítás: 2019/12/12 23:27 szerkesztette: delfin