Kapcsolódó információk:
› Paraméterezési útmutatók

Korábbi változatok

Összehasonlított verziók

Kulcs

Beillesztett sor.
Törölt sor.
Formázás megváltoztatva.

...

Kódblokk

title	Az XML séma vázlata

<?xml version="1.30" encoding="UTF-8"?>
<Elojegyzett_Szamlak FileVersion="EJSZ_1.56" FileTimeStamp="2017.-04.-10." FileDestination="SUPKISZLA">
  <CsomagInfo>...</CsomagInfo>
  <Szamlak>...
    <Szamla>...
      <Fejlec>...
        <TrackingKod>...</TrackingKod>
        <Vevo>...</Vevo>
        <EgyebInfo>...</EgyebInfo>
        <Gyujtok>...</Gyujtok>
      </Fejlec>
      <Tetelsorok>...
        <Tetelsor>...
          <Cikk>...</Cikk>
          <Menny>...</Menny>
          <Gyujtok>...</Gyujtok>      
      </Tetelsor>
      </Tetelsorok>
      <KontrollFizBruttoOssz>...</KontrollFizBruttoOssz>
    </Szamla>
  </Szamlak>
</Elojegyzett_Szamlak>

...

XML tag	Kötelező	Leírás
CsomagInfo	Igen	A csomag leíró adatai.
Szamlak	Igen	A számlák leíró adatai.
Szamla	Igen	A számla leíró adatai.
Fejlec	Igen	A számla fejléc adatai.
TrackingKod	Igen	Azonosító, nyomon követésre szolgál. A számla közlemény rovatába íródik fel.
Vevo	Igen	A számlához tartozó vevőadatok.
EgyebInfo	Igen	A számlához tartozó egyéb információk.
KontrollFizBruttoOssz	Igen	Ellenőrző összeg. A számla tételsorainak bruttó összesen értéke.
Tetelsorok	Igen	A számla tételsor adatai.
Tetelsor	Igen	A számla tételsor adatai.
Cikk	Igen	A számla tételsorhoz tartozó cikkadatok.
Menny	Igen	A számla tételsorhoz tartozó cikk mennyiség adatai.

...

<CsomagInfo> adatcsoport

A <CsomagInfo> XML tag a számlázási utasítás csomag egészre vonatkozó információkat ír le.

...

Attributum	Típus	Leírás
AtvetelStatus	Boolean	Számla kiállításának sikeressége esetén: True
AtvetelTimeStamp	TimeStamp	Számla kiállításának sikeressége esetén a kiállítás időpontja.
AtvetelSzlasz	Char	Számla kiállításának sikeressége esetén a számla sorszám.

<Fejléc> adatcsoport

A számla fejléc adatai a <Fejlec> adatcsoportba kerülnek.

...

XML tag	Kötelező	Típus	Hossz	Leírás
VevoKod	I	C	11	Vevőkód, a SUP rendszer partnertörzsével összhangban. A rendszerparaméterek között, az átvételre vonatkozó beállítások között szabályozható, hogy új vevő esetén hibát üzenjen, vagy az új vevőt automatikusan vegye fel a partnertörzsbe.
VevoMegnev	I	C	80	Vevő megnevezése.
VevoIrsz	I	C	5	Vevő címéből az irányítószám.
VevoVaros	I	C	30	Vevő címéből a város.
VevoUtca	I	C	40	Vevő címéből a utca.
VevoEmail	N	C	40	Vevő email címe.
VevoAdoszam	N	C	15	Vevő adószáma kötőjelek nélkül.
VevoEuAdosz	N	C	2	Vevő közösségi adószámának országkód előtagja. A kétbetűs országkódokat ISO 3166-1 szabványnak megfelelően kell átadni. Csak EU tagállamok esetén kell kitölteni.
ESzlaKuldMod	N	C	1	Opcionális. E-számla küldés módja lehet: `ESZLAKULD_`NINCS `NINCS = 'N'; // Nem küld semmit ESZLAKULD_PDFERT = 'P'; // Számla értesítő - ProForma ESZLAKULD_PDFSZL = 'X'; // Elektronikusan továbbított PDF formátumú számla ESZLAKULD_`ESZLA `ESZLA = 'E'; // Hitelesített E-számla`
ESzlaMailAddress	N	C	127	Opcionális. E-mail címek. Vesszővel elválasztva több is megadható. Beállításra kerülnek a partnerhez.

...

