Az oldal megtekintéséhez kérjük, engedélyezze a JavaScriptet.

sERPa súgó

A függvény egy vevő számlából előállítja a NAV Online adatszolgáltatás részére az XML-t.

Azt a vevőszámlát kell exportálnunk, amit a cég kiadott a partnere részére.

Típus

függvény

Bemenő paraméterek

VevoSz_ID

smallint

SorszamKoz

 

Eredményhalmaz

Az adatoknak az itt leírt sorrendben kell egymást követniük.

?xml version="1.0" encoding="UTF-8" ?

Invoice

xmlns = "http://schemas.nav.gov.hu/OSA/1.0/data"

Mező

Tulajdonság

Leírás

InvoiceExchange



invoiceReference



 

@originalInvoiceNumber

Az eredeti számla sorszáma, melyre a módosítás vonatkozik  - ÁFA tv. 170. § (1) (Amennyiben egy számlabokor van, úgy az első számla, melyből kiindul a többszöri helyesbítés, vagy sztornózás)

 

@modificationIusseDate

Módosító okirat kelte  - ÁFA tv. 170. § (1) bek. (Helyesbítő, vagy stornó)

 

@invoiceModificationTimestamp

A módosító okirat készítésének időbélyege a forrásrendszerben UTC időben

 

@lastModificationDocumentNumber

Az eredeti számla legutóbbi módosító okiratának sorszáma (ha létezik) (Amennyiben nem két számlás bokorról beszélünk, hanem mondjuk egy helyesbítés sztornózásáról, úgy a helyesbítő számla száma lenne, azaz a most beküldött számla előtti számla bizonylatszáma)

 

@modifyWithoutMaster

Annak jelzése, hogy a módosítás olyan alapszámlára hivatkozik, amelyről nem történt és nem is fog történni adatszolgáltatás (true csak akkor, ha az eredeti számlát nem adjuk át, false akkor ha az eredeti számlát is átadjuk az OSA-ba)

/invoiceReference



invoiceHead



supplierInfo


A kibocsátóra vonatkozó mezőkre igaz: VevoSz.SajatAdat_ID + VevoSz.SajatAdatTelephely_ID -ből kell venni (ha a telephely ki van töltve, akkor abból)

supplierTaxNumber


Ha  SajatAdat.CsKAdoszam <> NULL akkor az, egyébként SajatAdat.Adoszam

 

@taxpayerID

SajatAdat.CsKAdoszam vagy SajatAdat.Adoszam első 8 számjegye

 

@vatCode

...Adoszam első 9. számjegye

 

@countyCode

...Adoszam első 10-11. számjegye

/supplierTaxNumber



groupMemberTaxNumber


Ha  SajatAdat.CsKAdoszam <> NULL akkor SajatAdat.Adoszam

 

@taxpayerID

SajatAdat.Adoszam első 8 számjegye

 

@vatCode

SajatAdat.Adoszam első 9. számjegye

 

@countyCode

SajatAdat.Adoszam első 10-11. számjegye

/groupMemberTaxNumber



 

@communityVatNumber

HA VevoSz.SzamlaDatum a SajatAdatEUAdoszam időszakába esik, akkor "HU" + SajatAdat.CsKAdoszam vagy ha ez üres akkor SajatAdat.Adoszam

 

@supplierName

SajatAdat.HosszuCegnev

supplierAddress



detailedAddress


HA a cím UtcaHSzam része felbontható. (parseUtcaHSzam függvényt kell használni. Ezt a részt kell kitölteni, ha EgyebCim = NULL)

 

@countryCode

Saját adat telephelyből vagy saját adatból.

 

@region

egyelőre nem használjuk (csak belfüöldi számlákkal kell foglalkozni)

 

@postalCode


 

@city


 

@streetName

parseUtcaHSzam.KozterNev

 

@publicPlaceCategory

parseUtcaHSzam.KozterJelleg

 

@number

parseUtcaHSzam.HazSzam

 

@building

parseUtcaHSzam.Epulet

 

@staircase

parseUtcaHSzam.Lepcsohaz

 

@floor

parseUtcaHSzam.Emelet

 

@door

parseUtcaHSzam.Ajto

 

@lotNumber

