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

Korábbi változatok

Összehasonlított verziók

Régi verzió 7

changes.mady.by.user QSoft

Mentés ekkor: '2014 nov. 28, ' típus

összehasonlítva

Új verzió Aktuális

changes.mady.by.user QSoft

Mentés ekkor: '2024 máj. 29, ' típus

Kulcs

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

...

Mivel XML file csak programozással állítható elő, lehetőség van számlák kiállítására Excel táblából is. Ez a az XML-es fogadáshoz képest meglehetősen leegyszerűsített, korlátozott lehetőségeket biztosít.

Qsboxmegjegyz
Ugyanez, angolul megtalálható a Outgoing invoices to import XML format útmutatóban.

...

Tartalomjegyzék

maxLevel	1

Qsboxjavaslat
Az alábbi séma szerint elkészített XML fájl szerkezetileg, formailag ellenőrizhető az Online XML Schema Validator segítségével.

Az XML séma

A számlázási utasítás az alábbi XML séma szerint elkészített file beolvasásával lehetséges.

Az XML teljes sémája a következő: shKiszlaImport.xsd
Diagram formában (vizuálisan): XML Séma séma
Minta XML file: Elojegyzett_szamlak.xml

Kódblokk

title	Az XML séma vázlata

<?xml version="1.0" encoding="UTF-8"?>
<Elojegyzett_Szamlak FileVersion="EJSZ_1.18" FileTimeStamp="2014.01.01.2020-03-18" FileDestination="SUPKISZLAPUKISZLA">
  <CsomagInfo>...</CsomagInfo>
  <Szamlak>...
    <Szamla>...
      <Fejlec>...
        <TrackingKod>...</TrackingKod>
        <Vevo>...</Vevo>
        <EgyebInfo>...</EgyebInfo>
        <Gyujtok>...</Gyujtok>
        <Visszatartas>...</Visszatartas>
      </Fejlec>
      <Tetelsorok>...
        <Tetelsor>...
          <Cikk>...</Cikk>
          <Menny>...</Menny>
          <Gyujtok>...</Gyujtok>      
      </Tetelsor>
      </Tetelsorok>
      <KontrollFizBruttoOssz>...</KontrollFizBruttoOssz>
    </Szamla>
  </Szamlak>
</Elojegyzett_Szamlak>

Qsboxfigyelem
Az XML file készítésekor figyelni kell az XML-ben nem megengedett speciális karakterek használatára. Pl.: & jel megfelelője: &

A következőkben az XML tag-ek részletes leírása kerül ismertetésre.

Tartalmi leírás

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.

Minta

Tartalmi leírás

XML tag	Kötelező	Típus	Hossz	Leírás
CegKod	Igen	C	10	A könyvelt cégeket a SUP rendszerben a CegKod azonosítja. Annak a cégnek a kódját kell megadni, amiben a kimenő számlának el kell készülnie.
KuldoKod	Igen	C	20	Küldő alrendszer megnevezése vagy azonosítója - konstans
Devnem	Nem	C	3	A csomag devizanemének 3 betűs ISO kódja. Devizanemenként külön csomagot kell képezni. 'HUF' devizanem esetén üresen kell hagyni.
FKNaplo RAMozgnem	Igen	C	3	A SUP^®

rendszerben

rendszer számviteli modulban meghatározott számlázási napló száma, vagy raktári számla esetén a mozgásnem kódja.

<Szamlak> adatcsoport

A <Szamlak> XML tag írja le a kiállítandó számlák tartalmát. Egy számla attributumokból, fejlécből és tételsorokból áll.

...

A számla attributumokon keresztül a SUP^® rendszer információt ad vissza a küldő félnek, a számla kiállításának sikerességéről, ill. a küldő fél megkapja a kiállított számla sorszámát is, melyet a saját rendszerében a TRACKINGKOD-hoz párosíthat.

Attributum	Típus	Leírás
AtvetelStatus

Boolean

BOOL	File alapú interface esetén a SUP rendszer által visszaírt adat. Számla kiállításának sikeressége esetén: True
AtvetelTimeStamp

TimeStamp

