Skip to main content

Other details

Find out more about the way the Számla Agent works.

Testing Számla Agent​

During the testing phase, you have to make sure not to generate a huge amount of invoices in the testing environment (maximum number: 100 invoices per hour). The test account can be turned on and off by the user.

XML validation using XSD​

You can validate the content of the XML file with an XSD file. In the XSD file there is a description that describes the content of the given file. Use this online validation tool or embed any checker in your code.

Security​

The connection is built on a 256 bit encrypted SSL connection.

Requirements​

Your system needs to send an XML file in an HTTPS POST request to Számlázz.hu. This XML file has to contain the controlling parameters and the data that is necessary to perform the given Számla Agent function. Do not forget to handle session cookies.

The request/response pairs of the given Számla Agent call types (new invoice, reverse invoice, query pdf, etc.) will be described later.

Can an XML file contain details of other invoices as well?​

No. Each XML file contains the information of a single invoice only.

What is required to issue e-invoices?​

In order to issue e-invoices you need your own certificate, or you can also use the certificate provided by Számlázz.hu (this is the default option).

How can I provide more e-mail addresses?​

In case you would like to provide multiple e-mail addresses in the e-mail field of the XML file, they must be separated by “,” (comma).

In what case does Szamlazz.hu actually send notifications by email?​

In case of a test account, the system will send an invoice note. The recipient is not the e-mail address provided in the XML, but the e-mail address set in the settings page (the “Email cím” value in this form: https://www.szamlazz.hu/szamla/?action=directlogin&targetpage=beallitasokstep1).

If you set an e-mail address in the buyer's data, the system will send the invoice to this address. Obviously if you have not set any e-mail address, the system will not send the invoice. This is the default behavior.

You can define the buyer's e-mail address in the XML and ask Számla Agent NOT to send the invoice to the buyer. In this case you have to add this line right after the e-mail address: <sendEmail>false</sendEmail>

Use for multiple websites​

The Számlázz.hu user can be used for the Agent by multiple websites. If you would like to separate invoices by webshop please configure a separate invoice "prefix” (szamlaszamElotag) for each of them.

Invoice and receipt templates​

You can use various invoice and receipt templates. You can read more about them and find examples here only in Hungarian. In the invoice generation request, within the fejlec, you need to specify which template to use in the szamlaSablon variable, and similarly for receipt generation, within the fejlec in the pdfTemplate field, you must specify which its template to create the given document with.

Languages​

Currently you can issue invoices in 15 languages. The default invoice notification email template and customer account will be sent out and displayed in the language of the invoice. The following languages can be specified in the szamlaNyelve field within the fejlec during invoice generation:

  • Hungarian (hu)
  • English (en)
  • German (de)
  • Italian (it)
  • Romanian (ro)
  • Slovak (sk)
  • Croatian (hr)
  • French (fr)
  • Spanish (es)
  • Czech (cz)
  • Polish (pl)
  • Bulgarian (bg)
  • Dutch (nl)
  • Russian (ru)
  • Slovenian (si)