Au cours du fonctionnement normal du système de caisse, il peut s’avérer nécessaire de procéder à une restauration des données, par exemple en raison de défaillances matérielles, afin de pouvoir continuer à utiliser le système d’enregistrement.
Attention : dans certains pays, les procédures décrites ci-dessous pour la restauration des clients du service de fiscalisation RetailForce ne sont pas autorisées en raison de la réglementation en vigueur. Si le système d’enregistrement (caisses enregistreuses, etc.) est défectueux, aucune récupération de données ne peut être effectuée ; il convient alors de mettre en service une nouvelle caisse enregistreuse. Pour plus d’informations, voir ci-dessous.
Restauration via RetailForce Cloud
La restauration du système peut être effectuée à partir des données stockées dans le RetailForce Cloud.
Prérequis
- Licence d’archivage dans le Cloud activée,
- licence GetConfiguration activée,
- option d’archivage dans le Cloud activée dans la configuration,
- le répertoire de données du client à restaurer (par exemple, sur les systèmes Windows : C:\ProgramData\RetailForce\Fiscal Webservice\{clientId} ne doit pas exister,
- la configuration du client à restaurer ne doit pas figurer dans le magasin de configuration (aucune entrée pour le clientId correspondant dans fiscalService.config.json).
Attention : la restauration n’est possible que si le client concerné était déjà en service à un moment antérieur, c’est-à-dire si les données nécessaires à la restauration sont disponibles. Si une erreur s’est produite lors du démarrage initial (avant l’initialisation), la restauration échouera également ! Dans ce cas, seul un redémarrage complet est possible. Vérifiez si les composants matériels nécessaires (TSE/TSS en Allemagne, module de sécurité en Lituanie, etc.) ont déjà été initialisés. Si tel est le cas, il peut s’avérer nécessaire de les remplacer.
Fonctionnement
La restauration des données s’effectue en appelant les points de terminaison suivants :
-
POST /api/v1/management/clients/recovery/restoreByCloud
ou - POST /api/v1/management/clients/recovery/restoreByCloud/ID
Remarque : seules les données déjà transférées vers le RetailForce Cloud peuvent être restaurées. Les données qui n’ont pas été transférées vers le RetailForce Cloud system (données qui se trouvaient dans le dossier \tempcloud et qui, par exemple, n’ont pas encore été transférées vers le cloud en raison d’une interruption de réseau) ne peuvent pas être restaurées et risquent d’être perdues.
Important : la restauration d’un client à l’aide des fonctions susmentionnées ne peut aboutir que si au moins une clôture journalière (document EndOfDay) a été enregistrée par le passé pour la caisse (client/terminal) en question et transférée vers les archives Cloud.
Redémarrage
Afin de pouvoir continuer à travailler avec les nouvelles caisses enregistreuses, il est nécessaire de connaître le dernier document traité par le client.
Celui-ci peut être récupéré à partir du stockage de documents via le point de terminaison
- GET /api/v1/transactions/document/{clientId}/last
Toutefois, seule la charge utile JSON envoyée par le système de point de vente au client est récupérée, et non la réponse (fiscalResponse).
Pour récupérer également la fiscalResponse correspondante, utilisez le point de terminaison
- GET /api/v1/transactions/document/{clientId}/{DocumentGuid}/response
en précisant les paramètres
- ClientId et
- DocumentGuid (issus de l’objet JSON précédemment renvoyé lors de l’appel de GET /api/v1/transactions/document/{clientId}/last)
À l’aide des informations contenues dans payload et fiscalResponse, le système de point de vente peut incrémenter le numéro de document pour passer à l’élément suivant de la séquence.
Récupération via les données de sauvegarde
Le service de fiscalisation RetailForce permet de créer des sauvegardes locales des données. Celles-ci peuvent être générées à tout moment en appelant le point de terminaison :
- GET /api/v1/management/clients/recovery/{clientId}/backup
Cette opération génère un fichier ZIP contenant l’ensemble des données de base et de transaction relatives au client, telles qu’elles étaient disponibles localement au moment de la création de la sauvegarde.
En cas d’incident système (POS défaillant nécessitant une réinstallation), un fichier de sauvegarde existant peut être utilisé pour restaurer le client concerné à l’aide du point de terminaison
- POST /api/v1/management/clients/recovery/restore
L’ensemble de données correspond à chaque création de sauvegarde. Aucune donnée n’est téléchargée depuis le RetailForce Cloud (par exemple, les données qui ont été transférées vers le RetailForce Cloud après la création du fichier de sauvegarde).
La procédure est identique à celle utilisée pour déplacer un FiscalClient d’un ordinateur à un autre.
Attention : afin d’éviter toute divergence de données entre la caisse enregistreuse et les archives du RetailForce Cloud, nous vous recommandons d’utiliser cette fonction uniquement pour les systèmes hors ligne (par exemple, si un pack de licences SANS archivage dans le cloud a été sélectionné).
Redémarrage
Le redémarrage par importation d’un fichier de sauvegarde local fonctionne exactement de la même manière que la restauration via le RetailForce Cloud. Veuillez toutefois noter que si l’archivage dans le cloud des données fiscales est activé pour le client concerné, il peut subsister un écart de données entre le fichier de sauvegarde et le système cloud.
Pour vérifier cela, utilisez les fonctions d’exportation de données du client concerné sur le RetailForce portal.
Nouvelle installation
Dans certains cas, la seule solution consiste à initialiser le terminal de point de vente entièrement à partir de zéro, sans récupération des données. Les réglementations légales en vigueur dans les pays concernés peuvent également exiger une nouvelle installation ; par exemple, si le module de sécurité lituanien (matériel) est défectueux, un nouveau terminal de point de vente doit être enregistré.
La nouvelle installation d’un terminal/client s’effectue selon la procédure habituelle.
Pays dans lesquels la restauration du client n’est pas autorisée :
- Lituanie
Cet article a été traduit automatiquement.
Commentaires
0 commentaire
Vous devez vous connecter pour laisser un commentaire.