Kimenő számlák

A Számlázz.hu képes átadni a számlázási fiókban létrehozott számlákat (és PDF-eket) egy külső rendszer felé. A regisztráció részben definiált táblázatban két plusz paraméter (URL a kimenő számlák fogadására) megadásával, meglévő kapcsolat is könnyen bővíthető. Az átküldés push jellegű, tehát amikor a Számlázz.hu-ban számlakibocsátás történik, akkor a Számlázz.hu erről üzenetet küld a fogadó rendszer felé. Nincs lehetőség arra, hogy a fogadó rendszer "lekérdezze" a számlaadatokat. A Hogyan működik? részben leírt működési logika ugyanúgy igaz a kimenő számlákra, mint a bejövőkre.

📄 Átadott bizonylattípusok

A következő típusú (kimenő) bizonylatokat a Számlázz.hu átadja a fogadó rendszer felé:

• számlák
• sztornó számlák
• helyesbítő számlák
• előlegszámlák
• végszámlák
• díjbekérők
• szállítólevelek

Ha a fogadó rendszernek valamelyik bizonylattípusra nincs szüksége, akkor az <alap> tagen belüli <tipus> tag alapján szűrhet.

Számlaküldést indukáló események

A Számlázz.hu egy kibocsátott számlát többször is átküldhet a fogadó rendszer felé. Minden egyes átküldés során átadja a kérdéses számla összes (aktuális) adatát (XML formában). A következő események indukálják azt, hogy a számla (először vagy ismételten) elküldésre kerül a fogadó rendszer felé:

• számla kibocsátása
• számla kifizetettségi állapotának megváltozása
• számla utólag módosítható adatainak változása, nevezetesen:
• könyvelés dátuma
• vevő főkönyvi szám
• vevő főkönyvi azonosító
• számla „folyamatos teljesítés” állapot
• bármely számlatétel árbevétel főkönyvi száma
• bármely számlatétel áfa főkönyvi száma
• bármely számlatétel gazdasági eseménye
• bármely számlatétel áfa gazdasági esemény
• bármely számlatétel elszámolási időszakának kezdete
• bármely számlatétel elszámolási időszakának vége
• a számla fizetési határidejének módosítása (<fizh>)
• a számla fizetési módjának módosítása (<fizmod>, <fizmodunified>)
• a számla bankszámlaszámának módosítása (<bankszamla> a <szallito> blokkban)

NAV-tól lehívott számlák továbbítása (Számlaverzum)

A Számlaverzummal a NAV Online Számla rendszeréből letöltött számlák (külső forrás, az XML-ben <forras>34) csak akkor kerülnek továbbításra a fogadó rendszer felé, ha a számlázási fiókban be van kapcsolva a „NAV-tól lehívott számlák továbbítása a könyvelői rendszerek felé” kapcsoló.

• A kapcsolót a fiók beállításokban találod, a Beállítások → NAV online adatkapcsolat oldalon, a Számlaverzum blokkban. Csak akkor látható, ha a fiókban van aktív pénzügyi adatkapcsolat.
• A kapcsoló alapértelmezetten kikapcsolt. A Számlaverzum bekapcsolásakor a rendszer automatikusan bekapcsolja, de utólag kikapcsolható, ezért érdemes ellenőrizni az állapotát.
• Ha a kapcsoló kikapcsolt, a NAV-tól lehívott számlák nem kerülnek továbbításra a fogadó rendszer felé. Ez a kimenő és a bejövő számlákat egyaránt érinti. A Számlázz.hu-ban kiállított számlákra nincs hatással.
• Ha a kapcsoló bekapcsolt, a NAV-ból letöltött számlák is átadásra kerülnek; bekapcsolás után a korábban letöltött NAV-számlák is feladásra kerülnek.

Ugyanez a beállítás vonatkozik a bejövő számlákra is.

Külső forrás, fizetési adatok

Külső forrásból (pl. NAV) érkező számlán a fizetési mód, fizetési határidő és bankszámlaszám a felületen utólag kitölthető, ha a mező üres. Kitöltés vagy módosítás után a bizonylat teljes adattartalommal újraküldésre kerül a fogadó rendszer felé; minden további módosítás is újabb átküldést indukál. Meglévő érték, akár Számlázz.hu-ban korábban rögzített, akár 2026.06.04. előtt külső forrásból letöltött adat nem szerkeszthető.

Ha a NAV nem ad értéket és a felhasználó sem tölti ki a felületen, az átadott XML-ben:

Mező	2026.06.04. előtt	2026.06.04. után
Fizetési mód	ismeretlen (NAV)	üres string
Fizetési határidő	2099-12-31	2099-12-31 (változatlan)
Bankszámlaszám	ismeretlen (NAV)	üres string

Ugyanez a szabály a bejövő számlák esetén is érvényes.

információ

Hogyan igényeld kimenő számla szolgáltatásunkat? A részletekhez kattints ide!

Kimenő számla feladás (XML)

A kimenő számlák feladása XML formátumban történik. Az alábbi tabokon a minta XML és az XSD séma található.

Minta XML

