TicketBAI y ef4ktur: registro, configuración y pruebas por provincia

Si eres autónomo o empresa en el País Vasco, ya sabes que TicketBAI es obligatorio. Pero lo que muchos no saben es que cada provincia tiene su propio sistema, sus propios requisitos de registro y su propia forma de validar facturas. Álava, Bizkaia y Gipuzkoa comparten el nombre "TicketBAI", pero las diferencias técnicas son importantes.

En esta guía te explico cómo registrarte, configurar certificados digitales, usar ef4ktur para hacer pruebas y prepararte para producción en cada territorio histórico, incluyendo los errores más frecuentes y cómo solucionarlos.

Requisitos previos

Antes de empezar con TicketBAI en cualquier provincia, necesitas:

Documentación y datos fiscales

• NIF/CIF de tu empresa o actividad como autónomo
• Datos del establecimiento: dirección completa, código postal, nombre comercial
• Epígrafe IAE (Impuesto de Actividades Económicas)
• Datos de contacto: teléfono, email

Certificado digital válido

Imprescindible para autenticar las comunicaciones con Hacienda. Los certificados aceptados varían por provincia:

✅ Recomendación: Usa certificados de IZENPE (Autoridad de Certificación del Gobierno Vasco). Son los que mejor funcionan con TicketBAI y tienen soporte técnico especializado en euskera y castellano.

Software compatible

Tienes dos opciones principales:

1. Software comercial certificado: Facturian, Sage, A3, Wolters Kluwer, etc.
2. ef4ktur (software libre): Herramienta oficial del Gobierno Vasco para generar XMLs TicketBAI

⚠️ Importante: ef4ktur no es un programa de facturación completo. Es una herramienta para generar y enviar ficheros XML de TicketBAI. Si quieres facturar de forma normal, usa software comercial.

Certificados digitales: obtención y formatos

Cómo obtener un certificado IZENPE

