Név

Köt.

Típus

Megjegyzés

<?xml version="1.0" encoding="UTF-8"?>

A fájl kódolása szabadon választott.

Gyakori hiba, hogy az XML-be beírják, hogy UTF-8, mégis windows1250 (ANSI) karaktereket tartalmaz.

Ha 1250-es kód készlettel fog készülni a fájl, akkor a következőt kell írni a fájl elejébe:

encoding="Windows-1250"

A legegyszerűbben úgy lehet megtudni, hogy az XML milyen kódlappal készült, hogy Jegyzettömbben meg kell nyitni, majd mentés másként műveletet kell választani. Ha a Kódolás mezőben ANSI érték van, akkor az XML elején a Windows-1250 szerepeljen.
Ha Ha a Kódolás mezőben UTF-8 érték van, akkor az XML elején az UTF-8 szerepeljen.

<szamlak>

ez a tag csak több számla esetén kell

 <szamla xmlns="http://www.apeh.hu/2005/szamla" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

X

<sajatadoszam>

Az xml fájl tartalmazhatja a saját adószámot.

<sajatadoszam> tag, a fájl elején a <szamla> (egy számla beolvasása esetén)  vagy <szamlak> (több számlát tartalmaz az xml) tag utáni sorban.

Csak abba a kötetbe lehet beolvasni a fájlt, amelyikben a saját adószám megegyezik a fájlban lévővel.

DBEllenőrzés = Adószám paraméter hatására a <sajatadoszam> taget hasonlítja a sajátcím adószám első 8 karakterével.

Ha nem egyezik üzen és kilép.

<fejlec>

X

számla fejléc adatait tartalmazó rész

    <elado>

X

A blokk mezőit lásd alább: Ügyfélblokk

Kimenő számla esetén

Számlaimport esetén nem veszi figyelembe a program ezt a blokkot.

Kivéve: a <bankszamlaszam> -ot, amennyiben meg van adva

Számlaexport esetén a Saját adatban megadottak alapján lesz kitöltve.

Bejövőszámla

Az Ügyféltörzs adatait tartalmazza a blokk.

   </elado>

   <vevo>

X

A blokk mezőit lásd alább: Ügyfélblokk

Kimenő számla esetén

Az Ügyféltörzs adatait tartalmazza a blokk.

Bejövőszámla esetén

Számlaimport esetén nem veszi figyelembe a program ezt a blokkot.

Számlaexport esetén a Saját adatban megadottak alapján lesz kitöltve.

 </vevo>

<telephely>

A blokk mezőit lásd alább: Ügyfélblokk.

A telephely konverzió során azt feltételezi a program, hogy a telephelyek az ún. Telephelyügyfél struktúrában lettek rögzítve.

Kimenő számla esetén

Számlaimport esetén a <vevo> blokkban megadott ügyfél aktuális számlában megadott telephelyéhez tartozó ügyfél adatait kell tartalmazni a blokknak.

Számlaexport esetén a <vevo> blokkban megadott ügyfél aktuális számlában megadott telephelyéhez tartozó ügyfél adatait fogja tartalmazni a blokk.

Bejövőszámla

Nincs telephely blokk

 </telephely>

 <szamlainfo>

A számla egészére vonatkozó információkat tartalmazó blokk

Egyéb könyvelési információkat is tartalmazhat a blokk - lásd alább Könyvelés fejezet

             <sorozatid>

9(16)

A számlasorozatban funkcióban definiált számlasorozat azonosítószámát lehet ide írni. Megadásának az lehet a jelentősége, hogy a számlasorozatban lehet például meghatározni a nyomtatandó számla formátumát.

Ha üresen hagyják ezt a mezőt, akkor is megpróbálja a program a sorozat ID-t saját maga kitalálni. Ehhez megnézi, hogy a számlaszám milyen sorozatba tartozik (pl.: 13-01/00001-ből a 01 a sorozat). Ezek után a Számlasorozat funkcióban megnézi, hogy melyik számlasorozatban kapná ezt a sorozatot.

             <sorozat>

