TicketBAI - Synapsis

Introducción

TicketBai es una estrategia de control y asistencia en el cumplimiento de sus obligaciones tributarias de todas las personas y entidades que desarrollen actividades economicas sujetas en conjunto a la normativa de todas las haciendas vascas con independencia de su naturaleza y tamaño.

TicketBai está compuesto por tres elementos:

El software garante de facturación denominado TicketBai.
La obligación de llevanza de los libros registro de operaciones económicas (LROE) a través de la Sede electrónica de la Diputación Foral de las haciendas vascas.
- Para los contribuyentes obligados al suministro de información inmediata a efectos del IVA (en adelante, SII), estos LROE integrarán la información y obligaciones del SII.
Y la asistencia al contribuyente en el cumplimiento de sus obligaciones tributarias, mediante la puesta a su disposición por parte de la Hacienda Foral de las haciendas vascas de borradores de las declaraciones de IRPFS, IS e IVA.

TicketBai será obligatorio para los periodos que se inicien a partir del 1 de Enero de 2024.

Esquema Global

A continuación mostramos una representación visual detallada de la estructura de TicketBai y sus componentes principales. Este esquema proporciona una visión genérica de cómo se integran las distintas partes para formar un sistema funcional y eficiente.

El producto se compone de varios módulos clave, cada uno desempeñando un papel fundamental en su funcionamiento a nivel global.

Procesos

Proceso de Firma

Este proceso utiliza XAdES (XML Advanced ELectronic Signatures) es un estandar de firma electronica, se utiliza para firmar documentos XML utilizando el estandar de firma digital XMLDSig.

Proceso generación de QR

Este proceso genera un código QR en base a un enlace, dicho enlace es el que luego también puede ser utilizado para visualizar todas las facturas generadas en los sistemas de la AT (Agencia Tributaria).

Proceso de envío a Vizcaya

Este proceso se envía a través de LROE, un LROE es una envoltura o wrapper que engloba todo tipo de envíos). Este proceso se envía por paquetes, es decir muchos envíos en uno.

Proceso de envío a Guipúzcoa/Álava

Este proceso se envía a través de envío de facturas normales, en este tipo de casos solo se pueden enviar tanto envíos de altas como de bajas, pero nunca concilias.

Proceso de generación de QRFirma

Este proceso unifica los procesos mencionados anteriormente, el proceso de Firma y el proceso de QR en un único proceso.

Proceso de Zuzendu

Este proceso sirve para enviar nuevamente tanto facturas erronéas como facturas ya enviadas en las que se quiera hacer algún tipo de modificacion en ellas.

Objeto de envío y respuesta

En este apartado hablaremos sobre la composición de los objetos tanto de envío como de respuesta y explicaremos las diferentes configuraciones que encontraremos dentro de ellos.

En primer lugar tenemos el objeto de envío, aquí encontraremos los siguientes apartados:

TCIHeaders: En este apartado encontramos los datos de configuración de Synapsis.
etiqueta: Nombre del fichero dentro de nuestro sistema.
tipoDocumento: Este apartado especifica el tipo de documento a enviar.
agencia: En este bloque indica la agencia a la que se está enviando.
payload: En este bloque encontramos de forma encriptada todos los datos que se envian a la AT.
bloqueStatus: Este apartado en el envío va vacío, por eso vemos que es un campo opcional, no tiene que ser rellenado obligatoriamente.

En segundo lugar tenemos el objeto de respuesta, este objeto en cuanto a estructura es igual que el de envío, simplemente cambia el payload y el bloqueStatus, estos son sus apartados:

TCIHeaders: En este apartado encontramos los datos de configuración de Synapsis.
etiqueta: Nombre del fichero dentro de nuestro sistema.
tipoDocumento: Este apartado especifica el tipo de documento enviado.
agencia: En este bloque indica la agencia a la que se ha enviado.
payload: En este apartado encontramos de forma encriptada la respuesta que recibimos por parte de la AT.
bloquestatus: En este bloque encontramos la info de como ha ido el envío y en el caso de que se hubiera dado un error, nos informaría de cual es.