parseUtcaHSzam.HRSZ

 



/detailedAddress



simpleAddress


A parseUtcaHSzam függvényt kell használni. Ezt a részt kell kitölteni, ha EgyebCim <> NULL)

 

@countryCode

Saját adat telephelyből vagy saját adatból.

 

@region

egyelőre nem használjuk (csak belfüöldi számlákkal kell foglalkozni)

 

@postalCode


 

@city


 

@additionalAddressDetail

parseUtcaHSzam.EgyebCim

/simpleAddress



/supplierAddress


 

 

@supplierBankAccountNumber

VevoSz.Bankszamla_ID -> Bankszamla.Bankszamlaszam 8 karakterenként kötőjellel

 



 

@individualExemption

HA PenzEv.AfaAlanyiAdomentesseg=1 akkor TRUE

 

@exciseLicenceNum

SajatAdatTelephely -> AdoraktarEngedelyszam

 


 

/supplierInfo


 

customerInfo


 

customerTaxNumber


VevoSzFSzNKieg.CsKAdoszam vagy VevoSzFSzNKieg.Adoszam vagy Ugyfel.CsKAdoszam vagy Ugyfel.Adoszam

.....


 

/customerTaxNumber



groupMemberTaxNumber


HA CsKAdoszam <>NULL AKKOR Adoszam

....



/groupMemberTaxNumber



 

@communityVatNumber

Ugyfel.EUAdoszam

 

@thirdStateTaxId


 

@customerName

VevoSzFSzNKieg.Nev vagy Ugyfel.Nev

customerAddress



detailedAddress



 

...

VevoSzFSzNKieg vagy Ugyfel

/detailedAddress



simpleAddress



 

...

VevoSzFSzNKieg vagy Ugyfel

/simpleAddress



 



 

@customerBankAccountNumber

szerintem nem kell

 



/customerInfo



fiscalRepresentativeInfo


 

 

.....

Pénzügyi képviselő adatai, egyelőre nincs ilyen a sERPában.

/fiscalRepresentativeInfo


 

invoiceData


 

 

@invoiceNumber

Bizonylatszám (Év+Sorozat+Sorszám)

 

@invoceCategory

NORMAL

Egyébként

SIMPLIFIED

Soha

AGGREGATE

Ha SzamlaTipus = [8,9]

 

@invoiceIusseDate

SzamlaDatum

 

@invoiceDeliveryDate

TeljesitesDatum

 

@invoiceDeliveryPeriodStart

ElszamoltIdoszakKezdete

 

@invoiceDeliveryPeriodEnd

ElszamoltIdoszakVege

 

@invoiceAccountingDeliveryDate

KonyvelesDatum (Számviteli teljesítés dátuma)

 

@currencyCode

Deviza_ID -> Deviza

 

@exchangeRate

PenzEv.ArfolyamPenzintezet_ID és ArfolyamTipus szerint meghatározott árfolyam.

 

@selfBillingIndicator

TRUE Ha szállító számlából készül az export (önszámlázás)

 

@paymentMethod

TRANSFER


CASH


CARD


VOUCHER


OTHER


FizetesiMod_ID -> FizetesiMod.FizetesiMod -> Felsorolt típus tétel kód.

 

@paymentDate

EsedekessegDatum

 

@cashAccountingIndicator

TRUE Ha PenzforgalmiAfa = 1 (2=felvásárlási jegy, az egyáltalán nem kell az adatszolgáltatásba)

 

@invoiceAppearance

PAPER


ELECTRONIC

ArchivaltHitelesSz = 1

EDI


UNKNOWN


 

@electronicInvoiceHash

Elektromikus számla esetén annak SHA256 lenyomata.

 

@additionalInvoiceData

Nincs egyelőre.

 

@additionalLineData

       

 

A00001_MEGJEGYZES: A tételmegjegyzés első 512 karaktere

A00001_MEGJEGYZES_FOLYT: A tételmegjegyzés második 512 karaktere

/invoiceData


 

/invoiceHead


 

invoiceLines


 

line


VevoSzTetel

 

@lineNumber

VevoSzTetel_ID

lineModificationReference



 

@lineNumberReference

HelyesbitettVevoSzTetel_ID -> Sorrend

 

@lineOperation

