Skip to main content

Document types

The following document types can be created through this interface. The type is set in the <fejlec> (header) block of the XML request:

  • Invoice – the default type; no special field required.
  • Prepayment invoice – <elolegszamla>true</elolegszamla> (advance invoice to record a partial payment before the final invoice).
  • Final invoice – <vegszamla>true</vegszamla> (issued after a prepayment invoice to settle the remaining amount).
warning

In Számlázz.hu, one prepayment invoice can have exactly one final invoice. It is not possible to issue multiple partial invoices from a single prepayment invoice, nor to combine multiple prepayment invoices into one final invoice.

  • Corrective invoice – <helyesbitoszamla>true</helyesbitoszamla> + <helyesbitettSzamlaszam> (set to the number of the invoice being corrected).
  • Pro forma invoice – <dijbekero>true</dijbekero> (a payment request; not a legally binding invoice).
  • Delivery note – <szallitolevel>true</szallitolevel> (a document accompanying delivered goods, not an invoice; not available in the #free package). It is not the same as the SzlaFuvarlevelesAlap invoice template and the <fuvarlevel> block: those display courier consignment note data on the invoice image and do not change the document type. For invoicing and voiding it, see Invoicing and voiding a delivery note.
  • Reversal (storno) invoice – handled by a separate interface; see Reversing an invoice.

For tour operators, the invoice, pro forma invoice, prepayment invoice, final invoice and reversal invoice can be issued with a simplified invoice image that hides price and VAT details from the buyer; see Simplified item data for tour operators (simpleItems).

E-invoice or paper invoice​

Számla Agent can generate both e-invoices and regular paper-based invoices. The <eszamla> field in the XML controls this: true creates an e-invoice, false creates a traditional paper-based invoice. The system signs e-invoices with the certificate of Számlázz.hu (KBOSS.hu Kft.), with a qualified electronic signature; your own certificate cannot be used. When you query the document in XML, the format is returned as a number, not as true/false (3 = e-invoice, 1 = paper invoice).

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.

Invoicing and voiding a delivery note​

You currently cannot create an invoice from a delivery note through Agent. The invoice request has no field that links the invoice to a delivery note, the way <dijbekeroSzamlaszam> does for a pro forma invoice. One or more delivery notes can be invoiced in the web interface with the "Szállítólevelek számlázása" (invoice delivery notes) bulk action of the document list; the invoice is then linked to the delivery notes.

Marking a delivery note as voided ("rontott"), and undoing that mark, is only available in the web interface; Agent has no operation for it. A delivery note cannot be reversed either: the reversal interface does not create a reversal document for it.