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.
| Campo | Valor |
|---|---|
| API | API TicketBAI |
| Tipo de factura o clave | simplificada: false |
| Endpoint | /ticketbai/create |
| Cuándo se usa | Facturas 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
{
"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.
{
"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.