CREATE


MODIFY


/lineModificationReference



        referencesToOtherLines

 
 


 

@referenceToOtherLine

DRS esetén a szülő tétel sorszáma.

(SzuloVevoSzTetel_ID)

              /referencesToOtherLines



 

@advanceIndicator

TRUE Ha VevoSz.ElolegTipus = 1

productCodes^



 

@productCodeCategory

VTSZ


SZJ


KN


AHK


CSK


KT


EJ


OWN


OTHER


BesorolasiSzam.Tipus -> FelsoroltTipus.Kod

 

@productCodeValue

BesorolasiSzam.Kod

 



/productCodes



 

@lineDescripton

Termek_ID -> Termek.Nev, Szoveg

 

@quantity

Mennyiseg

 

@unitOfMeasure

MennyisegEgyseg_ID -> MennyisegEgyseg.Nev

 

@unitPrice

NettoEgysegar

lineDiscountData



 

@discountDescription


 

@discountValue

EngedmenyOsszeg

 

@discountRate

EngedmenySzazalek

/lineDiscountData



lineAmountsNormal



 

@lineNetAmount

NettoErtek

lineVatRate



 

@vatPercentage

AdoKulcs -> százalék

 

@vatExemption

FelsoroltTipusTetel.Nev ahol FelsoroltTipus_ID=352

 

@vatOutOfScope

HA AfaAnalitika1=6 AKKOR TRUE

 

@vatDomesticReverseCharge

HA AfaAnalitika1=[15,16,17,20] AKKOR TRUE

 

@marginSchemeVat


 

@marginSchemeNoVat


/lineVatRate



 

@lineVatAmount


 

@lineVatAmountHUF


 

@lineGrossAmount


/lineAmountsNormal



 

@intermediatedService

TRUE Ha KozvetitettSzolgaltats=1

aggregateInvoiceLineData



 

@lineExchangeRate

HA VevoSz.Deviza_ID>0 AKKOR VevoSzTeteDKKieg.NettoErtek (Deviza_ID=0) / VevoSzTetel.NettoErtek

 

@lineDeliveryDate

HA VevoSz.SzamlaTipus=[8,9] AKKOR GyujtoSzlaTeljDatum VAGY VevoSzTetelSzLevelTetel -> SzLevel.Datum

/aggregateInvoiceLineData



newTransportMean



 

...


/newTransportMean



 

@depositIndicator

 

 

@marginSchemeIndicator

TRAVEL_AGENCY

AfaAnalitika2=20

SECOND_HAND

AfaAnalitika3=18

ARTWORK

AfaAnalitika3=19

ANTIQUES

AfaAnalitika3=20

ekaerIds



 

@ekaerId


/ekaerIds



 

@obligatedForProductFee

TRUE ha VevoSzTermekDij<>0 (vagy VevoSzTetelTermekdijReszl-ből?)

 

@GPCExcise

Földgáz, villamosenergia, szén jövedéki adója (nem kezeljük)

dieselOilPurchase


Üzemanyag eladás (nem kezeljük)

 



/dieselOilPurchase



 

@netaDeclaration

HA Termek_ID -> Termek -> TermekNepEuTermekAdo -> NepEuTermekAdoSzlaTipus = 0 AKKOR TRUE

productFeeClause



productFeeTakeoverData


HA VevoSzTetelTermekdijReszl.KTKod2_ID = [...]

 

@takeover

01


02_aa


02_ab


02_b


02_c


02_d


02_ea


02_eb


02_fa


02_fb


02_ga


02_gb


 

@amount

összeg

/productFeeTakeoverData



costumerDeclaration


HA VevoSzTetelTermekdijReszl.KTKod2_ID = [...]

 

@productStream

BATTERY


PACKING


OTHER_PETROL


ELECTRONIC


TIRE


COMMERCIAL


PLASTIC


OTHER-CHEMICAL


PAPER


 

@productWeight


 



 



 

@productWeight


/costumerDeclaration



/productFeeClause



lineProductFeeContent



productFeeCode



 

@productCodeCategory

CSK

VevoSzTetelTermekdijReszl -> Csk kód

KT

VevoSzTetelTermekdijReszl  - KT kód

 

@productCodeValue

