TicketBAI guarantor software in Gipuzkoa, via API
The Verifacti TicketBAI API connects your invoicing software with the Gipuzkoa Foral Treasury: you send each invoice as JSON, instantly get the QR and TicketBAI code, and Verifacti generates, chains and submits the TicketBAI file. Verifacti is TicketBAI guarantor software in Álava, Bizkaia and Gipuzkoa, with the same endpoint for all three territories.
Test environment and test NIF included{
"serie": "A",
"numero": "234634",
"fecha_expedicion": "19-11-2026",
"tipo_operacion": "servicios",
"importe_total": "242.00",
…
}{
"tbai": "TBAI-B05434202-021224-…",
"estado": "Pendiente",
"qr": "iVBORw0KGgoAAAANSUhEUgAA…"
}How the TicketBAI API works in Gipuzkoa
- 1
You send the invoice as JSON
Your software calls the API with the invoice data and the issuing NIF’s API key.
- 2
You get the QR and the TicketBAI code
Instantly, to print on the invoice.
- 3
Verifacti submits the file to the Gipuzkoa Foral Treasury
It generates the file, chains it and submits it in the background.
The result reaches you by webhook or by checking the record’s status.
Example: create a TicketBAI invoice for Gipuzkoa
It is the same endpoint for all three territories: the target treasury comes from the NIF. In Gipuzkoa, the customer’s direccion and cp are required, except on simplified invoices.
curl -X POST https://api.verifacti.com/ticketbai/create \
-H "Authorization: Bearer $VERIFACTI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"serie": "A",
"numero": "234634",
"fecha_expedicion": "19-11-2026",
"simplificada": false,
"nif": "A15022510",
"nombre": "Empresa de ejemplo SL",
"direccion": "Calle Mayor 15",
"cp": "20001",
"descripcion": "Descripción de la factura",
"tipo_operacion": "servicios",
"lineas": [{
"descripcion": "Línea 1",
"cantidad": "2",
"importe_unitario": "100.00",
"importe_total": "242.00"
}],
"desglose_iva": [{
"base_imponible": "200",
"tipo_impositivo": "21",
"cuota_impuesto": "42"
}],
"importe_total": "242.00"
}'{
"uuid": "ea6eae92-bac6-48c3-baa4-2bbf6b5ee562",
"tbai": "TBAI-B05434202-021224-mwUG7NRo2ZNxp-010",
"estado": "Pendiente",
"url": "https://…/qrtbai/?id=TBAI-B05434202-021224-…",
"qr": "iVBORw0KGgoAAAANSUhEUgAA…"
}What the TicketBAI API includes in Gipuzkoa
Guarantor software in Gipuzkoa
Verifacti is guarantor software here and in the other two territories. The software calling the API does not need to join the guarantor software register.
Submission to the Gipuzkoa Foral Treasury
Every invoice, with the QR and TicketBAI code instantly in the response.
Corrective invoices, cancellation and amendments
Corrective invoices (R1–R5) with
/ticketbai/create; modification and amendment of rejected files with/ticketbai/modify, and cancellation with/ticketbai/cancel.Validation before sending
Every invoice is validated before it is sent and any error comes back with a code (code catalogue). By default we also check that the customer’s NIF is identified by the AEAT.
No digital certificate
The taxpayer signs the representation form once, also online.
The same endpoint for all three territories
Each NIF is assigned its treasury when registered; the call to
/ticketbai/createis the same in Álava, Bizkaia and Gipuzkoa.
One integration per regulation, on top of the NIF management API
You integrate the NIF management API once: registering, activating and removing NIFs, representation and webhooks. Each regulation then adds its own submission integration, close to the target administration’s API. If a customer is taxed in common territory, they use the Verifactu API with the same NIF management and the same price.
Why Verifacti for TicketBAI in Gipuzkoa
Built for developers
Public documentation with examples for every call, quick start guide, Postman collections, llms.txt and a free account with a test environment.
Typical integration: one to three developer daysSpecialists in Spain
Common and foral territory: Verifactu, TicketBAI and SII with one provider.
Guarantor software in Álava, Bizkaia and GipuzkoaProven reliability
Hundreds of companies and software vendors in production with Verifacti. Data hosted in the EU and an SLA in the terms of use.
AEAT social collaboratorTicketBAI in Gipuzkoa: dates and official source
In Gipuzkoa, TicketBAI is regulated by Foral Decree 32/2020 and its roll-out was completed on 1 June 2023.
| Who | Date | Status | Rule |
|---|---|---|---|
| TicketBAI in Gipuzkoa: foral taxpayers Phased by activity from 1 July 2022. | Since 1 Jun 2023 | In force | NF 3/2020 · DF 32/2020 |
This is not advice: each taxpayer determines what applies to them with their adviser.
- The price per NIF goes down with every tier.
- Up to 3,000 invoicing records per month per NIF.
- Online signing of the representation form: €2.90 + VAT.
- Free test environment and test NIF.
- Annual plan with a 10% discount, no setup fees.
- Same price as the Verifactu API.
- Startup plan for companies under 12 months old, with under €100,000 in revenue and under €200,000 in funding.
Everything you need to integrate TicketBAI
Questions about TicketBAI in Gipuzkoa
More questions about TicketBAIIs Verifacti TicketBAI guarantor software in Gipuzkoa?
Does my software need to register as guarantor software?
Can I amend a rejected invoice?
/ticketbai/modify: accion SUBSANAR if the file was rejected and MODIFICAR if it was accepted with errors.Do I need a digital certificate?
How much does it cost?
Start integrating today
Try it for free with the test environment.