<?xml version="1.0" encoding="UTF-8"?>
<szamla xmlns="http://www.szamlazz.hu/szamla" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.szamlazz.hu/szamla https://www.szamlazz.hu/szamla/docs/xsds/szamla/szamla.xsd">
    <szallito>                                                             <!-- REQ         -->
        <id>12345</id>                                                     <!-- REQ int     -->
        <nev>Példa Kft.</nev>                                              <!-- REQ string  -->
        <cim>                                                              <!-- REQ         -->
            <orszag></orszag>                                              <!--     string  -->
            <irsz>1234</irsz>                                              <!-- REQ string  -->
            <telepules>Budapest</telepules>                                <!-- REQ string  -->
            <cim>Kis utca 2.</cim>                                         <!-- REQ string  --> <!-- a cím többi része -->
        </cim>
        <postacim>                                                         
            <orszag></orszag>                                              <!--     string  -->
            <irsz></irsz>                                                  <!--     string  -->
            <telepules></telepules>                                        <!--     string  -->
            <cim></cim>                                                    <!--     string  --> <!-- a cím többi része -->
        </postacim>                                                        
        <adoszam>12345678-9-99</adoszam>                                   <!-- REQ string  -->
        <adoszameu></adoszameu>                                            <!--     string  -->
        <bank>                                                             
            <nev></nev>                                                    <!--     string  -->
            <bankszamla>12345678-12345678</bankszamla>                     <!--     string  -->
        </bank>
    </szallito>
    <alap>                                                                 <!-- REQ         -->
        <id>123456</id>                                                    <!-- REQ int     --> <!-- a számla számlázz.hu-s belső azonosítója -->
        <szamlaszam>2015-123</szamlaszam>                                  <!-- REQ string  --> <!-- a számla egyedi száma -->
        <gazdEsemAzon>123456</gazdEsemAzon>                                <!-- REQ int     --> <!-- a számla számlázz.hu-s belső gazdasági esemény azonosítója --> 
        <forras>34</forras>                                                <!--     int     --> <!-- csak abban az esetben szerepel, ha a kérdéses számla nem a Számlázz.hu-val lett kibocsátva. 26:QUiCK, 28:SMARTBooks, 34:NAV Online számla -->
        <iktatoszam></iktatoszam>                                          <!--     string  --> <!-- könyvelési rendszertől kapott adat -->
        <tipus>SZ</tipus>                                                  <!-- REQ string  --> <!-- "SZ" Számla, "SS" Sztornó számla, "JS" Jóváíró számla, "HS" Helyesbítő számla, "ES" Előlegszámla, "VS" Végszámla, "D" Díjbekérő, "SL" szállítólevél -->
        <eszamla>1</eszamla>                                               <!-- REQ string  --> <!-- 0: nem számla,  1: papír számla,  2: e-számla,  3: e-számla -->
        <hivszamlaszam>2015-1</hivszamlaszam>                              <!--     string  --> <!-- Ha a számla sztornózó vagy jóváíró vagy végszámla, akkor a szülő számla számlaszáma -->
        <hivdijbekszam>D-1</hivdijbekszam>                                 <!--     string  --> <!-- Ha a számla díjbekérő alapján készült akkor a díbekérő száma -->
        <kelt>2015-12-01</kelt>                                            <!-- REQ date    --> <!-- Számla kelte     -->
        <telj>2015-12-02</telj>                                            <!-- REQ date    --> <!-- Teljesítés időpontja  -->
        <fizh>2015-12-03</fizh>                                            <!-- REQ date    --> <!-- Fizetései határidő    -->
        <fizmod>bankkártya</fizmod>                                        <!-- REQ string  --> <!-- Fizetési mód: agent esetén bármi lehet, egyébként fix értékek a felületen -->
        <fizmodunified>bankkártya</fizmodunified>                          <!-- REQ string  --> <!-- Fizetési mód: ha nem olyan a fizetési mód, mint ami a kézi számlán is elérhető, akkor "egyéb" lesz az értéke -->
        <keszpenz>true</keszpenz>                                          <!-- REQ boolean --> <!-- true ha a számla készpénzes -->
        <rendelesszam></rendelesszam>                                      <!--     string  -->
        <nyelv>hu</nyelv>                                                  <!-- REQ string  --> <!-- hu/en/de/sk/it/fr/hr/ro -->
        <devizanem>EUR</devizanem>                                         <!--     string  --> <!-- üres, Ft, HUF, EUR, CHF, USD, ... -->
        <devizabank></devizabank>                                          <!--     string  -->
        <devizaarf>210</devizaarf>                                         <!--     double  -->
        <megjegyzes></megjegyzes>                                          <!--     string  -->
        <penzforg>true</penzforg>                                          <!-- REQ boolean --> <!-- true ha a számla pénzforgalmi -->
        <kata>true</kata>                                                  <!-- REQ boolean --> <!-- true ha a számla KATA-s -->
        <katafokonyv>false</katafokonyv>                                   <!-- REQ boolean --> <!-- Ez a számla a számlakibocsátó véleménye szerint katás számlaként kezelendő-e (könyvelés) -->
        <email>[email protected]</email>                                    <!--     string  --> <!-- számlával összefüggésbe hozható emailcím (utoljára ide lett elküldve a számla) -->
        <teszt>false</teszt>                                               <!-- REQ boolean --> <!-- A számla teszt vagy éles üzemű fiókban van -->
    </alap>         
    <vevo>                                                                 <!-- REQ         -->
        <id>1234567</id>                                                   <!-- REQ int     -->
        <nev></nev>                                                        <!-- REQ string  -->
        <azonosito></azonosito>                                            <!--     string  --> <!-- Vevő azonosító  -->
        <cim>                                                              
            <orszag></orszag>                                              <!-- REQ string  -->
            <irsz></irsz>                                                  <!-- REQ string  -->
            <telepules></telepules>                                        <!-- REQ string  -->
            <cim></cim>                                                    <!-- REQ string  --> <!-- a cím többi része -->
        </cim>                                                             
        <postacim>                                                         
            <nev></nev>                                                    <!--     string  -->
            <orszag></orszag>                                              <!--     string  -->
            <irsz></irsz>                                                  <!--     string  -->
            <telepules></telepules>                                        <!--     string  -->
            <cim></cim>                                                    <!--     string  --> <!-- a cím többi része -->
        </postacim>
        <email>[email protected]</email>                                    <!--     string  --> <!-- a vevő emailcíme -->         
        <adoszam></adoszam>                                                
        <adoszameu></adoszameu>                                            
        <lokacio>1</lokacio>                                               <!-- REQ int     --> <!-- 1: belföldi (magyar), 2: EU-n belüli,3: EU-n kívüli (3. ország),-1: ismeretlen -->
        <privatePersonIndicator>false</privatePersonIndicator>             <!--     boolean --> <!--  vevő magánszemély -->
        <fokonyv>  
            <vevo>12345A</vevo>                                            <!--     string  --> <!--  vevői főkönyvi szám -->
            <vevoazon>12345A</vevoazon>                                    <!--     string  --> <!--  vevői főkönyvi azonosító -->
            <datum>2015-12-05</datum>                                      <!--     date    --> <!--  könyvelés dátuma -->
            <folyamatostelj>false</folyamatostelj>                         <!--     boolean --> <!--  folyamatos teljesítésű-e a számla -->
        </fokonyv>
    </vevo>
    <tetelek>                                                              <!-- REQ         -->
        <tetel>                                                            <!-- REQ         -->
            <nev>Alma</nev>                                                <!-- REQ string  -->
            <azonosito></azonosito>                                        <!--     string  -->
            <mennyiseg>2</mennyiseg>                                       <!-- REQ double  -->
            <mennyisegiegyseg>kg</mennyisegiegyseg>                        <!-- REQ string  -->
            <nettoegysegar>100.1</nettoegysegar>                           <!-- REQ double  -->
            <afatipus>ÁKK</afatipus>                                       <!--     string  --> <!--  ÁKK: áfakörön kívüli, K.AFA: különbözeti áfa, F.AFA: fordított áfa fizetés, MAA: Mentes az adó alól, EUKT: EU-n kívül, EUT: EU-n belül, EUK: EU-n kívül, EU: EU-n belül, AAM: Alanyi adómentes, TAM: Tárgyi adómentes, TAHK: áfa tárgyi hatályán kívül -->
            <afakulcs>0</afakulcs>                                         <!-- REQ double  -->
            <netto>200</netto>                                             <!-- REQ double  -->
            <arresafaalap>0</arresafaalap>                                 <!-- REQ double  -->
            <afa>54</afa>                                                  <!-- REQ double  -->
            <brutto>254</brutto>                                           <!-- REQ double  -->
            <megjegyzes>zöld</megjegyzes>                                  <!--     string  -->
            <sztetordering>1</sztetordering>                               <!-- REQ double  -->  <!-- tétel sorrendje a számlán -->
            <fokonyv>                                                                      
                <arbevetel>12345A</arbevetel>                              <!--     string  --> <!--  árbevétel főkönyvi szám -->
                <afa>12345A</afa>                                          <!--     string  --> <!--  ÁFA főkönyvi szám -->
                <gazdasagiesemeny>12345A</gazdasagiesemeny>                <!--     string  --> <!--  gazdasági esemény főkönyvi szám -->
                <gazdasagiesemenyafa>12345A</gazdasagiesemenyafa>          <!--     string  --> <!--  ÁFA gazdasági esemény főkönyvi szám -->
                <elszdattol>2018-01-01</elszdattol>                        <!--     date    --> <!--  A számla tétel elszámolási időszak kezdete -->
                <elszdatig>2018-01-31</elszdatig>                          <!--     date    --> <!--  A számla tétel elszámolási időszak vége -->
            </fokonyv>                                                                     
        </tetel>                                                                           
    </tetelek>                                                                             
    <osszegek>                                                                             
        <afakulcsossz>                                                     <!-- REQ double  -->
            <afatipus>ÁKK</afatipus>                                       <!--     string  --> <!--  ÁKK: áfakörön kívüli, K.AFA: különbözeti áfa, F.AFA: fordított áfa fizetés, MAA: Mentes az adó alól, EUK: EU-n kívül, EU: EU-n belül, AAM: Alanyi adómentes, TAM: Tárgyi adómentes -->
            <afakulcs>0</afakulcs>                                         <!-- REQ double  -->
            <netto>200</netto>                                             <!-- REQ double  -->
            <afa>54</afa>                                                  <!-- REQ double  -->
            <brutto>254</brutto>                                           <!-- REQ double  -->
        </afakulcsossz>                                                                    
        <totalossz>                                                        <!-- REQ         -->
            <netto>200</netto>                                             <!-- REQ double  -->
            <afa>54</afa>                                                  <!-- REQ double  -->
            <brutto>254</brutto>                                           <!-- REQ double  -->
        </totalossz>                                                                       
    </osszegek>                                                                            
    <kifizetesek>                                                                          
        <kifizetes>                                                                        
            <datum>2015-02-28</datum>                                      <!--     date    -->
            <jogcim>átutalás</jogcim>                                      <!--     string  -->
            <osszeg>300</osszeg>                                           <!--     double  -->
            <megjegyzes></megjegyzes>                                      <!--     string  -->
            <bankszamlaszam></bankszamlaszam>                              <!--     string  --> <!-- A kifizetés ténylegesen erről a bankszámláról érkezett, vagy a számlán szereplő bankszámlaszám (ha a küldő bankszámlaszám nem ismert) -->
            <banktranzid>1234</banktranzid>                                <!--     int     -->
            <devizaarf>275</devizaarf>                                     <!--     double  -->
        </kifizetes>    
    </kifizetesek>
    <pdf></pdf>
