Bejövő számlák átadása
Az online adatkapcsolat 3.0 verziójától a Számlázz.hu képes átadni a számlázási fiókban levő bejövő számlákat. A regisztráció részben definiált táblázatban két plusz paraméter (URL a bejövő számlák fogadására, bejövő számla PDF küldés) megadásával meglévő kapcsolat is könnyen bővíthető.
A működés részletei fejezetekben leírt működési logika ugyanúgy igaz a bejövő számlákra, mint a kimenőkre.
Request XSD
A feladáshoz tartozó XSD: https://www.szamlazz.hu/szamla/docs/xsds/szamlabe/szamlabe.xsd
<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://www.szamlazz.hu/szamlabe" targetNamespace="http://www.szamlazz.hu/szamlabe" 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:cimpostaTipus" 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" />
<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="folyamatostelj" type="boolean" maxOccurs="1" minOccurs="0" />
<!-- NEW -->
<element name="elszDatTol" type="date" maxOccurs="1" minOccurs="0" />
<element name="elszDatIg" type="date" maxOccurs="1" minOccurs="0" />
<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="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="teszt" type="boolean" maxOccurs="1" minOccurs="1" />
<element name="dobdel" type="boolean" maxOccurs="1" minOccurs="0" />
<element name="sztornozott" type="boolean" maxOccurs="1" minOccurs="0" />
</sequence>
</complexType>
<!-- vevő adatai -->
<!-- DEL 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>
</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="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" />
<!-- DEL >element name="fokonyv" type="tns:fokonyvvevoTipus" maxOccurs="1" minOccurs="0"></element -->
</sequence>
</complexType>
<!-- számla tételek -->
<complexType name="fokonyvtetelTipus">
<sequence>
<!-- DEL element name="arbevetel" type="string" maxOccurs="1" minOccurs="0"></element -->
<!-- DEL element name="afa" type="string" maxOccurs="1" minOccurs="0"></element -->
<!-- DEL element name="gazdasagiesemeny" type="string" maxOccurs="1" minOccurs="0"></element -->
<!-- DEL element name="gazdasagiesemenyafa" type="string" maxOccurs="1" minOccurs="0"></element -->
<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" minOccurs="0" maxOccurs="1" />
<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="devizaarf" type="double" maxOccurs="1" minOccurs="0" />
<element name="banktranzid" type="integer" 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="szamlabe">
<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>
Response XSD
És az elvárt válasz XSD: https://www.szamlazz.hu/szamla/docs/xsds/szamlabe/szamlabevalasz.xsd
<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://www.szamlazz.hu/szamlabevalasz" targetNamespace="http://www.szamlazz.hu/szamlabevalasz" elementFormDefault="qualified">
<!-- számla alapadatai -->
<complexType name="alapTipus">
<sequence>
<element name="id" type="int" maxOccurs="1" minOccurs="0" />
<element name="iktatoszam" type="string" maxOccurs="1" minOccurs="0" />
</sequence>
</complexType>
<simpleType name="hibakodTipus">
<restriction base="string">
<!--
KEY_ERR kulcs hiba, az átküldött kulcs nem található a fogadó rendszerben,
a Számlázz.hu ilyenkor a számlát a számla változásáig nem küldi újra.
-->
<enumeration value="KEY_ERR" />
<!--
KEY_DEL kulcs hiba, törölni kell az online feladáshoz szükséges információkat.
Ezen esemény hatására a fiókgazda e-mailben fog értesülni a változásról.
(Technikai limitációk miatt bizonyos számlák még feladásra kerülhetnek, a törlés tényének regisztrálása után is)
-->
<enumeration value="KEY_DEL" />
</restriction>
</simpleType>
<!-- gyökérelem -->
<element name="szamlabevalasz">
<complexType>
<sequence>
<element name="alap" type="tns:alapTipus" maxOccurs="1" minOccurs="0" />
<element name="hibakod" type="tns:hibakodTipus" maxOccurs="1" minOccurs="0" />
</sequence>
</complexType>
</element>
</schema>