Ugrás a fő tartalomhoz

Kimenő számlák átadása

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 működés részletei fejezetekben 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

Ezek az adatok a számla adatlapján módosíthatók.

információ

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

Kimenő számla feladás​

A kimenő számlák feladása XML formátumban történik, és az alábbi XSD-nek felel meg.

https://www.szamlazz.hu/szamla/docs/xsds/szamla/szamla.xsd
<schema xmlns="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://www.szamlazz.hu/szamla" targetNamespace="http://www.szamlazz.hu/szamla" elementFormDefault="qualified">
<simpleType name="nyelvTipus">
<restriction base="string">
<enumeration value="hu"/>
<enumeration value="en"/>
<enumeration value="de"/>
<enumeration value="it"/>
<enumeration value="ro"/>
<enumeration value="sk"/>
<enumeration value="hr"/>
<enumeration value="fr"/>
<enumeration value="es"/>
<enumeration value="cz"/>
<enumeration value="pl"/>
<enumeration value="bg"/>
<enumeration value="nl"/>
<enumeration value="ru"/>
<enumeration value="si"/>
</restriction>
</simpleType>
<simpleType name="afatipusTipus">
<restriction base="string">
<enumeration value="TAM"/>
<enumeration value="AAM"/>
<enumeration value="EU"/>
<enumeration value="EUK"/>
<enumeration value="MAA"/>
<enumeration value="F.AFA"/>
<enumeration value="K.AFA"/>
<enumeration value="ÁKK"/>
<enumeration value="TAHK"/>
<enumeration value="TEHK"/>
<enumeration value="EUT"/>
<enumeration value="EUKT"/>
<enumeration value="HO"/>
<enumeration value="EUE"/>
<enumeration value="EUFADE"/>
<enumeration value="EUFAD37"/>
<enumeration value="ATK"/>
<enumeration value="NAM"/>
<enumeration value="EAM"/>
<enumeration value="KBAUK"/>
<enumeration value="KBAET"/>
</restriction>
</simpleType>
<simpleType name="fizmodunifiedTipus">
<restriction base="string">
<enumeration value="átutalás"/>
<enumeration value="készpénz"/>
<enumeration value="bankkártya"/>
<enumeration value="csekk"/>
<enumeration value="utánvét"/>
<enumeration value="ajándékutalvány"/>
<enumeration value="barion"/>
<enumeration value="barter"/>
<enumeration value="csoportos beszedés"/>
<enumeration value="OTP Simple"/>
<enumeration value="kompenzáció"/>
<enumeration value="kupon"/>
<enumeration value="PayPal"/>
<enumeration value="PayU"/>
<enumeration value="SZÉP kártya"/>
<enumeration value="utalvány"/>
<enumeration value="egyéb"/>
</restriction>
</simpleType>
<complexType name="cimTipus">
<sequence>
<element name="orszag" type="string" maxOccurs="1" minOccurs="0"/>
<element name="irsz" type="string" maxOccurs="1" minOccurs="1"/>
<element name="telepules" type="string" maxOccurs="1" minOccurs="1"/>
<element name="cim" type="string" maxOccurs="1" minOccurs="1"/>
</sequence>
</complexType>
<complexType name="cimpostaTipus">
<sequence>
<element name="nev" type="string" maxOccurs="1" minOccurs="0"/>
<element name="orszag" type="string" maxOccurs="1" minOccurs="0"/>
<element name="irsz" type="string" maxOccurs="1" minOccurs="0"/>
<element name="telepules" type="string" maxOccurs="1" minOccurs="0"/>
<element name="cim" type="string" maxOccurs="1" minOccurs="0"/>
</sequence>
</complexType>
<complexType name="bankTipus">
<sequence>
<element name="nev" type="string" maxOccurs="1" minOccurs="0"/>
<element name="bankszamla" type="string" maxOccurs="1" minOccurs="0"/>
</sequence>
</complexType>
<!--  szállító adatai  -->
<complexType name="szallitoTipus">
<sequence>
<element name="id" type="int" maxOccurs="1" minOccurs="1"/>
<element name="nev" type="string" maxOccurs="1" minOccurs="1"/>
<element name="cim" type="tns:cimTipus" maxOccurs="1" minOccurs="1"/>
<element name="postacim" type="tns:cimTipus" maxOccurs="1" minOccurs="0"/>
<element name="adoszam" type="string" maxOccurs="1" minOccurs="1"/>
<element name="csoportazonosito" type="string" maxOccurs="1" minOccurs="0"/>
<element name="adoszameu" type="string" maxOccurs="1" minOccurs="0"/>
<element name="bank" type="tns:bankTipus" maxOccurs="1" minOccurs="0"/>
</sequence>
</complexType>
<!--  számla alapadatai  -->
<complexType name="alapTipus">
<sequence>
<element name="id" type="int" maxOccurs="1" minOccurs="1"/>
<element name="szamlaszam" type="string" maxOccurs="1" minOccurs="1"/>
<element name="gazdEsemAzon" type="int" maxOccurs="1" minOccurs="1"/>
<element name="forras" type="int" maxOccurs="1" minOccurs="0"/>
<!--  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 name="tipus" type="string" maxOccurs="1" minOccurs="1"/>
<element name="eszamla" type="int" maxOccurs="1" minOccurs="1"/>
<element name="hivszamlaszam" type="string" maxOccurs="1" minOccurs="0"/>
<element name="hivdijbekszam" type="string" maxOccurs="1" minOccurs="0"/>
<element name="kelt" type="date" maxOccurs="1" minOccurs="1"/>
<element name="telj" type="date" maxOccurs="1" minOccurs="1"/>
<element name="fizh" type="date" maxOccurs="1" minOccurs="1"/>
<element name="fizmod" type="string" maxOccurs="1" minOccurs="1"/>
<element name="fizmodunified" type="tns:fizmodunifiedTipus" maxOccurs="1" minOccurs="1"/>
<element name="keszpenz" type="boolean" maxOccurs="1" minOccurs="1"/>
<element name="rendelesszam" type="string" maxOccurs="1" minOccurs="0"/>
<element name="nyelv" type="tns:nyelvTipus" maxOccurs="1" minOccurs="1"/>
<element name="devizanem" type="string" maxOccurs="1" minOccurs="1"/>
<element name="devizabank" type="string" maxOccurs="1" minOccurs="0"/>
<element name="devizaarf" type="double" maxOccurs="1" minOccurs="0"/>
<element name="megjegyzes" type="string" maxOccurs="1" minOccurs="0"/>
<element name="afatipus" type="string" maxOccurs="1" minOccurs="0"/>
<!--  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 name="kata" type="boolean" maxOccurs="1" minOccurs="1"/>
<element name="katafokonyv" type="boolean" maxOccurs="1" minOccurs="1"/>
<element name="email" type="string" maxOccurs="1" minOccurs="0"/>
<element name="teszt" type="boolean" maxOccurs="1" minOccurs="1"/>
<element name="sztornozott" type="boolean" maxOccurs="1" minOccurs="0"/>
</sequence>
</complexType>
<!--  vevő adatai  -->
<complexType name="fokonyvvevoTipus">
<sequence>
<element name="vevo" type="string" maxOccurs="1" minOccurs="0"/>
<element name="vevoazon" type="string" maxOccurs="1" minOccurs="0"/>
<element name="datum" type="date" maxOccurs="1" minOccurs="0"/>
<element name="folyamatostelj" type="boolean" maxOccurs="1" minOccurs="0"/>
<element name="elszDatTol" type="date" maxOccurs="1" minOccurs="0"/>
<element name="elszDatIg" type="date" maxOccurs="1" minOccurs="0"/>
</sequence>
</complexType>
<complexType name="vevoTipus">
<sequence>
<element name="id" type="int" maxOccurs="1" minOccurs="0"/>
<element name="nev" type="string" maxOccurs="1" minOccurs="1"/>
<element name="azonosito" type="string" maxOccurs="1" minOccurs="0"/>
<element name="cim" type="tns:cimTipus" maxOccurs="1" minOccurs="1"/>
<element name="postacim" type="tns:cimpostaTipus" maxOccurs="1" minOccurs="0"/>
<element name="email" type="string" maxOccurs="1" minOccurs="0"/>
<element name="adoszam" type="string" maxOccurs="1" minOccurs="1"/>
<element name="csoportazonosito" type="string" maxOccurs="1" minOccurs="0"/>
<element name="adoszameu" type="string" maxOccurs="1" minOccurs="0"/>
<element name="lokacio" type="int" maxOccurs="1" minOccurs="1"/>
<element name="privatePersonIndicator" type="boolean" maxOccurs="1" minOccurs="1"/>
<element name="fokonyv" type="tns:fokonyvvevoTipus" maxOccurs="1" minOccurs="0"/>
</sequence>
</complexType>
<!--  számla tételek  -->
<complexType name="fokonyvtetelTipus">
<sequence>
<element name="arbevetel" type="string" maxOccurs="1" minOccurs="0"/>
<element name="afa" type="string" maxOccurs="1" minOccurs="0"/>
<element name="gazdasagiesemeny" type="string" maxOccurs="1" minOccurs="0"/>
<element name="gazdasagiesemenyafa" type="string" maxOccurs="1" minOccurs="0"/>
<element name="elszdattol" type="date" maxOccurs="1" minOccurs="0"/>
<element name="elszdatig" type="date" maxOccurs="1" minOccurs="0"/>
</sequence>
</complexType>
<complexType name="tetelTipus">
<sequence>
<element name="nev" type="string" maxOccurs="1" minOccurs="1"/>
<element name="azonosito" type="string" maxOccurs="1" minOccurs="0"/>
<element name="mennyiseg" type="double" maxOccurs="1" minOccurs="1"/>
<element name="mennyisegiegyseg" type="string" maxOccurs="1" minOccurs="1"/>
<element name="nettoegysegar" type="double" maxOccurs="1" minOccurs="1"/>
<element name="afatipus" type="tns:afatipusTipus" maxOccurs="1" minOccurs="0"/>
<element name="afakulcs" maxOccurs="1" minOccurs="1">
<simpleType>
<restriction base="double">
<minInclusive value="0"/>
</restriction>
</simpleType>
</element>
<element name="netto" type="double" maxOccurs="1" minOccurs="1"/>
<element name="arresafaalap" type="double" maxOccurs="1" minOccurs="0"/>
<element name="afa" type="double" maxOccurs="1" minOccurs="1"/>
<element name="brutto" type="double" maxOccurs="1" minOccurs="1"/>
<element name="megjegyzes" type="string" maxOccurs="1" minOccurs="0"/>
<element name="sztetordering" type="int" maxOccurs="1" minOccurs="1"/>
<element name="fokonyv" type="tns:fokonyvtetelTipus" maxOccurs="1" minOccurs="0"/>
</sequence>
</complexType>
<complexType name="tetelekTipus">
<sequence>
<element name="tetel" type="tns:tetelTipus" maxOccurs="unbounded" minOccurs="1"/>
</sequence>
</complexType>
<!--  áfakulcsonkénti összesítés  -->
<complexType name="afakulcsosszTipus">
<sequence>
<element name="afatipus" type="tns:afatipusTipus" maxOccurs="1" minOccurs="0"/>
<element name="afakulcs" maxOccurs="1" minOccurs="1">
<simpleType>
<restriction base="double">
<minInclusive value="0"/>
</restriction>
</simpleType>
</element>
<element name="netto" type="double" maxOccurs="1" minOccurs="1"/>
<element name="afa" type="double" maxOccurs="1" minOccurs="1"/>
<element name="brutto" type="double" maxOccurs="1" minOccurs="1"/>
</sequence>
</complexType>
<!--  számla teljes összesítés  -->
<complexType name="totalosszTipus">
<sequence>
<element name="netto" type="double" maxOccurs="1" minOccurs="1"/>
<element name="afa" type="double" maxOccurs="1" minOccurs="1"/>
<element name="brutto" type="double" maxOccurs="1" minOccurs="1"/>
</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 name="totalossz" type="tns:totalosszTipus" maxOccurs="1" minOccurs="1"/>
</sequence>
</complexType>
<!--  számla kifizetettségi adatok  -->
<complexType name="kifizetesTipus">
<sequence>
<element name="datum" type="date" maxOccurs="1" minOccurs="1"/>
<element name="jogcim" type="string" maxOccurs="1" minOccurs="1"/>
<element name="osszeg" type="double" maxOccurs="1" minOccurs="1"/>
<element name="megjegyzes" type="string" maxOccurs="1" minOccurs="0"/>
<element name="bankszamlaszam" type="string" maxOccurs="1" minOccurs="0"/>
<element name="banktranzid" type="int" maxOccurs="1" minOccurs="0"/>
<element name="devizaarf" type="double" maxOccurs="1" minOccurs="0"/>
</sequence>
</complexType>
<complexType name="kifizetesekTipus">
<sequence>
<element name="kifizetes" type="tns:kifizetesTipus" maxOccurs="unbounded" minOccurs="1"/>
</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"/>
</sequence>
</complexType>
<!--  pénzügyi tételek  -->
<complexType name="qutetekTipus">
<sequence>
<element name="qutet" type="tns:qutetTipus" maxOccurs="unbounded" minOccurs="0"/>
</sequence>
</complexType>
<complexType name="qutetTipus">
<sequence>
<element name="nev" type="string" maxOccurs="1" minOccurs="1"/>
<element name="afatipus" type="tns:afatipusTipus" maxOccurs="1" minOccurs="0"/>
<element name="afakulcs" maxOccurs="1" minOccurs="1">
<simpleType>
<restriction base="double">
<minInclusive value="0"/>
</restriction>
</simpleType>
</element>
<element name="netto" type="double" maxOccurs="1" minOccurs="1"/>
<element name="afa" type="double" maxOccurs="1" minOccurs="1"/>
<element name="brutto" type="double" maxOccurs="1" minOccurs="1"/>
<element name="elszdattol" type="date" maxOccurs="1" minOccurs="0"/>
<element name="elszdatig" type="date" maxOccurs="1" minOccurs="0"/>
<element name="afalevon" type="int" maxOccurs="1" minOccurs="1"/>
<element name="cimkek" type="tns:cimkekTipus" maxOccurs="1" minOccurs="0"/>
</sequence>
</complexType>
<!--  gyökérelem  -->
<element name="szamla">
<complexType>
<sequence>
<element name="szallito" type="tns:szallitoTipus" maxOccurs="1" minOccurs="1"/>
<element name="alap" type="tns:alapTipus" maxOccurs="1" minOccurs="1"/>
<element name="vevo" type="tns:vevoTipus" maxOccurs="1" minOccurs="1"/>
<element name="tetelek" type="tns:tetelekTipus" maxOccurs="1" minOccurs="1"/>
<element name="qutetek" type="tns:qutetekTipus" maxOccurs="1" minOccurs="0"/>
<element name="cimkek" type="tns:cimkekTipus" maxOccurs="1" minOccurs="0"/>
<element name="osszegek" type="tns:osszegekTipus" maxOccurs="1" minOccurs="1"/>
<element name="kifizetesek" type="tns:kifizetesekTipus" maxOccurs="1" minOccurs="0"/>
<element name="pdf" type="string" minOccurs="0"/>
</sequence>
</complexType>
</element>
</schema>

Kimenő számla XML (minta)​

<?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>vevo@example.com</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>vevo@example.com</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, TEHK: áfa területi hatályán kívül, TAHK: áfa tárgyi hatályán kívül -->
            <afakulcs>0</afakulcs>                                         <!-- REQ int     -->
            <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 int     -->
            <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>

Elvárt válasz​

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 három 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 a Számlázz.hu kapja meg a feladott számla fogadó rendszerben kiosztott iktatószámát.

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>
        <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 működés részletei 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.