DELETER /api/v1/management/germany/ {clientId}/TSE/listTransactions – RetailForce

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

permet de clôturer les transactions TSE en cours.

En règle générale, les transactions ne doivent pas rester ouvertes. Nous vous recommandons de clôturer toutes les transactions ouvertes avant la clôture journalière, soit à l’aide de

POST /api/v1/transactions/storeDocument – si une vente a eu lieu, ou
POST /api/v1/transactions/cancelDocument – si aucune vente n’a eu lieu.

Attention : veuillez noter que les annulations de documents sont (doivent être) également enregistrées dans le TSE. Il est donc également nécessaire de clôturer chaque transaction lancée par PUT /api/v1/transactions/createDocument à l’aide de « storeDocument » ou « cancelDocument ». En cas d’annulations fréquentes de documents, nous ne pouvons exclure la possibilité que les autorités fiscales posent des questions sur les motifs de ces annulations lors d’un contrôle de caisse .

Résultat

Les transactions TSE ouvertes sont clôturées collectivement à l’aide de la commande POST /api/v1/transactions/cancelDocument, sans qu’il soit nécessaire de les clôturer individuellement.

Utilisation

Nous vous recommandons d’utiliser ce point de terminaison avec prudence et uniquement en cas d’erreur.

L’appel génère d’abord une requête auprès du TSE afin de déterminer quelles transactions sont ouvertes. Les différents types de TSE (Cloud TSE, hardware TSE) ne renvoient pas une liste complète des transactions ouvertes, mais uniquement « paquet par paquet » :

SWISSBIT HARDWARE TSE : 8 transactions à la fois,
fiskal Cloud TSE : 100 transactions à la fois

Une fois que le TSE a renvoyé le lot de transactions ouvertes, les transactions qu’il contient sont clôturées via un document vide, comportant les informations suivantes :

DocumentId : GUID généré par le service
DocumentNr : GUID généré par le service
DocumentGuid : GUID généré par le service
DocumentType : Reçu
documentTypeCaption : CancelTransaction

Si le nombre de transactions ouvertes dépasse la limite spécifiée, le point de terminaison doit être appelé de manière itérative.

Toutes les transactions clôturées sont également enregistrées en conséquence dans les données DSFinV-K.

Conditions préalables

Il existe des transactions ouvertes (lancées), c'est-à-dire non clôturées, sur la TSE.

Si le nombre maximal de transactions ouvertes est atteint, aucune nouvelle transaction ne peut être lancée sur la TSE, qui renvoie alors un code d’erreur. Pour plus d’informations, consultez l’article « Erreur de connexion à la TSE ».

Vous pouvez récupérer le nombre de transactions ouvertes via le point de terminaison :

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

Exemple :

Le TSE renvoie le nombre de transactions lancées dans le champ « startedTransactions ».

{
   ...
   "startedTransactions": 512,
   "maxStartedTransactions": 512,
   ...
}

Remarque : cette fonctionnalité n’est disponible que pour les TSE matérielles. La limite du nombre de transactions ouvertes simultanément pour le Fiskaly Cloud TSE est de 2 000.

Champs du formulaire

Les informations suivantes doivent être transmises :

Désignation	Description	Exemple
clientId	L'identifiant unique « uniqueClientId » de la caisse (provenant du RetailForce system).	c1062c55-57c4-4ed2-9c53-aff1762326a4

Réponses

Réponses possibles :

Code	Description	Exemple
200	fiscalResponse – les transactions en cours ont été clôturées avec succès (cancelDocument)	-
400	« TSE non connecté » : aucun TSE n’est connecté au système ni attribué au client correspondant. Dépannage : Vérifier si la TSE est connectée au système , par exemple au moyen de la requête GET /api/v1/management/germany/tse	-
404	« Client introuvable » : aucune configuration n’existe sur ce système pour le clientId spécifié. Dépannage : Vérification du clientId spécifié Vérifiez si le clientId spécifié est configuré dans le middleware (dans le fichier fiscalService.config.json situé sous C:\Program Files\RetailForce\Fiscal Webservice\Config)	-
422	« Le clientId a été défini sur Guid.Empty » Dépannage :	-
500	« Erreur interne du serveur » – Autre erreur. Dépannage : répétez l'appel, redémarrez le service si nécessaire, exécutez CloudConnect.	-

Attention : quelle que soit la manière dont l’erreur a été résolue, nous vous recommandons d’analyser attentivement la raison pour laquelle les transactions TSE restent ouvertes. Dans le cadre du processus de clôture habituel, toutes les transactions ouvertes doivent être clôturées avant la clôture journalière.

Cet article a été traduit automatiquement.

Résultat

Utilisation

Conditions préalables

Champs du formulaire

Réponses

Articles associés