You connect Billingo on the Integrations page, in the Invoicing section, on the Billingo invoicing tile. Bokko first verifies the API key, then lets you choose the invoicing settings it needs to issue documents.
1. Get the API key in Billingo
You create the API key in your Billingo account, under Settings → API keys, using the New API key option. Bokko uses the V3 API, which needs only a single (public) key, and the key must have read and write scope — Bokko has to create documents, not just read them.
The exact steps and the difference between API versions are described in Billingo’s official help: API kulcsok — Billingo Support (Hungarian).
2. Connect it in Bokko
- Open Integrations in the dashboard.
- In the Invoicing section, click Set up on the Billingo invoicing tile. The Connect Billingo dialog opens.
- Paste your Billingo API key and click Verify.
- After a successful check the dialog moves to the Configure step. Fill in the settings, then click Save.
- 1. Billingo invoicing
3. Choose your settings
| Field | What you select |
|---|---|
| Document block | Which Billingo document block numbers your invoices. Required. |
| Bank account | Which Billingo bank account appears on the document. Required. |
| Receipt block | A separate, receipt-type block. You can set it, but Bokko does not currently issue receipts through the invoicing provider (see below). |
| Default VAT rate | 27% or 0% (VAT exempt). |
| Default payment method | Cash, card, bank transfer or other. |
| 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. |
Bokko only lets you save a block and bank account that actually exist in the verified Billingo account.
Readiness and invoice mode
After a successful connection, the Connection details card shows the connection, the selected document block and bank account, whether Invoices and Receipts are set up, the status (Ready to use or Incomplete), the invoice mode, VAT rate, payment method and connection date.
Billingo always issues invoices immediately as final, numbered documents — there is no draft. The Invoice mode row shows who delivers it: “Final invoice, you send it to the guest” (default) or “Final invoice, sent to the guest automatically by the invoicing provider” (when Automatic sending is on).
- 1. Edit settings
4. Automatic sending
After connecting, Edit settings opens the Invoicing settings dialog, where you can turn on Automatic sending (“The invoicing provider automatically issues and delivers the documents.”).
- When on, at completion you can choose Issue an invoice with the invoicing software in the Document section. The invoice is not created automatically on every completion: you select it in the completion dialog.
- When off, the provider document cannot be selected at completion; you can only record an external document.
Inactive integration
If another invoicing provider is already active
Only one invoicing provider can be active at a time. While Számlázz.hu is active, the Billingo tile is not shown: start the change with Switch to another provider, and after confirming, the Connect Billingo dialog opens. After a successful connection Számlázz.hu is deactivated automatically (not deleted), and documents issued earlier remain.
Disconnecting
- On the active Billingo card, click Disconnect.
- Confirm. If there are still redeemable gift cards or passes, a second dialog appears; continue with Continue with disconnect.
Disconnecting removes the saved integration and the stored API key from Bokko. Invoices already issued stay in Billingo.