Skip to main content

How to activate VeriFactu or TicketBai on your platform

Learn how to activate Verifactu or TicketBai in order to comply to Spain e-invoicing system.

What are VeriFactu and TicketBai?

VeriFactu and TicketBAI are invoicing compliance systems introduced by Spanish tax authorities to make invoices more secure, traceable, and tamper-proof.

The main difference is that VeriFactu applies to the general Spanish tax framework and is managed by the national Tax Agency (AEAT), while TicketBAI applies specifically to businesses subject to the Basque Country tax authorities (Álava, Bizkaia, and Gipuzkoa).

Both systems aim to prevent tax fraud by ensuring invoices are generated and transmitted in a compliant format.

In this guide, we’ll explain how to activate the integration with VeriFactu or TicketBai through Fiskaly, our fiscal partner that allows you to connect your invoicing system to the Spanish Tax Agency easily, automatically, and securely.

The integration has to be activated, please reach out to your Account Manager to activate it.

Introduction

In order to be able to sign your invoices, you must complete all the following steps and prerequisites.

Invoices created before completing these steps won't be sent automatically. You'll have to do it manually.

Note that the system will automatically display the correct form (Verifactu or TicketBai) based on the company address in your Stripe information.

Common steps

Whether your company is subject to VeriFactu or TicketBai, you should follow these first steps.

To set up the integration, go to Settings> Billing > Veri Factu/TicketBai.

If you see the following screen, it means the integration has not been activated. You must reach out to your Account Manager to ask for activation.

Once the integration activated you should see the following screen:

For TicketBai, the "details of representative" section won't be displayed.

1. Set up your bsport account

First make sure you've correctly set up your Stripe information and indicated your VAT number.

Please go to Settings>Company.

It can take a bit of time for your VAT number to be recognized.

⚠️ Double-check your VAT number before completing setup.

When you finish setup, your VAT number will be registered with our partner Fiskaly. This registration is locked: even if you edit your VAT number later in bsport, Fiskaly will keep the one entered at setup.

An incorrect VAT number will cause every invoice submission to fail. If you realise the VAT number is wrong after setup, contact your Account Manager.

2. Activate sequential numbering

If not already done during your onboarding, you'll have to activate invoice sequential numbering. To do so, please follow this helpsheet.

Important to note:

  • if your sequential numbering starts today, the system will still block you, considering sequential numbering was not activated. You'll have to wait for the next day to continue the process.

  • if your sequential numbering starts next month, the system will block you until next month has we need sequential numbering to be up and running.

Specific set up

Based on your company address, you will either have to complete the VeriFactu steps or the TicketBai steps.

VeriFactu

1. Spanish Electronic Certificate

The first step of this integration is to obtain your Spanish Electronic Certification. To do so, please follow the steps indicated here 💡

Please note:

  • Cost: 24€ (without taxes)

  • Can be completed:

  • Estimated timing:

    • Online: a few hours

    • In-person appointment: usually within ~1 week

  • Validity

    • Your certificate will be valid for 2 years

Why is this required?

To allow Fiskaly to submit invoices to Verifactu on behalf of your company, a Social Collaboration Agreement must be signed between you and Fiskaly.

This agreement can only be signed using the Spanish Electronic Certificate of the company representative.

2. Provide Studio Representative Details

In Settings > Billing > VeriFactu > Details of the representative

The following information must be provided and must exactly match the data associated with the electronic certificate:

  • Full name

  • DNI / NIE

  • Address line

  • Municipality

  • Country

Reminder: the following information must exactly match the data associated with the electronic certificate.

3. Social Collaboration Agreement

Once everything is completed, click on Create Agreement. The system will load and you should have the following page:

  • Click on Download PDF

  • Sign the PDF with your Spanish electronic certificate

    • See how to do it following this article

  • Upload the signed document with Upload PDF

Let the system load, once the document has been approved you should see the following screen:

You are now all set! VeriFactu has been correctly set up and activated on you account.

To note: You can always change the details of representative or generate a new agreement by clicking on the Edit button and start again the previous flow.

TicketBai