VevoSzTetelTermekdijReszl -> CsKKod (1+2+3+4) vagy KTKod (1+2+3).

/productFeeCode



 

@productQuantity

VevoSzTetelTermekdijReszl.TermekdijAlap

 

@measuringUnit

VevoSzTetelTermekdijReszl.Termekdij_ID -> TermekDij.MennyisegEgyseg_ID -> MennyisegEgyseg.Nev

 

@productFeeRate

VevoSzTetelTermekdijReszl.TermekdijMertek

Ahol VevoSzTetelTermekdijReszl.TermekDijKod_ID in (select TermekDijKod_ID from termekdijkod where szoveg like '%visszaigény%')

 

@productFeeAmount

VevoSzTetelTermekdijReszl.TermekdijOsszeg (u.a.)

/lineProductFeeContent



 

@additionalLineData


/line


 

/invoiceLines


 

productFeeSummary


Termékdíjjal kapcsolatos adatok

refundData



productFeeData


 

productFeeCode


 

 

@productCodeCategory

 

 

@productCodeValue

 

/productFeeCode


 

 

@productQuantity

 

 

@measuringUnit

 

 

@productFeeRate

 

 

@productFeeAmount

 

/productFeeData


 

 

@aggregateProductCharge


paymentEvidenceDocumentData


 

 

@invoiceNo

VevoSzTetelTermekdijReszl.SzamlaSzam

 

@invoiceDate

VevoSzTetelTermekdijReszl.SzamlaDatum

 

@obligatedName

VevoSzTetelTermekdijReszl.Ugyfel_ID -> Ugyfel.Nev

obligatedAddress



detailedAddress


VevoSzTetelTermekdijReszl.Ugyfel_ID -> Ugyfel cím adatokból

 

@countryCode

 

 

@region

 

 

@postalCode

 

 

@city

 

 

@streetName

 

 

@publicPlaceCategory

 

 

@number

 

 

@building

 

 

@staircase

 

 

@floor

 

 

@door

 

 

@lotNumber

 

 


 

/detailedAddress


 

simpleAddress


 

 

@countryCode

 

 

@region

 

 

@postalCode

 

 

@city

 

 

@additionalAddressDetail

 

/simpleAddress


 

/obligatedAddress


 

TaxNumberOfObligator


VevoSzTetelTermekdijReszl.Ugyfel_ID -> Ugyfel.Adoszam-ból

 

@taxpayerID

 

 

@vatCode

 

 

@countyCode

 

/TaxNumberOfObligator


 

/paymentEvidenceDocumentData


 

/refundData


 

productDepositData


Termék raktárba történő beszállításakor

productFeeData


Mint az előző részben

productFeeCode


 

 

@productCodeCategory

 

 

@productCodeValue

 

/productFeeCode


 

 

@productQuantity

 

 

@measuringUnit

 

 

@productFeeRate

 

 

@productFeeAmount

 

/productFeeData


 

 

@ProductChargeSum

 

/productDepositData


 

/productFeeSummary


 

InvoiceSummary


 

summaryNormal


 

summaryByVatRate



vatRate



 

@vatPercentage

 

 

@vatExemption


 

@vatOutOfScope


 

@vatDomesticReverseCharge

 

 

@marginSchemeVat

 

 

@marginSchemeNoVat

 

/vatRate


 

 

@vatRateNetAmount

SUM(VevoSzTetel.NettoErtek)

 

@vatRateVatAmount

SUM(VevoSzTetel.AfaErtek)

 

@vatRateVatAmountHUF

SUM(VevoSzTetelDKKieg.AfaErtek+AfaArfKulonbozet)

 

@vatRateGrossAmount

@vatRateNetAmount+@vatRateVatAmount

/summaryByVatRate



 

@invoiceNetAmount

Mint az előző, csak nem adókulcsonként.

 

@invoiceVatAmount


 

@invoiceVatAmountHUF


/summaryNormal



summarySimplified



/summarySimplified




@invoiceGrossAmount

@invoiceNetAmount+@invoiceVatAmount

/InvoiceSummary



InvoiceExchange



 

XML séma: https://onlineszamla.nav.gov.hu/dokumentaciok

 

Alkalmazó funkciók és tárolt eljárások