| Purpose | Configure Croatian fiscalization in Cloudbeds using the Fonoa integration. |
| Best for | Property owners, property admins, accounting managers, and implementation users at properties in Croatia. |
| Use this when | Your property is preparing to issue Croatian fiscal invoices through Cloudbeds and must configure Fonoa, fiscal mappings, and invoice operators. |
| Requirements | A Croatian fiscal certificate and password, Fonoa credentials, the property OIB, operator details, tax codes, and payment methods. |
| Expected result | Fonoa fiscalization shows as active, and new invoices and credit notes can be fiscalized automatically. |
| Limitations | Missing certificate details, operator information, tax mappings, or payment-method mappings can prevent activation or invoice creation. |
Introduction
Croatian fiscalization connects invoice activity in Cloudbeds with the fiscal provider responsible for registering eligible documents. Complete the provider, certificate, mapping, and operator configuration before issuing invoices.
Follow the setup sections in order. After the integration shows Active, invoice fiscalization is triggered as part of the normal folio workflow.
Table of contents
- Before you begin
- Open Fiscalization settings
- Configure Fonoa as the fiscal provider
- Configure invoice operators
- Confirm setup is active
- Issue your first invoice
Before you begin
Gather the required property, certificate, tax, and operator information before opening the fiscalization settings. Most of this information comes from your accountant or the Fonoa portal.
| What you need | Details |
|---|---|
| Fonoa certificate file | A physical certificate file, such as a .p12 file, issued by the Croatian Tax Authority or provided by your accountant. |
| Certificate password | The password associated with the certificate file. |
| Fonoa credentials | The username and API credentials provided by Fonoa. |
| OIB | Your property's Croatian personal identification number. |
| Operator details | The full name and OIB of each employee who will create invoices. |
| Tax codes | The applicable VAT or PDV tax codes for your property. |
| Payment methods | All payment methods accepted at the property. |
| Invoice branding | A company logo in PNG or JPG format and the preferred accent color for invoice PDFs. These items are recommended. |
Contact your accountant to obtain the certificate file, certificate password, and required credentials. Fonoa must be registered as your certified fiscal provider before activation.
Open Fiscalization settings
- In Cloudbeds, open Account.
- Select Settings.
- Select Fiscalization from the left-hand navigation.
Configure Fonoa as the fiscal provider
In the Fiscalization section, select Fonoa as the provider and complete the required certificate, mapping, and branding fields.
| Field | Description | Requirement |
|---|---|---|
| Fiscal provider | Select Fonoa from the provider menu. | Required |
| Certificate file | Upload the certificate file provided by your accountant. | Required |
| Certificate password | Enter the password associated with the certificate. | Required |
| Tax codes | Map the property's VAT or PDV codes to the corresponding fiscal categories. | Required |
| Payment methods | Map each payment method, such as cash, card, or bank transfer, to its fiscal code. | Required |
| Invoice color | Select the accent color used on the fiscalized invoice PDF. | Recommended |
| Logo | Upload the property logo to display on fiscalized documents. | Recommended |
Unmapped tax codes or payment methods can prevent invoice creation. Map every active tax rate and every payment method used at the property before continuing.
Configure invoice operators
Register each employee who is authorized to create invoices. Each operator requires an individual name and OIB entry.
- On the Fiscalization settings page, go to the Operators section.
- Select Add Operator.
- Enter the operator's full name.
- Enter the operator's OIB.
- Repeat these steps for each staff member who will generate invoices.
- Select Save.
Small properties may only need one or two operators, such as the owner and another staff member. Each person must still be configured separately.
Confirm setup is active
After saving the provider configuration, review the fiscalization status. The setup is ready when the status shows Active.
When the integration is active, new invoices and credit notes are fiscalized automatically.
If the status does not change to Active, review the certificate, credentials, tax mappings, payment-method mappings, and operator details for missing or incorrectly formatted information.
Issue your first invoice
After fiscalization is active, create the invoice through the property's normal reservation and folio workflow.
- Open the reservation folio in Cloudbeds.
- Add the applicable charges to the folio.
- Select Create Invoice.
- Confirm that the fiscalized document is generated.
Fiscalization is triggered automatically. The fiscalized PDF, including the JIR, ZKI, and QR code, is available under Accounting → Invoices and Documents.
Next Operational Step
After confirming that Fonoa fiscalization is active, follow the Issue your first invoice workflow to verify that fiscal documents are generated successfully.
Comments
Please sign in to leave a comment.