XML tag	Kötelező	Típus	Hossz	Leírás
NyelvKod	N	C	2	Számla nyomtatási nyelv kódja, az ISO 639 kódolásnak megfelelően. A jelenleg nyelvek: 'en', 'de', 'sk', 'it'. Magyar esetén üresen hagyható, alapértelmezett nyelvkód: 'hu'.
DevTeljhely	N	C	1	Teljesítés helye: (B)elföld, (U)nión belül, (K)ülföld. Ha nincs megadva: (B)elföld
DevArfolyam	N	NUM	18 +6	Deviza árfolyam, megadása csak devizás számlák esetén. (Max. 18 karakter +6 tizedes hosszan adható meg.)
Fizmod	I	NUM	1	Fizetési mód, a SUP rendszer belső kódolásának megfelelően. 0 – Készpénz 4 – Átutalás
Telj	I	DATE	éééé-hh-nnéééé.hh.nn	Teljesítés időpontja.Magyar, vagy az ISO 8601 -es vagy magyar formátum szerint.
Kelt	I	DATE	éééé-hh-nnéééé.hh.nn	Számla kelt dátum.Magyar, vagy az ISO 8601 -es formátum szerint vagy magyar formátum szerint. A DbConnector REST API-n keresztül kiállított számlák esetén ez alapján lesz meghatározva a kiállított számla üzleti éve.
Elsz	N	DATE	éééé-hh-nn	Számviteli elszámolási időszak vége. ISO 8601 vagy magyar formátum szerint.
			éééé.hh.nn
Hatinap	I	NUM	3	A teljesítéshez partnertörzsben rögzített módon, a számla kelt vagy teljesítés dátumhoz viszonyított számított x nap a határidő. Új partner automatikus nyitása esetén a számla kelt a default.
Megjegyzes	N	C	1500	A számla közlemény rovata. Megjelenik a számlán a fejléc és a tételsorok között.
EngSzaz	I	NUM	4 +1	A számla egészére adott engedmény százalék 1 tizedes pontossággal. Engedmény nélküli számla esetén értéke: 0 (nulla). (Max. 4 karakter +1 tizedes hosszan adható meg.). Használata nem javasolt, az engedményt inkább a tételsoron célszerű adni.
Megrbizsz	N	C	15	Rendelés száma
ElozmTrackKod	N	C	C	A sztornózott, helyesbített számlák előzmény adat generálásához számla hivatkozás kikereséséhez szükséges adat.

<Tetelsorok> adatcsoport

A számla tételsor adatai. Itt kerül megadásra a számlázandó cikk és a kapcsolódó adatok.

...

XML tag	Kötelező	Típus	Hossz	Leírás
GyCsop1	N	C	4	Gyűjtő csoport kód, 1. indexen.
GyAzon1	N	C	12	A GyCsop1 alá tartozó gyűjtőazonosító kódja.
GyCsop2	N	C	4	Gyűjtő csoport kód, 2. indexen.
GyAzon2	N	C	12	A GyCsop2 alá tartozó gyűjtőazonosító kódja.
GyCsop3	N	C	4	Gyűjtő csoport kód, 3. indexen.
GyAzon3	N	C	12	A GyCsop3 alá tartozó gyűjtőazonosító kódja.
GyCsop4	N	C	4	Gyűjtő csoport kód, 4. indexen.
GyAzon4	N	C	12	A GyCsop4 alá tartozó gyűjtőazonosító kódja.

Tartalmi leírás - <Spec>...</Spec> adatcsoport

XML tag	Kötelező	Típus	Hossz	Leírás
ElhatTol	N	D	éééé-hh-nn	Ha a számlázási utasítás alapján készülő számla könyvelésének az időszaki elhatárolás kezelésről is szükséges rendelkezni, megadható az elhatárolás kezdő időszaka.


ElhatIg	N	D	éééé-hh-nn	Elhatárolás záró időszaka.
ElolegSzlasorsz	N	C	12	Ha a számla tételsor előleg levonás, akkor meg lehet adni az előleg számla sorszámát. Ezáltal a számla könyvelésekor az előleg folyószámla is automatikusan rendeződik.

Storno és helyesbítés

Az XML séma lehetőséget ad a storno ill. helyesbítő számlák kiállítására. Ez esetben a tételsor mennyiséget kell negatív számként megadni. Az eredeti számlára a ...<Számla> <Fejlec> <EgyebInfo> <ElozmTrackKod> megadásával lehet visszahivatkozni. Az előzmény tracking kód alapján a számla generálás kikeresi az előzményszámlát, és összekapcsolja azt a negatív számával.
A storno illetve a helyesbítő információ a számla címében is megjelenik. Az előzmény számla - storno számla páros vevő folyószámlán automatikusan zárt állapotba kerül.

Előleg kezelés

Speciális lehetőség, hogy az előleg levonást egészen a számla könyvelésén keresztül, az előleg folyószámla automatikus rendezéséig automatizálni lehet.

Ehhez a ...<Számla> Tetelsorok <Tetelsor> <Spec> <ElolegSzlasorsz> adatot kell megadni. Ez a lehetőség csak számla REST API szolgáltatáson keresztül kiállított számlák esetén érhető el, mivel el kell tárolni a korábban sikeresen kiállított előleg számla sorszámát.

Content

Munkatér eszközei