Perte de connexion

Tant que vous êtes connecté à SIGN ES, vous n’avez pas à vous en préoccuper. En cas de perte de connexion au serveur de l’administration fiscale espagnole, SIGN ES met en œuvre une vérification de disponibilité du service Verifactu. La transmission des enregistrements de facturation reprendra automatiquement dès que la connexion au service sera rétablie.

Tout temps d’arrêt ou problème de transmission détecté par fiskaly sera notifié via notre page de statut.

📘Note

Nous indiquons automatiquement le champ incident comme Oui si nous détectons des problèmes de déconnexion de notre côté. L’API SIGN ES transmettra les fichiers XML dès que la connexion au service de l’administration fiscale sera rétablie.

📘Important

L’utilisateur du système de caisse doit être notifié en cas de problème de connexion Internet ou d’incident affectant la transmission vers l’API SIGN ES. Idéalement, un message s’affiche dans la caisse pour indiquer cette situation.

En cas de perte de connexion avec nous

Même en cas de problème de connexion, le contribuable émettra une facture pour le client en en conservant une copie.

En cas de problème de connexion Internet sur le système de caisse, la réglementation Verifactu prévoit une indication des problèmes de transmission des factures émises via un champ incident dans la structure XML créée.

Dans notre API SIGN ES, le champ incident fait partie des annotations lors de la création d’une nouvelle facture. Dès que le problème de connectivité est résolu, les factures émises doivent être introduites via le logiciel de l’API SIGN ES de manière corrélative et en incluant ce champ incident.

Veuillez noter qu’en aucun cas une facture ne peut être émise sans être transmise à l’API SIGN ES.

Comment générer le QR code hors ligne ?

📘Important

Tant que l’API SIGN ES de fiskaly est disponible, vous devez imprimer les factures en utilisant l’URL fournie dans la réponse de création de facture. Cette procédure n’est applicable que dans les cas hors ligne.

Conformément à la réglementation Verifactu, toutes les factures doivent contenir un QR code Verifactu. Afin de générer le QR code pour les factures émises hors ligne, nous vous fournissons le pseudocode suivant qui présente un flux d’implémentation possible :

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

Les aspects suivants doivent être pris en compte lors de la génération de l’URL :

L’URL doit conserver l’ordre dans lequel les paramètres sont fournis :
- URL de base
  - L’URL de base pour l’environnement TEST est : https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR
  - L’URL de base pour l’environnement LIVE est : https://www2.agenciatributaria.gob.es/wlpl/TIKE-CONT/ValidarQR
- NIF du contribuable
  - Dans l’API SIGN ES, cela correspond au champ Créer un contribuable > content > issuer > tax_number.
- Série et numéro de facture
  - Dans l’API SIGN ES, cela correspond aux champs Créer une facture > content > series et Créer une facture > content > number qui sont concaténés sans espaces ni caractères entre eux. Si la facture n’a pas de série, seul le numéro est utilisé.
- Montant total de la facture
  - Dans l’API SIGN ES, cela correspond au champ Créer une facture > content > full_amount qui doit être arrondi à 2 décimales (ex. : “121.00” et non “121”).
Tous les caractères spéciaux doivent être encodés en UTF-8.
Il ne doit pas y avoir d’espaces dans l’URL.

⚠️Avertissement

Cela doit être soigneusement vérifié lors de l’implémentation et en utilisant l’environnement TEST, afin d’éviter tout écart entre l’URL générée dans les scénarios hors ligne et l’URL que fiskaly génère lorsque le système est de nouveau en ligne.

Dans notre FAQ vous trouverez des exemples pour tester cette implémentation.

Le QR code imprimé sur les factures hors ligne doit suivre les mêmes directives que ceux imprimés sur les factures en ligne, y compris le texte conforme VERI*FACTU. Pour plus d’informations, veuillez consulter notre guide pour la Conformité des factures Verifactu.

Was this page helpful?