Documentación y normativa

Documentación

Guía rápida TicketBAI (PDF)

Servicio TicketBAI

• OF 521/2020 (PDF)
• Anexo I: Estructura y validaciones del  fichero de alta TicketBAI (PDF)
• Anexo II: Estructura y validaciones del fichero de anulación TicketBAI (PDF)
• Anexo III: Especificaciones de la firma electrónica de los ficheros de alta y de anulación de operación con software TicketBAI (PDF)
  • La firma electrónica de los ficheros de alta y anulación debe incluir el identificador https://www.gipuzkoa.eus/ticketbai/sinadura y su correspondiente Hash SHA256 vSe1CH7eAFVkGN0X2Y7Nl9XGUoBnziDA5BGUSsyt8mg=
• Anexo IV: Especificaciones técnicas y funcionales, y requisitos del envío de los ficheros TicketBAI (PDF)
• Anexo V: Especificaciones del código identificativo y del código QR de las factura o justificantes generados por el software TicketBAI (PDF)
• Esquemas de archivos XSD de envío y anulación (ZIP)
• Listado de validaciones y errores del fichero de alta TicketBAI (PDF) Actualizado a 07-11-2024
• Listado de validaciones y errores del fichero de anulación TicketBAI (PDF) Actualizado a 07-11-2024

Servicio Zuzendu

• OF 16/2022 (PDF)
• Anexo I Zuzendu: requisitos de los servicios zuzendu, procedimiento y especificaciones técnicas y funcionales para la subsanación y modificación de los ficheros TicketBAI (PDF)
• Listado de validaciones y errores del fichero de SUBSANACIÓN del servicio Zuzendu ALTA  (PDF) Actualizado a 07-11-2024
• Listado de validaciones y errores del fichero de MODIFICACIÓN del servicio Zuzendu ALTA (PDF) Actualizado a 07-11-2024
• Listado de validaciones y errores del fichero de SUBSANACIÓN del servicio Zuzendu ANULACIÓN (PDF). Actualizado a 07-11-2024
• Diagrama del Servicio ZUZENDU (PDF).
• Esquemas de archivos XSD de envío y anulación ZUZENDU (ZIP).

Servicio OSATU

• OF 330/2022 (PDF)
• Anexo: estructura y validaciones del fichero OSATU (PDF)
• Listado de validaciones y errores OSATU (PDF) Actualizado a 07-11-2024
• Requisitos del servicio OSATU, procedimiento y especificaciones técnicas y funcionales para el envío del fichero OSATU (PDF)
• Esquemas de archivos XSD OSATU (ZIP)

Versiones anteriores

Entorno de pruebas

• Guía de entorno de pruebas TicketBAI (PDF)
• FAQs para desarrolladores TicketBAI (PDF)
• KONTSULTA: Nuevo servicio REST para la consulta del estado de las facturas envidas a TicketBAI (PDF)
  • Kontsulta XML (ZIP)
  • Kontsulta XSD (ZIP)

Recursos lingüísticos

• Plantilla TicketBAI (XLS)
• Plantilla TicketBAI (PDF)

Normativa

• Obligación TicketBAI
  • Colaboración social:
    • Documento de adhesión al acuerdo de colaboración para el envío de los ficheros TicketBAI de terceros (PDF)
    • Autorización para el envío de ficheros TicketBAI (PDF)
• Obligaciones de facturación