Skip to main content

Response

What answers do I receive when querying invoice XML?​

ResultResponse format
SuccessFull szamla XML document with the data of the document; xsi:schemaLocation references szamla.xsd
Errorxmlszamlavalasz XML with <sikeres>false</sikeres>, <hibakod> and <hibauzenet>

On error, the response is an xmlszamlavalasz XML document — the same format used by other operations on error.

If the invoice number, order number or external identifier is not found, the server returns error code 7: Missing data: invoice xml (unknown invoice number, order number or external identifier).

tip

If the response indicates an error, look up the code on the Error handling & error codes page. If you cannot find the code or experience an unexpected issue, contact support.

Key elements of the response​

ElementMeaning
<alap><tipus>Document type: SZ invoice, ES prepayment invoice, VS final invoice, HS corrective invoice, SS reversal invoice, JS credit invoice, D pro forma invoice, SL delivery note
<alap><eszamla>Document format as a number: 0 = not an invoice (pro forma invoice, delivery note), 1 = paper invoice, 3 = e-invoice. For old e-invoices that were still signed with the issuer's own certificate, the value can also be 2.
<alap><hivdijbekszam>For an invoice issued from a pro forma invoice: the number of the pro forma invoice
<kifizetesek>Payments recorded on the document (date, payment method, amount, etc.); only present if the document has payments
The e-invoice flag is a number in the response

When generating an invoice, <eszamla> is a boolean (true/false), but in the query response it is an integer. To recognise an e-invoice, check for the value 3 (or 2 for old documents), not for true.

Successful request​

<?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 szamla.xsd ">
    <szallito>
        <id>201</id>
        <nev>Lorem ipsum dolor sit amet, consectetur adipiscing amet., 512356234</nev>
        <cim>
            <orszag>Hungary</orszag>
            <irsz>1086</irsz>
            <telepules>Budapest</telepules>
            <cim>Szerdahelyi utca 4-8</cim>
        </cim>
        <adoszam>202 336 0856</adoszam>
        <adoszameu>DPH:SK2023360856</adoszameu>
        <bank>                                                             
            <nev>UniCredit Bank Hungary Zrt.</nev>
            <bankszamla></bankszamla>                                                     
        </bank>
    </szallito>                                                                                                 
    <alap>
        <id>529992</id>
        <szamlaszam>D-LOLO-66</szamlaszam>
        <tipus>D</tipus>
        <eszamla>0</eszamla>
        <kelt>2024-10-09</kelt>
        <telj>2024-10-09</telj>
        <fizh>2024-10-09</fizh>
        <fizmod>credit_card</fizmod>
        <fizmodunified>other</fizmodunified>
        <nyelv>hu</nyelv>
        <devizanem>HUF</devizanem>
        <devizaarf>0</devizaarf>
        <megjegyzes></megjegyzes>
        <penzforg>false</penzforg>
        <kata>true</kata>
        <email>[email protected]</email>
        <teszt>false</teszt>
    </alap>
    <vevo>
        <id>221216</id>
        <nev>Customer name</nev>
        <cim>
            <orszag>Hungary</orszag>
            <irsz>1324</irsz>
            <telepules>Debrecen</telepules>
            <cim>1234</cim>
        </cim>
     <email>[email protected]</email>
        <adoszam></adoszam>
        <fokonyv>
            <vevo></vevo>
            <vevoazon></vevoazon>
        </fokonyv>
    </vevo>
    <tetelek>
        <tetel>
            <nev>Apple</nev>
            <mennyiseg>1</mennyiseg>
            <mennyisegiegyseg>pieces</mennyisegiegyseg>
            <nettoegysegar>380</nettoegysegar>
            <afakulcs>20</afakulcs>
            <netto>380</netto>
            <arresafaalap>0</arresafaalap>
            <afa>76</afa>
            <brutto>456</brutto>
            <megjegyzes>Apple comment</megjegyzes>
            <fokonyv>
                <arbevetel></arbevetel>
                <afa></afa>
                <gazdasagiesemeny></gazdasagiesemeny>
                <gazdasagiesemenyafa></gazdasagiesemenyafa>
            </fokonyv>
        </tetel>
    </tetelek>
    <osszegek>
        <afakulcsossz>
            <afakulcs>20</afakulcs>
            <netto>464</netto>
            <afa>93</afa>
            <brutto>557</brutto>
        </afakulcsossz>
        <totalossz>
            <netto>464</netto>
            <afa>93</afa>
            <brutto>557</brutto>
        </totalossz>
    </osszegek>
    <kifizetesek>
        <kifizetes>
            <datum>2020-09-22</datum>
            <jogcim>transfer</jogcim>
            <osszeg>15</osszeg>
            <megjegyzes>comment</megjegyzes>
            <bankszamlaszam>-</bankszamlaszam>
        </kifizetes>
    </kifizetesek>
    <pdf>The receipt .pdf can be found here in BASE64 encoding</pdf>
</szamla>