1. Solicita el certificado en línea: Entra en www.izenpe.eus y selecciona "Certificados > Personas físicas" o "Personas jurídicas"
2. Identifícate: Necesitas DNIe, certificado previo o acudir presencialmente a una oficina de registro
3. Descarga el certificado: IZENPE te lo entrega en formato .pfx (PKCS#12) con contraseña
4. Instálalo en tu navegador y sistema operativo

Conversión de .cer a .pfx

Algunos proveedores entregan el certificado en formato .cer (solo parte pública). Para usarlo con TicketBAI necesitas el formato .pfx que incluye la clave privada.

Con OpenSSL (Linux/Mac):

openssl pkcs12 -export -out certificado.pfx -inkey clave-privada.key -in certificado.cer

Con Windows:

1. Importa el .cer en el administrador de certificados (certmgr.msc)
2. Exporta desde ahí marcando "Exportar clave privada" y seleccionando formato PFX

⚠️ Atención: Si no tienes la clave privada (archivo .key), no podrás convertirlo. Tendrás que solicitar un nuevo certificado.

Software garante: qué es y cuándo registrarse

Un software garante es un programa que genera ficheros TicketBAI válidos, firmados y con cadena de hash íntegra. Si desarrollas tu propio software o usas ef4ktur, debes registrarte como "software garante" en cada provincia.

¿Cuándo es obligatorio registrarse?

Proceso de registro

Cada provincia tiene su propio registro:

• Álava: Formulario en la web de la Diputación Foral de Álava
• Bizkaia: Registro en el portal Batuz
• Gipuzkoa: Formulario en la sede electrónica de Gipuzkoa

Deberás proporcionar:

• Nombre del software
• Versión
• NIF del desarrollador o empresa responsable
• Descripción técnica (opcional pero recomendado)

✅ Consejo: Aunque uses software comercial ahora, si tienes pensado cambiar a ef4ktur o desarrollo propio en el futuro, puedes registrar tu "software garante" de antemano.

Álava (Araba): configuración y pruebas

Si estás empezando con TicketBAI y quieres un primer contacto sin demasiadas complicaciones, Álava es el territorio que te lo pone más fácil. Fue la primera provincia en implementarlo (1 de enero de 2022) y su sistema es el más directo: envío en tiempo real, sin LROE ni capas adicionales. Conviene hacer las primeras pruebas aquí aunque se opere en otra provincia, porque el flujo es más limpio y te ayuda a entender la mecánica general.

Marco legal y registro

La base normativa es la Norma Foral 13/2021 y el Decreto Foral 48/2021. Para darte de alta, accede a la sede electrónica en web.araba.eus/es/hacienda/ticketbai, autentícate con tu certificado digital y rellena el formulario de alta con tus datos fiscales, establecimientos y software garante. Te enviarán un PDF de confirmación.

⚠️ Importante: En Álava, el alta en TicketBAI es automática si ya estabas dado de alta en el Censo del IGIC (tributo local). Aun así, verifica que tus datos estén actualizados.

Configuración en ef4ktur (Álava)

1. Descarga ef4ktur: www.ef4ktur.eus
2. Instala el programa: Disponible para Windows, Linux y Mac
3. Configura el certificado:
   • Ve a "Configuración > Certificado digital"
   • Selecciona tu archivo .pfx e introduce la contraseña
4. Selecciona territorio: Álava / Araba
5. Configura datos del emisor:
   • NIF, nombre o razón social
   • Dirección del establecimiento
6. Activa modo test: Marca la casilla "Entorno de pruebas"

Entorno de test (Álava)

URL del servicio de pruebas: https://ticketbai-prep.araba.eus

Cómo hacer pruebas

1. Genera una factura en ef4ktur: Rellena todos los campos obligatorios
2. Firma el XML: ef4ktur firma automáticamente con tu certificado
3. Envía al servidor de test: Botón "Enviar a TicketBAI"
4. Interpreta la respuesta:

✅ Consejo: Descarga el XSD oficial de TicketBAI Álava (TicketBai_alta_1_0.xsd) y valida tus XMLs localmente antes de enviarlos. Esto te ahorra reintentos innecesarios.

Estructura de respuesta (Álava)

Cuando Hacienda acepta una factura, devuelve un XML con:

• Número de registro: Identificador único de Hacienda
• Fecha y hora de recepción
• Firma de Hacienda: Prueba de que la factura fue registrada

Guarda este fichero junto con el XML original. Es tu justificante de cumplimiento.

Paso a producción (Álava)

1. Desactiva el modo test en ef4ktur
2. Cambia la URL: El programa usará automáticamente https://ticketbai.araba.eus
3. Registra tu software garante (si usas ef4ktur en producción)
4. Envía tu primera factura real: Hazlo con una factura de bajo importe para verificar

⚠️ Atención: Una vez enviada una factura en producción, no puedes borrarla. Solo puedes emitir una factura rectificativa.

Lo que distingue a Álava

Álava apuesta por la sencillez: cada factura se envía en tiempo real, sin libro registro adicional (LROE) ni envíos por lotes. El XSD que usa (TicketBai_alta_1_0.xsd) es más simple que el de Bizkaia, y los códigos de error siguen la serie "A_" (por ejemplo, A_1001, A_2003). Si vienes de trabajar con el SII estatal, notarás que el esquema es más ligero.

Bizkaia: Batuz (TicketBAI + LROE)

Bizkaia es, sin rodeos, la provincia donde más trabajo vas a tener con la configuración. En la práctica, Batuz es el que más dudas genera porque no se limita a facturas: integra TicketBAI con el LROE (Libro Registro de Operaciones Económicas), lo que significa que también envías gastos, inversiones y otros asientos contables. La normativa de referencia es la Norma Foral 5/2020 y el Decreto Foral Normativo 12/2020.

¿Qué es LROE?

El Libro Registro de Operaciones Económicas (LROE) es un registro contable electrónico obligatorio en Bizkaia que reemplaza y extiende los libros tradicionales (IVA, facturas emitidas, facturas recibidas, bienes de inversión).

⚠️ Diferencia clave: En Álava y Gipuzkoa envías facturas directamente. En Bizkaia envías registros LROE que contienen TicketBAI.

Registro en Batuz (Bizkaia)

1. Accede a la sede electrónica: www.batuz.eus/es/inicio
2. Autentícate con certificado digital
3. Completa el censo Batuz: Indica actividades, establecimientos, régimen de IVA
4. Declara tu software garante: Si usas ef4ktur o desarrollo propio
5. Recibe el alta: Confirmación por email y en la sede

Configuración en ef4ktur (Bizkaia)

1. Descarga ef4ktur: www.ef4ktur.eus
2. Selecciona territorio: Bizkaia / Bizkaia
3. Configura certificado: Archivo .pfx + contraseña
4. Configura datos fiscales:
   • NIF, nombre, actividad
   • Importante: Indica si estás en régimen simplificado, recargo de equivalencia, etc.
5. Activa modo Batuz: Marca "Generar LROE (Bizkaia)"
6. Activa modo test: Marca "Entorno de pruebas"

Entorno de test (Bizkaia)

URL del servicio de pruebas: https://pruesarrerak.bizkaia.eus/N3B4000M/aurkezpena

Cómo hacer pruebas en Batuz

1. Genera una factura en ef4ktur (igual que en Álava)
2. ef4ktur envuelve el TicketBAI en LROE: El XML final contiene:
   • Factura TicketBAI (bloque <TicketBai>)
   • Registro LROE (capítulo 1.1)
3. Envía el fichero LROE al servidor de pruebas
4. Interpreta la respuesta:

✅ Consejo: Los códigos de error en Bizkaia empiezan con B4_. Consulta la tabla completa en la documentación oficial de Batuz.

Envío por lotes vs. tiempo real

Bizkaia permite dos modos de envío:

• Tiempo real: Envías cada factura inmediatamente (como Álava)
• Lotes: Agrupas varias facturas en un solo fichero LROE y las envías juntas

ef4ktur soporta ambos modos. En producción, el modo lote es útil para empresas con muchas operaciones diarias.

Paso a producción (Bizkaia)

1. Desactiva modo test
2. Cambia a URL de producción: https://sarrerak.bizkaia.eus
3. Envía facturas reales: Primera factura con <PrimerRegistro>S</PrimerRegistro> si empiezas la cadena
4. Verifica en tu área privada Batuz: Todas las facturas enviadas aparecen en tu libro LROE

Particularidades de Bizkaia

• Sistema dual: TicketBAI + LROE, lo que obliga a gestionar dos capas de XML
• Envío envuelto: El XML TicketBAI va encapsulado dentro del XML LROE, así que un error en cualquiera de las dos capas rechaza todo el envío
• Códigos B4_: Serie propia de errores (no confundir con los de Álava o Gipuzkoa)
• Plazos más flexibles: Dispones de 4 días hábiles para enviar facturas emitidas
• Envío por lotes: Puedes agrupar varias operaciones en un solo fichero, algo que las otras dos provincias no permiten

Gipuzkoa: TicketBAI directo con validaciones SII

Si ya has trabajado con el SII (Suministro Inmediato de Información) de la Agencia Tributaria estatal, Gipuzkoa te resultará familiar. Es TicketBAI puro -- sin LROE como Bizkaia -- pero con un sistema de validaciones y códigos de error que bebe directamente del SII. La normativa que lo regula es la Norma Foral 3/2020 y el Decreto Foral 6/2020.

Registro

El alta se tramita en la sede electrónica de Gipuzkoa (egoitza.gipuzkoa.eus). Busca "TicketBAI" en el buscador, autentícate con tu certificado digital y rellena el formulario con tus datos de censo, establecimientos y software. Una vez confirmado, recibirás un justificante.

Configuración en ef4ktur (Gipuzkoa)

1. Descarga e instala ef4ktur: www.ef4ktur.eus
2. Selecciona territorio: Gipuzkoa / Gipuzkoa
3. Configura certificado: Archivo .pfx
4. Datos del emisor: NIF, nombre, dirección
5. Activa modo test: Marca "Entorno de pruebas"

Entorno de test (Gipuzkoa)

URL del servicio de pruebas: https://tbai-prep.egoitza.gipuzkoa.eus

Cómo hacer pruebas

1. Genera factura en ef4ktur
2. Firma y envía al servidor de test
3. Interpreta respuesta:

✅ Nota: Gipuzkoa usa códigos numéricos simples (estilo SII), no serie "G_" como podrías esperar.

Estructura de respuesta (Gipuzkoa)

La respuesta incluye:

• CSV (Código Seguro de Verificación): Identificador único de la factura en Hacienda
• Fecha de registro
• Estado: Correcto / Aceptado con avisos / Rechazado

Guarda el CSV junto con el XML. Es tu justificante oficial.

Paso a producción (Gipuzkoa)

Cuando estés listo, desactiva el modo test y ef4ktur apuntará automáticamente a https://tbai.egoitza.gipuzkoa.eus. Para la primera factura de la cadena, deja PreviousHash vacío. Tras enviarla, consulta el estado en la sede electrónica para confirmar que todo ha ido bien.

Resumen de Gipuzkoa

Gipuzkoa usa códigos de error numéricos al estilo SII estatal, no series con prefijo como las otras provincias. En lugar de un número de registro, recibirás un CSV (Código Seguro de Verificación) alfanumérico como identificador de cada factura. El envío es siempre en tiempo real (no hay opción de lotes como en Bizkaia), y el XSD es algo menos restrictivo que el de Álava, lo que facilita la integración si tu software genera XMLs con ligeras variaciones de formato.

ef4ktur: instalación y uso avanzado

ef4ktur es la herramienta oficial y gratuita del Gobierno Vasco para generar XMLs TicketBAI. Es de código abierto y funciona en Windows, Linux y Mac.

Descarga e instalación

1. Descarga: www.ef4ktur.eus
2. Versiones disponibles:
   • Windows: Instalador .exe
   • Linux: Paquete .deb o AppImage
   • Mac: Aplicación .dmg
3. Instala siguiendo el asistente
4. Verifica instalación: Abre ef4ktur y comprueba la versión

Configuración detallada

1. Certificado digital

• Ve a Configuración > Certificado
• Selecciona tu archivo .pfx
• Introduce la contraseña
• ef4ktur validará el certificado

2. Datos del emisor

• NIF/CIF: Tu identificación fiscal
• Nombre o razón social
• Dirección del establecimiento:
  • Calle, número, piso
  • Código postal
  • Municipio, provincia

⚠️ Importante: La dirección debe coincidir exactamente con la que tienes en el censo de Hacienda Foral.

3. Territorio y entorno

• Territorio: Álava, Bizkaia o Gipuzkoa
• Entorno: Test o Producción
• LROE (solo Bizkaia): Activa si estás en Bizkaia

4. Configuración de la cadena de hash

ef4ktur gestiona automáticamente la cadena de hash entre facturas. Cada factura nueva incluye el hash de la anterior.

• Primera factura: PreviousHash vacío
• Siguientes facturas: ef4ktur calcula el hash automáticamente

✅ Consejo: Guarda todas tus facturas en la misma carpeta. ef4ktur lee la última para calcular el hash.

Generar y enviar una factura

1. Nueva factura: Haz clic en "Nueva factura"
2. Rellena datos:
   • Número de factura
   • Fecha de emisión
   • Cliente (NIF, nombre)
   • Líneas de detalle (descripción, cantidad, precio, IVA)
3. Revisa el total: ef4ktur calcula automáticamente base imponible + IVA
4. Genera XML: Botón "Generar TicketBAI"
5. Firma: ef4ktur firma con tu certificado
6. Envía: Botón "Enviar a TicketBAI"
7. Guarda respuesta: Descarga el XML de confirmación de Hacienda

Validación local con XSD

Antes de enviar, puedes validar tu XML localmente:

1. Descarga el XSD oficial:
   • Álava: TicketBai_alta_1_0.xsd
   • Bizkaia: LROE_PJ_240_1_1_FacturasEmitidas.xsd
   • Gipuzkoa: TicketBai_v1_0.xsd
2. Usa una herramienta de validación XML (online o local)
3. Corrige errores antes de enviar

Esto te ahorra reintentos y acelera el proceso.

Errores frecuentes y soluciones

1. Error de certificado (401 Unauthorized)

Causa: Certificado caducado, no válido o no instalado correctamente.

Solución:

• Verifica la fecha de caducidad del certificado
• Asegúrate de que está instalado en el almacén correcto
• Prueba a exportarlo e importarlo de nuevo
• Si es DNIe, actualiza los drivers

2. Error de validación XSD (400 Bad Request)

Causa: El XML generado no cumple el esquema XSD oficial.

Errores típicos:

• Falta un campo obligatorio (ej: dirección del establecimiento)
• Formato de fecha incorrecto (debe ser DD-MM-YYYY)
• NIF con formato inválido (ej: espacios o guiones)
• Importes con más de 2 decimales

Solución:

• Valida el XML localmente con el XSD oficial
• Revisa la documentación técnica de tu provincia
• Compara tu XML con un ejemplo oficial

3. Error de hash (código 3001 en Gipuzkoa, B4_1000050 en Bizkaia)

Causa: El hash de la factura anterior no coincide.

Solución:

• Verifica que estás enviando las facturas en orden cronológico
• Comprueba que no has saltado ninguna factura
• Si empiezas una nueva cadena, deja PreviousHash vacío
• Revisa que el hash calculado coincida con el de la factura anterior guardada

⚠️ Ojo con esto: Si rompes la cadena de hash, deberás enviar una factura de anulación y reiniciar la cadena. Conviene numerar las facturas con un sistema que no deje huecos (sin saltar números), porque facilita mucho la trazabilidad.

4. Factura duplicada (B4_2000001 en Bizkaia)

Causa: Ya enviaste una factura con el mismo número y fecha.

Solución:

• Verifica tus registros locales
• Consulta en tu área privada de Hacienda si ya se envió
• Si fue un error, genera una factura rectificativa para corregir

5. Error de NIF no censado (1001 en Gipuzkoa, B4_1000010 en Bizkaia)

Causa: Tu NIF no está dado de alta en el censo de TicketBAI.

Solución:

• Completa el alta en la sede electrónica de tu provincia
• Espera 24-48h para que se actualice el censo
• Verifica que el NIF en el XML coincida exactamente con el del censo (sin espacios ni guiones)

6. Error en dirección del establecimiento

Causa: La dirección en el XML no coincide con la del censo.

Solución:

• Consulta tu dirección exacta en la sede electrónica
• Copia el texto tal cual (incluidos acentos, mayúsculas, etc.)
• Si has cambiado de domicilio, actualiza primero el censo

Configuración en Facturian

Si usas Facturian (nuestro software de facturación), la configuración de TicketBAI es automática:

1. Ve a Configuración > Empresa
2. Marca la casilla "TicketBAI activo"
3. Selecciona tu provincia: Álava, Bizkaia o Gipuzkoa
4. Sube tu certificado digital: Archivo .pfx + contraseña
5. Verifica datos del establecimiento: Dirección, código postal
6. Guarda cambios

Facturian gestiona automáticamente:

• Generación de XMLs TicketBAI válidos
• Firma con tu certificado
• Envío a Hacienda (test o producción)
• Cadena de hash entre facturas
• Almacenamiento de respuestas oficiales
• QR TBAI en las facturas PDF

✅ Ventaja: No necesitas registrar Facturian como software garante. Ya está certificado en las tres provincias.

Comparativa entre provincias

Calendario de obligaciones

⚠️ Importante: Estas fechas son obligatorias. Si no cumples, te arriesgas a sanciones de entre 150 € y 10000 € según la gravedad.

Recursos y enlaces oficiales

Documentación oficial

• Álava: web.araba.eus/es/hacienda/ticketbai
• Bizkaia (Batuz): www.batuz.eus/es/inicio
• Gipuzkoa: www.gipuzkoa.eus/ticketbai

Herramientas

• ef4ktur (oficial): www.ef4ktur.eus
• IZENPE (certificados): www.izenpe.eus
• Facturian: www.facturian.com

XSDs oficiales

• Álava: Disponible en la sede electrónica
• Bizkaia: www.batuz.eus/es/inicio > Documentación técnica
• Gipuzkoa: Disponible en la sede electrónica

Soporte técnico

Conclusión

TicketBAI es obligatorio en todo el País Vasco, pero cada provincia tiene su propio sistema, sus URLs de test, sus códigos de error y sus particularidades técnicas. Lo más importante:

1. Obtén un certificado digital válido (preferiblemente IZENPE)
2. Date de alta en el censo de tu provincia antes de empezar
3. Usa el entorno de test para hacer todas las pruebas necesarias
4. Valida tus XMLs localmente antes de enviar a producción
5. Guarda todas las respuestas de Hacienda como justificantes

ef4ktur es una herramienta potente para pruebas y para empresas pequeñas, pero si facturas habitualmente, usa software comercial certificado como Facturian. Te ahorrará tiempo, dolores de cabeza y te asegurará el cumplimiento normativo sin complicaciones técnicas.

Referencias legales

• Norma Foral 13/2021, de 21 de abril, de Álava — Implantación de TicketBAI
• Decreto Foral 48/2021, de 7 de septiembre, de Álava — Reglamento TicketBAI
• Norma Foral 5/2020, de 15 de julio, de Bizkaia — Sistema Batuz
• Decreto Foral Normativo 12/2020, de 1 de septiembre, de Bizkaia — Desarrollo reglamentario Batuz
• Norma Foral 3/2020, de 6 de noviembre, de Gipuzkoa — TicketBAI
• Decreto Foral 6/2020, de 1 de diciembre, de Gipuzkoa — Desarrollo reglamentario TicketBAI
• Ley 58/2003, de 17 de diciembre, General Tributaria — Régimen sancionador

¿Tienes dudas sobre TicketBAI en tu provincia? Contacta con el soporte técnico de tu Diputación Foral o prueba Facturian con nuestro plan gratuito de 30 días.

Este artículo tiene carácter informativo y no constituye asesoramiento fiscal. Consulta con un profesional para tu situación particular.