How to use TicketBAI for Spain Basque E-Invoicing

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.

Issuing Invoices

Option 1. Issuing a Simplified Invoice

Simplified Invoices are limited to a total amount of 3000 EUR. They don’t require any specific details.

Steps to issue a Simplified Invoice

  1. Go to the reservation’s details.
  2. Verify that the transactions are invoiceable. Make sure all transactions have VAT. There shouldn’t be any transactions without VAT.
  3. Select Actions -> Generate New Invoice:

  1. The invoice creation dialog will be show up:


Note: The “Create Invoice” button, which would issue a “Complete Invoice” (i.e. an invoice with a specified recipient) is disabled because the current selected recipient, in this case “Martín Pescador” doesn’t have the required details to set it as a recipient of a “Complete Invoice”. However, “Simplified Invoices” don’t have recipients and any of the billing contacts can be selected, whether they do or don’t have the required details, since only the full name will appear on the invoice’s PDF, just for reference.

  1. Select all the transactions you wish to include in the invoice.

  1. Click Create simplified invoice to send the invoice creation request to the integration.
  2. You can then go to the Documents section, select Invoices from the dropdown menu and see all created invoices for that reservation and their status.

  1. The newly created invoice can be viewed by clicking on its internal number (in blue):

  1. The file officially generated PDF can be downloaded or sent. Just open the document’s menu and select the action:

Option 2. Issuing a Complete Invoice

Complete Invoices have a specific recipient. These are usually issued either because the customer needs an invoice to a specific recipient, which could be themselves, someone else or a company, or because the total amount exceeds 3000 EUR.

Complete invoices are actually just “invoices” and that’s how they are referred to within Cloudbeds.

Required Recipient Details

Complete invoice requires specific data from the invoice recipient to be included in the invoice details, so it needs to be available in Cloudbeds when issuing the invoice. Here are the different cases and which data is required:

Foreign Recipient:

  • Legal Name:
    • For a person, it’s their full name.
    • For a company, it’s the company’s legal entity’s name.
  • Identification Details:
    • If a Tax Identification Number is provided:
      • For Spanish recipients, the value must be a valid NIF (CIF, DNI or NIE).
      • For foreign recipients from countries within the European Union, the value must be prefixed by the country’s ISO 3166-1 alpha-2. For example, if the value is a Portuguese NIF like 123456789, then the value must be ”PT123456789”.
      • For foreign recipients from countries that don’t belong to the European Union, the value is just Tax ID, no need to prefix it with the country’s ISO 3166 alpha-2 code.
    • If a Tax Identification Number is not provided, then the following details are required:
      • Document Issuing Country
      • Document Type
      • Document Number
  • Full Address:
    • The following fields are required:
      • Address Line 1
      • City
      • ZIP or Postal Code
      • State or Province
      • Country

Steps to issue a Complete Invoice

  1. Go to the reservation’s details.
  2. Make sure the invoice recipient guest has the necessary details:
    • If the recipient is a person with a valid NIF, make sure the NIF is in the Guest Tax ID Number field and their address details are complete.
    • If the recipient is a foreign guest, make sure their Type of Document, Document Issuing Country, Document Number are all set.
  3. Verify that the transactions are invoiceable:
    • Make sure all transactions have VAT. There shouldn’t be any transactions without VAT.
  4. Once you’ve verified that all fields have been set and then select Actions -> Generate New Invoice:
  5. Select the guest you want as the invoice’s recipient.
    Note: If the guest has a company name and a company tax ID set, the recipient will be the company.
  6. Select all the transactions you wish to include in the invoice.
  7. Click the Create Invoice button to issue the complete invoice.
  8. You can then go to the Documents section, select Invoices from the dropdown menu and see all created invoices for that reservation and their status.

  1. The newly created invoice can be viewed by clicking on its internal number (in blue):

  1. The officially generated PDF can be downloaded or sent. Just open the document’s menu and select the action:

How to rectify an invoice with new transactions

If you previously invoiced transactions or added new charges or adjustments to the folio, you can issue a rectifying invoice to add the new transactions to the previously issued invoice.

  1. Find the previously issued invoice, open its menu and select Rectify invoice:

  1. Select the transactions you wish to add to the rectifying invoice in order to modify the previous invoice’s taxable base and issue the rectifying invoice:

  1. After the invoice is issued by this integration, it will be available in the list of invoices:

  1. The invoice can be seen by clicking on its number (in blue):

  1. And it can also be sent by clicking on its menu and selecting the option to send it:

How to void an invoice and all of its rectifying invoices

The mechanism our platform supports for voiding invoices creating a Rectifying Invoice by differences which will reduce the taxable base to zero.

  1. Open the invoice’s menu and select Void and issue rectifying invoice.
  2. Select to Void & issue Rectifying invoice
  3. The rectifying invoice is ready:

Troubleshooting Failed Invoice Details

If an invoice fails to issue and the error reason isn't descriptive, the integration logs detailed error messages in your Account Menu → Utilities → Integration Sync section for review.

 

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.