9(4)

2*

            <sorszam>

X

X(20)

2*

             <alapbizonylat>

X(20)

2*

            <kialldatum>

X

yymmdd

             <teljdatum>

yymmdd

Nem kötelező megadni. Ha üres, akkor a számla kibocsátás dátumán kerül rögzítésre a számla. Időszaki számla esetén az <afadatum> értéke kerül bele.

Kapcsolódó paraméter: IdőszakiTelj

            <fizhatarido>

X

yymmdd

             <teljdatumtol>

X

yymmdd

Időszaki elszámolású számla esetén a teljesítési időszak kezdete.

Kapcsolódó paraméter: IdőszakiTelj

              <teljdatumig>

X

yymmdd

Időszaki elszámolású számla esetén a teljesítési időszak vége.

Kapcsolódó paraméter: IdőszakiTelj

             <vamdatum>

yymmdd

Vámolás dátuma.                                        Export és import számla esetén.

             <kibedatum>

yymmdd

Kiviteli ellenőrzés dátuma, belépés dátuma.   Export és import számla esetén.

            <fizmod>

X

Átutalás

Készpénz

Készpénz-2

Kompenzáció

Hitelkártya

Utánvétel

Előrefizetés

Csekk

             <szamlatipusa>

X

Normál

Helyesbítő

Stornó

            <hivatkozottszamla>

X(20)

Helyesbítő és stornó esetén kötelező

            <penznem>

X(3)

            <arfolyam>

9(4,4)

            <afaarfolyam>

9(4,4)

Amennyiben meg van adva, akkor áfa forint értéket számol tételenként

Érdemes nyomtatottként importálni a számlát, mivel a rögzített számla lezárását követően a devizaárfolyam táblából bekerül az árfolyam

            <nyomtatas>

0

1

Rögzített

Nyomtatott

            <szamlaalap>            

X(30)

            <sajatugyintezo>

X(30)

            <ugyfelugyintezo>

X(30)

            <fokonyviszam>

9(8)

            <afaelszamolas>

Normál

Pénzforgalmi

lásd Pénzforgalmi elszámolás

            <adonem>

Társasági

EVA

Kisadózó

Kisvállalati

lásd Kisadózó

            <megjegyzes>

X(1500)

Számlafejléc megjegyzése

            <egyebadat>

A mezővel csak a számlaexport foglalkozik, értékébe az ügyféltörzs/további adatok alatt megadott e-mail cím kerül. Kapcsolódó paraméter: EgyébAdat

            <szamlakep>

X(150)

Az elérési útban jelzett fájl dokumentumként becsatolódik a betöltött számlához. A működéshez szükséges paraméterek:

FájlnévInput=Nincs (azaz csak automatikus betöltésnél működik)

Könyvtár=xxxx (a FájlnévInput=Nincs miatt)

FájlnévMaszk=xxxx (a FájlnévInput=Nincs miatt)

VevőSorozat|ExpoSorzat vagy SzállSorozat|ImpoSorozat=xxxx  (a FájlnévInput=Nincs miatt)

DKIktatás=NincsInput

DKGyűjtő=xxxx

           <megjelenes>

X

ha az itt érkező érték "elektronikus", a program a beolvasást követően az Ügyféltörzs/Fizetési feltételek/E-számla paraméterek blokkjában automatikusan rögzít egy számlaközpontos e-számla rekordot azzal az email címmel, amely a számla XML-ben az Ügyfél blokkban, az <email> mezőben érkezik

Ld. EmailMódos paraméter

  </szamlainfo>

  </fejlec>

        <tetelek>

Kapcsolódó paraméter: Összevonás

           <tetel id="1">

A számlatétel adatait tartalmazó blokk

Egyéb könyvelési információkat is tartalmazhat a blokk - lásd alább Könyvelés fejezet

                  <termekkod>            

X(15)

NM saját cikkszám.

