PUT /api/v1/transactions/createDocument – RetailForce

Ce point de terminaison constitue la première étape de la transmission des transactions depuis le système d’enregistrement électronique (« caisse enregistreuse ») vers l’administration fiscale. Le processus se déroule toujours en deux étapes. Ce processus en deux étapes de transmission des transactions repose sur les exigences de l’ordonnance allemande relative à la protection des caisses enregistreuses contre la manipulation frauduleuse et doit être mis en œuvre dans tous les pays soumis à la fiscalité au sens d’une interface normalisée. En Allemagne, lorsque l’appel PUT /api/v1/transactions/createDocument est effectué, une transaction est enregistrée dans ce que l’on appelle le dispositif technique de sécurité (TSE/TSS).

Enregistrement de la transaction

Une transaction/un document est enregistré(e) dans l’unité fiscale :

PUT /api/v1/transactions/createDocument et
POST /api/v1/transactions/storeDocument

Annulation d’une transaction

Cette opération enregistre la fin d’une transaction dans l’unité fiscale :

PUT /api/v1/transactions/createDocument et
POST /api/v1/transactions/cancelDocument

Remarque : toutes les transactions initiées via PUT /api/v1/transactions/createDocument doivent être clôturées soit par POST /api/v1/transactions/storeDocument, soit par POST /api/v1/transactions/cancelDocument. Veuillez noter la méthode listTransactions (DELETE).

Résultat

Un appel réussi vers le point de terminaison (200)

enregistre le début d’une transaction dans l’unité fiscale et
renvoie une réponse « fiscalResponse » au système en amont (système d’enregistrement électronique).

Utilisation

À chaque fois qu’une nouvelle transaction doit être envoyée à l’unité fiscale, avant d’appeler POST /api/v1/transactions/storeDocument ou POST /api/v1/transactions/cancelDocument.

Prérequis

Client Fiskal initialisé

Champs du formulaire

Les informations suivantes doivent être transmises :

Désignation	Type	Description	Exemple
clientId	M	L'identifiant unique (uniqueClientId) de la caisse (provenant du RetailForce system).	c1062c55-57c4-4ed2-9c53-aff1762326a4
documentType	M	Le type de document à enregistrer. Énumération : [0] = Reçu [1] = Facture [2] = Bon de livraison [10] = Paiement [11] = PayIn [12] = Facture pro forma [13] = Commande client [14] = PreliminaryReceipt [80] = LongTermOrder [90] = OpeningBalance [98] = CashCheck [99] = EndOfDay [100] = Stock [101] = Achat [1000] = Reçu nul [1100] = Divers non fiscal	-
DocumentGuid	R	Le GUID/UUID attribué à la transaction par le système de point de vente. Comportement du paramètre « DocumentGuid » inclus dans la requête : La spécification de « DocumentGuid » rend l’appel idempotent. La fonction « createDocument » peut être appelée plusieurs fois sans initier de nouvelle transaction dans le TSE (dispositif technique de sécurité allemand). « fiscalResponse » : la MÊME réponse est toujours renvoyée. Comportement SANS « DocumentGuid » dans la requête : Si aucun « DocumentGuid » n’est spécifié, une nouvelle transaction est lancée dans le TSE (Allemagne) à CHAQUE appel de createDocument ! « fiscalResponse » : une NOUVELLE réponse est renvoyée à chaque fois. Remarque : le même « DocumentGuid » doit également être transmis lors de l’appel suivant vers POST /api/v1/transactions/storeDocument.	b5744d8c-71ec-4ea0-a340-53070da8b5a1

Réponse

Réponses possibles :

Code	Description	Exemple
200	La transaction a été initiée et une fiscalResponse est renvoyée au système en amont	-

Cet article a été traduit automatiquement.

Résultat

Utilisation

Prérequis

Champs du formulaire

Réponse

Articles associés