Saltar al contenido principal

Pérdida de conexión

Mientras estés conectado a SIGN ES, no tienes de qué 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 los registros de facturación continuará automáticamente cuando se restablezca la conexión con el servicio.

Cualquier interrupción o problema de transmisión detectado por fiskaly será notificado a través de nuestro Status page.

nota

Indicamos automáticamente el campo incident como Sí si detectamos problemas de desconexión en nuestro sistema. La API SIGN ES transmitirá los archivos XML tan pronto como se restablezca la conexión con el servicio de la Agencia Tributaria.

importante

El usuario del sistema TPV debe ser notificado si existe un problema de conexión a internet o un incidente que afecte la transmisión a la API de SIGN ES. Idealmente, se debe mostrar un mensaje en el TPV indicando esta situación.

Si pierdes la conexión con nosotros​

Incluso si hay un problema de conexión, el contribuyente debe emitir una factura para el cliente y conservar una copia de la misma.

En caso de problemas de conexión a Internet en el sistema POS, la normativa Verifactu contempla la indicación de cualquier problema con la transmisión de facturas emitidas mediante el campo incident en la estructura del archivo XML creado.

En nuestra API SIGN ES, el campo incident forma parte de las anotaciones (annotations) al crear una nueva factura. Una vez resuelto el problema de conectividad, las facturas emitidas deben introducirse en el software de la API SIGN ES de forma correlativa, incluyendo este campo incident.

Ten en cuenta que bajo ninguna circunstancia se puede emitir una factura sin que haya sido transmitida a la API SIGN ES.

¿Cómo generar el código QR offline?​

importante

Siempre que la API SIGN ES de fiskaly esté disponible, las facturas deben imprimirse utilizando la URL proporcionada en la respuesta de creación de factura. Este procedimiento solo debe aplicarse en casos offline.

De acuerdo con la normativa de Verifactu, todas las facturas deben contener un código QR Verifactu. Para generar el código QR en facturas emitidas en modo offline, 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 url

Debes tener en cuenta los siguientes aspectos al generar la URL:

  • La URL debe mantener el orden en el que se proporcionan los parámetros:

    • Base URL

    • NIF del emisor

      • En la API SIGN ES, esto corresponde al campo Crear contribuyente > content > issuer > tax_number .

    • Serie y número de factura

      • En la API SIGN ES, esto corresponde a los campos Crear factura > content > series y Crear factura > content > number , los cuales deben concatenarse sin espacios ni caracteres intermedios. Si la factura no tiene serie, se utiliza solo el número.

    • Importe total de la factura

      • En la API SIGN ES, esto corresponde al campo Crear factura > content > full_amount , el cual debe estar redondeado a dos decimales (Ej.: “121.00” y no “121”).

  • Todos los caracteres especiales deben estar codificados en UTF-8.

  • La URL no debe contener espacios en blanco.

aviso

Esto debe verificarse cuidadosamente durante la implementación y usando el entorno TEST, para evitar cualquier discrepancia entre la URL generada en escenarios offline y la que fiskaly genera cuando el sistema vuelve a estar en línea.

En nuestra sección de Preguntas Frecuentes encontrarás ejemplos para probar esta implementación.

El código QR impreso en facturas offline debe seguir las mismas pautas que las facturas online, incluyendo el texto obligatorio conforme a VERI*FACTU. Para más información, consulta nuestra guía sobre Cumplimiento de Facturas Verifactu.