El siguiente artículo hace referencia a la funcionalidad que permite la firmas electrónica de facturas de venta mediante la API de Fiskaly. Para poder utilizar esta funcionalidad debes tener contratado el módulo, puedes consultar mas detalles escribiéndonos a peticiones@doblemente.com

Índice de contenido

• Introducción
• Configuración
  • Formulario de configuración
  • Filtro de series de facturación
• Cómo se firma una factura
  • QR y texto tributario
• Detalles de la firma de factura
• Estados de registro de una factura
  • Estados de registro de una factura
  • Cómo actualizar el estado de registro
• Logs de la firma de factura

Introducción

La integración de Dispongo con Fiskaly permite enviar los datos de las facturas de venta a la API Fiskaly "SIGN ES", la cual genera una firma digital que garantiza el cumplimiento de las normativas fiscales españolas como Verifactu y TicketBAI

Estas normativas requieren que las facturas de venta incluyan un código QR, mediante el cual es posible acceder al portal oficial de validación de la hacienda. Esto facilita al receptor comprobar la autenticidad del documento, así como consultar la información esencial tanto del emisor como del receptor.

Configuración

La configuración de Fiskaly se realiza durante el proceso de alta, que consiste en registrar en la API de Fiskaly las empresas asociadas a la licencia de Dispongo.

Al completar este registro, se generan las credenciales de acceso a la API para cada empresa, compuestas por la API Key y el API Secret y se configuran en Dispongo.

Un aspecto relevante es el campo Territory, que define el domicilio fiscal de la empresa. Este valor determina qué normativa aplicará Fiskaly al momento de firmar cada factura: Verifactu vs. TicketBAI: diferencias clave en la implementación

Formulario de configuración

El formulario de configuración de la firma de facturas se encuentra en el menú:
Administración >> Facturación >> Firma de factura.

Ejemplo de configuración de un entorno de test

Dentro de esta sección, se muestra una opción para configurar el entorno de firmas a través de la API de Fiskaly, así como un apartado de configuración específico para cada empresa en la que se requiera la firma digital de facturas.

Dentro del detalle de configuración de una empresa encontrar los siguientes campos:

• Activo: activa o desactiva la firma de factura
• Nombre: texto libre para identificar la configuración por empresa
• Empresa: empresa en Dispongo a la que se aplica la configuración
• Clave API y Secreto API: datos obtenidos al dar de alta la empresa en el entorno de fiskaly y que permitirán la conexión a su API
• SignerID y ClientID: estos datos se obtienen tras la activación de la configuración y se bloquean para no permitir modificarlos.
• Territory: indicar un valor en función del domicilio fiscal de la empresa gestionada.

Filtro de series de facturación

Disponemos de la opción de poder aplicar un filtro sobre las facturas que queremos filtrar por su serie de facturación. Si es el caso, indicaremos las series de facturación a excluir en el filtro de series de factura al pie del formulario de configuración:

Como se firma una factura

El proceso de firma de facturas se ejecuta automáticamente al finalizar la facturación de una reserva, por lo que resulta transparente para el usuario.

Una vez completada la firma electrónica, al acceder al formulario de la factura podrás ver:

• Una leyenda con el estado “FIRMADA”.

• El historial de llamadas realizadas a la API.

• Un nuevo acceso en el menú para consultar los detalles del proceso de firma.

QR y texto tributario

Como resultado del proceso de firma electrónica, el documento de factura mostrará un código QR mediante el cual el cliente de la factura puede acceder al portal oficial de validación de la hacienda.

La disposición de este QR variar en función de la normativa que se aplique: Verifactu o TickeBAI

Una factura que aplique la normativa con TIKETBAI mostrará el QR al pie de página

Detalles de la firma de factura

Dentro del formulario de una factura firmada, al acceder al detalle de firma se muestra la siguiente información:

Este formulario muestra la información generada durante el proceso de firma.
Entre todos los datos, es importante destacar el campo “Estado de registro”, que indica la situación de la factura en la autoridad tributaria.

Para facilitar el proceso de venta, Fiskaly no envía la factura de forma inmediata. En su lugar, la marca con el estado Pendiente (“PENDING”) y realiza el envío a Hacienda más adelante de forma asíncrona.

Por este motivo, es necesario actualizar el estado de registro de la factura para conocer el estado final del proceso de firma.

Estados de registro de una factura

Estos son los posibles estados de registro que podemos obtener en el proceso de firma de una factura con Fiskaly:

• INVALID: no ha sido posible procesar la factura
• PENDING: la solicitud de registro está pendiente de ser procesada por la autoridad tributaria
• REGISTERED: el registro en el servidor de la autoridad tributaria se ha realizado correctamente
• REQUIRES_CORRECTION: la factura ha sido registrada con los servicios tributarios pero se han detectado errores que requieren una corrección
• REQUIRES_INSPECTION: la factura ha sido rechazada por los servicios tributarios con errores que requieren inspección
• STORED: La factura ha sido almacenada por la entidad de firma pero está pendiente de ser enviada a los servidores de la autoridad tributaria    

Cómo actualizar el estado de registro

Disponemos de dos formas distintas de realizar la actualización del estado de registro de las facturas firmadas por fiskaly:

Desde el formulario de factura de venta

Podemos actualizar el estado de registro de firma de una factura de venta desde el formulario de detalles de la firma.

Esta opción nos servirá cuando necesitemos actualizar el estado de registro de una factura en concreto o de la factura de venta que tenemos en edición.

Para actualizar el estado pulsaremos el botón "Actualizar" que se encuentra junto al campo "Estado de registro"

Desde el listado de facturas

Desde el listado de facturas podemos consultar y actualizar de forma masiva el estado de registro de la firma de factura.

Para hacer la actualización seguiremos los siguientes pasos:

1. Configuramos el valor en los los filtros y ejecutamos la consulta para obtener una lista de facturas.

2. En la misma consulta antes de los datos del cliente obtendremos el tipo de normativa utilizado para firma la factura y el estado de registro de cada una de ellas.

3. Para actualizar el estado seleccionaremos las facturas que queremos actualizar y ejecutamos el proceso "Actualizar estado de firma" desde el menú acciones.

Si queremos seleccionar todas las facturas disponemos de la opción "Seleccionar todas" en la parte superior derecha del menú del listado de facturas.

Logs de la firma de factura

Todas las llamadas a la API de Fiskaly quedan registradas en una tabla de logs. 

Este registro de llamadas las podemos consultar desde el formulario de la factura en el detalle "Histórico de firmas" al pie del formulario.

O también desde el formulario de configuración de la firma por empresa obteniendo los registros de todos los métodos y facturas que se realizan