Skip to main content

Issue invoices as self-biller

After a successful connection, the buyer company issues the self-billed invoices from the supplier's account with the dedicated delegated user. This page follows the same structure as Issue invoices in third-party invoicing; only the self-billing specifics differ.

Prerequisites​

Request: what changes compared to standard invoicing?​

Nothing in the XML structure. Use the standard invoice XML (xmlszamla, action-xmlagentxmlfile) with the delegated login. The self-billing specifics:

  • The seller is the supplier company automatically; you do not send seller data.
  • In the <vevo> (buyer) block, set your own company data, including your tax number (<adoszam>).
  • No dedicated "self-billing" field exists, and none is needed.

Automatic self-billing indication​

When the invoice is issued, the system compares the buyer's tax number with the tax number of the delegate company issuing the invoice. If they match:

  • The printed invoice shows the "önszámlázás" (self-billing) indication, as required by law.
  • In the NAV Online Számla data report, the selfBillingIndicator is set to true.

This is fully automatic; the only requirement is that the buyer's tax number on the invoice belongs to your delegate company.

Invoice prefix​

Same rules as in delegated invoicing: you may only use invoice books tied to your company, and the same automatic selection and error codes apply. See Invoice prefix handling.

Response​

Same as standard Agent invoicing: invoice number in the szlahu_szamlaszam header, PDF in the body if requested. See Invoice response.

Common errors​

The most common pitfall comes without an error message

If the buyer's tax number (<adoszam>) is missing or mistyped, the system reports no error: the invoice is issued, just without the self-billing indication, and the selfBillingIndicator in the NAV data report stays false. The system compares the first 8 digits of the tax number (the "törzsszám") with your delegate company's tax number; if they do not match, a regular invoice is created. After issuing, check on the invoice image that the "önszámlázás" indication appears.

The error codes are the same as in delegated invoicing; the most common ones:

CodeMessage (HU)Meaning and what to do
3Sikertelen bejelentkezés.Login failed: wrong login name or password. Call with the username + password pair of the dedicated (usrMb) user; a Számla Agent key cannot be used for delegated calls.
164Ez a felhasználó (név) több számlázási fiókhoz is hozzáfér, így a funkció nem üzemképes.Agent requests can only be sent with a user that has access to exactly one account; use the dedicated user.
250Ez a fiók nem használható, mert a fiókgazda még nem regisztrált.The supplier has not taken ownership of the account created via the API yet. Wait until they activate it, then retry.
202Ez a számlaszám előtag nem létezik vagy nincs engedélyezve: (előtag).The invoice book of the prefix is disabled or blocked due to an invoice number collision found in NAV. A disabled book can be enabled in the supplier's account on the Settings > Prefixes page; a NAV-blocked book requires a different prefix.
354Ez a számlaszám előtag nem használható.The prefix belongs to another delegate, is a receipt prefix, or already has invoices. Use your agreed prefix.
356A megadott számlaszám előtag helyett használd ezt: (előtag).You already have a delegated invoice book with this supplier; use the prefix returned in the message.
357Kérjük, add meg a számlaszám-előtagot.You sent no prefix, and it cannot be selected automatically either, because you have no delegated invoice book or more than one. Send the agreed prefix in <szamlaszamElotag>.

Full list with resolutions: Error handling.

Restrictions​

The storno, correction, and repeat rules of delegated invoicing apply to self-billed invoices too: the invoices you issued are managed by you, the supplier's own invoices by the supplier. Details: Restrictions on invoice operations.