Factura completa en TicketBAI: ejemplo con la API

Una factura completa identifica al destinatario. En la API TicketBAI se envía a /ticketbai/create con simplificada a false (el valor por defecto), el nif o id_otro y el nombre del cliente.

CampoValor
APIAPI TicketBAI
Tipo de factura o clavesimplificada: false
Endpoint/ticketbai/create
Cuándo se usaFacturas a empresas y profesionales que identifican al destinatario.

Qué cambia en este caso

La factura completa es la factura ordinaria: identifica al destinatario con su nif (o con id_otro si no tiene NIF español) y su nombre. En Álava y Gipuzkoa también son obligatorios cp y direccion; inclúyelos siempre y la misma petición vale en los tres territorios.

Cada línea lleva descripcion, cantidad, importe_unitario (sin IVA) e importe_total (con IVA). El IVA se informa aparte, en desglose_iva, con una entrada por tipo impositivo.

Si incluyes el nif, la API comprueba por defecto que está censado en la AEAT, porque si no lo está la hacienda foral rechazaría el envío.

Peticiones JSON

Factura completa

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"
}

Emisor persona física en Bizkaia

En Bizkaia, si el NIF emisor es una persona física, añade detalle_renta con el epigrafe de su actividad (del listado que enlaza la documentación). Es obligatorio para personas físicas en Bizkaia; en el resto de casos no se usa.

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"
    }
  ]
}

Errores frecuentes

La API rechaza la factura si importe_total no cuadra con la suma de las líneas o con la suma de bases y cuotas de desglose_iva, o si la cuota no corresponde al tipo impositivo. En Álava y Gipuzkoa, fecha_expedicion tiene que ser la fecha de hoy.

Prueba este caso en el entorno de test

Crea tu cuenta gratuita y pide a soporte@verifacti.com el NIF de test de TicketBAI; después copia la petición y envíala con su API key de test.

Entorno de test y NIF de prueba incluidosLee la documentación