</szamla>    

XSD

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.szamlazz.hu/szamla" xmlns:tns="http://www.szamlazz.hu/szamla" elementFormDefault="qualified">

    <simpleType name="nyelvTipus">
        <restriction base="string">
            <enumeration value="hu"></enumeration>
            <enumeration value="en"></enumeration>
            <enumeration value="de"></enumeration>
            <enumeration value="it"></enumeration>
            <enumeration value="ro"></enumeration>
            <enumeration value="sk"></enumeration>
            <enumeration value="hr"></enumeration>
            <enumeration value="fr"></enumeration>
            <enumeration value="es"></enumeration>
            <enumeration value="cz"></enumeration>
            <enumeration value="pl"></enumeration>
            <enumeration value="bg"></enumeration>
            <enumeration value="nl"></enumeration>
            <enumeration value="ru"></enumeration>
            <enumeration value="si"></enumeration>
        </restriction>
    </simpleType>

    <simpleType name="afatipusTipus">
        <restriction base="string">
            <enumeration value="TAM"></enumeration>
            <enumeration value="AAM"></enumeration>
            <enumeration value="EU"></enumeration>
            <enumeration value="EUK"></enumeration>
            <enumeration value="MAA"></enumeration>
            <enumeration value="F.AFA"></enumeration>
            <enumeration value="K.AFA"></enumeration>
            <enumeration value="ÁKK"></enumeration>
            <enumeration value="TAHK"></enumeration>
            <enumeration value="TEHK"></enumeration>
            <enumeration value="EUT"></enumeration>
            <enumeration value="EUKT"></enumeration>
            <enumeration value="HO"></enumeration>
            <enumeration value="EUE"></enumeration>
            <enumeration value="EUFADE"></enumeration>
            <enumeration value="EUFAD37"></enumeration>
            <enumeration value="ATK"></enumeration>
            <enumeration value="NAM"></enumeration>
            <enumeration value="EAM"></enumeration>
            <enumeration value="KBAUK"></enumeration>
            <enumeration value="KBAET"></enumeration>
        </restriction>
    </simpleType>
    
    <simpleType name="fizmodunifiedTipus">
        <restriction base="string">
            <enumeration value="átutalás"></enumeration>
            <enumeration value="készpénz"></enumeration>
            <enumeration value="bankkártya"></enumeration>
            <enumeration value="csekk"></enumeration>
            <enumeration value="utánvét"></enumeration>
            <enumeration value="ajándékutalvány"></enumeration>
            <enumeration value="barion"></enumeration>
            <enumeration value="barter"></enumeration>
            <enumeration value="csoportos beszedés"></enumeration>
            <enumeration value="OTP Simple"></enumeration>
            <enumeration value="kompenzáció"></enumeration>
            <enumeration value="kupon"></enumeration>
            <enumeration value="PayPal"></enumeration>
            <enumeration value="PayU"></enumeration>
            <enumeration value="SZÉP kártya"></enumeration>
            <enumeration value="utalvány"></enumeration>
            <enumeration value="MasterCard Mobile"></enumeration>
            <enumeration value="Borgun"></enumeration>
            <enumeration value="EP kártya"></enumeration>
            <enumeration value="térítésmentes"></enumeration>
            <enumeration value="egyéb"></enumeration>
        </restriction>
    </simpleType>



    <complexType name="cimTipus">
        <sequence>
            <element name="orszag"    type="string" maxOccurs="1" minOccurs="0"></element>
            <element name="irsz"      type="string" maxOccurs="1" minOccurs="1"></element>
            <element name="telepules" type="string" maxOccurs="1" minOccurs="1"></element>
            <element name="cim"       type="string" maxOccurs="1" minOccurs="1"></element>
        </sequence>
    </complexType>

    <complexType name="cimpostaTipus">
        <sequence>
            <element name="nev"       type="string" maxOccurs="1" minOccurs="0"></element>
            <element name="orszag"    type="string" maxOccurs="1" minOccurs="0"></element>
            <element name="irsz"      type="string" maxOccurs="1" minOccurs="0"></element>
            <element name="telepules" type="string" maxOccurs="1" minOccurs="0"></element>
            <element name="cim"       type="string" maxOccurs="1" minOccurs="0"></element>
        </sequence>
    </complexType>

    <complexType name="bankTipus">
        <sequence>
            <element name="nev"        type="string" maxOccurs="1" minOccurs="0"></element>
            <element name="bankszamla" type="string" maxOccurs="1" minOccurs="0"></element>
        </sequence>
    </complexType>

    <!-- szállító adatai -->
    <complexType name="szallitoTipus">
        <sequence>
            <element name="id"                  type="int"               maxOccurs="1" minOccurs="1"></element>
            <element name="nev"                 type="string"            maxOccurs="1" minOccurs="1"></element>
            <element name="cim"                 type="tns:cimTipus"      maxOccurs="1" minOccurs="1"></element>
            <element name="postacim"            type="tns:cimTipus"      maxOccurs="1" minOccurs="0"></element>
            <element name="adoszam"             type="string"            maxOccurs="1" minOccurs="1"></element>
            <element name="csoportazonosito"    type="string"            maxOccurs="1" minOccurs="0"></element>
            <element name="adoszameu"           type="string"            maxOccurs="1" minOccurs="0"></element>
            <element name="bank"                type="tns:bankTipus"     maxOccurs="1" minOccurs="0"></element>
        </sequence>
    </complexType>


    <!-- számla alapadatai -->
    <complexType name="alapTipus">
        <sequence>
            <element name="id"              type="int"                    maxOccurs="1" minOccurs="1"></element>
            <element name="szamlaszam"      type="string"                 maxOccurs="1" minOccurs="1"></element>
            <element name="gazdEsemAzon"    type="int"                    maxOccurs="1" minOccurs="1"></element>
            <element name="forras"          type="int"                    maxOccurs="1" minOccurs="0"></element>    <!-- csak abban az esetben szerepel, ha a kérdéses számla nem a Számlázz.hu-val lett kibocsátva.  -->
                                                                                                                     <!-- 26:QUiCK, 28:SMARTBooks, 34:NAV Online számla --> 
            <element name="iktatoszam"      type="string"                 maxOccurs="1" minOccurs="0"></element>
            <element name="tipus"           type="string"                 maxOccurs="1" minOccurs="1"></element>
            <element name="eszamla"         type="int"                    maxOccurs="1" minOccurs="1"></element>
            <element name="hivszamlaszam"   type="string"                 maxOccurs="1" minOccurs="0"></element>
            <element name="hivdijbekszam"   type="string"                 maxOccurs="1" minOccurs="0"></element>
            <element name="kelt"            type="date"                   maxOccurs="1" minOccurs="1"></element>
            <element name="telj"            type="date"                   maxOccurs="1" minOccurs="1"></element>
            <element name="fizh"            type="date"                   maxOccurs="1" minOccurs="1"></element>
            <element name="fizmod"          type="string"                 maxOccurs="1" minOccurs="1"></element>
            <element name="fizmodunified"   type="tns:fizmodunifiedTipus" maxOccurs="1" minOccurs="1"></element>
            <element name="keszpenz"        type="boolean"                maxOccurs="1" minOccurs="1"></element>
            <element name="rendelesszam"    type="string"                 maxOccurs="1" minOccurs="0"></element>
            <element name="nyelv"           type="tns:nyelvTipus"         maxOccurs="1" minOccurs="1"></element>
            <element name="devizanem"       type="string"                 maxOccurs="1" minOccurs="1"></element>
            <element name="devizabank"      type="string"                 maxOccurs="1" minOccurs="0"></element>
            <element name="devizaarf"       type="double"                 maxOccurs="1" minOccurs="0"></element>
            <element name="megjegyzes"      type="string"                 maxOccurs="1" minOccurs="0"></element>
            <element name="afatipus"        type="string"                 maxOccurs="1" minOccurs="0"></element>  <!-- a számlán szereplő áfa nem magyar (hanem az EU másik tagállamát illeti) -->
            <element name="penzforg"        type="boolean"                maxOccurs="1" minOccurs="1"></element>
            <element name="kata"            type="boolean"                maxOccurs="1" minOccurs="1"></element>
            <element name="katafokonyv"     type="boolean"                maxOccurs="1" minOccurs="1"></element>
            <element name="email"           type="string"                 maxOccurs="1" minOccurs="0"></element>
            <element name="teszt"           type="boolean"                maxOccurs="1" minOccurs="1"></element>
            <element name="sztornozott"     type="boolean"                maxOccurs="1" minOccurs="0"></element>
        </sequence>
    </complexType>

    <!-- vevő adatai -->
    <complexType name="fokonyvvevoTipus">
        <sequence>
            <element name="vevo"           type="string"  maxOccurs="1" minOccurs="0"></element>
            <element name="vevoazon"       type="string"  maxOccurs="1" minOccurs="0"></element>
            <element name="datum"          type="date"    maxOccurs="1" minOccurs="0"></element>
            <element name="folyamatostelj" type="boolean" maxOccurs="1" minOccurs="0"></element>
            <element name="elszDatTol"     type="date"    maxOccurs="1" minOccurs="0"></element>
            <element name="elszDatIg"      type="date"    maxOccurs="1" minOccurs="0"></element>
        </sequence>
    </complexType>
    <complexType name="vevoTipus">
        <sequence>
            <element name="id"                      type="int"                  maxOccurs="1" minOccurs="0"></element>
            <element name="nev"                     type="string"               maxOccurs="1" minOccurs="1"></element>
            <element name="azonosito"               type="string"               maxOccurs="1" minOccurs="0"></element>
            <element name="cim"                     type="tns:cimTipus"         maxOccurs="1" minOccurs="1"></element>
            <element name="postacim"                type="tns:cimpostaTipus"    maxOccurs="1" minOccurs="0"></element>
            <element name="email"                   type="string"               maxOccurs="1" minOccurs="0"></element>
            <element name="adoszam"                 type="string"               maxOccurs="1" minOccurs="1"></element>
            <element name="csoportazonosito"        type="string"               maxOccurs="1" minOccurs="0"></element>
            <element name="adoszameu"               type="string"               maxOccurs="1" minOccurs="0"></element>
            <element name="lokacio"                 type="int"                  maxOccurs="1" minOccurs="1"></element>
            <element name="privatePersonIndicator"  type="boolean"              maxOccurs="1" minOccurs="1"></element>
            <element name="fokonyv"                 type="tns:fokonyvvevoTipus" maxOccurs="1" minOccurs="0"></element>
        </sequence>
    </complexType>

    <!-- számla tételek -->
    <complexType name="fokonyvtetelTipus">
        <sequence>
            <element name="arbevetel"           type="string" maxOccurs="1" minOccurs="0"></element>
            <element name="afa"                 type="string" maxOccurs="1" minOccurs="0"></element>
            <element name="gazdasagiesemeny"    type="string" maxOccurs="1" minOccurs="0"></element>
            <element name="gazdasagiesemenyafa" type="string" maxOccurs="1" minOccurs="0"></element>
            <element name="elszdattol"          type="date"   maxOccurs="1" minOccurs="0"></element>
            <element name="elszdatig"           type="date"   maxOccurs="1" minOccurs="0"></element>
        </sequence>
    </complexType>
    <complexType name="tetelTipus">
        <sequence>
            <element name="nev"              type="string" maxOccurs="1" minOccurs="1"></element>
            <element name="azonosito"        type="string" maxOccurs="1" minOccurs="0"></element>
            <element name="mennyiseg"        type="double" maxOccurs="1" minOccurs="1"></element>
            <element name="mennyisegiegyseg" type="string" maxOccurs="1" minOccurs="1"></element>
            <element name="nettoegysegar"    type="double" maxOccurs="1" minOccurs="1"></element>
            <element name="afatipus"         type="tns:afatipusTipus" maxOccurs="1" minOccurs="0"></element>
            <element name="afakulcs"         maxOccurs="1" minOccurs="1">
                <simpleType>
                    <restriction base="double">
                        <minInclusive value="0"></minInclusive>
                    </restriction>
                </simpleType>
            </element>
            <element name="netto"            type="double" maxOccurs="1" minOccurs="1"></element>
            <element name="arresafaalap"     type="double" maxOccurs="1" minOccurs="0"></element>
            <element name="afa"              type="double" maxOccurs="1" minOccurs="1"></element>
            <element name="brutto"           type="double" maxOccurs="1" minOccurs="1"></element>
            <element name="megjegyzes"       type="string" maxOccurs="1" minOccurs="0"></element>
            <element name="sztetordering"    type="int"    maxOccurs="1" minOccurs="1"></element>
            <element name="fokonyv"          type="tns:fokonyvtetelTipus" maxOccurs="1" minOccurs="0"></element>
        </sequence>
    </complexType>
    <complexType name="tetelekTipus">
        <sequence>
            <element name="tetel" type="tns:tetelTipus" maxOccurs="unbounded" minOccurs="1"></element>
        </sequence>
    </complexType>

    <!-- áfakulcsonkénti összesítés -->
    <complexType name="afakulcsosszTipus">
        <sequence>
            <element name="afatipus" type="tns:afatipusTipus" maxOccurs="1" minOccurs="0"></element>
            <element name="afakulcs" maxOccurs="1" minOccurs="1">
                <simpleType>
                    <restriction base="double">
                        <minInclusive value="0"></minInclusive>
                    </restriction>
                </simpleType>
            </element>
            <element name="netto"    type="double" maxOccurs="1" minOccurs="1"></element>
            <element name="afa"      type="double" maxOccurs="1" minOccurs="1"></element>
            <element name="brutto"   type="double" maxOccurs="1" minOccurs="1"></element>
        </sequence>
    </complexType>
    <!-- számla teljes összesítés -->
    <complexType name="totalosszTipus">
        <sequence>
            <element name="netto"  type="double" maxOccurs="1" minOccurs="1"></element>
            <element name="afa"    type="double" maxOccurs="1" minOccurs="1"></element>
            <element name="brutto" type="double" maxOccurs="1" minOccurs="1"></element>
        </sequence>
    </complexType>
    <!-- számla összesítők (áfakulcsonként és total) -->
    <complexType name="osszegekTipus">
        <sequence>
            <element name="afakulcsossz" type="tns:afakulcsosszTipus" maxOccurs="unbounded" minOccurs="1"></element>
            <element name="totalossz"    type="tns:totalosszTipus"    maxOccurs="1"         minOccurs="1"></element>
        </sequence>
    </complexType>
    
    <!-- számla kifizetettségi adatok -->
    <complexType name="kifizetesTipus">
        <sequence>
            <element name="datum"          type="date"   maxOccurs="1" minOccurs="1"></element>
            <element name="jogcim"         type="string" maxOccurs="1" minOccurs="1"></element>
            <element name="osszeg"         type="double" maxOccurs="1" minOccurs="1"></element>
            <element name="megjegyzes"     type="string" maxOccurs="1" minOccurs="0"></element>
            <element name="bankszamlaszam" type="string" maxOccurs="1" minOccurs="0"></element>
            <element name="banktranzid"    type="int"    maxOccurs="1" minOccurs="0"></element>
            <element name="devizaarf"      type="double" maxOccurs="1" minOccurs="0"></element>
        </sequence>
    </complexType>
    <complexType name="kifizetesekTipus">
        <sequence>
            <element name="kifizetes" type="tns:kifizetesTipus" maxOccurs="unbounded" minOccurs="1"></element>
        </sequence>
    </complexType>

    <!-- pénzügyi tételek (és számla egésze) címkék -->
    <complexType name="cimkekTipus">
        <sequence>
            <element name="cimke" type="string" maxOccurs="1" minOccurs="0"></element>
        </sequence>
    </complexType>

    <!-- pénzügyi tételek -->
    <complexType name="qutetekTipus">
        <sequence>
            <element name="qutet" type="tns:qutetTipus" maxOccurs="unbounded" minOccurs="0"></element>
        </sequence>
    </complexType>

    <complexType name="qutetTipus">
        <sequence>
            <element name="nev"              type="string" maxOccurs="1" minOccurs="1"></element>
            <element name="afatipus"         type="tns:afatipusTipus" maxOccurs="1" minOccurs="0"></element>
            <element name="afakulcs"         maxOccurs="1" minOccurs="1">
                <simpleType>
                    <restriction base="double">
                        <minInclusive value="0"></minInclusive>
                    </restriction>
                </simpleType>
            </element>
            <element name="netto"            type="double" maxOccurs="1" minOccurs="1"></element>
            <element name="afa"              type="double" maxOccurs="1" minOccurs="1"></element>
            <element name="brutto"           type="double" maxOccurs="1" minOccurs="1"></element>
            <element name="elszdattol"       type="date" maxOccurs="1" minOccurs="0"></element>
            <element name="elszdatig"        type="date" maxOccurs="1" minOccurs="0"></element>
            <element name="afalevon"         type="int"  maxOccurs="1" minOccurs="1"></element>
            <element name="cimkek"           type="tns:cimkekTipus" maxOccurs="1" minOccurs="0"></element>
        </sequence>
    </complexType>

    <!-- gyökérelem -->
    <element name="szamla">
        <complexType>
            <sequence>
                <element name="szallito"    type="tns:szallitoTipus"    maxOccurs="1" minOccurs="1"></element>
                <element name="alap"        type="tns:alapTipus"        maxOccurs="1" minOccurs="1"></element>
                <element name="vevo"        type="tns:vevoTipus"        maxOccurs="1" minOccurs="1"></element>
                <element name="tetelek"     type="tns:tetelekTipus"     maxOccurs="1" minOccurs="1"></element>
                <element name="qutetek"     type="tns:qutetekTipus"     maxOccurs="1" minOccurs="0"></element>
                <element name="cimkek"      type="tns:cimkekTipus"      maxOccurs="1" minOccurs="0"></element>
                <element name="osszegek"    type="tns:osszegekTipus"    maxOccurs="1" minOccurs="1"></element>
                <element name="kifizetesek" type="tns:kifizetesekTipus" maxOccurs="1" minOccurs="0"></element>
                <element name="pdf"         type="string"                             minOccurs="0"></element>
            </sequence>
        </complexType>
    </element>
    
