A SUP^®Integrált Számviteli Rendszer pénzügyi moduljában található számlázási modul segítségével lehetőség van más rendszer által komplexen előkészített számlázási utasítás alapján kimenő számla készítésére. Ez esetben a küldő rendszer egy XML adatséma alapján kell, hogy küldje a számlázási utasítást. A számlázási utasítás csomagnak a számlák kiállításához szükséges minden adatot tartalmaznia kell. A számlaszámot a számla készítés során a SUP^® rendszer generálja.

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.

Megjegyzés

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

Javaslat

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
Minta XML file: Elojegyzett_szamlak.xml

Az XML séma vázlata

<?xml version="1.0" encoding="UTF-8"?>
<Elojegyzett_Szamlak FileVersion="EJSZ_1.8" FileTimeStamp="2020-03-18" FileDestination="PUKISZLA">
  <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>

Figyelem

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^® 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.

Minta

<Számla> attributumok

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

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

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.

Megjegyzés

File alapú feldolgozás esetén az XML fájlba a <Szamla AtvetelStatus=, AtvetelSzlasz=, AtvetelTimeStamp= > 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.

<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. 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 = '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 = '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.

Megjegyzés

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.

<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. ISO 8601 vagy magyar formátum szerint.
Elsz	N	DATE	éééé-hh-nn	Számviteli elszámolási időszak vége. ISO 8601 vagy magyar formátum szerint.

Hatinap	I	NUM	3	A 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.
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

<Cikk>...</Cikk> adatcsoport

XML tag	Kötelező	Típus	Hossz	Leírás
CikkSzam	I	C	13	Cikkszám, a SUP rendszerrel összhangban.
CikkMegnevMagyar	N	C	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	N	C	15	A cikk SZJ/VTSZ száma. Ha nincs megadva, a cikkszám alapján kerül meghatározásra.

<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

Az XML séma

<CsomagInfo> adatcsoport

<Szamlak> adatcsoport

<Számla> attributumok

<Fejléc> adatcsoport

<Tetelsorok> adatcsoport

Storno és helyesbítés

Előleg kezelés

Content

Munkatér eszközei

Kimenő számlák importálásának XML formátuma

Az XML séma

<CsomagInfo> adatcsoport

<Szamlak> adatcsoport

<Számla> attributumok

<Fejléc> adatcsoport

<Tetelsorok> adatcsoport

Storno és helyesbítés

Előleg kezelés