Durante il normale funzionamento del registratore di cassa, potrebbe essere necessario ripristinare i dati, ad esempio a causa di difetti hardware, al fine di continuare a lavorare con il sistema di registrazione.
Attenzione: in alcuni Paesi, le procedure descritte di seguito per il ripristino dei clienti del servizio di fiscalizzazione RetailForce non sono consentite a causa di normative di legge. Se il sistema di registrazione (registratori di cassa, ecc.) è difettoso, non è possibile eseguire alcun recupero dei dati; occorre invece mettere in funzione un nuovo registratore di cassa. Per ulteriori informazioni, si veda di seguito.
Ripristino tramite RetailForce Cloud
È possibile eseguire un ripristino del sistema sulla base dei dati memorizzati nel RetailForce Cloud.
Prerequisiti
- Licenza per l’archiviazione su Cloud attivata,
- licenza GetConfiguration attivata,
- opzione di archiviazione Cloud abilitata nella configurazione,
- la directory dei dati del cliente da ripristinare (ad es. sui sistemi Windows: C:\ProgramData\RetailForce\Fiscal Webservice\{clientId}) non deve esistere,
- la configurazione del client da ripristinare non deve essere presente nell’archivio di configurazione (nessuna voce per il clientId corrispondente nel file fiscalService.config.json).
Attenzione: il ripristino è possibile solo se il client era già operativo in precedenza e se sono presenti i dati necessari per l’operazione. Se si è verificato un errore durante l’avvio iniziale (prima dell’inizializzazione), anche il ripristino fallirà. In tal caso, è necessario un riavvio completo. Verifichi se i componenti hardware necessari (TSE/TSS in Germania, modulo di sicurezza in Lituania, ecc.) siano già stati inizializzati. In tal caso, potrebbe essere necessario sostituirli.
Funzionamento
Il ripristino dei dati viene eseguito richiamando gli endpoint:
-
POST /api/v1/management/clients/recovery/restoreByCloud
oppure - POST /api/v1/management/clients/recovery/restoreByCloud/ID
Nota: è possibile ripristinare esclusivamente i dati già trasferiti al RetailForce Cloud. I dati non ancora sincronizzati con il RetailForce Cloud (ad esempio, quelli presenti nella cartella \tempcloud che non sono stati ancora trasferiti a causa di un’interruzione di rete) non possono essere recuperati e potrebbero andare persi.
Importante: il ripristino del client tramite le funzioni sopra menzionate può essere eseguito con successo solo se, in passato, è stata salvata almeno una chiusura giornaliera (documento EndOfDay) per il registratore di cassa (client/terminal) in questione e trasferita nell’archivio Cloud.
Riavvio
Per poter continuare a lavorare con i nuovi registratori di cassa, è necessario conoscere l’ultimo documento elaborato dal client.
È possibile recuperarlo dall’archivio dei documenti tramite l’endpoint
- GET /api/v1/transactions/document/{clientId}/last
Tuttavia, viene recuperato solo il JSON payload che il sistema POS ha inviato al client, non la risposta (fiscalResponse).
Per richiamare anche la corrispondente fiscalResponse, è necessario utilizzare l’endpoint
- GET /api/v1/transactions/document/{clientId}/{DocumentGuid}/response
, specificando i parametri
- ClientId e
- DocumentGuid (tratti dall’oggetto JSON precedentemente restituito in seguito alla chiamata a GET /api/v1/transactions/document/{clientId}/last)
Sfruttando le informazioni contenute nei campi payload e fiscalResponse, il sistema POS può determinare il numero di documento successivo in sequenza.
Ripristino tramite dati di backup
Il servizio di fiscalizzazione di RetailForce consente di creare backup locali dei dati. Tali backup possono essere generati in qualsiasi momento richiamando l’endpoint:
- GET /api/v1/management/clients/recovery/{clientId}/backup
Ciò genera un archivio .zip contenente tutte le anagrafiche e le transazioni relative al client che erano disponibili localmente al momento della creazione del backup.
In caso di guasto del sistema (PC del registratore di cassa difettoso e da reinstallare), è possibile utilizzare un file di backup esistente per ripristinare il client in questione tramite l’endpoint
- POST /api/v1/management/clients/recovery/restore
Il dataset corrisponde esattamente a quello presente al momento della generazione del backup. Non viene effettuato alcun download di dati dal RetailForce Cloud (ad es. dati trasferiti al RetailForce Cloud dopo la creazione del file di backup).
La procedura è identica a quella prevista per il trasferimento di un FiscalClient da un nodo all’altro.
Attenzione: per evitare discrepanze nei dati tra il registratore di cassa e l’archivio di RetailForce Cloud, si raccomanda di utilizzare questa funzione solo per i sistemi offline (ad es. se è stato selezionato un pacchetto di licenze SENZA archiviazione cloud).
Riavvio
Il riavvio tramite l’importazione di un file di backup locale funziona esattamente allo stesso modo del ripristino tramite il RetailForce Cloud. Si prega tuttavia di tenere presente che, qualora per il rispettivo client sia attivata l’archiviazione dei dati fiscali nel cloud, potrebbero verificarsi discrepanze tra il file di backup e il sistema cloud.
Per verificarlo, si prega di utilizzare le funzioni di esportazione dei dati del client in questione nel RetailForce portal.
Nuova installazione
In alcuni scenari, l’unica soluzione consiste nel configurare il registratore di cassa completamente da zero, senza recupero dei dati. Anche le normative vigenti nei rispettivi paesi potrebbero richiedere una nuova installazione; ad esempio, se il modulo di sicurezza lituano (hardware) è difettoso, è necessario registrare un nuovo registratore di cassa.
La nuova installazione di un terminal/client viene eseguita secondo la procedura standard.
Paesi in cui il ripristino del client non è consentito:
- Lituania
Questo articolo è stato tradotto automaticamente.
Commenti
0 commenti
Accedi per aggiungere un commento.