</schema>

Elvárt válasz

Fogadó végpont követelményei

Csak olyan végponttal működik megbízhatóan a kapcsolat, amely HTTP 200 (OK) státusszal és a helyes válasz XML-lel tér vissza egyetlen HTTP-válasz törzsében. Nem támogatjuk azokat a végpontokat, amelyek fogadáskor csak HTTP 302 (átirányítás) választ adnak, például a Google Apps Script (vagy hasonló "web appok"). Bővebben: Regisztráció.

A Számlázz.hu-nak érzékelnie kell, hogy az általa küldött HTTP kérést a fogadó rendszer “átvette”, értelmezte és kezelte. A számlaválasznak az alábbi XSD-nek kell megfelelnie: https://www.szamlazz.hu/szamla/docs/xsds/szamla/szamlavalasz.xsd

Az elvárt válaszhoz négy dolog szükséges:

• A HTTP válasz státuszkódja legyen 200 (OK).
• A válasz egy helyesen formázott XML.
• A válaszban kötelező szerepelnie a <id> mezőnek, és annak egyeznie kell a kapott számla XML-ben érkező <id> értékkel (az <alap><id>...</id></alap> blokkban). Ha a számlaválaszban szereplő <id> nem egyezik meg a kapott számla <id> értékével, a válasz elutasításra kerül.
• A válaszban opcionálisan megadható a fogadó rendszer által a számlához kiosztott iktatószám.

