Dans cet article, vous apprendrez comment mettre en œuvre correctement la gestion des erreurs en Espagne.

Prérequis

• FiscalClient à partir de la version 1.6.5 / Espagne 1.0.5 pour les fonctionnalités marquées d’un *.
• FiscalClient à partir de la version 1.5.0

Description

Le système TicketBAI permet de transmettre les reçus générés immédiatement, mais aussi de façon différée. Lors de la transmission des reçus, des erreurs de validation peuvent survenir. 

En mode synchrone, ces erreurs de validation sont immédiatement remontées au système de point de vente. En cas de transmission différée (le TicketBAI system n’était pas disponible au moment de la création du ticket), les erreurs doivent être extraites du système fiscal et, en fonction de la cause de l’erreur, le problème doit être traité en conséquence.

Traitement synchrone

Le système TicketBAI est disponible et les reçus peuvent être transmis.

Prérequis

• Le système TicketBAI est disponible
• Aucun fichier en attente de transmission (issu d’interruptions précédentes)

Le ticket de caisse est transféré de manière synchrone vers le système TicketBAI. Si le transfert du ticket de caisse s’effectue avec succès et qu’aucune erreur de validation n’est détectée, le résultat est renvoyé au système de point de vente avec le statut « Réussi ».

Le ticket de caisse est alors persisté dans le système fiscal et dans TicketBAI, et ne doit pas être retransmis.

Causes des erreurs

Le système TicketBAI est désormais indisponible

Le ticket de caisse est alors persisté dans le système fiscal et mis à disposition pour la prochaine transmission. Ce scénario déclenche le processus asynchrone.

Le ticket de caisse est alors persisté dans le système fiscal et sera transmis ultérieurement vers TicketBAI. Il ne doit en aucun cas être retransmis vers le système fiscal.

Erreur de validation retournée par TicketBAI

Le ticket de caisse n’est pas enregistré dans le système fiscal et un message d’erreur signalant un ticket de caisse non valide est renvoyé au système de point de vente.

Le ticket de caisse doit alors être transféré à nouveau vers le système fiscal.

Traitement asynchrone

Le système TicketBAI ou la connexion à celui-ci n’est pas disponible.

Conditions préalables

• FiscalClient est disponible et opérationnel
• Le système TicketBAI est indisponible ou la connexion à ce système est interrompue.

Les tickets de caisse sont alors pris en charge par le système fiscal, enregistrés et marqués pour un transfert ultérieur.

En raison du traitement asynchrone, les erreurs de validation ne peuvent pas être renvoyées directement au système de point de vente. Par conséquent, les états d’erreur relatifs à ces tickets de caisse doivent être interrogés.

Tous les tickets transmis de manière asynchrone sont stockés dans le système fiscal et ne peuvent plus être réémis vers ce dernier.

Consulter les informations d’erreur et leur résolution *

Cette fonctionnalité est disponible à partir de la version 1.6.5 du client fiscal.

Les transferts ayant échoué peuvent être consultés dans le système fiscal.

Interrogation

Le point de terminaison suivant permet de récupérer les fichiers d'erreurs :

REST :

GET /api/v1/transactions/errorDocuments/{clientId}

nuget :

TrustedFiscalModule.GetErrorDocuments(bool onlyAsync)

Ce point de terminaison renvoie les informations d'erreur ainsi que les DocumentGuid des documents concernés.

Le paramètre « onlyAsync » peut être utilisé pour ne récupérer que les erreurs survenues de manière asynchrone.

Solution

Pour résoudre ce problème, le document doit être annulé dans le système comptable ; cette opération s’effectue via le point de terminaison suivant.

REST :

DELETE /api/v1/transactions/errorDocuments/{clientId}/{documentGuid}

nuget :

TrustedFiscalModule.CancelErrorDocument(Guid documentGuid)

Grâce à cet appel, le ticket de caisse est annulé dans le système fiscal, mais l’annulation n’est pas transmise au TicketBAI system (le ticket de caisse n’existe pas encore dans le TicketBAI system). Si ce ticket de caisse est marqué comme annulé, il ne sera plus renvoyé comme erroné via la requête ci-dessus.

Le document est annulé dans le système fiscal – il n’est pas supprimé !

Le document peut désormais être transféré à nouveau vers le système fiscal avec de nouvelles informations d’en-tête (numéro de document, DocumentGuid, etc.) et les données corrigées. 

Cet article a été traduit automatiquement.