TicketBAI API FAQ
Answers on how to comply with TicketBAI in Álava, Bizkaia and Gipuzkoa with the Verifacti TicketBAI API: guarantor software, integration, testing, submission to each foral treasury, corrections and Batuz. What each territory’s rules say is on the TicketBAI page.
Integration
2 questions
Do I need a separate integration for TicketBAI or is it the same integration for both TicketBAI and Verifactu?
- Consistency: the endpoints, fields, and error messages we present to our users are practically the same as those in the tax authority APIs.
- Easier tax consultations: this similarity eliminates interpretations or biases stemming from an intermediary API, which streamlines communication with advisors and with the tax authorities themselves.
If I am in the SII, do I have to comply with TicketBAI?
Being in the SII does not exempt you from TicketBAI in any of the three territories: they are separate obligations. Who is obliged and from when is on the TicketBAI page.
Guarantor software and representation
3 questions
If I use the TicketBAI API, do I need to become a guarantor software (software garante)?
Is Verifacti guarantor software in all three territories?
Yes. Verifacti is registered as guarantor software with the foral treasuries of Álava, Bizkaia and Gipuzkoa. Registration is a listing, not an approval: no treasury approves or certifies software. Details per territory in TicketBAI in Álava, TicketBAI in Bizkaia and TicketBAI in Gipuzkoa.
How are certificates and representation managed with TicketBAI?
- Online signature (individuals / self-employed only): the NIF holder verifies their identity by video and signs from the browser, with no digital certificate required. It costs €2.90 + VAT per signing process. You can see the process step by step in the guide Online signing of the representation model.
- Signature with a digital certificate (individuals and legal entities): the pre-filled PDF is downloaded, signed with the issuing NIF's digital certificate and uploaded to Verifacti. It is free.
Testing and pricing
2 questions
Can I test TicketBAI with the free account?
Is TicketBAI included in the price?
Yes. TicketBAI has the same price as Verifactu, per NIF active in production: each NIF uses the TicketBAI API or the Verifactu API depending on where it is taxed, at no extra cost. A NIF registered with two treasuries counts as two NIFs. Rates on the pricing page and more in Do prices include TicketBAI?.
Submission and corrections by territory
4 questions
Which treasury does the API send each invoice to?
To the issuing NIF’s. When you register a NIF you choose the treasury it is linked to (alava, vizcaya or guipuzcoa), and the TicketBAI API sends its invoices to that foral treasury. The endpoint is the same in all three territories. The same NIF can be registered with several treasuries, each with its own API key (see the NIF management API documentation).
Does the response include the QR and the TicketBAI code?
Yes, straight away. The response of POST /ticketbai/create includes the QR in Base64 (qr), its URL (url) and the TicketBAI code (tbai), which are printed on the invoice. All fields in the documentation.
Can I correct a rejected invoice?
In Álava and Gipuzkoa, yes: with the SUBSANAR action of PUT /ticketbai/modify. In Bizkaia, no: the API offers no modification or correction, but it does offer cancellation with /ticketbai/cancel. Examples in correction and cancellation.
Start integrating today
Try it for free with the test environment.