Elvárt válasz példa XML

<szamlavalasz xmlns="http://www.szamlazz.hu/szamlavalasz"
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
              xsi:schemaLocation="http://www.szamlazz.hu/szamlavalasz">
    <alap>
        <id>1001</id>   <!-- egyezzen a kapott számla XML <szamla><alap><id>...</id></alap></szamla> értékével -->
        <iktatoszam>IKT-20250101</iktatoszam>
    </alap>
    <!--<hibakod>KEY_ERR</hibakod>-->
</szamlavalasz>

Az iktatószámról

A Számlázz.hu lehetővé teszi azt, hogy a fogadó rendszer egy egyedi iktatószámot rendeljen a frissen befogadott számlához. Ezt az iktatószámot a számla első befogadásakor, válaszként kell elküldeni a Számlázz.hu felé. Ha a válaszban érkezik iktatószám, akkor:

• azt a Számlázz.hu eltárolja a számla adatai között (a számla pdf-en nem jelenik meg!)
• a számla ismételt átküldésekor ezt az iktatószámot is elküldjük a számla többi adatával együtt. Fentebb részleteztük, hogy a számla adatait a Számlázz.hu mindig teljes körűen átküldi a fogadó rendszer felé, továbbá hogy a számla adatai többször is átküldésre kerülhetnek (Számlaküldést indukáló események). A számlaadatok első átküldésekor az iktatószám mindig üres. A számla adatok második (vagy későbbi) átküldésekor az iktatószám mezőben lehet adat attól függően, hogy a korábbi átküldésre válaszul a Számlázz.hu kapott-e iktatószámot a fogadó rendszertől.

