Incoming Invoices

Starting from version 3.0 of the online data connection, Számlázz.hu is capable of forwarding incoming invoices stored in the invoicing account. An existing connection can be easily expanded by providing two additional parameters (URL for receiving incoming invoices, sending incoming invoice PDF) as defined in the registration section. The operational logic described in How It Works applies equally to incoming invoices as it does to outgoing ones.

Events Triggering Invoice Transmission

Számlázz.hu can send an incoming invoice to the receiving system multiple times. Each transmission includes all current invoice data in XML format (push-based, same logic as for outgoing invoices).

The following events trigger the invoice to be sent (initially or again):

• the incoming invoice is recorded in the billing account
• change in the payment status of the invoice
• change in the invoice's modifiable data afterwards, specifically:
• accounting date
• customer ledger number
• customer ledger identifier
• "continuous fulfillment" status of the invoice
• revenue ledger number of any invoice item
• VAT ledger number of any invoice item
• economic event of any invoice item
• VAT economic event of any invoice item
• start of the settlement period of any invoice item
• end of the settlement period of any invoice item
• change in payment deadline (<fizh>)
• change in payment method (<fizmod>, <fizmodunified>)
• change in bank account number on the invoice (<bankszamla> in the <szallito> block)

Forwarding invoices fetched from NAV (Számlaverzum)

Invoices downloaded from the NAV Online Invoice system via Számlaverzum (external source, <forras>34 in the XML) are forwarded to the receiving system only if the "NAV-tól lehívott számlák továbbítása a könyvelői rendszerek felé" (Forwarding invoices fetched from NAV to accounting systems) toggle is enabled in the invoicing account.

• The toggle is located in the account settings under Settings → NAV online data connection, in the Számlaverzum block. It is only visible if the account has an active financial data connection.
• The toggle is off by default. When Számlaverzum is switched on, the system enables it automatically, but it can be turned off later, so it is worth checking its state.
• If the toggle is off, invoices fetched from NAV are not forwarded to the receiving system. This affects both incoming and outgoing invoices. Invoices issued in Számlázz.hu are not affected.
• If the toggle is on, NAV-fetched invoices are forwarded as well; after enabling it, previously downloaded NAV invoices are also submitted.

The same setting applies to outgoing invoices.

External source, payment fields

For invoices from an external source (e.g. NAV), payment method, payment deadline, and bank account number can be filled in later on the interface when the field is empty. After a fill-in or change, the invoice is sent again with full data to the receiving system; each further change triggers another transmission. An existing value, whether previously stored in Számlázz.hu or downloaded from an external source before 2026-06-04, cannot be edited.

If NAV provides no value and the user does not fill in the field on the interface, the transmitted XML contains:

Field	Before 2026-06-04	After 2026-06-04
Payment method	ismeretlen (NAV)	empty string
Payment deadline	2099-12-31	2099-12-31 (unchanged)
Bank account number	ismeretlen (NAV)	empty string

See also outgoing invoices, external source payment fields.

Request XSD

XSD for submission:

<?xml version="1.0" encoding="UTF-8"?>
<schema xmlns="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.szamlazz.hu/szamlabe" xmlns:tns="http://www.szamlazz.hu/szamlabe" 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>

    <!-- supplier details -->
    <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:cimpostaTipus" 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>

    <!-- basic billing information -->
    <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>
            <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="folyamatostelj" type="boolean"                maxOccurs="1" minOccurs="0"></element>   <!-- NEW -->
            <element name="elszDatTol"     type="date"                   maxOccurs="1" minOccurs="0"></element>
            <element name="elszDatIg"      type="date"                   maxOccurs="1" minOccurs="0"></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="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="teszt"          type="boolean"                maxOccurs="1" minOccurs="1"></element>
            <element name="dobdel"         type="boolean"                maxOccurs="1" minOccurs="0"></element>
            <element name="sztornozott"    type="boolean"                maxOccurs="1" minOccurs="0"></element>
        </sequence>
    </complexType>

    <!-- customer details -->
    <!-- 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>
            <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="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>
            <!-- DEL >element name="fokonyv"   type="tns:fokonyvvevoTipus" maxOccurs="1" minOccurs="0"></element-->
        </sequence>
    </complexType>

    <!-- invoice items -->
    <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>
            <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"  minOccurs="0" maxOccurs="1"></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>

    <!-- summary by VAT rate -->
    <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>
    <!-- invoice total summary -->
    <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>
    <!-- invoice summaries (by VAT rate and 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>
    
    <!-- invoice payment data -->
    <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="devizaarf"      type="double" maxOccurs="1" minOccurs="0"></element>
            <element name="banktranzid"    type="integer" maxOccurs="1" minOccurs="0"></element>
        </sequence>
    </complexType>
    <complexType name="kifizetesekTipus">
        <sequence>
            <element name="kifizetes" type="tns:kifizetesTipus" maxOccurs="unbounded" minOccurs="1"></element>
        </sequence>
    </complexType>

    <!-- financial items (and invoice as a whole) labels -->
    <complexType name="cimkekTipus">
        <sequence>
            <element name="cimke" type="string" maxOccurs="1" minOccurs="0"></element>
        </sequence>
    </complexType>

    <!-- financial items -->
    <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>
    
    <!-- root element -->
    <element name="szamlabe">
        <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>

Expected response

Receiving endpoint requirements

We can only work reliably with endpoints that return HTTP 200 (OK) and the correct response XML in a single HTTP response body. We do not support endpoints that answer only with HTTP 302 (redirect) when receiving the request, for example Google Apps Script (or similar web apps). See Registration for details.

Four things are needed for the expected response:

• The HTTP response status code must be 200 (OK).
• The response must be a well-formed XML.
• The response must include the <id> value that matches the <id> received in the invoice XML (inside <alap><id>...</id></alap>). If the <id> in your response does not match the invoice’s <id>, the response will be rejected.
• The response may include the registration number (iktatószám) assigned by the receiving system to the transmitted invoice.

Response XSD

And the expected response 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">
   <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">
         <enumeration value="KEY_ERR" />
         <enumeration value="KEY_DEL" />
      </restriction>
   </simpleType>
   <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>