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

Ejemplos de facturas TicketBAI por tipo de factura o caso
CasoTipo de factura o claveCuándo se usa
Factura simplificadasimplificada: trueTiques de hasta 400 € IVA incluido (3.000 € en ciertas actividades), sin datos del destinatario.
Factura completasimplificada: falseFacturas a empresas y profesionales que identifican al destinatario.
Varios tipos de IVAVarias entradas en desglose_ivaFacturas con líneas a distintos tipos de IVA.
Intracomunitaria B2B de bienesexenta con causa_exencion E5Ventas de bienes a empresas de otros países de la UE.
Intracomunitaria B2B de serviciosno_sujeta con causa RLServicios a empresas de otros países de la UE.
Intracomunitaria B2C bajo el umbraldesglose_iva con IVA españolVentas 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 IEVentas a particulares de otros países de la UE por encima del umbral, declaradas en la ventanilla única (OSS).
Exportación de bienesclave_regimen 02 y exenta E2Ventas de bienes a clientes fuera de la UE.
Servicios fuera de la UEno_sujeta con causa RLServicios 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 exentaexenta con causa_exencion E1–E6Operaciones exentas de IVA.
Operación no sujetano_sujeta con causa OT, RL, VT o IEOperaciones no sujetas a IVA.
Suplidos y retenciónespecial.retencion_soportadaFacturas de profesionales con retención de IRPF.
Factura de abonoRectificativa R1 por diferencias, en negativoDevoluciones y descuentos posteriores a la factura.
Factura de canjesustitucion_simplificada: trueCuando el cliente pide una factura a su nombre de un tique ya emitido.
Facturas rectificativasrectificativa.codigo R1–R5Corregir errores o modificar importes de facturas ya emitidas.
↳ Por sustituciónrectificativa.tipo SSustituir una factura por otra con los importes correctos.
↳ Por diferenciasrectificativa.tipo ICorregir una factura sumando o restando la diferencia.
Recargo de equivalenciatipo_recargo_equivalencia en desglose_ivaVentas a minoristas en régimen de recargo de equivalencia.
Emitida por tercerosSin campo adicionalFacturas que un tercero expide en nombre del emisor.
REBUclave_regimen 03Venta de bienes usados, objetos de arte o antigüedades en REBU.
Inversión del sujeto pasivoespecial.inversion_sujeto_pasivo: trueOperaciones en las que el destinatario liquida el IVA (por ejemplo, ciertas obras de construcción).
AnulaciónEndpoint /ticketbai/cancelFacturas emitidas por error.
SubsanaciónPUT /ticketbai/modify con accion SUBSANAR o MODIFICARCorregir 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 (SUBSANAR o MODIFICAR).
  • 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?

Sí. La cuenta gratuita incluye el entorno de test de TicketBAI, así que puedes hacer la integración sin coste. Para el NIF de test de la hacienda foral, escribe a soporte@verifacti.com. Para enviar facturas de NIFs reales a la hacienda foral necesitas una suscripción de pago.

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.

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