Available for Hungary-based studios only
This integration with Billingo.hu and Számlázz.hu is designed for studios registered in Hungary that need to comply with Hungarian invoicing regulations and NAV Online Invoice reporting. If your studio is based in a different country, this article does not apply to you.
Zenamu can issue billing documents — invoices (számla) and receipts (nyugta) — automatically through Billingo.hu or Számlázz.hu. Issued documents are reported to the NAV (Hungarian Tax Authority) Online Invoice system. This article walks you through the full setup.
Why is this needed?
Hungarian tax law requires a billing document for every sale. For immediate payments (card, cash, PayPal) the document must be issued at the moment of payment; for bank transfers, within 8 days of fulfilment. The data must also be reported to the NAV Online Invoice system. Both Billingo and Számlázz.hu handle NAV reporting automatically the moment a document is issued.
Once the integration is connected, Zenamu issues a document for every paid order automatically (the order status must be "Paid"). When an order is cancelled — provided it was previously in the "Paid" state — a corrective document (sztornó) is created automatically.
Both you and your client can see the issued documents in the system.
Clients also receive an email with a link to download the PDF document.
Requirements
Before you start, check the following:
Expert or Ultimate plan, or the 14-day free trial — the Billingo/Számlázz.hu integration is not available on lower plans.
A completed billing address with a tax number.
A configured VAT status (standard 27% VAT, subject-level VAT exempt, or object-level VAT exempt).
An active account with either Billingo or Számlázz.hu — with company details filled in, a bank account set up, and an active NAV Online Invoice connection.
Important: The NAV Online Invoice connection must be active in your provider account (Billingo / Számlázz.hu) before you activate the integration in Zenamu. Without it, documents will be created but will not be reported to NAV. You can register at onlineszamla.nav.gov.hu.
Obtaining the API key — Billingo
Before you connect Zenamu, complete the following steps in your Billingo admin:
1. Fill in your company details
Go to Settings → Company details (Beállítások → Vállalkozási adatok) and fill in your company name, address, tax number, and VAT status. Without these, Billingo will not let you issue real documents.
2. Add a bank account
Settings → Invoicing → Bank accounts → New bank account (Beállítások → Számlázó → Bankszámlák → Új bankszámla)
Bank name: e.g. "OTP Bank"
Account number: your bank account number
Currency: HUF
Do not tick the "Do not show on invoice" option — the bank account must appear on the documents.
3. Create a document numbering block (bizonylattömb) for invoices
Prefixes must be created manually in the Billingo admin before you load them in Zenamu.
Settings → Invoicing → Document blocks → New document block (Beállítások → Számlázó → Bizonylattömbök → Új Bizonylattömb)
Billingo guides you through a 4-step wizard:
Basic data: Give the block a name (e.g. "Zenamu"), set a prefix (e.g. "ZENAMU"), pick the bank account you created in step 2, and fill in the sender email address.
Additional settings: Leave the option "Immediate payment methods are automatically marked as paid" enabled (immediate payments will be set to "paid" status automatically).
Logo: Optional — you can upload your studio logo.
Template: Pick a visual template (purely cosmetic).
4. (Optional) Create a document block for receipts
If you accept on-site payments from clients without a billing address, or you want to issue receipts (nyugta) for on-site payments, you need a separate document block for receipts. A receipt does not require the customer's address.
Settings → Invoicing → Document blocks → New document block (Beállítások → Számlázó → Bizonylattömbök → Új Bizonylattömb) → choose the Receipt (Nyugta) type (not Invoice/Számla). Use a different prefix from the invoice block (e.g. "ZENAMU-NY").
Important: Use a prefix you have not previously used in another invoicing system. Identical prefixes can cause NAV reporting issues.
5. Connect NAV Online Invoice
Settings → INTEGRATIONS → NAV connection (Beállítások → INTEGRÁCIÓK → NAV összekötés) — enter the technical user credentials you created on the NAV portal.
6. Generate the API key
Settings → INTEGRATIONS → API keys → + New API key (Beállítások → INTEGRÁCIÓK → API kulcsok → + Új API kulcs)
API version: V3 (must be V3)
API name: "Zenamu" (internal label)
Associated connection: Choose Custom development (Egyedi fejlesztés) — your own integration
API scope: Read and Write — both permissions are required
Click Save and copy the generated key.
Obtaining the API key — Számlázz.hu
1. Fill in your company details
Basic settings — company name, address, tax number, bank account details. These appear on the documents as the issuer's details.
2. Activate Számla Agent
Számla Agent is an add-on service from Számlázz.hu that allows you to issue documents through their API. It is billed per issued document and is available on all plans, including the free plan.
3. Connect NAV Online Invoice
Same as with Billingo — in your Számlázz.hu settings, enter the credentials from the NAV portal.
4. Create a prefix for document numbering
Settings → Prefixes → New prefix (Beállítások → Előtagok → Új előtag)
The Számlázz.hu API cannot create or read prefixes — you have to create them manually in the Számlázz.hu admin before entering them in Zenamu.
Prefix for invoices:
Type: Invoice number prefix
Prefix: max 5 characters, e.g. "ZENAM"
Check "Engedélyezem az előtag használatát" (Allow prefix usage)
Prefix for receipts — optional:
Type: Receipt number prefix
Prefix: different from the invoice prefix, max 5 characters, e.g. "ZENNY"
Important: Use a prefix you have not previously used in another invoicing system. Identical prefixes can cause NAV reporting issues.
5. Copy the Számla Agent key (API key)
Settings → Számla Agent (Beállítások → Számla Agent) → copy the key.
Setup in Zenamu — step by step
Go to Settings → Payments → Payment receipts. Make sure the document issuing toggle is turned on.
Scroll to the External invoicing (NAV) section — it appears below the documents section.
Choose a provider — Billingo.hu or Számlázz.hu.
Enter the API key and click Test connection. Zenamu verifies whether the key is valid.
Configure document numbering:
Billingo: From the dropdown, pick the document block (bizonylattömb) you created in Billingo.
Számlázz.hu: Enter the prefix you created in the Számlázz.hu admin. The prefix must match exactly — Zenamu cannot verify it through the API.
(Billingo) Bank account: If you have several bank accounts in Billingo, pick the one that should appear on the documents. If you only have one, it is used automatically.
Documents for on-site payments: Decide how the system should handle on-site payments (cash / card at the studio):
Always issue a document — every on-site payment automatically gets a document.
Skip document issuing — no external document is issued for on-site payments.
Smart mode: based on the client — a document is issued only if the client has a billing address or a previous document on file.
Document type for on-site payments (shown when "Always" or "Smart mode" is selected):
Invoice (számla) — the client's billing address is required.
Receipt (nyugta) — no address required, but only valid for immediate payments of up to HUF 900,000.
If you choose receipt, also set the document block / prefix for receipts (Billingo: dropdown, Számlázz: enter the prefix).
Click Save. Zenamu re-validates the API key and stores your settings.
Tip: The bank account configured in Zenamu (Settings → Payment methods → Bank account) should match the bank account set up at your provider. The documents will show the data from your provider account.
What happens after activation?
Every paid order (card, PayPal, bank transfer, on-site payment) automatically gets an invoice or receipt.
The document is reported to NAV automatically by the provider.
The client receives an email with a link to download the PDF.
When an order is cancelled or refunded, a corrective document (sztornó) is created automatically.
If issuing fails, the error and a Retry button appear in the order details.
Invoice vs. receipt — when is each issued?
Card (Stripe) — Invoice. Online payment — always an invoice.
Bank transfer — Invoice. Not an immediate payment — a receipt is not allowed.
PayPal — Invoice. Online payment — always an invoice.
GoCardless — Invoice. Direct debit — not an immediate payment.
On-site + address on file — Depends on your settings. The type selected in step 7.
On-site + no address — Receipt. An invoice cannot be issued without an address.
An invoice is mandatory (receipt not allowed) in the following cases — regardless of your settings:
The amount reaches or exceeds HUF 900,000
The customer is a legal entity or a VAT payer (Zenamu does not collect legal-entity data in billing details — documents issued through Zenamu are intended for end customers only)
VAT status impact
VAT (27%) — the document shows the VAT amount and the tax base separately.
AAM (subject-level VAT exempt) — the document displays "Alanyi adómentes" (subject-level VAT exempt) and no VAT is charged.
MENTES (object-level VAT exempt) — the document displays "Tárgyi adómentes" (VAT-exempt activity).
VAT rates for VAT-registered businesses
Hungarian tax law allows only the following VAT rates: 0%, 5%, 18%, and 27%. In Zenamu you pick the correct rate from a dropdown — custom values are not allowed.
VAT rates are configured at Settings → Payments → Payment receipts, separately for services and for goods. Gift vouchers are taxed at the rate set for services.
Switching providers
If you want to switch to a different provider:
Disconnect the current provider with the Disconnect button.
Set up the new provider following the steps above.
Previously issued documents stay with the original provider. If you cancel an older order, the corrective document is issued through the original provider.
Plan limitations
If you downgrade to a lower plan:
Your settings are preserved — you don't need to reconfigure anything.
Automatic document issuing is paused.
An orange warning appears with an "Upgrade plan" link.
If you upgrade back to Expert or Ultimate, automatic issuing resumes immediately.
Frequently asked questions
What happens to orders paid before activation?
No external document is created for orders paid before the integration was activated. Only payments after activation get an automatic document.
Can I use both providers at the same time?
No. Only one provider can be active at a time. Previously issued documents stay with the original provider (e.g. for cancellation purposes).
What if the API key expires or becomes invalid?
Zenamu checks the connection to your provider daily. If the API key is invalid, you'll receive a warning email. Generate a new key in your provider's admin and update it in Zenamu (Settings → Payments → External invoicing).
Does Zenamu send the document to the client by email?
Yes. After the document is issued, Zenamu sends the client an email with a link to download the PDF.
How much does the integration cost?
Zenamu does not charge any extra fee for the integration. Costs depend on the provider:
Billingo: Monthly or yearly subscription.
Számlázz.hu: Per-document fee through the Számla Agent service.
What if the client asks for a company invoice (B2B, with a tax number)?
Zenamu issues documents automatically for individual customers (B2C). If a business client needs an invoice with a tax number, the document must be issued manually in the Billingo or Számlázz.hu interface.
Why can't I enter a custom VAT rate?
Hungarian law only allows specific VAT rates. The system therefore offers only the valid values: 0%, 5%, 18%, and 27%. You select the rate at Settings → Payments → Payment receipts.
What VAT rate applies to gift vouchers?
Gift vouchers are taxed at the rate set for services (the "Services VAT rate" field). You'll find it at Settings → Payments → Payment receipts.
Why can't I pick a Számlázz.hu prefix from a dropdown?
The Számlázz.hu API does not allow prefixes to be queried. The prefix has to be created in the Számlázz.hu admin and then entered in Zenamu exactly as it is.
Is a document issued for orders paid with credits or passes?
No. An external document is created only when real funds (HUF) change hands. The document is issued when credits or a pass are purchased, not when they are used.
Related articles