Plugin Ticketbai: automatiza el envío y
firma de tus facturas en Euskadi
Gestionar la facturación de un negocio en Álava, Bizkaia o Guipúzcoa se ha convertido en
una auténtica carrera de obstáculos. La obligación legal de cumplir con la normativa
TicketBAI exige firmar electrónicamente cada ticket o factura de venta, enviarla en tiempo
real a la hacienda foral correspondiente y generar un código QR único para que el cliente
pueda verificar su tributación. Un solo descuido, una factura firmada fuera de orden
correlativo o un error de cálculo en las cuotas de IVA puede paralizar las ventas de todo un
día, provocar rechazos por parte de la Diputación y desencadenar sanciones administrativas
evitables.
En elEquipoIA somos especialistas en facturación electrónica y este plugin forma parte de
nuestro ecosistema de soluciones diseñadas para simplificar la gestión diaria de pymes,
autónomos y comercios. Gracias al plugin ticketbai, el programa de facturación electrónica
de elEquipoIA se conecta directamente con las haciendas forales vascas. El sistema firma
las facturas automáticamente al emitirlas, genera el correspondiente código QR y envía los
ficheros XML normativos sin que tengas que abandonar la pantalla de venta ni recurrir a
procesos manuales.
¿Qué es el plugin Ticketbai y para quién es?
El plugin ticketbai de elEquipoIA es un módulo de integración fiscal que automatiza la
firma electrónica, generación de códigos QR y envío directo de facturas a las haciendas
forales de Álava, Bizkaia y Guipúzcoa. Este complemento está diseñado específicamente
para autónomos, pymes, asesorías y comercios radicados en el País Vasco que emiten
facturas o tickets de venta y necesitan garantizar el cumplimiento normativo exigido por el
sistema TicketBAI de forma automatizada y transparente.
Características principales del plugin Ticketbai
● Envío automático a haciendas forales: conecta directamente con los servidores
de la Hacienda Foral de Álava, Bizkaia o Guipúzcoa para remitir el registro fiscal en
el instante en que la factura pasa a estado emitida.
● Generación e impresión de código QR: añade automáticamente el código QR
normativo y la huella TBAI a la factura o ticket impreso para que el cliente final
pueda comprobar su validez fiscal.
● Firma electrónica de documentos: permite cargar el certificado digital de la
empresa para realizar el firmado criptográfico de los ficheros de facturación con total
garantía legal.
● Gestión avanzada de epígrafes IAE: permite asociar epígrafes de IAE a la
empresa, asignarlos por defecto o vincularlos a productos específicos para cumplir
las exigencias particulares de la hacienda de Bizkaia.
● Soporte para facturas rectificativas: gestiona de forma precisa las rectificaciones
por diferencia o por sustitución, incluyendo las etiquetas normativas
correspondientes de la factura sustituida.
● Control de excepciones y regímenes de IVA: clasifica correctamente los desglose
de IVA, ventas intracomunitarias, operaciones exentas y régimen de recargo de
equivalencia para evitar errores de validación.
● Filtros de auditoría y estado: incluye indicadores visuales para comprobar al
instante si una factura ha sido firmada, enviada con éxito a hacienda o si requiere
revisión.
● Entorno de pruebas y depuración: incorpora un modo de depuración para probar
el envío y validación de facturas firmadas en entornos de test antes de operar en el
sistema real.
¿Cómo funciona el plugin Ticketbai?
El funcionamiento del plugin se integra directamente en los flujos habituales de venta de
nuestro programa de facturación. Una vez realizada la configuración inicial, el usuario
trabaja de forma convencional y el software gestiona la fiscalidad en segundo plano.
Al crear una factura de venta dentro del programa, se habilita una pestaña específica
denominada Ticketbai. Desde este apartado es posible comprobar el estado de la firma,
revisar el fichero XML generado y pulsar la opción de envío. Si el usuario cambia el estado
de la factura directamente a «Emitida», el programa ejecuta la firma electrónica, remite el
documento a la hacienda foral y recupera la respuesta oficial en tiempo real.
Control de encadenamiento y validaciones
Para cumplir la normativa TicketBAI, la firma de facturas exige una estricta trazabilidad y
correlatividad. El plugin comprueba que la factura anterior esté firmada para formar el
encadenamiento criptográfico obligatorio. Si se detecta un salto de serie, falta de NIF/CIF o
inconsistencias en los desgloses de IVA, el plugin bloquea el envío e informa del motivo.
Una vez firmada y enviada a la hacienda foral, la factura queda protegida contra borrados o
modificaciones directas para asegurar la integridad de la cadena.
Gestión de epígrafes IAE por empresa y producto
Para las empresas que tributan en la hacienda de Bizkaia, el módulo permite dar de alta y
administrar el catálogo completo de epígrafes del IAE. Es posible configurar un epígrafe
general a nivel de empresa, definir epígrafes concretos en las fichas de los productos de
almacén o modificarlos en las líneas de detalle del documento de venta antes de firmar.
Pasos para empezar a usar el plugin Ticketbai
1. Verifica los requisitos del sistema: Asegúrate de disponer de PHP 7.4 o superior
con la extensión GMP activa en el servidor y mantén actualizado nuestro programa
de facturación a una versión compatible.
2. Alta como software garante: Regístrate en la hacienda foral correspondiente
(Álava, Bizkaia o Guipúzcoa) como software garante utilizando los datos
identificativos del programa.
3. Accede a la configuración de la empresa: Entra en el menú Administrador >
Empresas, selecciona tu empresa y localiza la sección de configuración de Ticketbai.
4. Introduce las credenciales de conexión: Rellena los campos obligatorios
facilitados por tu hacienda (código de desarrollador, proveedor, versión del plugin y
fecha de inicio de emisión firmada).
5. Sube el certificado digital: Adjunta el archivo del certificado digital firmado de la
empresa y especifica su contraseña de acceso para autorizar las firmas electrónicas.
6. Configura los epígrafes IAE (Bizkaia): En caso de operar en Bizkaia, entra en
Administrador > Panel de control para activar los epígrafes IAE necesarios y asigna
el epígrafe por defecto en la ficha de tu empresa.
7. Inicia la emisión de facturas: Crea una factura de venta, cambia su estado a
emitida y comprueba en la pestaña Ticketbai cómo se genera el código QR y la
huella oficial de envío.
Preguntas frecuentes sobre el plugin Ticketbai
¿Qué ocurre si intento eliminar una factura que ya ha sido firmada por
TicketBAI?
¿Se puede borrar una factura firmada en TicketBAI? No, la normativa prohíbe eliminar o
alterar facturas firmadas. El plugin ticketbai de elEquipoIA bloquea la opción de borrado
en las facturas que disponen de código de firma. Si necesitas anular una operación o
corregir un error, debes emitir una factura rectificativa (por sustitución o por diferencias)
según las reglas normativas.
¿Se pueden enviar facturas en orden no correlativo?
¿Es obligatorio firmar las facturas en orden correlativo? Sí, el sistema exige un
encadenamiento criptográfico entre la factura actual y la inmediatamente anterior. El
programa comprueba que no existan huecos en la serie de facturación y exige firmar los
documentos en estricto orden cronológico y de numeración antes de remitir los datos a la
hacienda foral.
¿El plugin funciona si tengo varios epígrafes IAE en Bizkaia?
¿Cómo se gestionan múltiples epígrafes de IAE con TicketBAI? El plugin permite definir un
epígrafe por defecto a nivel de empresa y asignar epígrafes específicos en cada ficha de
producto. Cuando se añade un elemento a la factura, la línea adopta el epígrafe
correspondiente, permitiendo además su selección manual mediante el menú de opciones
de la línea de venta.
¿Puedo probar el funcionamiento sin enviar facturas reales a Hacienda?
¿Existe un entorno de pruebas para TicketBAI? Sí, la configuración del plugin incluye una
opción de depuración o modo de pruebas. Este entorno permite simular el firmado y la
generación del código QR con servidores de test de la hacienda foral antes de empezar a
emitir documentos fiscales reales.
¿Quieres saber más sobre el plugin Ticketbai?
En elEquipoIA somos especialistas en facturación electrónica y ayudamos a empresas,
pymes y autónomos a adaptar sus procesos de facturación a las exigencias normativas de
cada territorio. Nuestro programa de facturación electrónica simplifica el cumplimiento
tributario para que puedas concentrarte en hacer crecer tu negocio sin miedo a sanciones o
errores administrativos. Si quieres conocer a fondo cómo instalar el plugin ticketbai o
necesitas asesoramiento para ponerlo en marcha en tu instalación, ponte en contacto con
nuestro equipo técnico y te acompañaremos en todo el proceso.