nem kötelező, de ha ki van töltve, akkor bent kell lennie a cikktörzsben, mert a konverzió nem veszi fel a cikktörzsbe.

                  <termeknev>

X(40)

A számlatétel megnevezése.

Ha <termekkod> ki van töltve, akkor figyelmen kívül hagyja a program, mert a cikktörzsben megadott név kerül a számlára.

                   <szarmorszag>

X(2)

Származási ország. Import számla esetén.

                   <szarmhely>

X(20)

Származási hely.     Export és import számla esetén.

                  <besorszam>

X(15)

Besorolási szám

                  <ugyletkod>

9(2)

A mezővel csak a bekonvertálás foglalkozik. Értékébe az import számla tételében megadható ügylet kód kerül.

                  <menny>

9(11,3)

Mennyiség.

Ha nincs megadva, akkor 1-nek tekinti a program.

                  <mennyegys>

X(5)

Mennyiségi egység (db, kart. stb.)

                   <listaar>

9(13,2)

Analitika=Előleg paraméterrel betölthető vevő előlegbekérő esetén a listaár és az előlegszázalék szorzata lesz a nettó egységár. Ha meg vannak adva, a <nettoegysegar> mezőt nem veszi figyelembe a betöltés.

                   <elolegszazalek>

9(3,2)

Analitika=Előleg paraméterrel betölthető vevő előlegbekérő esetén a listaár és az előlegszázalék szorzata lesz a nettó egységár. Ha meg vannak adva, a <nettoegysegar> mezőt nem veszi figyelembe a betöltés.

                  <nettoegysar>

9(13,2)

Ha meg van adva, akkor a <nettoar> mezőt nem veszi figyelembe  a program.

                    <arengedm>

9(13,2)

Ha meg van adva a <nettoar> mező, abból számítja az engedményt. Ha csak a <nettoar> van megadva, az engedmény értéke figyelmen kívül lesz hagyva.

                    <nettoar>

9(13,2)

Nettó ár = <menny> × <nettoegysar>

                    <afakulcs>

X

9(2)

Pl.: 27, 18
Számlaközpont.hu formátumú e-számlánál fordított áfa esetén az <afakulcs> mezőbe a Fordított érték kerül, mivel ez a formátum nem kezeli külön az áfaanalitika mezőt.

                    <afaertek>

X

9(13,2)

Számlaexport az áfaértékét teszi a mezőbe.

Számlaimport nem foglalkozik vele.

                   <afaftertek>

X

9(13,2)

A tétel forintban értelmezett áfa értéke.

Import számla betöltésénél kötelező érték, ha belföldi az áfatartalom.

                   <teljdatum>

yymmdd

Gyűjtőszámla esetén tétel teljesítés dátuma

                   <megjegyzes>

X(750)

A programban a tételhez tartozó F4-es megjegyzést tartalmazza.

                   <teteltipus>

"Előleg"

"Előlegfelhasználás"

-ha a számla xml-ben szerepel a tétel blokkban a <teteltipus>Előleg</teteltipus> tag, akkor a betöltött számla tételtípusa előleg lesz, azaz előlegszámla kerül betöltésre;
-ha olyan végszámlát töltünk be, melyben van tételes előlegfelhasználás, azaz van olyan negatív tétel, melyben szerepel a <teteltipus>Előlegfelhasználás</teteltipus> és az <elolegszamla>99-99/99999</elolegszamla> tag, a betöltött számlában lesz előlegfelhasználás tétel, mely össze tud kapcsolódni a korábban betöltött előlegszámlával (rekord kerül a VevőSzElőleg adatállományba).

                   <elolegszamla>

99-99/99999

az előlegszámla száma, melynek felhasználása történik a tételben;

a program akkor veszi figyelembe, ha a tételben szerepel a <teteltipus>Előlegfelhasználás</teteltipus> tag

           </tetel>

    </tetelek>

  <osszesites>

A számla összesített adatait tartalmazó blokk.

Számlaimport esetén az egész blokkból csak a <bruttoarossz> mező kötelező.

