You connect Számlázz.hu on the Integrations page, in the Invoicing section, on the Számlázz.hu tile. Bokko stores the settings needed to issue documents and, after a successful connection, shows the Számlázz.hu integration panel.
1. Generate the Agent key
The Számla Agent key is a 42-character identifier Bokko uses to connect to your Számlázz.hu account. You create it in your own account: sign in, click the invoice icon in the top left to open the Vezérlőpult (dashboard), scroll to the Számla Agent kulcsok block at the bottom of the page, and click the key icon. The new key is generated immediately, and the copy icon puts it on your clipboard.
Details in Számlázz.hu’s official knowledge base: Mi a Számla Agent kulcs (API kulcs)? (Hungarian).
2. Connect it in Bokko
- Open Integrations in the dashboard.
- In the Invoicing section, click Set up on the Számlázz.hu tile.
- In the Enter Agent key step, paste the key into the Agent key field, then click Validate.
- After a successful check the dialog moves to Default settings. Fill it in, then click Save.
- 1. Számlázz.hu
If the check fails, the dialog stays on the Enter Agent key step and the reason appears below the field: “Invalid Agent key format.” (the value is too short), “Invalid Agent key. Check your Számlázz.hu account.” (Számlázz.hu rejected the key — copy it again or generate a new one), “Your Számlázz.hu account is not ready to issue invoices yet…” (finish setting up the account in Számlázz.hu), “Számlázz.hu is not available right now…” (try again in a few minutes), or “An error occurred during validation.” if the check could not run for technical reasons. The message disappears when you change the key.
3. Set the defaults
| Field | What you set |
|---|---|
| Default VAT rate | 27% (standard) or 0% (VAT exempt). |
| Default payment method | Cash, card, bank transfer or other. |
| Receipt prefix (optional) | Prefix for the receipt number (up to 16 characters). One prerequisite for receipts — Bokko does not currently issue receipts when a booking is completed (see below). |
| Tax number (optional) | Not required. |
| I can issue invoices (I am a registered business) | Must be ticked; otherwise the settings cannot be saved. |
| I accept business clients | When off, only individual invoicing is available on the booking page. |
4. Automatic sending
After connecting, click Edit settings below the panel; in the Invoicing settings dialog turn on Automatic sending (“The invoicing provider automatically issues and delivers the documents.”). It is off when you first connect.
- When on, at completion you can choose Issue an invoice with the invoicing software in the completion dialog; Számlázz.hu emails the invoice to the guest.
- When off, no Számlázz.hu document is created at completion; you can only record an external document.
Invoice mode and readiness
Invoices are always issued as final, there is no draft. The Invoice mode row reflects automatic sending: when off, “Final invoice, you send it to the guest”; when on, “Final invoice, sent to the guest automatically by the invoicing provider”.
The Számlázz.hu integration panel shows the connection, the Active status, the invoice mode, VAT rate, payment method, whether Invoices and Receipts are set up, and the connection date.
- 1. Edit settings
If another invoicing provider is already active
Only one invoicing provider can be active at a time. While Billingo is active, the Számlázz.hu tile is not shown: start the change with Switch to another provider and continue in the Switch provider dialog. After Számlázz.hu is connected, Billingo is deactivated automatically (not deleted).
Disconnecting
- In the Invoicing section, below the panel, click Disconnect.
- Confirm. If there are still redeemable gift cards or passes, Bokko asks for a declaration first.
Disconnecting removes the saved integration and the stored Agent key from Bokko. Documents already issued stay in Számlázz.hu. It is worth deleting the key in the Számlázz.hu dashboard too.