Skip to main content

TicketBAI

TicketBAI is the standardized digital format for submitting all invoices issued in the Basque Country, Spain.

Quaderno is officially recognized as "guaranteeing software" for TicketBAI by the local tax authorities.

Thanks to our API, complying is as easy as sending your sales and refund data to Quaderno in a single API call. You will receive a JSON response with the signed PDF of the document, which contains a QR code to ease later verification.

tip

You can test the TicketBAI integration in our Sandbox environment, which simulates the production environment without sending real data to the AEAT.

Connecting TicketBAI​

To start using TicketBAI in Quaderno, follow these steps:

  1. Upload your electronic certificate on the Certificates page.
  2. Connect the TicketBAI integration from the Integrations page.

Sending sales and refunds data​

Send your sales and refunds data to Quaderno as usual, using our Transactions API.

These guides will walk you through the process:

When the TicketBAI integration is enabled, Quaderno will automatically send all invoices and credit notes to the corresponding tax administration.

TicketBAI's verification_code and verification_url will be available from the API responses, and generated invoices will display their verification ID and a QR code, allowing your customers to confirm the status of the invoice with the respective tax administration.

Delivery events​

When an invoice or credit note is sent to the Basque Country tax authorities via TicketBAI, Quaderno will generate a delivery event to notify you of the result. You can subscribe to these events using webhooks to receive real-time notifications in your application.

The available delivery events are:

  • delivery.succeeded – The document was successfully delivered to the tax authorities.
  • delivery.failed – The delivery failed due to a technical error (e.g., network issues, service unavailable).
  • delivery.rejected – The tax authorities rejected the document due to validation errors in the data.

These events allow you to automate your workflow and take appropriate action based on the delivery status, such as notifying customers, retrying failed deliveries, or correcting rejected documents.

Limitations​

Once you enable the TicketBAI integration, keep these limitations in mind:

  • You won't be able to assign a custom number or issue_date to invoices or receipts. They will be assigned automatically.
  • The TicketBAI integration cannot be disabled. If you need to stop sending invoices, you must contact our support team.