Questo endpoint collega un client specifico (tenant) al RetailForce Cloud e memorizza nella cache il modulo fiscale. È necessario richiamare CloudConnect prima che le transazioni vengano inviate al servizio fiscale.
La funzione deve essere eseguita almeno dopo il riavvio del registratore di cassa o dopo il riavvio del sistema su cui è installato il middleware fiscale. Tuttavia, si raccomanda l’utilizzo regolare dell’endpoint per garantire una connessione costante al sistema Cloud.
Risultato
Una chiamata riuscita all’endpoint (200)
- stabilisce la connessione tra Fiscal Client e RetailForce Cloud e
- carica il modulo fiscale nella cache.
Utilizzo
- durante la messa in servizio, dopo aver eseguito PUT /api/v1/management/clients/byCloud o PUT /api/v1/management/clients;
- regolarmente, almeno dopo ogni riavvio del sistema host.
Il comando POST /api/v1/management/cloud/connect, ad esempio, può essere eseguito prima di ogni trasmissione di transazioni.
Prerequisiti
- Fiskal Middleware installato e almeno un'operazione PUT /api/v1/management/clients/byCloud o PUT /api/v1/management/clients eseguita con esito positivo.
Campi del modulo
È necessario fornire le seguenti informazioni:
| Denominazione | Descrizione | Esempio |
| clientId |
L'uniqueClientId del registratore di cassa (dal RetailForce system). |
c1062c55-57c4-4ed2-9c53-aff1762326a4 |
| cloudApiKey |
Chiave API per l’autenticazione della comunicazione cloud |
RFC_4a2abc... |
| cloudApiSecret |
API Secret per l’autenticazione della comunicazione cloud
Attenzione:
l'API Secret deve essere sempre racchiuso tra virgolette singole, ad esempio 'ypmqt7s5UVZOyY9mDFzOeVgdpRnJ8GrOsQ'
|
ypts7u5OU... |
Risposta
Risposte possibili:
| Codice | Descrizione | Esempio |
| 200 |
La connessione al Cloud è stata stabilita con successo |
- |
| 403 |
I dati di accesso (credenziali = cloudApiKey e API Secret) non sono corretti. Risoluzione dei problemi:
|
- |
| 422 |
Il sistema locale non ha potuto individuare il clientId specificato oppure non sono stati forniti i dati di accesso. Risoluzione dei problemi:
|
- |
| 424 |
Se si desidera utilizzare l’archivio Cloud, è necessario richiamare cloud connect prima di utilizzare il modulo fiscale certificato. Risoluzione dei problemi:
|
- |
Questo articolo è stato tradotto automaticamente.
Commenti
0 commenti
Accedi per aggiungere un commento.