Mientras estés conectado a SIGN ES, no tienes que preocuparte. En caso de pérdida de conexión con el servidor de la Agencia Tributaria española, SIGN ES implementa una verificación de disponibilidad del servicio Verifactu. La transmisión de registros de facturación continuará automáticamente cuando se restablece la conexión con el servicio.
Cualquier interrupción o problema de transmisión detectado por fiskaly se notificará a través de nuestra página de estado.
Nota: Indicamos automáticamente el campo incident como Sí si detectamos algún problema de desconexión en nuestra parte. La API de SIGN ES transmitirá los archivos XML tan pronto como se restablece la conexión con el servicio de la Agencia Tributaria.
Importante: El usuario del sistema POS debe ser notificado si hay un problema de conexión a Internet o un incidente que afecte a la transmisión a la API de SIGN ES. Lo ideal es que se muestre un mensaje en el POS indicando esta situación.
Si pierdes la conexión con nosotros
Aunque haya un problema de conexión, el contribuyente emitirá una factura al cliente, conservando una copia de la misma.
En caso de problemas de conexión a Internet en el sistema POS, el Reglamento Verifactu contempla la indicación de cualquier problema con la transmisión de facturas emitidas mediante un campo incident en la estructura XML creada.
En nuestra API de SIGN ES, el campo incident forma parte de las annotations al crear una nueva factura. En cuanto se solucione el problema de conectividad, las facturas emitidas deben introducirse a través del software de la API de SIGN ES de forma correlativa e incluyendo este campo incident.
Ten en cuenta que en ninguna circunstancia se puede emitir una factura sin que sea transmitida a la API de SIGN ES.
¿Cómo generar el código QR sin conexión?
Importante: Mientras la API de SIGN ES de fiskaly esté disponible, debes imprimir las facturas utilizando la URL proporcionada en la respuesta de creación de facturas. Este procedimiento solo es aplicable para casos sin conexión.
De acuerdo con la regulación Verifactu, todas las facturas deben contener un código QR de Verifactu. Para generar el código QR de las facturas emitidas sin conexión, te proporcionamos el siguiente fragmento de pseudocódigo que muestra un posible flujo de implementación:
GET base_url, nif, number, series, date, total_amount
IF series IS NOT EMPTY:
SET series_number = CONCAT series, number
ELSE:
SET series_number = number
SET date_string = DATE_FORMAT date AS "DD-MM-YYYY"
SET url_format = "$1?nif=$2&numserie=$3&fecha=$4&importe=$5"
SET url = FORMAT url_format WITH $1 = base_url, $2 = nif, $3 = series_number, $4 = date_string, $5 = total_amount
SET encoded_url = UTF-8_ENCODE urlAl generar la URL deben tenerse en cuenta los siguientes aspectos:
- La URL debe mantener el orden en que se proporcionan los parámetros:
- URL base
- La URL base para el entorno de PRUEBA es: https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR
- La URL base para el entorno de PRODUCCIÓN es: https://www2.agenciatributaria.gob.es/wlpl/TIKE-CONT/ValidarQR
- NIF del contribuyente
- En la API de SIGN ES, esto corresponde al campo
Crear contribuyente > content > issuer > tax_number.
- En la API de SIGN ES, esto corresponde al campo
- Serie y número de factura
- En la API de SIGN ES, esto corresponde a los campos
Crear una factura > content > seriesyCrear una factura > content > number, que se concatenan sin espacios ni caracteres intermedios. Si la factura no tiene serie, solo se utiliza el número.
- En la API de SIGN ES, esto corresponde a los campos
- Importa total de la factura
- En la API de SIGN ES, esto corresponde al campo
Crear una factura > content > full_amount, que debe redondearse a 2 decimales (p. ej., “121.00” y no “121”).
- En la API de SIGN ES, esto corresponde al campo
- URL base
- Todos los caracteres especiales deben estar codificados en UTF-8.
- No debe haber espacios en blanco dentro de la URL.
Advertencia: Esto debe verificarse minuciosamente durante la implementación y utilizando el entorno de PRUEBA, con el fin de evitar discrepancias entre la URL generada en escenarios sin conexión y la URL que fiskaly genera cuando el sistema vuelve a estar en línea.
En nuestro artículo sobre la generación del código QR offline para Verifactu encontrarás ejemplos que te ayudarán a probar esta implementación.
El código QR impreso en facturas sin conexión debe seguir las mismas directrices que el impreso en facturas en línea, incluido el texto conforme VERI*FACTU. Para más información, consulta nuestra guía sobre Conformidad de facturas Verifactu.