¿Quién está obligado a usar TicketBAI en Gipuzkoa?
Están obligados todos los contribuyentes que ejerzan actividades económicas en Gipuzkoa sujetas al IRPF o al Impuesto sobre Sociedades. No hay umbral mínimo de facturación: desde el primer euro, la obligación existe.
Esto incluye, sin excepción:
- Comercio electrónico (Shopify, WooCommerce, Etsy, Amazon…)
- Tiendas físicas con punto de venta
- Profesionales liberales (abogados, arquitectos, consultores)
- Hostelería y restauración
- Servicios digitales prestados desde Gipuzkoa
El incumplimiento puede conllevar sanciones económicas y la imposibilidad de acreditar ingresos ante Hacienda Foral de Gipuzkoa.
¿Qué tiene que llevar una factura TicketBAI?
Cada factura TicketBAI tiene cuatro componentes técnicos obligatorios. Su ausencia o incorrecta implementación invalida la factura ante Hacienda.
XML TicketBAI v1.2
El documento debe generarse conforme al esquema XSD oficial de Gipuzkoa v1.2. Incluye NIF del emisor, serie y número de factura, importes, tipo de IVA y datos del receptor cuando corresponde.
Firma XAdES-EPES
El XML debe firmarse digitalmente con el certificado P12 del titular del negocio, usando el algoritmo RSA-SHA256. La firma garantiza autenticidad e integridad.
Encadenamiento SHA-256
Cada factura incluye la huella criptográfica de la factura anterior de la misma serie. Esto crea una cadena inmutable que impide eliminar o modificar facturas pasadas.
Código QR Art. 8
Se genera un código QR con los datos de la factura codificados en la URL de verificación de Hacienda. Permite a cualquier persona verificar la autenticidad de la factura.
¿Qué es la firma XAdES-EPES?
XAdES-EPES (XML Advanced Electronic Signatures — Explicit Policy) es el estándar europeo de firma electrónica avanzada que TicketBAI exige. Es más estricto que una firma electrónica ordinaria: vincula la firma a una política de firma específica definida por Hacienda.
Una factura firmada con XAdES-EPES:
- No puede modificarse sin invalidar la firma — cualquier alteración del XML es detectable
- Identifica inequívocamente al emisor mediante su certificado P12
- Es verificable por Hacienda Foral mediante el endpoint oficial de validación
- Tiene validez legal equivalente a una firma manuscrita ante la Administración
El certificado P12 habitual en Gipuzkoa está emitido por Izenpe, la autoridad de certificación del Gobierno Vasco, aunque son válidos certificados de otras CAs reconocidas. La clave privada del certificado nunca abandona el entorno seguro del software garante.
La figura del Colaborador Social. La normativa TicketBAI contempla la figura del Colaborador Social: un tercero autorizado por la Hacienda Foral para firmar y remitir facturas en nombre y por cuenta del obligado tributario. ShopiBai opera bajo esta figura en Gipuzkoa, de modo que el negocio no necesita obtener ni gestionar su propio certificado de dispositivo. El obligado solo firma una autorización de envío y acepta el dispositivo de ShopiBai en su TicketBAI Ataria tras la primera factura, dentro del plazo de un mes que establece Hacienda.
¿Qué es el encadenamiento de facturas?
El encadenamiento es el mecanismo anti-fraude más importante de TicketBAI. Cada factura incluye en su XML la huella SHA-256 de la factura inmediatamente anterior de la misma serie. Esto crea una cadena criptográfica continua e inmutable.
Factura A-0002 → incluye hash₁ → hash₂
Factura A-0003 → incluye hash₂ → hash₃
↑ Cualquier alteración rompe la cadena
Si se elimina, inserta o modifica una factura de la cadena, el hash de la siguiente no coincide y Hacienda puede detectarlo. Por esto el orden de emisión de facturas es legalmente crítico y no puede alterarse retroactivamente.
¿Cómo funciona TicketBAI con una tienda Shopify?
Cada pedido pagado en Shopify genera la obligación de emitir una factura TicketBAI. El proceso técnico completo, si se hiciera a mano, requeriría:
- 01Recibir la notificación de pago de Shopify
- 02Extraer los datos fiscales del pedido
- 03Generar el XML conforme al esquema XSD v1.2 de Gipuzkoa
- 04Firmar el XML con el certificado P12 del negocio (XAdES-EPES, RSA-SHA256)
- 05Calcular la huella SHA-256 de la factura anterior y encadenarla
- 06Enviar el XML firmado al endpoint de Hacienda (`tbai.egoitza.gipuzkoa.eus`)
- 07Registrar el resultado (ACCEPTED / REJECTED) y generar el QR Art. 8
Para una tienda con 20 pedidos diarios, esto supone 140 operaciones manuales a la semana. ShopiBai automatiza los 7 pasos en menos de 3 segundos desde que se paga el pedido, sin intervención manual.
Instalación llave en mano
ShopiBai se encarga de todo
Certificado P12, firma XAdES-EPES, encadenamiento, pruebas contra Hacienda Foral y activación en producción. Todo en menos de 24 horas, sin que toques una sola línea de código.
Solicitar instalación