Invoice Provider Settings
Path: Settings → Invoice
Configure which provider CADENSA uses when you generate invoices from time entries.
Providers
Internal PDF (default)
No external integration required. CADENSA generates a branded PDF document locally.
Works out of the box — no API key needed- Suitable for proforma invoices and work summaries
Not a legally valid tax invoice- No NAV / e-invoice compliance
Billingo
Billingo is a Hungarian online invoicing platform, compliant with NAV Online Számla 3.0.
- Legally valid Hungarian tax invoice
- NAV Online Számla 3.0 compliant
- Partner list sync — select clients from your Billingo address book
- Automatic invoice number from Billingo
- PDF stamped with Billingo invoice number
- Requires: Billingo API key (v3)
- 📖 Billingo setup guide
Lexoffice
German invoicing platform (Haufe Group) supporting ZUGFeRD / E-Rechnung.
- Legally valid German / Austrian / Swiss invoice
- ZUGFeRD / E-Rechnung (mandatory for German B2B from 2025)
- Contact list sync — select clients from your Lexoffice address book
- Automatic invoice number from Lexoffice
- Requires: Lexoffice API key (Bearer token)
- 📖 Lexoffice setup guide
Pennylane
French invoicing platform supporting Factur-X (PDF/A-3 with embedded XML), targeting the FR, BE, LU, CH markets.
- Legally valid French invoice (Factur-X)
- Factur-X mandatory from 2026-09 (large companies) — phased rollout by 2027
- Automatic customer find-or-create
- French VAT rate codes (20% / 10% / 5.5% / exempt)
- Draft mode — create drafts first, finalize on demand
- No sandbox — use draft mode for testing
- Requires: Pennylane API token (Bearer)
- 📖 Pennylane setup guide
Holded
Spanish invoicing platform supporting FacturaE e-invoicing, targeting the ES, PT, IT, FR, DE markets.
- Legally valid Spanish invoice (FacturaE compatible)
- Automatic contact find-or-create (by VAT number or name)
- Spanish IVA rate mapping (21% / 10% / 4% / exempt)
- Multi-language invoices (ES, EN, FR, DE, PT)
- Invoice void/cancel via Holded API
- No sandbox — use test contacts for development
- Requires: Holded API key
- 📖 Holded setup guide
SmartBill
Romanian invoicing platform with e-Factura / ANAF compliance, designed for businesses registered in Romania.
- Legally valid Romanian invoice (factură fiscală)
- e-Factura / ANAF compliance (B2B mandatory e-invoice transmission)
- Romanian TVA rate mapping (
Normala19% /Redusa9% /Redusa15% /Scutit0%) - Invoice cancel (anulare) via SmartBill API
- No partner picker — SmartBill REST API has no client list endpoint; fill in client fields manually
- No sandbox mode — use a test invoice series in SmartBill Cloud for development
- Requires: SmartBill API token + account email + company CIF/CUI
- 📖 SmartBill setup guide
Other providers
| Provider | Market | Status |
|---|---|---|
| Számlázz.hu | Hungary (NAV) | Coming soon |
| Fakturoid | Czech Republic / Slovakia | Coming soon |
| Moneybird | Netherlands (Peppol) | Coming soon |
| e-conomic | Denmark / Norway / Sweden | Coming soon |
Setting Up Billingo
1. Get your Billingo API key
- Log in to app.billingo.hu
- Go to Integráció → API in the menu
- Click + Új API kulcs létrehozása (Create new API key)
- Copy the generated v3 API key
Keep your API key secret. Do not share it or commit it to version control.
2. Configure in CADENSA
- Open Settings → Invoice in CADENSA
- Select Billingo as the provider
- Paste your API key into the API Key field
- Click Test Connection — you must see a green ✓ before the Save button becomes active
- (Optional) Enable Sandbox mode for testing without issuing real invoices
- Click Save
The Save button stays disabled until you successfully test the API key. A failed or untested key cannot be saved. This prevents misconfigured integrations from silently breaking invoice generation.
3. Set defaults
Configure sensible defaults so the Generate Invoice dialog is pre-filled:
| Setting | Description |
|---|---|
| Default Currency | Currency used in new invoices (e.g. HUF, EUR) |
| Default VAT % | Tax rate pre-filled in the dialog (e.g. 27 for Hungary) |
| Payment Terms Days | Number of days until due date (e.g. 30) |
| Default Document Type | Which document type is pre-selected (proforma / work_summary / invoice) |
| Issuer Country | Your company's country as an ISO 3166-1 alpha-2 code (e.g. HU, DE, AT). Required for automatic VAT suggestion (reverse charge, export detection). |
The Issuer Country field enables smart VAT suggestions in the Generate Invoice dialog. Without it, CADENSA falls back to the buyer's domestic VAT rate for all transactions. See Invoice Generation — VAT Suggestion for details.
4. Configure Billingo-specific settings
| Setting | Description |
|---|---|
| Invoice Block ID | Billingo invoice block to use (from Settings → Blocks in Billingo) |
| Bank Account ID | Your Billingo bank account ID (optional — used on invoice) |
| Payment Method | Default payment method on issued invoices |
| Language | Invoice language (hu, en, de, …) |
5. (Optional) Configure issuer details
The issuer section (your company info) on the PDF is pulled from Unit Settings → Billing:
- Company name
- Street, City, Postal Code, Country
- VAT / Tax number
- Billing email
The Issuer Country field (configured in this same Invoice Settings page) is also used for automatic VAT rate suggestion in the Generate Invoice dialog — it is separate from the billing address country.
Document Type Routing
| Document Type | Provider setting | Output |
|---|---|---|
| Proforma | internal_pdf only | Internal PDF |
| Work Summary | internal_pdf only | Internal PDF |
| Invoice | internal_pdf | Internal PDF |
| Invoice | Billingo | Sent to Billingo API → PDF returned |
| Invoice | Lexoffice | Sent to Lexoffice API → PDF returned |
| Invoice | Pennylane | Sent to Pennylane API → PDF returned |
| Invoice | Holded | Sent to Holded API → PDF returned |
| Invoice | SmartBill | Sent to SmartBill API → PDF returned |
When an external provider (Billingo, Lexoffice, etc.) is selected, the Document Type selector automatically switches to Legal Invoice and the Proforma / Work Summary options become unavailable. These document types are only supported with the Internal PDF provider.
Provider Comparison
| Feature | Internal PDF | Billingo 🇭🇺 | Lexoffice 🇩🇪 | Pennylane 🇫🇷 | Holded 🇪🇸 | SmartBill 🇷🇴 |
|---|---|---|---|---|---|---|
| Market | Any | Hungary | DE / AT / CH | FR / BE / LU / CH | ES / PT / IT | Romania |
| Legal invoice | | NAV 3.0 | ZUGFeRD / E-Rechnung | Factur-X | FacturaE | e-Factura / ANAF |
| API key required | | | | | | |
| Sandbox mode | — | | | (use draft mode) | (use test contacts) | (use test series) |
| Partner picker | | | | (auto find-or-create) | (auto find-or-create) | (no API endpoint) |
| Setup guide | — | Billingo guide | Lexoffice guide | Pennylane guide | Holded guide | SmartBill guide |
Testing the Connection
Use the Test Connection button after entering credentials. CADENSA calls the provider's API and verifies:
- API key is valid
- Account is active
- Required permissions are available (read + write invoices)
A successful test shows:
✓ Connection successful — Billingo account: Your Company Kft.
A failed test shows the error reason (invalid key, expired, permission denied, etc.).
The Save button is disabled until the connection test passes. You cannot save an untested or failed API key. If you are only changing other settings (currency, VAT %, payment terms) and not re-entering the key, no re-test is needed.
Troubleshooting
"INVOICE_NO_BILLABLE_ITEMS" error
All line items in the selected date range have amount = 0. This happens when no hourly rates are configured for your projects.
Fix: Go to Settings → Rates and configure hourly rates for your projects.
"Partner not found" error
The client details you entered don't match an existing Billingo partner, and auto-creation failed.
Fix: Create the partner manually in Billingo first, then use the partner picker in the Generate Invoice dialog.
PDF has no invoice number
The Billingo API call succeeded but the PDF re-render with the external invoice number failed. The original PDF (without number) was kept.
Fix: Download the PDF again from Billing → Invoice History — the stored record has the correct invoice number.
Sandbox mode
Enable Sandbox in provider settings to test without issuing real invoices. Sandbox invoices do not appear in NAV or your official Billingo invoice list.