Ugrás a fő tartalomhoz

Minta XML + XSD séma

Az XML-ben a mezők sorrendje kötött, nem felcserélhetők. A <penznem> pénznemkódjaihoz és a devizás számla <arfolyam> / <arfolyamBank> mezőihez lásd a Támogatott devizanemek oldalt.

<?xml version="1.0" encoding="UTF-8"?>
<xmlszamla xmlns="http://www.szamlazz.hu/xmlszamla" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.szamlazz.hu/xmlszamla https://www.szamlazz.hu/szamla/docs/xsds/agent/xmlszamla.xsd">
<!-- A számla alapbeállításai -->
    <beallitasok>
        <!-- Számla Agent kulcsot a számlázz.hu-ra belépve tudsz generálni -->
        <szamlaagentkulcs>Az azonosítókulcs helye. Kérlek, töltsd ki!</szamlaagentkulcs>
        <eszamla>true</eszamla>
        <!-- „true" ha e-számlát kell létrehozni -->
        <szamlaLetoltes>true</szamlaLetoltes>
        <!-- „true" ha szeretnéd a választ PDF számlaként megkapni -->
        <valaszVerzio>1</valaszVerzio>
        <!-- 1: egyszerű szöveges vagy PDF válasz.
             2: XML válasz, ha a PDF-et is kéred, az XML-ben kerül elküldésre base64 kódolással -->
        <aggregator></aggregator>
        <!-- ez a tag kihagyható -->
        <szamlaKulsoAzon></szamlaKulsoAzon> <!--A számla ezzel a kulccsal azonosítható a harmadik fél rendszerében (a rendszer, amely használja a Számla Agentet): később ezzel a kulccsal le lehet kérdezni a számlát. Fontos: A számla csak akkor kapja meg ezt a külső azonosítót, ha a számla létrehozásakor beküldöd ezt a mezőt. -->
    </beallitasok>
    <!-- fejléc adatok -->
    <fejlec>
        <keltDatum>2025-01-20</keltDatum>
        <!-- kelte -->
        <teljesitesDatum>2025-01-20</teljesitesDatum>
        <!-- teljesítés dátuma -->
        <fizetesiHataridoDatum>2025-01-20</fizetesiHataridoDatum>
        <!-- fizetési határidő -->
        <fizmod>Átutalás</fizmod>
        <!-- fizetési mód: látható, ha a számlát böngészőből készíted -->
        <penznem>HUF</penznem>
        <!-- pénznem: látható, ha a számlát böngészőből készíted -->
        <szamlaNyelve>hu</szamlaNyelve>
        <!-- számla nyelve, lehet: de, en, it, hu, fr, ro, sk, hr -->
        <megjegyzes>Számla megjegyzése</megjegyzes>
        <!-- számla megjegyzése -->
        <arfolyamBank>MNB</arfolyamBank>
        <!-- bank neve: ha a számla nem HUF-ban van, fel kell tüntetni, melyik bank árfolyamát használtuk az ÁFA kiszámításához -->
        <arfolyam>0.0</arfolyam>
        <!-- árfolyam: ha a számla nem HUF-ban van, fel kell tüntetni, melyik bank árfolyamát használtuk az ÁFA kiszámításához -->
        <rendelesSzam></rendelesSzam>
        <!-- rendelési szám -->
        <dijbekeroSzamlaszam></dijbekeroSzamlaszam>
        <!-- hivatkozás a díjbekérő számlaszámra -->
        <elolegszamla>false</elolegszamla>
        <!-- előlegszámla -->
        <vegszamla>false</vegszamla>
        <!-- végszámla (előlegszámla után) -->
        <helyesbitoszamla>false</helyesbitoszamla>
        <!-- helyesbítő számla -->
        <helyesbitettSzamlaszam></helyesbitettSzamlaszam>
        <!-- a helyesbített számla száma -->
        <dijbekero>false</dijbekero>
        <!-- díjbekérő számla -->
        <szamlaszamElotag></szamlaszamElotag>
        <!-- A számlázz.hu-ban használható Előtagok egyike - Beállítások / Előtagok -->
        <simpleItems>false</simpleItems>
        <!-- egyszerűsített számlakép utazásszervezőknek; „true" esetén az ár- és
             áfaadatok nem jelennek meg a számlaképen, lásd az
             „Egyszerűsített tételadatok utazásszervezőknek" oldalt -->
    </fejlec>
    <elado>
        <!-- A kereskedő adatai -->
        <bank>BB</bank>
        <!-- bank neve -->
        <bankszamlaszam>11111111-22222222-33333333</bankszamlaszam>
        <!-- bankszámlaszám -->
        <emailReplyto></emailReplyto>
        <!-- válaszcím (e-mail) -->
        <emailTargy>Invoice notification</emailTargy>
        <!-- e-mail tárgya -->
        <emailSzoveg>mail text</emailSzoveg>
        <!-- e-mail szövege -->
    </elado>
    <vevo>
        <!-- Vevő adatai -->
        <nev>Kovacs Bt.</nev>
        <!-- név -->
        <irsz>2030</irsz>
        <!-- irányítószám -->
        <telepules>Érd</telepules>
        <!-- város -->
        <cim>Tárnoki út 23.</cim>
        <!-- cím -->
        <email>[email protected]</email>
        <!-- e-mail cím, ha megadja, erre a címre elküldjük a számlát -->
        <sendEmail>false</sendEmail>
        <!-- küldjük-e el e-mailben az ügyfélnek (e-mail) -->
        <adoszam>12345678-1-42</adoszam>
        <!-- adószám/adóazonosító jel -->
        <postazasiNev>Kovács Bt. mailing name</postazasiNev>
        <!-- szállítási név/postai név -->
        <postazasiIrsz>2040</postazasiIrsz>
        <!-- szállítási irányítószám/postai irányítószám -->
        <postazasiTelepules>Budaörs</postazasiTelepules>
        <!-- szállítási város/postai város -->
        <postazasiCim>Szivárvány utca 8.</postazasiCim>
        <!-- szállítási cím/postai cím -->
        <azonosito>1234</azonosito>
        <!-- Amennyiben számlázási fiókodban előfizetéssel rendelkezel,
        akkor a Beállítások - Partnerek menüpontban partnereid adatlapján
        egyedi azonosítót tudsz megadni. Fontos, hogy egy azonosító csak
        egyetlen partnerhez kapcsolódjon! NE használj olyan azonosítót,
        ami már más vevőhöz rögzítve lett számlázási fiókod partnertörzsében.-->
        <telefonszam>Tel:+3630-555-55-55, Fax:+3623-555-555</telefonszam>
        <!-- telefonszám -->
        <megjegyzes>Call extension 214 from the reception</megjegyzes>
        <!-- megjegyzés -->
    </vevo>
    <fuvarlevel>
        <!-- fuvarlevél/szállítólevél. ha nem kell, hagyd üresen -->
        <uticel></uticel>
        <futarSzolgalat></futarSzolgalat>
    </fuvarlevel>
    <tetelek>
        <!-- számlán lévő tételek -->
        <tetel>
            <!-- 1. tétel -->
            <megnevezes>Elado izé</megnevezes>
            <!-- megnevezés -->
            <mennyiseg>1.0</mennyiseg>
            <!-- mennyiség -->
            <mennyisegiEgyseg>db</mennyisegiEgyseg>
            <!-- mennyiségi egység -->
            <nettoEgysegar>10000</nettoEgysegar>
            <!-- nettó egységár -->
            <afakulcs>27</afakulcs>
            <!-- ÁFA kulcs -->
            <nettoErtek>10000.0</nettoErtek>
            <!-- nettó érték -->
            <afaErtek>2700.0</afaErtek>
            <!-- ÁFA érték -->
            <bruttoErtek>12700.0</bruttoErtek>
            <!-- bruttó érték -->
            <megjegyzes>lorem ipsum</megjegyzes>
            <!-- tétel megjegyzése -->
            <torloKod>123</torloKod>
            <!-- opcionális: adattörlőkód tételenként -->
        </tetel>
        <tetel>
            <!-- 2. tétel, részletek azonosak a fentiekkel -->
            <megnevezes>Elado izé 2</megnevezes>
            <mennyiseg>2.0</mennyiseg>
            <mennyisegiEgyseg>db</mennyisegiEgyseg>
            <nettoEgysegar>10000</nettoEgysegar>
            <afakulcs>27</afakulcs>
            <nettoErtek>20000.0</nettoErtek>
            <afaErtek>5400.0</afaErtek>
            <bruttoErtek>25400.0</bruttoErtek>
            <megjegyzes>lorem ipsum 2</megjegyzes>
        </tetel>
    </tetelek>
</xmlszamla>

A fenti mintában szereplő minden mező kötelező (a tagnek jelen kell lennie az XML-ben), azonban egyes mezők értéke üresen hagyható, ha a Számla Agent azt nem használja.

A Számlázz.hu nem végez számítást a tételadatokból, ezért a számlán szereplő összes összeget kötelező megadni. Az Agent tételenként ellenőrzi az alábbi összefüggések teljesülését:

  • nettó egységár × mennyiség = nettó érték
  • nettó érték + áfa = bruttó érték

Ha eltérést talál, hibát jelez (lehetséges hibakódok: 57, 259, 260, 261, 262, 263, 264) és a számla nem készül el.

Ne küldj már más vevőhöz rögzített azonosítót

Automatikus számlázás (Számla Agent) esetén a Számlázz.hu-ba küldött számlakészítési kérésben NE küldj olyan azonosítót (<azonosito>), ami már más vevőhöz rögzítve lett számlázási fiókod partnertörzsében. Ennek két következménye van: az egyező azonosítóval rendelkező vevők a vevői számlafiók link birtokában az összes, az adott vevői fiókhoz tartozó bizonylatot elérhetik, illetve a felismert azonosító alapján az általad küldött számlázási adatokkal automatikusan frissítjük a partner adatait.