In Settings > Billing > TicketBai

  • Click on Configure TicketBai

The device certificate registration process depends on the province of your company.

Araba and Bizkaia

In Araba and Bizkaia, the device certificate must be registered with the tax authorities before activating TicketBAI on bsport.

This means that invoices will not be sent to TicketBAI until you complete the registration and click on Complete setup in bsport.

  1. Retrieve your device certificate serial number on bsport.

  2. Register the certificate with your tax authority:

  3. Return to bsport check the checkbox I have completed... and click Complete setup.

Once the setup is completed, bsport will start sending your invoices to TicketBAI.

Gipuzkoa

In Gipuzkoa, the device certificate must be accepted after the first invoice has been sent to TicketBAI.

This means that invoices will start being sent as soon as you click Complete setup in bsport.

  1. Click Complete setup in bsport.

  2. Your first invoices will be sent to TicketBAI automatically.

  3. Retrieve your device certificate serial number on bsport.

You have up to 1 month to validate the certificate. During this period, your invoices remain legally compliant.

Invoice Eligibility for Verifactu/TicketBai

An invoice can be sent to Verifactu/TicketBai if and only if all of the following conditions are met:

  • The invoice is opened or a refund invoice

    • Meaning the invoice has a PDF

      • For example, subscriptions have draft invoices (for future ones), these are not opened invoices

    • It doesn't mean the invoice has been paid

  • The invoice is not voided

  • The invoice does not come from a migration

  • The invoice contains at least one invoice item

  • The invoice is not a partial refund from a payment pack

If any of these conditions are not met, the invoice will not be sent to Verifactu/ticketBai.

Invoice Signature Flows

In order to send an invoice to taxe authorities we first make sure that the invoice has the right information. Invoices with wrong information will be rejected by tax authorities and it won't be possible to send them again. This is why we do a first check before sending the invoices.

Reminder: all invoices generated before the full integration set up are not sent to the Spanish Tax Agency.

Once onboarding is complete, eligible invoices are automatically sent to Verifactu or TicketBai upon finalization.

Sending an invoice can:

  • Succeed, or

  • Fail (before Verifactu processes it)

This status reflects the ability to send the invoice, not its final registration result.

Failed Invoice Sending

For invoices ≥ 400€ (tax included), Verifactu or TicketBai requires information about the invoice recipient (the member).

Missing information about the recipient is the most common source of errors. Here is the information needed:

  • Recipient country

  • City

  • Zip code

  • If Spanish recipient: NIF

  • If non-Spanish recipient: official identification document

When information is missing:

  • The invoice cannot be sent

  • You must complete the missing information

  • They go back to the invoice and click “Try Again” to retry submission

⚠️ Important: If the retry succeeds but incorrect data is provided, the invoice may be rejected by Verifactu or TicketBai and cannot be sent again.

Successful Invoice Sending

Once an invoice is successfully sent, it can be in one of the following states:

Pending

  • Verifactu processing may take up to 3 minutes

  • Status updates automatically after refresh

Registered

  • The invoice has been correctly registered with Spanish tax authorities

Rejected

The invoice was not accepted by Verifactu.

Common reasons

  • Invalid tax rate

  • Invalid Spanish NIF (for invoices ≥ 400€)

In this case it is not possible to send the invoice again. You should correct the missing information, cancel/refund said invoice and create a new one.

In call cases

In all three cases:

  • A QR code and Verifactu/ticketBai URL are added to the invoice PDF

  • This ensures traceability and compliance

Invoices Finalized Before Onboarding Completion

Invoices finalized before Verifactu/TicketBai onboarding are not automatically sent. You can manually send eligible invoices from the invoice details page.

  • Each invoice must be sent individually

  • Automatic batch sending is not available

Reverse (Refund) Invoices

Reverse invoices follow the exact same Verifactu/TicketBai flows as regular invoices. A reverse invoice can only be sent to Verifactu/TicketBai if:

  • The source invoice was itself sent to Verifactu (even if it was rejected)

If the source invoice was never sent:

  • The reverse invoice can still be manually sent from the invoice details page

Did this answer your question?