Documentación técnica - araba
AVISO: El día 24/05/2026 a partir de las 16:30 no va a estar disponible el sistema TicketBAI debido a labores de mantenimiento. Se reanudará lo antes posible. El tiempo de corte del servicio está estimado en dos horas.
Documentación técnica
TicketBAI: Alta y anulación de facturas
| Esquemas de archivos XSD de envío y anulación 1.2.2 (ZIP) |
| Validaciones fichero de Alta TicketBAI (15/12/2025) |
| Validaciones fichero de Anulación TicketBAI (15/12/2025) |
| Comunicación a desarrolladores de software |
| Guía entorno pruebas TicketBAI |
| Ejemplos de XML (ZIP) |
| > Alta de facturas: https://ticketbai.araba.eus/TicketBAI/v1/facturas/ |
| > Anulación de facturas: https://ticketbai.araba.eus/TicketBAI/v1/anulaciones/ |
| > La URL que debe indicarse en la generación de los códigos QR es la siguiente: https://ticketbai.araba.eus/tbai/qrtbai/ |
| Especificaciones de la firma electrónica de los ficheros TicketBAI (06/05/2022) |
| > Política de firma: https://ticketbai.araba.eus/tbai/sinadura/ |
| > Hash de la política de Firma: 4Vk3uExj7tGn9DyUCPDsV9HRmK6KZfYdRiW3StOjcQA= |
Zuzendu: Subsanación y modificación de facturas
Osatu: Completar datos de facturas
| Esquema de archivos XSD de OSATU 1.2.2 (ZIP) |
| Validaciones del fichero OSATU (02/01/2023) |
| Guía pruebas de OSATU |
| > Osatu: https://ticketbai.araba.eus/TicketBAI/v1/osatu/ |
Kontsultak: Consulta del estado de las facturas.
| Esquema de archivos XSD de Kontsulta 1.2.3. (ZIP) |
| Validaciones de los ficheros Kontsulta (07/05/2025) |
| Guía de pruebas de Kontsulta |
| Ejemplos de XML (ZIP) |
| > Kontsultak-Facturas enviadas: https://ticketbai.araba.eus/TicketBAIConsultas/v1/facturaspaginadas/ |
| > Kontsultak-Última factura: https://ticketbai.araba.eus/TicketBAIConsultas/v1/ultimafactura |
Enlaces al entorno de pruebas
| FakturAraba - Versión PRUEBAS |
| Registro de certificados de dispositivo - Versión PRUEBAS |
| Consulta de facturas enviadas - Versión PRUEBAS |
Preguntas frecuentes
Normativa
- Norma Foral 13/2021, de 21 de abril, por la que se establece la obligación de utilizar herramientas tecnológicas.
- Decreto Foral 48/2021, del Consejo del Gobierno Foral de 5 de octubre, por el que se aprueba el Reglamento que desarrolla la obligación TicketBAI.
- Decreto Foral 52/2021, del Consejo de Gobierno Foral de 23 de noviembre, que modifica la representación voluntaria ante la Hacienda Foral de Álava, estableciendo el nivel de representación 2-d para el cumplimiento material de la obligación TicketBAI, así como para el envío y consulta de los registros del SII y del SILICIE.
- Orden Foral 802/2021, de la Primera Teniente de Diputado General y Diputada Foral de Hacienda, Finanzas y Presupuestos, de 27 de diciembre. Regulación de las especificaciones técnicas y funcionales del software TicketBAI y de la declaración de alta en el Registro de Software TicketBAI.
- Anexo V: Especificaciones del código TicketBAI y del código QR de las facturas o justificantes generados por el software TicketBAI.
- Norma Foral 34/2021, de 23 de diciembre, por la que se adoptan medidas para el impulso de la reactivación económica, para la aplicación del TicketBAI y otras medidas tributarias.
- Orden Foral 260/2022, de la Primera Teniente de Diputado General y Diputada Foral de Hacienda, Finanzas y Presupuestos, de 6 de mayo. Aprobar la regulación de los requisitos de los servicios, el procedimiento y las especificaciones técnicas y funcionales, para la subsanación de los ficheros TicketBAI.
- Orden Foral 774/2022, de la Diputada de Hacienda, Finanzas y Presupuestos, de 23 de diciembre. Aprobar la regulación de las especialidades en el cumplimiento del suministro inmediato de información para contribuyentes sujetos a la obligación TicketBAI y otras formas especiales de envío de los ficheros TicketBAI en determinados supuestos excepcionales.
- Orden Foral 714/2023, de la Segunda teniente de Diputado General y Diputada Foral del Departamento de Hacienda, Finanzas y Presupuestos, de 3 de noviembre. Aprobar la modificación de la Orden Foral 260/2022, de 6 de mayo, y de la Orden Foral 774/2022, de 23 de diciembre, en lo referente al diseño del fichero de alta TicketBAI.
Contacto
La Hacienda Foral de Álava ha habilitado un servicio de Atención a la Ciudadanía para resolver las dudas referentes a TicketBAI.
Puede llamar al 945 56 90 28 o enviarnos su consulta en el siguiente formulario.
