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.6" 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>

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
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	Igen	C	3	A SUP^® rendszerben meghatározott számlázási napló száma.

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

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

A feldolgozást követően az XML fájlba a <Szamla AtvetelStatus=, AtvetelSzlasz=, AtvetelTimeStamp= > attributomokba az átvételre vonatkozó adatok visszaíródnak, így átadó fél információt kaphat a művelet sikerességével kapcsolatban.

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

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

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

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	Teljesítés időpontja. ISO 8601 vagy magyar formátum szerint.
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 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.

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

Minta

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	I	C	50	Cikk magyar nyelvű megnevezése.
MennyEgys	I	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	I	NUM	2	A használni kívánt ÁFA százalék (nettóból számítva).
SzjVtszKod	I	C	15	A cikk SZJ/VTSZ száma.

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

Tartalmi leírás - <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.

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

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