Para cumplir con TicketBAI, el sistema de facturación o TPV debe estar equipado con un software que genera un fichero XML para cada transacción, lo firme con un certificado electrónico y lo envía a la Autoridad Tributaria correspondiente.
La firma de los ficheros TicketBAI se lleva a cabo en el componente de firma de la API SIGN ES.
Cada factura se encadenará a la anterior y la firma digital garantiza que la información no sea manipulada.
La API SIGN ES utiliza un certificado electrónico gestionado por fiskaly para firmar y enviar todos los ficheros XML de TicketBAI en nombre del contribuyente.
¿Por qué usar el certificado de fiskaly?
Sección titulada «¿Por qué usar el certificado de fiskaly?»En fiskaly, hemos decidido utilizar nuestro propio certificado electrónico debido a sus múltiples ventajas:
- Está completamente gestionado por fiskaly, por lo que no tienes que preocuparte por las fechas de vencimiento ni la renovación.
- El contribuyente no tiene que proporcionar su propio certificado privado.
- La firma y el envío de los ficheros TicketBAI se pueden realizar con el mismo certificado, ya que fiskaly es colaborador social de las Autoridades Tributarias de los tres territorios del País Vasco: Álava, Bizkaia y Gipuzkoa.
¡El uso del certificado electrónico de fiskaly para la creación del firmante te permite cumplir sin ningún esfuerzo adicional!
Acuerdo de colaboración social entre fiskaly y el contribuyente
Sección titulada «Acuerdo de colaboración social entre fiskaly y el contribuyente»Como parte del proceso de integración, es necesario implementar los endpoints correspondientes a la generación y carga del acuerdo de colaboración social entre fiskaly y el contribuyente.
A través del endpoint Generar acuerdo, proporcionarás toda la información necesaria para que fiskaly genere el acuerdo. La información requerida varía según si el contribuyente es una EMPRESA o un AUTÓNOMO.
- Para un AUTÓNOMO (p. ej., trabajador por cuenta propia), toda la información se proporciona a través del endpoint Crear contribuyente, donde se necesitan
legal_name,tax_numberyaddressdel emisor. No se utiliza información adicional del endpoint Generar acuerdo. - Para una EMPRESA, debes proporcionar:
legal_name,tax_numberyaddressdel endpoint Crear contribuyente- Información del representante de la empresa (
full_name,tax_numberyaddress) según se requiere en el endpoint Generar acuerdo.
Como respuesta satisfactoria, obtendrás el PDF, que debe ser firmado por el contribuyente.
El acuerdo debe ser firmado por el contribuyente utilizando cualquier firma digital válida. Para empresas, será la firma del representante legal y, para los autónomos, la firma de la persona física.
Una vez que el documento esté firmado digitalmente, SIGN ES requiere que lo proporciones como documento PDF codificado en Base-64 a través del endpoint Cargar acuerdo firmado.