CloudSync - Reinvio dei dati

La presente documentazione illustra come verificare e trasferire i documenti di fine giornata. Attualmente, questa funzione è supportata solo per la Germania.

Panoramica

Il processo di sincronizzazione su Cloud archivia in modo sicuro i Suoi documenti di fine giornata nel Cloud ed esegue le seguenti operazioni:

1. verifica la presenza di tutti i file End-of-Day (EOD) richiesti (il documento EOD generico e l’archivio TAR specifico per la Germania) nell’archivio Cloud
2. trasferisce eventuali file mancanti dal client locale al Cloud.

Prerequisiti

• Autorizzazione organizzativa: deve essere abilitata per poter inviare nuovamente i dati. L’attivazione deve essere effettuata tramite il supporto tecnico.
• Paese fiscale: attualmente disponibile solo per la Germania.
• Configurazione: i percorsi di archiviazione dei file locali e su cloud devono essere configurati nel RetailForce portal

Configurazione del portale

1. Acceda al RetailForce portal.
2. Accedere a Configurazione → Configurazione pertinente
3. Archiviazione file
   1. Fare clic su + Storage path.
   2. Il campo Storage path rimane vuoto e non richiede alcun inserimento.
4. Archiviazione su Cloud
   1. Fare clic su + Storage path.
   2. Anche il campo Storage path è inizialmente vuoto.
5. Salvare le modifiche.

Flusso di lavoro del client

Dopo aver generato e inviato un EOD basato sulle transazioni sul client, è necessario effettuare le seguenti chiamate API nell’ordine indicato:

• POST di aggiornamento della configurazione
  /api/v1/management/clients/byCloud/{clientId}
  Aggiorna la configurazione e garantisce che il middleware utilizzi i percorsi di storage su file e su Cloud attuali.
• POST CloudConnect
  /api/v1/management/cloud/connect
  Stabilisce una connessione al Cloud.
• Crea EOD
  ( GET) /api/v1/closing/{clientId}/endofdayDocument
  Crea il documento EOD locale.
• Archiviazione fine
  giornata ( POST) /api/v1/transactions/storeDocument
  Registra il documento EOD creato.

• Verifica requisiti
  di sincronizzazione GET /api/v1/cloudsync/{clientId}/isSyncRequired
  Verifica se nella coda messaggi locale sono ancora presenti file EOD.

  Possibili errori

  • EndOfDay required – Nessun documento EOD trovato; generare EOD.
  • CloudConnect required – È necessaria una chiamata a CloudConnect.
  • Files are in Message Queue (cloudTemp folder) – I file in sospeso devono essere caricati.
  • Terminal is not allowed to sync with cloud – Il client non dispone delle autorizzazioni necessarie.
  • Not implemented for country – Supportato esclusivamente per la Germania.

  Risposta

  • false – Tutti i file sono già presenti nel Cloud; non è richiesta alcuna ulteriore azione.
  • true – È necessario inviare uno o più file; procedere al passaggio successivo.

• Avviare il trasferimento sul Cloud
  POST /api/v1/cloudsync/{clientId}/startSendingToCloud
  Avvia il caricamento asincrono dei file.

  Possibili errori

  • Tutti gli errori provenienti da isSyncRequired.
  • Insufficient rights – Il client non è in grado di scrivere nell’archivio cloud.
  Nota: l’esito positivo indica che il processo di caricamento è stato avviato; non garantisce il trasferimento immediato.
• Verifica della completezza
  : ripetere la chiamata a isSyncRequired .
  • Se false: Caricamento completato.
  • Se il processo risulta ancora in corso true: attendere qualche istante e ripetere la chiamata fino a quando tutti i file non saranno stati rimossi dalla coda.

Condizioni di attivazione

Questa routine di sincronizzazione deve essere eseguita quando:

• È stata elaborata una transazione e
• l’archiviazione su file o su Cloud non era stata precedentemente abilitata (ad esempio, durante la configurazione iniziale) oppure
• un precedente tentativo di sincronizzazione è fallito e ha lasciato dei file nella coda locale.

Questo articolo è stato tradotto automaticamente.