Ce point de terminaison connecte un client spécifique (locataire) au RetailForce Cloud et met en cache le module fiscal. L’appel de CloudConnect doit être effectué avant que les transactions ne soient soumises au service fiscal.
Cette fonction doit être exécutée au moins après un redémarrage de la caisse enregistreuse ou après un redémarrage du système sur lequel le middleware fiscal est installé. Nous vous recommandons toutefois d’utiliser régulièrement ce point de terminaison afin de garantir une connexion permanente au système Cloud.
Résultat
Un appel réussi de l’interface (200)
- établit la connexion entre Fiscal Client et RetailForce Cloud et
- charge le module fiscal dans le cache.
Utilisation
- lors de la mise en service, après avoir exécuté PUT /api/v1/management/clients/byCloud ou PUT /api/v1/management/clients ;
- régulièrement, au moins après chaque redémarrage du système hôte.
La requête POST /api/v1/management/cloud/connect, par exemple, peut être exécutée avant chaque transmission de transaction.
Prérequis
- Fiskal Middleware doit être installé et les commandes PUT /api/v1/management/clients/byCloud ou PUT /api/v1/management/clients doivent avoir été exécutées avec succès.
Champs du formulaire
Les informations suivantes doivent être fournies :
| Désignation | Description | Exemple |
| clientId |
L'identifiant unique « uniqueClientId » de la caisse (provenant du RetailForce system). |
c1062c55-57c4-4ed2-9c53-aff1762326a4 |
| cloudApiKey |
Clé API permettant d’authentifier la communication avec le Cloud |
RFC_4a2abc... |
| cloudApiSecret |
API Secret pour l'authentification de la communication avec le cloud
Attention :
l’API Secret doit toujours être placé entre guillemets simples, par exemple « ypmqt7s5UVZOyY9mDFzOeVgdpRnJ8GrOsQ »
|
ypts7u5OU... |
Réponse
Réponses possibles :
| Code | Description | Exemple |
| 200 |
La connexion au Cloud a été établie avec succès |
- |
| 403 |
Les données d'accès (identifiants = cloudApiKey et API Secret) sont incorrectes. Dépannage :
|
- |
| 422 |
Le clientId spécifié est introuvable dans le système local ou les données d'accès n'ont pas été fournies. Dépannage :
|
- |
| 424 |
Si vous souhaitez utiliser l’archive cloud, vous devez appeler la fonction « cloud connect » avant d’utiliser le module fiscal certifié. Dépannage :
|
- |
Cet article a été traduit automatiquement.
Commentaires
0 commentaire
Vous devez vous connecter pour laisser un commentaire.