Erreur de connexion TSE

La fiscalisation en Allemagne impose l’utilisation d’un « dispositif technique de sécurité certifié » (TSE ou TSS dans la version anglaise de l’ordonnance). En cas d’utilisation d’une TSE matérielle, le message d’erreur « Tse connection error. » peut s’afficher après l’appel de la méthode createDocument.

Scénarios possibles :

Le TSE n’est pas connecté

Le TSE n’est pas connecté au système de caisse (au système sur lequel le RetailForce Middleware est installé).

Dépannage :

Connectez le TSE au système.

TSE connecté – le test indique « OK »

Si l’erreur persiste malgré la connexion effective du TSE au système, exécutez également un autotest

• L’appel POST /api/v1/management/germany/TSE/{TseSerial}/selftest renvoie
• « 200 - Succès »,

de même qu’un test de connexion :

• PUT /api/v1/management/germany/{clientId}/TSE/connectTest,
• « 200 - Succès ».

Cause possible :

La limite du nombre de transactions ouvertes a été atteinte ! Conformément à une exigence du BSI (Office fédéral allemand de la sécurité de l’information) relative aux TSE, ces derniers doivent limiter le nombre de transactions pouvant être ouvertes simultanément.

• la TSE matérielle de Swissbit peut gérer jusqu’à 512 transactions ouvertes,
• fiskaly Cloud TSE 2 000 transactions ouvertes.

Il s’agit de transactions initiées via la fonction createDocument mais qui n’ont pas été finalisées par la suite (avec storeDocument ou cancelDocument). Ce comportement peut survenir, par exemple, si le système de point de vente subit une panne après un createDocument sans avoir enregistré l’existence de transactions ouvertes.

Le nombre de transactions ouvertes peut être interrogé via le point de terminaison suivant :

• GET /api/v1/management/germany/TSE

Les transactions ouvertes sont renvoyées dans le champ « startedTransactions » de la réponse :

[
   {
      ...
      "startedTransactions": 512,
      "maxStartedTransactions": 512,
      "createdSignatures": 2238,
      "maxSignatures": 20000000,
      ...
   }
]

Dépannage :

Pour corriger l’erreur ou permettre au TSE d’accepter à nouveau des documents (« tickets de caisse ») en vue de leur traitement, les transactions ouvertes doivent être clôturées.

Pour ce faire, procédez comme suit.

Option 1 :

À l’aide de la requête

• GET /api/v1/management/germany/{clientId}/TSE/listTransactions ,

les identifiants fiscalDocumentNumbers des transactions en cours sont renvoyés par paquets.

Exemple :

[
   45,
   1,
   2,
   3,
   4,
   5,
   6,
   7
]

Les transactions récupérées via listTransactions (=fiscalDocumentNumber) doivent désormais, conformément à la situation réelle, être clôturées soit à l’aide de :

• POST /api/v1/transactions/storeDocument ou
• POST /api/v1/transactions/cancelDocument

Utilisez POST /api/v1/transactions/storeDocument (comme d’habitude) pour finaliser le document lorsqu’une vente a été effectuée et POST /api/v1/transactions/cancelDocument pour annuler la transaction (en l’absence de vente aboutie).

Option 2 :

L’

• DELETE /api/v1/management/germany/{clientId}/TSE/listTransactions

permet de clôturer en une seule fois toutes les transactions TSE en cours. Veuillez vous assurer de suivre les instructions ci-dessus concernant les annulations de documents avant d’utiliser ce point de terminaison ! Une fois toutes les transactions en cours clôturées, le TSE acceptera et traitera à nouveau les documents.

Cet article a été traduit automatiquement.