Ha a többi nincs megadva, akkor a program saját maga által számolt nettó, áfa összegeket fogja figyelembe venni.

Ha viszont megadják áfakulcsonként az áfát, vagy a nettó végösszeget, akkor a program a megadott összegekkel fogja felvenni a számlát. (Áfa és nettó kerekítést fog elszámolni a kalkulált és a megadott összeg között.)

              <afarovat id="1">

áfakulcsonként (<afakulcs>) van egy áfarovat.

                    <afakulcs>

9(2)

                    <nettoar>

9(13,2)

                    <afaertek>

9(13,2)

                    <bruttoar>

9(13,2)

                </afarovat>

                <vegosszeg>

                    <nettoarossz>

9(13,2)

                    <afaertekossz>

9(13,2)

                    <bruttoarossz>

X

9(13,2)

Számlaimport esetén <bruttoarossz> mezőkitöltése kötelező. A program az itt megadott végösszeget fogja könyvelni!

                  </vegosszeg>

      </osszesites>

  </szamla>

</szamlak>

Számlaszám

Machinátor kompatibilis számlaszámot tartalmaz a fájl

Másik programban képzett számlaszám kerül átvételre

SzámlaSzám paraméter értéke a beolvasó funkcióban

SzámlaSzám

AlapBizonylat

     <Szamlainfo>

          <sorszam>

A bekonvertálandó állomány <sorszam> mezőjében a Nagy Machinátorban által használható számlaszám van, amely megfelel a következő feltételeknek:

Egyedi azonosító. Maszkot (kötőjelet, vesszőt) ne tartalmazzon, csak számokból álljon.

9 számjegyet tartalmaz és fel kell tölteni balról nullákkal, ha nem elég hosszú.

Típus: 9(11)

Amennyiben a külső számlázó rendszer számlaszáma hosszabb, mint 9 karakter vagy betűt is tartalmaz, akkor a másik értéket kell használni.

A bekonvertálandó állomány <sorszam> mezőjében a Nagy Machinátorban által nem használható számlaszám van.

Ezért a <sorszam> tartalma az Alapbizonylat mezőbe fog kerülni.

A machinátoros számlaszámot ebben az esetben képezni fogja a program.

        <kod>

X(13)

Kimenő számla esetén

Bejövő számla esetén

        <nev>

X(40)

Ügyfél neve.

Új ügyfél esetén kötelező.

Ha az új ügyfél neve megegyezik egy már a rendszerben található ügyfél nevével (ez magánszemélyek esetén könnyen előfordulhat), akkor az új ügyfél nevének a végét sorszámozással módosítja a felvétel. Az ügyfél eredeti nevét pedig az ún. hosszú névbe generálja a program. ( számlára a hosszú név fog kerülni)

        <hosszunev>

X(80)

Ügyfél hosszú neve. Amennyiben nem elegendő a <nev> 40 karaktere, akkor az ügyfél teljes neve itt adható meg. (A számlára ez a név fog kerülni)

Megadása nem kötelező.

        <adoszam>

X(13)

Számlaimport esetén: 1*

        <csasz>

X(13)

Csoportos adószám

        <Euadoszam>

X(30)

Ügyfél közösségi adószáma

Kapcsolódó paraméter: EUTaxID

       <bankszamlaszam>

X(30)

Az eladó bankszámlaszáma. Vevőszámla exportnál ide kerül a számlában lévő bankszámlaszám, míg szállítószámla importnál ez az érték kerül egyrészt az Ügyféltörzs Bankszámlaszámok ablakába (ma még nincs ott), másrészt a szállítószámla Bankszámlaszám mezőjébe. Betöltésnél a mezőben lévő - karakterek eltávolításra kerülnek.

       <ean>

X(16)

A vevő EAN kódja. Amennyiben új ügyfélként jön létre a vevő a programban, ez az érték bekerül a További adatok/Ügyfélazonosító EAN mezőjébe

        <CEE>

X(20)

