Skip to main content

Request

Querying the document (XML)​

info

It is important to note that only the data of internal outgoing invoices (issued in Számlázz.hu) can be retrieved via this interface.

Query options​

You can query an invoice using one of the following identifiers:

  • Invoice number (szamlaszam): The unique invoice number generated by Számlázz.hu
  • Order number (rendelesSzam): The order number associated with the invoice. If multiple invoices have the same order number, the last one will be returned
  • External identifier (szamlaKulsoAzon): A custom identifier that you can assign when creating the invoice. This allows you to query invoices using your own system's identifier without needing to know the generated invoice number
Setting the external identifier

Important: Invoices only receive a szamlaKulsoAzon value if you send the szamlaKulsoAzon field when creating the invoice via Számla Agent. You can only query an invoice by external identifier if it was set during invoice creation.

External identifier benefits

The szamlaKulsoAzon field is useful for external systems because:

  • You can assign unique identifiers to invoices according to your external system
  • You don't need to know the generated invoice number to query the invoice
  • This allows your external system to manage invoices according to its own organization
Error handling

If you query with a szamlaszam, rendelesSzam, or szamlaKulsoAzon value that doesn't exist in the billing account, you will receive the following error message:

Error (7): Missing data: invoice xml (unknown invoice number, order number or external identifier).

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: exactly action-szamla_agent_xml (one file upload)
  • File content: the request data as XML (structure: XSD schema; sample: XML example)

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.