Skip to main content

Important information

This page contains important, operation-specific information for receipt generation.

Order number on the receipt

You can configure order number repetition for receipts using the same account setting as for invoices and other documents.

  • Purpose: If you need to issue multiple receipts for one order, enable order number repetition. If you want each order number to appear only once within that document type, disable repetition.
  • Where to set: SettingsAccount settingsInvoicing settings. Find the “Disable order number repetition” (Rendelésszám ismétlődésének tiltása) toggle. Turn on if you do not want multiple documents with the same order number; turn off if you issue multiple documents (e.g. several receipts) with the same order number.

Rendelésszám ismétlődésének tiltása – Számlaszerkesztő beállítások

Important

If the restriction is on, you cannot create a new document of the same type with a previously used order number. When off, the order number can be used on other document types. The setting applies to receipts, invoices, proforma invoices, etc. in the same way; there is no separate handling per document type.

How to send the order number in the request

Put the order number in the header (<fejlec>) block of the receipt creation request, in the optional <rendelesSzam> element. If you omit it, no order number is shown on the receipt.

Example header (order number at the end):

  <fejlec>
<hivasAzonosito></hivasAzonosito>
<elotag>NYGTA</elotag>
<fizmod>készpénz</fizmod>
<penznem>Ft</penznem>
<devizabank></devizabank>
<devizaarf>0.0</devizaarf>
<megjegyzes></megjegyzes>
<pdfSablon></pdfSablon>
<fokonyvVevo></fokonyvVevo>
<rendelesSzam>ORD-2026-001</rendelesSzam>
</fejlec>

The XML example and XSD schema pages show the full request structure.

Where the order number appears in the response

The receipt creation response (xmlnyugtavalasz) returns the receipt data inside the <nyugta> block. The order number is in the <alap> (basic data) block, in the <rendelesSzam> element—with the same value you sent in the request.

Example of the response’s alap block (order number at the end):

  <nyugta>
<alap>
<id>123456</id>
<hivasAzonosito></hivasAzonosito>
<nyugtaszam>NYGTA-2026-001</nyugtaszam>
<tipus>NY</tipus>
<stornozott>false</stornozott>
<kelt>2025-06-15</kelt>
<fizmod>cash</fizmod>
<penznem>Ft</penznem>
<megjegyzes></megjegyzes>
<fokonyvVevo></fokonyvVevo>
<teszt>false</teszt>
<rendelesSzam>ORD-2026-001</rendelesSzam>
</alap>
...
</nyugta>

For the full response structure, see the Response page.

Related knowledge base article: Rendelésszám a nyugtán.

PDF template (pdfSablon)

The <pdfSablon> field is an optional string: the custom PDF template identifier. If you leave it empty or omit it, the default template (standard A4 receipt) is used.

Allowed values (template codes)

CodeMeaning
ADefault, standard (A4) receipt
JTicket template
LTicket template with logo
N80 mm receipt

Data erasure code (torloKod)

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

Further reading

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

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.

Same settings and error codes apply as for invoice items. For full description and examples, see Data erasure code (invoice).