Certificado Electrónico
Estamos trabajando en mejoras para optimizar la gestión de certificados de TicketBAI. Esta página se irá actualizando en los próximos días.
Si estás integrando la API en este momento y necesitas activar contribuyentes en alguna provincia del País Vasco, te recomendamos contactar con nuestros especialistas (equipo@fiskaly.com), quienes te guiarán para que el proceso sea lo más sencillo posible.
Para cumplir con TicketBAI, el sistema de facturación o TPV debe estar equipado con un software que genere ficheros XML para cada transacción, los firme con un certificado digital y los envíe a la Hacienda Foral correspondiente.
La firma de los archivos TicketBAI se realiza en el componente de firma de SIGN ES API.
Cada factura será encadenada a la anterior y la firma digital garantiza que no se pueda manipular la información. Para esto, se requiere un certificado digital provisto por un Proveedor de Servicio Confiable (eIDAS QTSP).
La legislación que establece TicketBAI permite utilizar los siguientes tipos de certificados digitales:
- Certificado de dispositivo
- Certificado de persona física o representante de entidad
- Sello de entidad
- Certificado de autónomo
¿Por qué el certificado de dispositivo de fiskaly?
En fiskaly, decidimos implementar un certificado de dispositivo porque presenta múltiples ventajas:
- Fue creado exclusivamente para TicketBAI. No permite ver ni realizar otros trámites del contribuyente en conexión con la Hacienda Tributaria.
- El contribuyente no debe brindar su propio certificado, cuya información es privada.
- Se puede utilizar el mismo certificado para firmar y enviar los ficheros TicketBAI.
SIGN ES API de fiskaly utiliza un certificado de dispositivo exclusivo para TicketBAI provisto por Izenpe. Este certificado está contenido por cada objeto del tipo firmante, pero debe estar asociado al NIF del contribuyente en la Hacienda Foral.
Utilizar el certificado de dispositivo de fiskaly para crear firmantes te permite cumplir con la normativa, ¡sin esfuerzo adicional!
¿Cómo registro el certificado de dispositivo?
Para enviar los ficheros TicketBAI a las Haciendas Forales utilizando un certificado de dispositivo, el mismo debe estar asociado al NIF del contribuyente que emite las facturas. Esto se realiza mediante un proceso sencillo en la página web de la Hacienda Foral correspondiente:
El registro del certificado del dispositivo en Araba y en Bizkaia tiene que realizarse antes de que el dispositivo comience a emitir facturas a nombre del contribuyente, proporcionando el número de serie del certificado del dispositivo.
El registro del certificado del dispositivo en Gipuzkoa tiene que realizarse después de que se haya emitido la primera factura, aceptando el certificado.
Para realizar este registro, el contribuyente debe ingresar con su certificado digital personal en el sitio web de la hacienda foral. Una vez ha ingresado, se debe informar el Número de serie del certificado de dispositivo que fiskaly o el proveedor del TPV brindará.
El número de serie del certificado de dispositivo se obtiene desde la API SIGN ES utilizando el endpoint Retrieve a signer. El contenido de la respuesta provee la información del certificado, en donde se indica el número de serie (serial_number) del certificado de dispositivo de TicketBAI.
El NIF indicado debe estar asociado al certificado de dispositivo utilizado. Si el contribuyente no realiza el registro del certificado de dispositivo, entonces el envío obligatorio de archivos TicketBAI a la Hacienda Foral resultará en rechazo. Este registro es el único paso que debe realizar el contribuyente.
Debido al tipo de certificado utilizado, la normativa TicketBAI no permite la emisión de facturas por tercero o por destinatario. Solo se podrán emitir facturas en nombre del contribuyente indicado en el componente de firma.