Manage TicketBAI tax declarations in B2Brouter

What is TicketBAI?

TicketBAI is a joint project by the Basque Government and the Provincial Tax Authorities that aims to establish legal and technical obligations for the invoicing software used by taxpayers. This system allows the tax administration to more effectively monitor income derived from economic activities, especially in sectors where goods or services are sold directly to consumers and payment is often made in cash.

How does TicketBAI work?

TicketBAI involves the immediate and real-time submission of invoice data to the tax administration as soon as the invoice is generated. This ensures that no changes can be made after the invoice is issued, guaranteeing its security. Additionally, the invoice includes a QR code that allows the recipient to verify its fiscal compliance through the tax administration’s platform.

How to activate TicketBAI in B2Brouter

To activate TicketBAI, you must have an active Premium Plan (Professional, Business or eDocExchange).

Click on the gear icon at the top of the screen and select Account settings.
Go to the Taxes section in the side menu and select TicketBAI.
Carefully read the section Important information before activating TicketBAI.
Click the Activate TicketBAI button.
A pop-up window will appear where you can review the default TicketBAI configuration and modify it if necessary. If needed, you can adjust the settings when creating an invoice, but those changes will only apply to that specific invoice and will not affect the default configuration.
Once the default configuration is updated, click the “next” button. A confirmation message will appear.
Click Activate TicketBAI to complete the activation.
Once activated, a box will display the date and time of TicketBAI activation.

Important information before activating TicketBAI

TicketBAI cannot be deactivated

Once you activate TicketBAI, you commit to the corresponding Provincial Tax Authority to submit a declaration for every invoice you generate.

Start date

The date you activate TicketBAI will be the official start date of your commitment to the corresponding Provincial Tax Authority to declare all invoices issued from that moment onward. This date cannot be changed.

Stopping the use of B2Brouter

If you decide to stop using B2Brouter after activating TicketBAI, you will need to have another TicketBAI-compliant invoicing system. Once the commitment with the Tax Authority has been made, it is no longer possible to generate invoices manually, as all invoices must be submitted using a TicketBAI-compliant invoicing system.

Create the invoice and submit the declaration

Once TicketBAI is configured, you can start creating invoices and then sending them along with their corresponding declarations.

The TicketBAI declaration is automatically generated with the information from the invoice and is sent to the corresponding Provincial Tax Authority when you send the invoice.

Invoices are sent to your clients with the integrated QR code. You can see it at the bottom of the open invoice, where you’ll also find the link to the record generated on the Provincial Tax Authority’s portal. Using the link, you can view all the information registered on the portal.

Access the declarations

To view a submitted declaration, open the sent invoice. At the top, you’ll find the “View declaration” option. Click it to access the declaration information.

You can also access all submitted declarations:

From the top menu, go to the Taxes section.
On the following page, you’ll see the submitted declarations. You can open a document by clicking on its declaration number.

Manage TicketBAI through integration with your system and B2Brouter

To manage TicketBAI through integration, keep the following in mind:

You must have an active eDocExchange Plan.
Your management system must be able to generate the XML file with the required registration information.

If you meet these requirements, you can connect your management system with B2Brouter to import the required information. B2Brouter will handle invoice chaining, add the digital fingerprint (if needed), digitally sign the document (if needed), and send it directly to the corresponding Provincial Tax Authority.

Follow these steps to manage TicketBAI:

Configure integration with B2Brouter

To use the TicketBAI service, you can integrate your system with B2Brouter using one of three connection types: B2Bconnector, SFTP, or API.

See how to configure the B2Bconnector connection. See how to configure the SFTP connection. See how to configure the API connection.

Activate tax declaration

Follow the steps as explained here

Import the file

Once you generate the file in your system, import it into B2Brouter using the configured connection type.

In all cases, you must upload the TicketBAI file in XML format to the TicketBAI folder:

The file will be automatically imported into B2Brouter.
You can import multiple files at once.

Submit the declaration

Once the file is imported, you’ll find it in the Invoices section of the main menu and in Declarations in the submenu at the bottom of the main menu:

This section lists all imported documents.
You can open a document by clicking its number.
The submission to the tax authority is done right after the import.

Manage statuses

You can check the status of records on the right side of the list or at the top of an open record.

If the imported file is correct and successfully sent, it will appear as Sent.
If the submission fails, it will appear as Error.

Download the QR code

If the record was created successfully, you only need to download the registration QR code to insert it into the invoice you need to send.

Open the record.
At the top, you’ll find the QR code.
Right-click on the QR code and save it to your system.
You can also use the link above the QR code to verify the registration directly on the official records website.