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.

FieldValue
APITicketBAI API
Invoice type or keysimplificada: false
Endpoint/ticketbai/create
When to use itInvoices 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

Factura completa
{
  "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.

Factura completa
{
  "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.

Test environment and test NIF includedRead the documentation