Overview
Add Spain Basque Fiscal Receipts (TicketBai) in the Marketplace to connect your properties to the TicketBAI system, a regional tax authority platform. This feature allows the generation of fully compliant invoices directly within TicketBAI without exiting Cloudbeds PMS. In this article, you'll learn how to connect and disconnect the app.
This integration is currently available only for properties in:
- Araba/Álava (Basque Country)
- Bizkaia/Biscay (Basque Country)
- Gipuzkoa (Basque Country)
How to connect
Step 1 - Configure Invoices
- Go to Account and click Settings
- Click on Payments and go to Invoicing Details in the Invoicing tab
- Select the series you want for your invoices by choosing a Suffix.
The integration ignores the Prefix and the Starting Index Number fields.
- Under the Company Details section, switch the Show company details toggle ON.
- Fill in the Legal Company Name. Enter your VAT ID in the Tax ID Number 1 field. Leave Tax ID Number 2 empty.
- Click Save
- Now go to the Invoicing Settings tab and set Select when to generate invoice to Manually
- In the section Invoice Layout Settings ensure you:
-
- Check Show the room number column on the invoice
- Check Show tax/fee specifics on the invoice
- Uncheck Use compact invoices
- Uncheck Use guest's Document Number
- Check Show package breakdown option
- Click Save
Step 2 - Configure Taxes
Go to Taxes and Fees and make sure you have the following taxes configured:
Type | Description | Category | Available For | Type | Amount | Charge on top of fees | Code |
Tax | IVA 4% | Inclusive | Items; Reservations | Percentage of total amount | 4% | No | VAT-4 |
Tax | IVA 10% | Inclusive | Items; Reservations | Percentage of total amount | 10% | No | VAT-10 |
Tax | IVA 21% | Inclusive | Items; Reservations | Percentage of total amount | 21% | No | VAT-21 |
Make sure your Sources have the right taxes assigned.
Step 3 - Connect the app
- Connect the Spain Basque Fiscal Receipts (TicketBai) app in the Marketplace: How to Connect an App to Cloudbeds PMS.
- You will be prompted to select the property to which you want to connect the app.
- Allow Access to the listed items when prompted.
- Once the connection process has finished, you will be redirected to the Connected Apps section.
- From the app, click Settings
- Select the values for Tipo de factura a usar and Régimen de tributación en el IVA that apply to your business.
- Enter the Próximo número de factura.
- Click Submit
By regulation, it’s mandatory to register the property’s integration as a device on Fiskaly’s portal. This can be done by following the steps below.
How to register Cloudbeds at TicketBAI's Portal
- Go back to the app’s settings and take note of the “Número de serie de Fiskaly como dispositivo.”
- With the “Número de serie de Fiskaly como dispositivo” in hand, follow Fiskaly’s Guide.
When do I need to register Cloudbeds with TicketBAI's Portal app?
- Araba/Álava (Basque Country): After connecting the app, before generating the first invoice.
- Bizkaia/Biscay (Basque Country): After connecting the app, before generating the first invoice.
- Gipuzkoa (Basque Country): After connecting the app, within 29 days of generating the first invoice.
How to disconnect
Use this guide to disconnect the app: Marketplace - How to disconnect an app from Cloudbeds PMS
Learn more about How to use Spain Basque Fiscal Receipts (TicketBai).
Comments
Please sign in to leave a comment.