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

Összehasonlított verziók

Régi verzió 18

changes.mady.by.user QSoft

Mentés ekkor:

összehasonlítva

Új verzió Aktuális

changes.mady.by.user QSoft

Mentés ekkor:

Kulcs

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

...

Kódblokk
titleAz XML séma vázlata
<?xml version="1.0" encoding="UTF-8"?>
<Elojegyzett_Szamlak FileVersion="EJSZ_1.8" FileTimeStamp="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>

...

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 tagKötelezőTípusHosszLeírás
CegKodIgenC10A 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. 
KuldoKodIgenC20Küldő alrendszer megnevezése vagy azonosítója - konstans
DevnemNemC3A 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		IgenC3A 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.

...

Qsboxmegjegyz

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 tagKötelezőTípusHosszLeírás
VevoKodIC 11Vevő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örzsbeCsak 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.
VevoMegnevINC80

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.

VevoIrszINC5Vevő címéből az irányítószám. Csak közös vevő-folyószámla esetén szükséges.
VevoVarosINC30Vevő címéből a város. Csak közös vevő-folyószámla esetén szükséges.
VevoUtcaINC40Vevő címéből a utca. Csak közös vevő-folyószámla esetén szükséges.
VevoEmailNC40Vevő email címe. Csak közös vevő-folyószámla esetén.
VevoAdoszamNC15Vevő adószáma kötőjelek nélkül. Csak közös vevő-folyószámla esetén szükséges.
VevoEuAdoszNC2
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.
ESzlaKuldModNC1Opcioná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

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

 

<EgyebInfo>...</EgyebInfo> adatcsoport

XML tagKötelezőTípusHosszLeírás
NyelvKodNC2

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

DevTeljhelyNC1

Teljesítés helye: (B)elföld, (U)nión belül, (K)ülföld. Ha nincs megadva: (B)elföld

DevArfolyamNNUM 18 +6Deviza árfolyam, megadása csak devizás számlák esetén. (Max. 18 karakter +6 tizedes hosszan adható meg.)
DevArfNapNDATEéééé-hh-nnDeviza árfolyam, megadása csak devizás számlák esetén. Ha nincs megadva, a Telj dátum az árfolyamnap
FizmodINUM1

Fizetési mód, a SUP rendszer belső kódolásának megfelelően.
  0 – Készpénz
  4 – Átutalás

KeltIDATE

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

TeljIDATEéééé-hh-nnTeljesítés időpontja. ISO 8601 vagy magyar formátum szerint.
ElszNDATEéééé-hh-nnSzámviteli elszámolási időszak vége. ISO 8601 vagy magyar formátum szerint.





HatinapINUM3A 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.
MegjegyzesNC1500A számla közlemény rovata. Megjelenik a számlán a fejléc és a tételsorok között.
MegrbizszNC15Rendelés száma
ElozmTrackKodNCCA 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ámla tételsor adatai. Itt kerül megadásra a számlázandó cikk és a kapcsolódó adatok.

Minta

 

<Cikk>...</Cikk> adatcsoport

XML tagKötelezőTípusHosszLeírás
CikkSzamIC13
Cikkszám, a SUP rendszerrel összhangban.
CikkMegnevMagyarNC80Cikk magyar nyelvű megnevezése.
Ha nincs megadva, a cikkszám alapján kerül meghatározásra.
MennyEgysNC5Mennyisé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.
AFAszaznNNUM2A 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.
SzjVtszKodNC15A cikk SZJ/VTSZ száma.
Ha nincs megadva, a cikkszám alapján kerül meghatározásra.

 

<Menny>...</Menny> adatcsoport

...

XML tagKötelezőTípusHosszLeírás
GyCsop1NC4Gyűjtő csoport kód, 1. indexen.
GyAzon1NC12A GyCsop1 alá tartozó gyűjtőazonosító kódja.
GyCsop2NC4Gyűjtő csoport kód, 2. indexen.
GyAzon2NC12A GyCsop2 alá tartozó gyűjtőazonosító kódja.
GyCsop3NC4Gyűjtő csoport kód, 3. indexen.
GyAzon3NC12A GyCsop3 alá tartozó gyűjtőazonosító kódja.
GyCsop4NC4Gyűjtő csoport kód, 4. indexen.
GyAzon4NC12A GyCsop4 alá tartozó gyűjtőazonosító kódja.

...