Full invoice in TicketBAI: API example
A full invoice identifies the recipient. In the TicketBAI API it is sent to /ticketbai/create with simplificada set to false (the default), plus the customer's nif or id_otro and nombre.
| Field | Value |
|---|---|
| API | TicketBAI API |
| Invoice type or key | simplificada: false |
| Endpoint | /ticketbai/create |
| When to use it | Invoices to businesses and professionals that identify the recipient. |
What changes in this case
The full invoice is the standard invoice: it identifies the recipient with their nif (or id_otro if they have no Spanish NIF) and their nombre. In Álava and Gipuzkoa cp and direccion are mandatory too; always include them and the same request works in all three territories.
Each line carries descripcion, cantidad, importe_unitario (excluding VAT) and importe_total (including VAT). VAT goes separately in desglose_iva, with one entry per tax rate.
If you include the nif, the API checks by default that it is registered with the AEAT, because otherwise the foral treasury would reject the submission.
JSON requests
Full invoice
{
"serie": "Ejemplos",
"numero": "1",
"fecha_expedicion": "19-11-2026",
"descripcion": "Factura completa",
"nif": "A15022510",
"nombre": "Nombre destinatario",
"cp": "48001",
"direccion": "Calle Ejemplo 1, Bilbao",
"lineas": [
{
"descripcion": "Servicio de consultoría",
"cantidad": "2",
"importe_unitario": "100.00",
"importe_total": "242.00"
}
],
"desglose_iva": [
{
"base_imponible": "200.00",
"tipo_impositivo": "21",
"cuota_impuesto": "42.00"
}
],
"importe_total": "242.00"
}Self-employed issuer in Bizkaia
In Bizkaia, if the issuing NIF is a natural person, add detalle_renta with the epigrafe of their activity (from the list linked in the documentation). It is mandatory for natural persons in Bizkaia; in every other case it is not used.
{
"serie": "Ejemplos",
"numero": "1",
"fecha_expedicion": "19-11-2026",
"descripcion": "Factura completa",
"nif": "A15022510",
"nombre": "Nombre destinatario",
"cp": "48001",
"direccion": "Calle Ejemplo 1, Bilbao",
"lineas": [
{
"descripcion": "Servicio de consultoría",
"cantidad": "2",
"importe_unitario": "100.00",
"importe_total": "242.00"
}
],
"desglose_iva": [
{
"base_imponible": "200.00",
"tipo_impositivo": "21",
"cuota_impuesto": "42.00"
}
],
"importe_total": "242.00",
"detalle_renta": [
{
"epigrafe": "165110"
}
]
}Common errors
The API rejects the invoice if importe_total does not match the sum of the lines or the sum of bases and tax amounts in desglose_iva, or if a tax amount does not match its rate. In Álava and Gipuzkoa, fecha_expedicion must be today's date.
Try this case in the test environment
Create your free account and ask soporte@verifacti.com for a TicketBAI test NIF; then copy the request and send it with its test API key.