Skip to main content

Important information

Can I issue electronic invoices?​

Yes. Számla Agent can generate both e-invoices and regular paper-based invoices. The type of the invoice depends on the value of the eszamla variable. In the case it is TRUE, an e-invoice will be created; in the case it is FALSE, a regular invoice will be created. In order to issue e-invoices you need your own certificate, or you can use the certificate provided by Számlázz.hu (this is the default option).

Referencing a pro forma invoice​

You can issue an invoice by referencing an existing pro forma invoice. For this, set the pro forma invoice number in <dijbekeroSzamlaszam></dijbekeroSzamlaszam> in the invoice request <fejlec> block.

Recommended flow:

  1. Make sure you have the exact pro forma invoice number you want to reference.
  2. Prepare the invoice creation XML.
  3. In <fejlec>, fill <dijbekeroSzamlaszam> with that pro forma invoice number.
  4. Submit the invoice creation request based on the sample shown on Create invoice > Sample XML.
  5. Agent creates the invoice linked to that pro forma invoice based on the provided number.

Agent output types​

The Agent can create the following types of documents:

  • invoice
  • reverse invoice (storno invoice)
  • prepayment invoice based on payment request
  • final invoice
  • corrective invoice
  • pro forma (prepayment, deposit) request
  • delivery note

Will the system send an e-mail notification after an invoice was generated by Számla Agent?​

It will send a notification only if the e-mail address of the buyer is provided in the XML. Here you can also set the subject and text content of the notification e-mail. Also, there are a few options to format the text with the help of BBCode tags.

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. If you have not set any e-mail address, the system will not send the invoice. 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 by adding <sendEmail>false</sendEmail> right after the e-mail address.

Accepted BBCodes are the following:

  • [b], [/b]
  • [i], [/i]
  • [u], [/u]
  • [h1], [/h1]...[h6], [/h6]
  • [center], [/center]

You can also attach files to the e-mail notification. This could be useful e.g. if you are selling electronics, and you would like to attach the warranty to the invoice. Line breaks in the email text cannot be inserted with BB code, instead simply use manual line breaks in the emailSzoveg field.

    <emailSzoveg>first row
      second row
      enter
      enter
    </emailSzoveg>

In order to do this, you need to post the XML file to the action-xmlagentxmlfile form and the attachment to attachfile1. The maximum number of attachments is 5, and you can only post a single file to a single form. To attach e.g. 2 files, you need to post one file to attachfile1, and another to attachfile2.

info

To provide multiple e-mail addresses in the e-mail field of the XML file, separate them with "," (comma).

Invoice and receipt templates​

You can use various invoice and receipt templates. You can read more about them and find examples here (page in Hungarian). In the invoice generation request, within the fejlec, specify which template to use in the szamlaSablon variable. For receipt generation, within the fejlec, use the pdfTemplate field to specify which template to use for the document.

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. Specify the language in the szamlaNyelve field within the fejlec during invoice generation. Supported values: 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).

Data erasure code (torloKod)​

You can optionally specify a data erasure code per line item in the invoice request. Where: In the items block (tetelek / tetel), inside each tetel element. XSD: The tetelTipus type includes the torloKod element: optional (minOccurs="0"), type int, value ≥ 0.

Further reading

For more on using the data erasure code via the API and in bulk invoice generation, see the knowledge base.

Example for one item:

<tetel>
    <megnevezes>Minta termék</megnevezes>
    <mennyiseg>2.0</mennyiseg>
    <mennyisegiEgyseg>db</mennyisegiEgyseg>
    <nettoEgysegar>10000</nettoEgysegar>
    <afakulcs>27</afakulcs>
    <nettoErtek>20000.0</nettoErtek>
    <afaErtek>5400.0</afaErtek>
    <bruttoErtek>25400.0</bruttoErtek>
    <torloKod>123</torloKod>
</tetel>
warning

You must enable the use of data erasure codes in the Számlázz.hu account under Settings (Beállítások). If it is disabled, you will receive error code 539. At most 400 data erasure codes can be assigned per item; if you exceed this, you will receive error code 537. See Error handling for these codes.