Az Ügyféltörzs további adatokban megadható CEE mező tartalma.

              <cim>

                     <telepules>

X(40)

                     <irszam>

X(4)

                     <utcahsz>

X(40)

                    <kozternev>

X(20)

                    <kozterjell>

X(20)

                    <hazszam>

X(10)

            </cim>

             <pcim>

Postacím adatait tartalmazó blokk.

Számlaexport nem tartalmazza a blokkot, csak a számlaimport foglalkozik a mezőkkel.

                     <ptelepules>

X(40)

                    <pirszam>

X(4)

                   <putcahsz>

X(40)

                   <pkozternev>

X(20)

                  <pkozterjell>

X(20)

                  <phazszam>

X(10)

          </pcim>

          <email>

ld. EmailMódos paraméter

          <megjegyzes1>

X (40)

a mező tartalmát a program betölti az Ügyfél/Alapadatok Megjegyzés mezőjébe

Azonosítás:

Machinátoros ügyfélkód alapján

Másik programban lévő ügyfélkód alapján

Adószám (8 karakteres) alapján

Adószám (11 karakteres) alapján

ÜgyfélKód paraméter értéke a beolvasó funkcióban

ÜgyfélTörzs

ÜgyfélID

Adószám

Adószám11

        <kod>

Kötelező a mezőt kitölteni a Machinátoros ügyfélkóddal.

Típus: 9(8)

A mezőkben a másik rendszer ügyféltörzsének kódja szerepel. Kötelező kitölteni. Típus: X(11)

Ebben az esetben, a programban az ÜgyfélID állományban van felvéve, hogy mi az Ügyfél idegen rendszer kódja és az a kód milyen saját kódnak felel meg.

Az ÜgyfélID állományt nem kell feltölteni előre, mert ha egy ügyfelet nem talál a program az ÜgyfélID állományban a soron következő saját kódon felveszi az Ügyféltörzsben és az így kapott saját kód - idegen kód kapcsolatot rögzíti az ÜgyfélID állományba is.

nem veszi figyelembe a program a mezőt.

nem veszi figyelembe a program a mezőt.

        <adoszam>

Opcionális.

Opcionális

Kötelező

Típus X(8)

A XML-ben szereplő 8 jegyű adószám alapján történik az ügyfél azonosítása.

Ha nem találja meg, akkor fel fog venni egy ügyfelet a soron következő ügyfélkódon a program.

Kötelező

Típus X(11)

A XML-ben szereplő 11 jegyű adószám alapján történik az ügyfél azonosítása.

Ha nem találja meg, akkor fel fog venni egy ügyfelet a soron következő ügyfélkódon a program.

Azonosítás:

Machinátoros telephelykód

Telephelyügyfél partner vevőkódja

TelephelyKód paraméter értéke a beolvasó funkcióban

ÜgyfélThely

PartnerVevőKód

        <kod>

A telephelykód kerül a mezőbe.

4 karakter telephelykód

Típus: 9(4)

A mezőkben a másik rendszer ügyféltörzsének kódja szerepel. Kötelező kitölteni. Típus: X(15)

Ebben az esetben a program az Ügyféltörzs további adatok menüpontban megadható Partner vevőkód mezőben (ÜgyfélTörzs.VevőKód ) tárolt érték alapján fogja a telephelyet azonosítani.

- Ha a Partner vevőkódot nem találja az ügyféltörzsben a program, akkor a következő Ügyfélkódon felveszi az ügyféltörzsbe.

Majd az <vevo> blokk alapján azonosított ügyfél telephelyei közé felveszi az telephelyügyfelet. (ÜgyfélThely.FizFelÜgyfél)

- Ha a Partner vevőkódot megtalálta ugyan a program az ügyféltörzsben, de a vevo> blokk alapján azonosított ügyfél telephelyei között nem találta meg, akkor felveszi a telephelyügyfelet a program.

Név

Köt.

Típus

Feltétel

Megjegyzés

    <tetel id="1">

       ....

   <koltseghely>

