CloudSync – Renvoi des données

Cette documentation décrit comment vérifier et transférer les documents de fin de journée. Actuellement, cette fonction n’est prise en charge qu’en Allemagne.

Présentation

Le processus de synchronisation dans le Cloud stocke de manière sécurisée vos documents de fin de journée dans le Cloud et effectue les tâches suivantes :

1. vérifie la présence de tous les fichiers de fin de journée requis (le document générique de fin de journée et l’archive TAR spécifique à l’Allemagne) dans le stockage Cloud
2. transfère les fichiers manquants depuis le client local vers le Cloud.

Conditions préalables

• Autorisation organisationnelle : celle-ci doit être activée pour permettre la réenvoi des données. L’activation doit être effectuée par le service d’assistance.
• Pays fiscal : actuellement disponible uniquement pour l’Allemagne.
• Configuration : les chemins d’accès au stockage de fichiers local et au stockage dans le cloud doivent être configurés dans le RetailForce portal

Configuration du portail

1. Connectez-vous au RetailForce portal.
2. Accédez à Configuration → Configuration pertinente
3. Stockage des fichiers
   1. Cliquez sur « + Storage path ».
   2. Le champ Storage path demeure vide et ne nécessite aucune saisie.
4. Stockage dans le cloud
   1. Cliquez sur + Storage path.
   2. Le champ Storage path est également vide au démarrage.
5. Enregistrez les modifications.

Workflow client

Après avoir généré et comptabilisé une clôture de journée (EOD) basée sur les transactions chez le client, les appels d’API suivants doivent être effectués dans l’ordre indiqué :

• Mise à jour de la configuration
  ( POST) /api/v1/management/clients/byCloud/{clientId}
  Met à jour la configuration et garantit que le middleware utilise les chemins d’accès actuels vers le stockage de fichiers et le stockage dans le Cloud.
• POST CloudConnect
  /api/v1/management/cloud/connect
  Établit une connexion au Cloud.
• Création d’un document de fin de journée
  ( GET) /api/v1/closing/{clientId}/endofdayDocument
  Crée le document EOD local.
• Enregistrement de fin
  de journée ( POST) /api/v1/transactions/storeDocument
  Enregistre le document de fin de journée créé.

• Vérification des conditions
  de synchronisation (GET) /api/v1/cloudsync/{clientId}/isSyncRequired
  Détermine s’il reste des fichiers de fin de journée dans la file d’attente locale des messages.

  Erreurs possibles

  • EndOfDay required – Aucun document de fin de journée trouvé ; générer un document de fin de journée.
  • CloudConnect required – Appel CloudConnect requis.
  • Files are in Message Queue (cloudTemp folder) – Les fichiers en attente doivent être téléchargés.
  • Terminal is not allowed to sync with cloud – Le client ne dispose pas des autorisations nécessaires.
  • Not implemented for country – Prise en charge réservée à l’Allemagne.

  Réponse

  • false – Tous les fichiers sont déjà présents dans le Cloud ; aucune action supplémentaire n’est requise.
  • true – Un ou plusieurs fichiers doivent être envoyés ; passez à l’étape suivante.

• Lancer le transfert vers le Cloud
  POST /api/v1/cloudsync/{clientId}/startSendingToCloud
  Lance le téléchargement asynchrone des fichiers.

  Erreurs possibles

  • Toutes les erreurs provenant de isSyncRequired.
  • Insufficient rights – Le client ne dispose pas des droits d'écriture sur le stockage cloud.
  Remarque : un résultat positif indique que le processus de téléchargement a démarré ; il ne garantit pas un transfert immédiat.
• Vérifiez que le processus est terminé
  en répétant l’appel à isSyncRequired .
  • Si false: Téléchargement terminé.
  • Si ce n’est toujours pas le cas true: Patientez quelques instants et réessayez jusqu’à ce que tous les fichiers aient quitté la file d’attente.

Conditions de déclenchement

Cette routine de synchronisation doit être exécutée lorsque :

• Une transaction a été traitée et
• le stockage sur disque ou le stockage dans le Cloud n’était pas activé auparavant (c’est-à-dire lors de la configuration initiale) ou
• Une tentative de synchronisation précédente a échoué et a laissé des fichiers dans la file d’attente locale.

Cet article a été traduit automatiquement.