Skip to main content

Request

warning

It is important to note that only the data of internal outgoing documents (issued in Számlázz.hu) can be retrieved via this interface. Besides invoices, this also includes other documents, for example pro forma invoices: the <tipus> element of the response shows the document type.

To query the document in XML, send a single XML file in an HTTP POST request.

Requirements​

  • Base URL: https://www.szamlazz.hu/szamla/ (request target)
  • Method: POST
  • Content type: multipart/form-data
  • Form field name: action-szamla_agent_xml
  • File content: the request data as XML (structure: XSD schema; sample: XML example)
  • Identifying the document: by invoice number (szamlaszam), order number (rendelesSzam) or external identifier (szamlaKulsoAzon) – if multiple documents share the same order number, the last one is returned; the external identifier is only usable if it was set when the document was created
Pro forma invoice after payment

If both the "Díjbekérő automatikus számlázása" (automatic invoicing of pro forma invoices) and the "Díjbekérő automatikus törlése" (automatic deletion of pro forma invoices) settings are enabled in the account (both are enabled by default), an invoice is issued when the pro forma invoice is paid, and the pro forma invoice is deleted. After that, the pro forma invoice can no longer be found by its number, and you receive error code 7. A query by order number returns the automatically issued invoice in this case, because it inherits the order number of the pro forma invoice, and if multiple documents share the same order number, the last one is returned. The <hivdijbekszam> element of the invoice contains the number of the pro forma invoice.

Sample HTML form​

The request can be sent for example with a form like this:

<html>
  <head><meta content="text/html; CHARSET=UTF-8"></head>
  <body>
    <form action="https://www.szamlazz.hu/szamla/" method="post" enctype="multipart/form-data">
      <input type="file" name="action-szamla_agent_xml">
      <input type="submit" name="generate" value="Query document (XML)">
    </form>
  </body>
</html>

Try it:

Upload your edited XML file
tip

We recommend validating your XML against the XSD before sending.