Költséghelytörzsbe felvett költséghely kódja

   <temaszam

5*

   <temanev>

Ha nincs a struktúrában a témaszám akkor a konverzió során automatikusan felveszi

   <fokonyviszam>

Tétel főkönyvi száma

Pl.: Kimenő számla esetén: 911)

   <afatartalom>

3*

   <khelyfokonyviszam>

Bejövőszámla esetén a költséghely főkönyvi szám (hatos, hetes...)

   <afafokonyviszam>

Áfa főkönyvi száma.

Folyamatos áfaanalitika1 esetén ha nincs megadva, a főkönyvi paraméterekből történik a feltöltés.

   <afaanalitika1>

3*

   <afaanalitika2>

3*

   <afaanalitika3>

3*

   <afaanalitika4>

3*

   <megjegyzes>

A programban a tételhez tartozó F4-es megjegyzést tartalmazza.

   <neta>

A Népegészségügyi termékadó beállításait tartalmazza az adott tételnek

</tetel>

<szamlainfo>

...

      <ugyfelugyintezo>

ügyfélügyintéző

      <sajatugyintezo>

saját ügyintéző

       <sajatugyintezo2>

második saját ügyintéző, a vevőszámlában használható, a felületen az SÜgyintSzám=Kettő paraméterrel lehet megjeleníteni

      <szamlaalap>

Számlázás alapja mező

      <fokonyviszam>

Elszámolási főkönyvi szám

Pl.:Kimenő számla esetén 311

      <megjegyzes>

A programban a fejléchez tartozó F7-es megjegyzést tartalmazza.

    <afadatum>

Áfakötelezettség napja. Az áfa ezen a napon lesz feladva a főkönyvbe.

       <konyvdatum>

Könyvelési dátum. Az áfán kívül minden más ezen a dátumon kerül feladásra a főkönyvbe.

</szamlainfo>

afatartalom

afaanalitika1

afaanalitika2

afaanalitika3

afaanalitika4

Ha nincs kitöltve akkor Belföldi lesz

kimenő számla esetén

'Belföldi'

’Közösségen belüli'

'Külföldi’ lehet

bejövő számla esetén

'Belföldi'

’Közösségen belüli'

'Külföldi’

’Import szolgáltatás’

'Normál'

'ForditottÁfa' vagy 'Fordított'

'AlanyiAdómentes' vagy 'Alanyi a.m'

'HatályonKívűl' vagy ’Hatályon kív'

'Adómentes'

'ÁFA számla'

'VPOP ÁFA'

'Tárgyi a.m'  

'Folyamatos'

'Speciális'

'Csoportos'

'Különleges'

'Levonható'

'Nem levon.’

'Arány.lev.'

'Normál'

'Beruházás'

'Tárgyieszk.'

'Apport'

'Támogatás'

'Szolgáltatás'

'Hulladék'  

'Ingatlan'  

'Ing.szolg.'

'Utaz.szerv.'  

'Használt'  

'Egyéb'

'Termékbesz'

'Egyéb(75.sor)'

'Normál'

'EU'

'EU felsz.'

'Táv.ért.'

'EU v.áth.'  

'EVA'  

'PHARE,ISPA'

'Áfa Tv.11/A'  

'Háromszög'  

'Áfa Tv.15'

'Új közl.e.'

'Jövedéki'

'Áfa Tv.29/D'

'Beruházás'

'Közv.vámj.k.'

'Közérdekű'

'Sajátos'

'Egyéb'

Azonosítás:

Machinátoros témaszámkód

Témaszámhoz rendelt ügyfél adószám

TémaszámKód paraméter értéke a beolvasó funkcióban

Nincs

Adószám

      <temaszam

tématörzsbe felvett témaszám kódja

Típus: 9(8)

A XML-ben szereplő 11 jegyű adószám alapján történik a témaszám azonosítása.

A tématörzsben meg lehet adni egy ügyfelet. Ennek az ügyfélnek az adószáma alapján lesz a témaszám azonosítva.

Típus X(11)