Skip to main content

Sending e-invoices with TicketBAI

What is TicketBAI

TicketBAI is a standarized 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.

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.
  3. Grant authorization to send data to the tax administration on behalf of your business.

Sending sales and refunds data

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

These guides will guide 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.

Accessing TicketBAI responses

You can read TicketBAI responses in all credits and invoices sent to TicketBAI. The deliveries list will contain all the information, including TicketBAI's error messages.

For example, retrieving an invoice with a GET call to /invoices/{id} :

curl --request GET
--url https://quadernoapp.com/api/invoices/92732431 \
--header 'Authorization: Basic API_KEY' \

Will return a response with a list of deliveries:

[
{
"delivered_at": 1721913643,
"recipient": "ticketbai_bizkaia",
"service_response":"{\"LROEPF140IngresosConFacturaConSGAltaRespuesta\":{\"Cabecera\":{\"Modelo\":\"140\",\"Capitulo\":\"1\",\"Subcapitulo\":\"1.1\",\"Operacion\":\"A00\",\"Version\":\"1.0\",\"Ejercicio\":\"2024\",\"ObligadoTributario\":{\"NIF\":\"00000000T\",\"ApellidosNombreRazonSocial\":\"xxx yyy zzz\"}},\"DatosPresentacion\":{\"FechaPresentacion\":\"19-06-2024 12:57:42\",\"NIFPresentador\":\"X00000000T\"},\"Registros\":{\"Registro\":{\"Identificador\":{\"IDFactura\":{\"NumFactura\":\"00010\",\"FechaExpedicionFactura\":\"19-06-2024\"}},\"SituacionRegistro\":{\"EstadoRegistro\":\"Correcto\"}}}}}",
"type":"registration"
},
{ … } 
]