GET /api/v1/transactions/document/ {clientId}/start – RetailForce

Utilisation du point de terminaison

GET /api/v1/transactions/document/{clientId}/start,

un document dit « de démarrage » (document initial) est généré par le service fiscal et renvoyé au système en amont.

Les documents de démarrage sont des documents spécifiques à chaque pays qui servent à initialiser (mettre en service) l’unité fiscale.

Certains pays exigent légalement un tel document de démarrage, comme le montre le tableau ci-dessous.

Pays	Désignation	DocumentType
Autriche	« Startbeleg » – reçu initial	[1000] = NullReceipt
Lituanie	rapport initial (Z)	[99] = EndOfDay

La requête GET /api/v1/transactions/document/{clientId}/start génère systématiquement le document de démarrage requis dans le pays concerné.

Important : dans le cadre de l’interface standardisée, l’initialisation d’un client fiscal s’effectue toujours selon le processus décrit dans l’article référencé. Un document de démarrage doit donc être transmis au service fiscal de chaque pays.

Remarque : au lieu d’interroger le point de terminaison GET /api/v1/transactions/document/{clientId}/start, le document de démarrage correspondant peut également être généré par le système amont (système d’enregistrement électronique) lui-même.

Résultat

En cas de traitement réussi (code 200), le client fiscal concerné renvoie le document de démarrage au système en amont.

Utilisation

Une seule fois, dans le cadre de la mise en service d’un client fiscal.

Prérequis

Middleware fiscal installé,
client fiscal créé et configuré, soit via
- PUT /api/v1/management/clients ou
- PUT /api/v1/management/clients/byCloud
CloudConnect a été exécutée avec succès (uniquement pour les systèmes connectés à RetailForce Cloud).

Champs du formulaire

Les informations suivantes doivent être fournies :

Désignation	Description	Exemple
clientId	L'identifiant unique « uniqueClientId » de la caisse (issu du RetailForce system).	c1062c55-57c4-4ed2-9c53-aff1762326a4
BookDate	Facultatif : l'heure d'enregistrement du document initial	2023-05-19T10:30:04.297Z

Réponse

Réponses possibles :

Code	Description	Exemple
200	Document de référence spécifique au pays	-

Cet article a été traduit automatiquement.