POST /api/v1/management/clients/ initialize – RetailForce

point de terminaison POST /api/v1/management/clients/initialize

sert à

initialiser l’unité fiscale (client),
tout matériel fiscal requis (unité de création de signature, dispositif technique de sécurité, unité de contrôle, imprimante/boîtier fiscal, etc.) et
à enregistrer le système d’enregistrement électronique (caisse enregistreuse) auprès des autorités fiscales. (par exemple, procédure d’enregistrement sur FinanzOnline – Autriche)

Résultat

En cas de traitement réussi (code 200),

le client fiscal correspondant et
l’ensemble du matériel fiscal requis sont mis en service et configurés, et
(si nécessaire / disponible dans le pays concerné), la caisse enregistreuse est enregistrée auprès de l’administration fiscale.

Utilisation

Exécution unique, dans le cadre de la mise en service d’un client fiscal.

Conditions préalables

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).
Le document de démarrage a été créé, soit via GET /api/v1/transactions/document/{clientId}/start, soit par le système en amont lui-même.

Champs du formulaire

Le document de démarrage doit être transmis au point de terminaison.

Lorsque l’appel GET /api/v1/transactions/document/{clientId}/start a été effectué, un document de démarrage a été renvoyé au système hôte en guise de réponse. Celui-ci peut désormais être envoyé au point de terminaison POST /api/v1/management/clients/initialize.

Il est également possible que le document de démarrage requis soit créé par le système en amont lui-même.

Réponses

Réponses possibles :

Code	Description	Exemple
200	Le document source a été transmis avec succès et sans erreur, puis persisté dans le documentStore. De plus, une « fiscalResponse » est renvoyée au système en amont. Celle-ci doit être enregistrée dans le journal du système en amont à des fins de référence.	fiscalResponse
204	Le document de démarrage a été transmis avec succès et sans erreur, puis enregistré dans le documentStore. Dans certains pays, aucune fiscalResponse n’est transmise en cas de mise en service réussie.	-
422	Le document de démarrage ne répond pas aux exigences du pays concerné ou l’identifiant ClientId est absent du document de démarrage. Dépannage : Exécutez la requête POST /api/v1/transactions/validateDocument ou POST /api/v1/transactions/validateDocumentString afin d’obtenir une analyse plus détaillée de l’erreur ; Utilisez GET /api/v1/transactions/document/{clientId}/start pour générer un document de démarrage valide ; spécifiez le clientId correspondant.	-
500	Erreur de validation dans le document de démarrage ou le clientId transmis dans le document de démarrage est introuvable dans le ConfigStore. Dépannage : Exécutez POST /api/v1/transactions/validateDocument ou POST /api/v1/transactions/validateDocumentString afin d’obtenir une analyse plus détaillée de l’erreur ; Utilisez GET /api/v1/transactions/document/{clientId}/start pour générer un document de démarrage valide ; vérifiez que le clientId a bien été créé dans le système (PUT /api/v1/management/clients ou PUT /api/v1/management/clients/byCloud).	-

Cet article a été traduit automatiquement.

Résultat

Utilisation

Conditions préalables

Champs du formulaire

Réponses

Articles associés