TSTAMP	File alapú interface esetén a SUP rendszer által visszaírt adat. Számla kiállításának sikeressége esetén a kiállítás időpontja.
AtvetelSzlasz

Char

C	File alapú interface esetén a SUP rendszer által visszaírt adat. Számla kiállításának sikeressége esetén a számla sorszám.
AutoNyomtatas	BOOL	Csak a DbConnector REST API-n keresztül kiállított számlák esetén lehet rá szükség. Ezzel lehet vezérelni, hogy a beküldött számla azonnal ki legyen-e nyomtatva. Default: True

Megjegyzés
A DbConnector REST API-n keresztül a számla PDF kép csak akkor kérhető le, ha az `AutoNyomtatas=true`.

<Fejléc> adatcsoport

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

Minta

Image Removed

Image Added

Tartalmi leírás

XML tag	Kötelező	Típus	Hossz	Leírás
TrackingKod	Igen	C	40	A küldő rendszer által képzett azonosító kód, mely az elkészült számlák nyomon-követésre szolgál. A SUP^® adatbázisban eltárolásra kerül az elkészült számlához. A számla nyomtatásakor is megjelenik a közlemény rovatában. Pl.: egy rendelés-nyilvántartó rendszer esetén a rendelésszám kerülhet ide, egy szerviz rendszer esetén a munkalap száma.

Qsboxmegjegyz
A feldolgozást követően File alapú feldolgozás esetén az XML fájlba a `<Szamla AtvetelStatus=, AtvetelSzlasz=, AtvetelTimeStamp= >` attributomokba attributumokba file alapú feldolgozás esetén, az átvételre vonatkozó adatok visszaíródnak, így átadó fél információt kaphat a művelet sikerességével kapcsolatban. Ez a módozat elavultnak tekinthető. Célszerűbb a DbConnector REST API - számla készítés módot hasznáni, ha a számlázási utasítást kiadó szoftver visszajelzést vár.

Qsboxmegjegyz

A feldolgozást követően File alapú feldolgozás esetén az XML fájlba a <Szamla AtvetelStatus=, AtvetelSzlasz=, AtvetelTimeStamp= > attributomokba attributumokba file alapú feldolgozás esetén, az átvételre vonatkozó adatok visszaíródnak, így átadó fél információt kaphat a művelet sikerességével kapcsolatban.
Ez a módozat elavultnak tekinthető. Célszerűbb a DbConnector REST API - számla készítés módot hasznáni, ha a számlázási utasítást kiadó szoftver visszajelzést vár.

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

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

Csak olyan partnerre lehet számlát készíteni, akinek a kódja szerepel a partnertörzsben. A kimenő számla az adott vevő-folyószámlára könyvelődik.
Lehetőség van egy közös vevő-folyószámlára is számlázni. Ez esetben a partnerkód fix, és az alábbiakban kell megadni a vevő adatokat.

VevoMegnev

N	C	80	Vevő megnevezése. Csak akkor kell, ha egy közös vevő-folyószámla van minden kiemnő számlához. Egyébként a partnertörzsben beállított név és cím adatok lesznek a számlán.
VevoIrsz

N	C	5	Vevő címéből az irányítószám. Csak közös vevő-folyószámla esetén szükséges.
VevoVaros

N	C	30	Vevő címéből a város. Csak közös vevő-folyószámla esetén szükséges.
VevoUtca

N	C	40	Vevő címéből a utca. Csak közös vevő-folyószámla esetén szükséges.
VevoEmail	N	C	40	Vevő email címe. Csak közös vevő-folyószámla esetén.
VevoAdoszam	N	C	15	Vevő adószáma kötőjelek nélkül. Csak közös vevő-folyószámla esetén szükséges.
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. Csak közös vevő-folyószámla esetén.
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.

Qsboxmegjegyz
Az ESzlaKuldMod, valamint ESzlaMailAddress adattartalom csak akkor tud a partnertörzsbe felíródni, ha a Szerviz \| Technikai Információk \| Rendszerinformációk \| Általános beállítások adatlapon az erre vonatkozó rendszerparaméter engedélyezve van . [Új partner létrehozása = IGEN]. Amennyiben az "Új partner" létrehozása nem engedélyezett az XML-ben elegendő a partnerkód megadása. A DbConnector REST API - számla készítés mód esetén ezt a paramétert célszerű kikapcsolva tartani.

