Questo endpoint consente il ripristino di un client nel RetailForce Middleware, con i dati (comprese le informazioni di configurazione) provenienti dal RetailForce Cloud.
Il recupero del client può essere necessario in caso di sostituzione dell’hardware del registratore di cassa o di difetti hardware.
La funzione POST /api/v1/management/clients/recovery/restoreByCloud è sostanzialmente identica a PUT /api/v1/management/clients/byCloud, ma quest’ultima può essere eseguita una sola volta al momento della messa in servizio iniziale di un client.
Risultato
Una chiamata riuscita all’endpoint (200):
- Ricarica l’oggetto di configurazione del client dal sistema Cloud e applica la configurazione.
- Ripristina un client già messo in funzione nel middleware e gli assegna il corrispondente uniqueClientId del terminal proveniente dal RetailForce Cloud.
Utilizzo
Questo endpoint viene invocato quando è necessario ripristinare un client già provisionato in precedenza e di cui si conosce il clientId (ad esempio, in caso di sostituzione dell’hardware).
Prerequisiti
- Il client deve essere stato creato in precedenza e il ClientId deve essere noto.
- La struttura organizzativa e l’oggetto di configurazione sono stati creati in RetailForce Cloud e assegnati di conseguenza.
- I valori di «storeNumber» e «terminalNumber» sono noti.
- Il "LicenseConsumerId" è noto.
- Il middleware fiscale è installato.
- RestoreByCloud può essere utilizzato solo se:
- venga utilizzata una licenza corrispondente (pacchetto di licenze che includa «Cloud Archive Access»),
- la casella di controllo «Cloud Archive» sia abilitata nella configurazione (Cloud),
- il client abbia già trasferito i dati nell’archivio Cloud (PRIMA del ripristino).
- In Germania, nel client deve essere stata registrata almeno una chiusura giornaliera (in qualsiasi momento nel passato) e trasferita all’archivio Cloud.
Nota: restoreByCloud funzionerà correttamente solo se
- il middleware sia stato installato ex novo sul sistema PRIMA di eseguire restoreByCloud,
- oppure, in assenza di reinstallazione, il servizio di fiscalizzazione (servizio RetailForce) sia stato riavviato prima di eseguire restoreByCloud.
Campi del modulo
È necessario fornire le seguenti informazioni:
| Nome | Descrizione | Esempi |
| LicenseConsumerId | L'ID dell'organizzazione. | ID: d92254ca-d0fe-XXXX-bc3c-XXXXXX |
| storeNumber |
Il numero della filiale in cui è installato il punto cassa. Deve corrispondere alle informazioni registrate in RetailForce Cloud. Dettagli sul Paese:
|
|
| terminalNumber | Numero del registratore di cassa. Deve corrispondere alle informazioni inserite in RetailForce Cloud. | 0010 |
| cloudApiKey | Chiave API per l’autenticazione della comunicazione con il Cloud | RFC_4a2abc... |
| cloudApiSecret | API Secret per l’autenticazione della comunicazione con il Cloud | ypts7u5OU... |
Risposta
Possibili risposte:
| Codice | Descrizione | Esempio |
| 200 | Il cliente è stato ripristinato e configurato con successo. L’oggetto di risposta restituisce l’uniqueClientId del cliente ripristinato. L’uniqueClientId deve essere memorizzato dal sistema di cassa e utilizzato per l’intero processo di comunicazione successivo relativo al cliente. | b7cf6d59-cec4-4cc2-a647-01XXXX |
| 406 |
Il tipo dell’identificativo aziendale fornito non è univoco. Gestione degli errori: Utilizzare uno dei seguenti identificativi aziendali: [0] = VatNumber, |
- |
Questo articolo è stato tradotto automaticamente.
Commenti
0 commenti
Accedi per aggiungere un commento.