TicketBAI is the Basque Country's system for invoicing software. For each invoice, the software creates a TicketBAI XML file, signs it, chains it to the previous invoice and sends it to the provincial tax authority of Álava, Bizkaia or Gipuzkoa. The invoice shows a 39 character TBAI identifier and a QR code. Each province sets its own dates and details. Klarbon support is planned, not available yet.
What is in a TicketBAI file?
| Part | Holds |
|---|---|
| Subjects | the issuer and the recipients |
| Invoice | header with series, number, date and time; invoice data with description and total; the tax breakdown |
| Chaining | series, number and date of the previous invoice, and the first 100 characters of its file signature |
| Software | the identification of the TicketBAI invoicing software |
| Signature | electronic signature under the TicketBAI signature policy |
| Property | Value |
|---|---|
| Specification | TicketBAI functional and technical specifications 1.2 |
| Order of steps | create the file, sign it, then produce the invoice |
| TBAI identifier | 39 characters, for example TBAI-00000006Y-251019-btFpwP8dcLGAF-237 |
| QR code | 30x30 to 40x40 mm, below the TBAI identifier |
| Run by | the provincial tax authorities of Álava, Bizkaia and Gipuzkoa |
The shared specification describes the file, the signature, the chaining, the TBAI identifier and the QR code (TicketBAI 1.2). Each authority publishes its own validation lists and rules, as Gipuzkoa does (Gipuzkoa).
TicketBAI or VERI*FACTU?
| TicketBAI | VERI*FACTU | |
|---|---|---|
| Where | Basque provinces | the rest of Spain under state rules |
| Authority | the provincial tax authority | the AEAT |
| Sent | every signed file | every record in VERI*FACTU mode, or kept signed |
| On the invoice | TBAI identifier and QR code | QR code, and the VERI*FACTU phrase where sent |
What does Klarbon do with TicketBAI files?
Klarbon does not support TicketBAI today; opening TicketBAI files is planned, not available yet. Klarbon does not create, sign or send TicketBAI files, and it is not TicketBAI invoicing software.
Related
Frequently asked questions
What is TicketBAI?
A system shared by the three Basque provincial tax authorities, of Álava, Bizkaia and Gipuzkoa. Invoicing software must create a signed TicketBAI file for each invoice, before the invoice itself, and send it to the provincial authority.
What is the TBAI identifier?
A 39 character code printed on the invoice. It is made of the text TBAI, the issuer's tax number, the issue date as DDMMYY, the first 13 characters of the file's signature value and a 3 character CRC-8 check code, separated by hyphens.
How are TicketBAI files chained?
Each file holds the series, number and issue date of the previous invoice and the start of that file's signature. A missing or altered invoice breaks the chain.
Does TicketBAI apply in the rest of Spain?
No. It applies to taxpayers under the Basque provincial tax authorities. The rest of Spain follows the state invoicing software rules, known as VERI*FACTU, and the dates and details of TicketBAI are set by each province.