This guide is intended only for customers participating in the Limited Release phase, as the integration is not yet available in the Cloudbeds Marketplace.
General Availability is expected in Q1 2026; additional details will be shared closer to launch.
We are excited to offer the TicketBAI integration, allowing you to create and submit fully compliant invoices required by the Basque and Navarrese tax authorities directly from your Cloudbeds account.
This guide covers everything you need to know about the requirements, capabilities, and the essential configurations needed to get started.
Integration Requirements and Availability
This integration is specifically designed for properties located within the regions that require compliance with the TicketBAI system:
- Araba/Álava (Basque Country)
- Bizkaia/Biscay (Basque Country)
- Gipuzkoa (Basque Country)
- Nafarroa/Navarre
Integration Capabilities
Once connected to TicketBAI, you can perform the following compliant invoicing actions without ever leaving the Cloudbeds platform:
- Issue Invoices: Create and issue compliant invoices or simplified invoices directly from a Reservation Folio or a Group Folio.
- Cancel an Invoice (Zero Base): Rectify an invoice so that its taxable base is zero (e.g., for a full refund), effectively canceling it.
- Modify an Invoice: Rectify an invoice to adjust its taxable base due to new transactions posted on the folio.
- Annul an Invoice: Cancel an invoice that should not have been issued in the first place by generating an "Annulment XML File" (Fichero XML de Anulación).
Mandatory Configurations in TicketBAI
By regulation, your Cloudbeds integration must be registered as a device on your respective TicketBAI portal. This ensures legal compliance for every invoice submitted.
Your required deadline for registration depends on your region:
| Region | When to Register the Device in TicketBAI |
| Araba/Álava | After connecting the app, before generating the first invoice. |
| Bizkaia/Biscay | After connecting the app, before generating the first invoice. |
| Gipuzkoa | After connecting the app, within 29 days of generating the first invoice. |
| Nafarroa/Navarre | After connecting the app, before generating the first invoice. |
Important: Once your property details and the app settings are correctly configured in Cloudbeds, the required device serial number will be available in Cloudbeds so you can complete the device setup on the TicketBAI portal.
Currently Unsupported Use Cases
The following invoicing scenarios are not supported by the current integration:
- Issuing invoices with VAT exemptions.
- Issuing invoices for pending transactions or for deposits/advanced payments.
- Issuing a rectifying invoice solely to add or fix recipient details.
- Issuing an invoice from the reservation module with an individual person as the recipient who is not one of the registered guests.
Note on Reporting: At the moment, our platform does not automatically generate quarterly or monthly VAT reports from all issued and rectifying invoices.
Where to View Generated Invoices
All generated invoices can be viewed and reviewed in the experimental section of your platform:
- Navigate to: Menu
→ Accounting
→ Documents and Invoices
Comments
Please sign in to leave a comment.