Ejemplos de facturas TicketBAI con la API
Aquí tienes 24 ejemplos de facturas TicketBAI, uno por tipo de factura o caso (completas, simplificadas, rectificativas, abono, canje, intracomunitarias, exportaciones, exentas, no sujetas, inversión del sujeto pasivo, REBU, recargo de equivalencia, anulación y subsanación), casi todos con la petición JSON a la API TicketBAI de Verifacti lista para copiar. La misma petición vale para Álava, Bizkaia y Gipuzkoa salvo donde el caso indica lo contrario.
Tipos de factura TicketBAI
| Caso | Tipo de factura o clave | Cuándo se usa |
|---|---|---|
| Factura simplificada | simplificada: true | Tiques de hasta 400 € IVA incluido (3.000 € en ciertas actividades), sin datos del destinatario. |
| Factura completa | simplificada: false | Facturas a empresas y profesionales que identifican al destinatario. |
| Varios tipos de IVA | Varias entradas en desglose_iva | Facturas con líneas a distintos tipos de IVA. |
| Intracomunitaria B2B de bienes | exenta con causa_exencion E5 | Ventas de bienes a empresas de otros países de la UE. |
| Intracomunitaria B2B de servicios | no_sujeta con causa RL | Servicios a empresas de otros países de la UE. |
| Intracomunitaria B2C bajo el umbral | desglose_iva con IVA español | Ventas a particulares de otros países de la UE por debajo del umbral. |
| Intracomunitaria B2C sobre el umbral (OSS) | clave_regimen 17 y no_sujeta IE | Ventas a particulares de otros países de la UE por encima del umbral, declaradas en la ventanilla única (OSS). |
| Exportación de bienes | clave_regimen 02 y exenta E2 | Ventas de bienes a clientes fuera de la UE. |
| Servicios fuera de la UE | no_sujeta con causa RL | Servicios a empresas de fuera de la UE, y a particulares de fuera de la UE cuando son servicios del artículo 69.Dos (asesoría, consultoría, servicios electrónicos, cesión de derechos…). |
| Factura exenta | exenta con causa_exencion E1–E6 | Operaciones exentas de IVA. |
| Operación no sujeta | no_sujeta con causa OT, RL, VT o IE | Operaciones no sujetas a IVA. |
| Suplidos y retención | especial.retencion_soportada | Facturas de profesionales con retención de IRPF. |
| Factura de abono | Rectificativa R1 por diferencias, en negativo | Devoluciones y descuentos posteriores a la factura. |
| Factura de canje | sustitucion_simplificada: true | Cuando el cliente pide una factura a su nombre de un tique ya emitido. |
| Facturas rectificativas | rectificativa.codigo R1–R5 | Corregir errores o modificar importes de facturas ya emitidas. |
| ↳ Por sustitución | rectificativa.tipo S | Sustituir una factura por otra con los importes correctos. |
| ↳ Por diferencias | rectificativa.tipo I | Corregir una factura sumando o restando la diferencia. |
| Recargo de equivalencia | tipo_recargo_equivalencia en desglose_iva | Ventas a minoristas en régimen de recargo de equivalencia. |
| Emitida por terceros | Sin campo adicional | Facturas que un tercero expide en nombre del emisor. |
| REBU | clave_regimen 03 | Venta de bienes usados, objetos de arte o antigüedades en REBU. |
| Inversión del sujeto pasivo | especial.inversion_sujeto_pasivo: true | Operaciones en las que el destinatario liquida el IVA (por ejemplo, ciertas obras de construcción). |
| Anulación | Endpoint /ticketbai/cancel | Facturas emitidas por error. |
| Subsanación | PUT /ticketbai/modify con accion SUBSANAR o MODIFICAR | Corregir en Álava y Gipuzkoa una factura rechazada o aceptada con errores. |
Cómo es un ejemplo de TicketBAI
Cada caso trae la petición JSON a la API TicketBAI, con pestañas para cURL, Python, JavaScript, Node.js, PHP, Go, Java, C# y VB6. La cuenta gratuita incluye el entorno de test de TicketBAI: pide el NIF de test de tu territorio a soporte@verifacti.com y prueba la petición con su API key de test. La fecha de expedición ya es la de hoy. Para repetir un envío, cambia numero (o serie): la API no admite dos facturas con la misma serie, número y año.
No tienes que generar el XML: con esa petición, Verifacti compone el fichero TicketBAI, lo firma, calcula el código TicketBAI y el QR, y lo envía a la hacienda foral del NIF. La respuesta trae el identificador de la factura (uuid), el código TicketBAI (tbai), el estado, la URL de verificación (url) y el QR en Base64 (qr); el código TicketBAI y el QR van impresos en la factura.
El endpoint es el mismo en los tres territorios; cambia lo que hay detrás:
- Álava y Gipuzkoa: una factura rechazada o aceptada con errores se corrige con el servicio Zuzendu (
SUBSANARoMODIFICAR). - Bizkaia: el envío va a Batuz, dentro del LROE; si el emisor es persona física, la factura lleva
detalle_renta.
Preguntas sobre los ejemplos
Preguntas frecuentes TicketBAI¿La respuesta trae el QR y el código TicketBAI?
Sí, al instante. La respuesta de POST /ticketbai/create incluye el QR en Base64 (qr), su URL (url) y el código TicketBAI (tbai), que van impresos en la factura. Campos completos en la documentación.
¿Puedo subsanar una factura rechazada?
En Álava y Gipuzkoa, sí: con la acción SUBSANAR de PUT /ticketbai/modify. En Bizkaia, no: la API no ofrece modificación ni subsanación, pero sí anulación con /ticketbai/cancel. Ejemplos en subsanación y anulación.
¿Puedo probar TicketBAI con la cuenta gratuita?
Prueba los ejemplos en el entorno de test
Crea tu cuenta gratuita, pide a soporte@verifacti.com el NIF de test de TicketBAI y envía cualquiera de estas peticiones con su API key de test.