Kapcsolódó információk:
› Paraméterezési útmutatók
Korábbi változatok
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.
| Qsboxmegjegyz |
|---|
Ugyanez, angolul megtalálható a Outgoing invoices to import XML format útmutatóban! |
| Tartalomjegyzék | ||
|---|---|---|
|
Az XML séma
A számlázási utasítás az alábbi XML séma szerint, hogy vezérli a számlázást.
- 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
| Kódblokk | ||
|---|---|---|
| ||
<?xml version="1.0" encoding="UTF-8"?>
<Elojegyzett_Szamlak FileVersion="EJSZ_1.1" FileTimeStamp="2014.01.01." FileDestination="SUPKISZLA">
<CsomagInfo>...</CsomagInfo>
<Szamlak>...
<Szamla>...
<Fejlec>...
<TrackingKod>...</TrackingKod>
<Vevo>...</Vevo>
<EgyebInfo>...</EgyebInfo>
<Gyujtok>...</Gyujtok>
</Fejlec>
<Tetelsorok>...
<Tetelsor>...
<Cikk>...</Cikk>
<Menny>...</Menny>
</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 |
|---|---|---|---|---|
| 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. |
| Qsboxmegjegyz |
|---|
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. Az országkódokat ISO 3166-1 szabványnak megfelelően kell átadni. Csak EU tagállamok esetén kell kitölteni. |
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'. |
| 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. |
| Telj | I | DATE | éé.hh.nn | Teljesítés időpontja. |
| Kelt | I | DATE | éé.hh.nn | Számla kelt dátum. |
| Hatinap | I | NUM | 3 | A teljesítéshez számított x nap határidő. |
| 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. |
<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.) |