Qsboxmegjegyz

Az ESzlaKuldMod, valamint ESzlaMailAddress adattartalom csak akkor tud a partnertörzsbe felíródni, ha a Szerviz | Technikai Információk | Rendszerinformációk | Általános beállítások adatlapon az erre vonatkozó rendszerparaméter engedélyezve van . [Új partner létrehozása = IGEN]. Amennyiben az "Új partner" létrehozása nem engedélyezett az XML-ben elegendő a partnerkód megadása.
A DbConnector REST API - számla készítés mód esetén ezt a paramétert célszerű kikapcsolva tartani.

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

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.)
DevArfNap	N	DATE	éééé-hh-nn	Deviza árfolyam, megadása csak devizás számlák esetén. Ha nincs megadva, a Telj dátum az árfolyamnap
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
Kelt	I	DATE	éééé-hh-nn	Számla kelt dátum. ISO 8601 vagy magyar formátum szerint. A DbConnector REST API-n keresztül kiállított számlák esetén a kelt alapján lesz meghatározva a kiállított számla üzleti éve.
Telj	I	DATE

éé.

éééé-hh

-nn	Teljesítés időpontja.

Kelt

ISO 8601 vagy magyar formátum szerint.
Elsz	N

DATE

éé.

éééé-hh

-nn

Számla kelt dátum

Számviteli elszámolási időszak vége. ISO 8601 vagy magyar formátum szerint.

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.

EngSzazINUM4 +1A 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 számla hivatkozás kikereséséhez szükséges adat.

<Gyujtok>...<Gyujtok/> adatcsoport

A számlán használandó gyűjtőket a SUP^® paraméterezéssel összhangban kell beletenni az XML-be.

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

<Visszatartas>...</Visszatartas> adatcsoport

XML tag	Kötelező	Típus	Hossz	Leírás
Honap	N	BOOL	2	Visszatartás hónapok száma
JoteljOsszeg	N	NUM	15+2	Jóteljesítési garancia összege
JoteljSzaz	N	NUM	2	Jóteljesítési garancia százakék a számla végösszegéből
GarOsszeg	N	NUM	15+2	Garanciális visszatartás összege
GarSzaz	N	NUM	2	Garanciális visszatartás százakék a számla végösszegéből

<Tetelsorok> adatcsoport

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

Minta

Image Removed

Image Added

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

XML tag	Kötelező	Típus	Hossz	Leírás
CikkSzam	I	C	13	Cikkszám, a SUP rendszerrel összhangban.
CikkMegnevMagyar

80	Cikk magyar nyelvű megnevezése. Ha nincs megadva, a cikkszám alapján kerül meghatározásra.
MennyEgys

N	C	5	Mennyiségi egység kódja a SUP rendszerrel összhangban. Pl.: db. Ha nincs megadva, akkor a SUP rendszer cikktörzsben előírt mennyiségi egység.
AFAszazn

N	NUM	2	A használni kívánt ÁFA százalék (nettóból számítva). Ha nincs megadva, a cikkszám alapján kerül meghatározásra.
SzjVtszKod

A cikk SZJ/VTSZ száma.
Ha nincs megadva, a cikkszám alapján kerül meghatározásra.

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

XML tag	Kötelező	Típus	Hossz	Leírás
Mennyiseg	I	NUM	18+3	Mennyiségi darabszám. (Max. 18 karakter +3 tizedes hosszan adható meg.)
NegysAr	I	NUM	15+6	A cikk nettó egységára. (Max. 15 karakter +6 tizedes hosszan adható meg.)

<Gyujtok>...</Gyujtok> adatcsoport

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.

<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 ...<Szamla> 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

Összehasonlított verziók

Régi verzió 7

Új verzió Aktuális

Kulcs

Az XML séma

<CsomagInfo> adatcsoport

<Szamlak> adatcsoport

<Fejléc> adatcsoport

<Tetelsorok> adatcsoport

Storno és helyesbítés

Előleg kezelés