Kulcshiba kezelés

Hibás kulcs esetén a válaszban lehetőség van két speciális paramétert küldeni a hibakodTipus-on belül:

KEY_ERR: hibás kulcs. Az átküldött kulcs nem található a fogadó rendszerben, ilyenkor a bizonylatot a következő változásáig nem küldjük újra.

KEY_DEL: törlendő kulcs. Törölni kell az online feladáshoz szükséges információkat a számlázási fiókból. Ezen válasz hatására a fiókgazda e-mailben fog értesülni arról, hogy a fiókjában kikapcsoltuk a fogadó rendszer felé az online kapcsolatot. Mivel a küldés aszinkron, a már feladásra jelölt bizonylatokat átadhatjuk a törlés tényének regisztrálása után is.

tanács

Ha ezen az oldalon nem találtad meg, amit kerestél, akkor nézz körbe a Hogyan működik? oldalon.

Mi történik akkor, ha díjbekérő alapján történik számlakibocsátás?

1. Ilyenkor a frissen kibocsátott számlát elküldjük a fogadó rendszer felé, de a díjbekérőt nem küldjük újra.
2. A frissen kibocsátott számla az <alap><hivdijbekszam> tagben tartalmazza majd a díjbekérő számlaszámát. A díjbekérő iktatószámát viszont nem tartalmazza.
3. A díjbekérő attól függően törlődik, hogy a beállítások között mi szerepel (Beállítások/Fiók beállításai).
4. Díjbekérő törléséről a Számlázz.hu semmilyen üzenetet nem küld a fogadó rendszer felé.

💳 Fizetési módok kezelése

A Számlázz.hu-ban kézi számlakészítéskor vagy jóváírások adminisztrálása során fix értékkészletből választható a fizetés módja, de a Számla Agenttel készített számlákon a küldő rendszer tetszőleges stringet adhat át a fizetés módjaként. Emiatt a számlák online feladásakor a fizetési módot kétféleképpen küldjük az XML-ben:

• A <fizmod> tag tartalmazza a fizetési módként tárolt tetszőleges értékű stringet (gyakorlatilag ez a fizetési mód szerepel a számlán).
• A <fizmodunified> tag pedig ennek normalizált értéke. Az értékkészlet: átutalás, készpénz, bankkártya, csekk, utánvét, ajándékutalvány, barion, barter, csoportos beszedés, OTP Simple, kompenzáció, kupon, PayPal, PayU, SZÉP kártya, utalvány, egyéb. Ha a <fizmod> értéke ezek valamelyikéhez nem rendelhető hozzá egyértelműen, akkor az érték “egyéb” lesz. Az értékek az XSD-ben is megtalálhatóak.
• A <keszpenz> értéke true, ha készpénzes a fizetés, egyébként false.