RetailForce Cloud API

L’API RetailForce Cloud espone tutte le funzionalità del RetailForce Cloud Portal. È possibile utilizzarla per automatizzare i processi o per richiamare funzioni da sistemi esterni senza dover effettuare l’accesso al portale ed eseguire le operazioni manualmente.

Autenticazione

Per utilizzare le funzioni, il sistema richiedente deve autenticarsi presso il sistema Cloud. Di seguito viene descritta l’autenticazione manuale, oltre a esempi di chiamate guidate dagli eventi.

Accesso tramite api.RetailForce Cloud

La Cloud API è disponibile al seguente URL:

• https://api.retailforce.cloud/swagger/index.html

Autenticazione manuale

L’autenticazione avviene tramite cloudApiKey e cloudApiSecret e la generazione di un Bearer Token.

1. Endpoint di chiamata

1. Fare clic sull’endpoint POST /api/v1.0/authenticate/logon per espandere la sezione.
2. Inserisca i Suoi apiKey e apiKeySecret nei campi corrispondenti.
3. Eseguire la richiesta per ottenere un Bearer Token.

2. Utilizzo del Bearer Token

1. Copiare il token Bearer dal ResponseBody.
2. Fare clic sul pulsante "Autorizza" in alto a destra nella Swagger UI.
3. Inserisca il Bearer Token nella finestra di dialogo. Formato: Bearer <token> (inserire uno spazio dopo "Bearer").
4. Fare clic su "Autorizza"

Autenticazione automatica

L’autenticazione automatica consente ai sistemi di accedere in modo sicuro alla RetailForce Cloud API senza intervento dell’utente, soluzione ideale per servizi in background, flussi di lavoro automatizzati o query regolari sui dati.

1. Autenticazione e ricezione del token Bearer:

Inviare una richiesta POST con le proprie credenziali API all’endpoint di autenticazione.

curl -X POST "https://api.retailforce.cloud/api/v1.0/authenticate/logon" \
-H "Content-Type: multipart/form-data" \
-F "key=cloudApiKey" \
-F "secret=cloudApiSecret"

Una volta completata con successo l’autenticazione, riceverà un token Bearer nel ResponseBody, necessario per autorizzare ulteriori richieste API.

2. Accesso agli endpoint:

Utilizzi il token Bearer ricevuto per accedere agli endpoint.

Esempio:

curl -X 'GET' \
'https://api.retailforce.cloud/api/v1.0/someEndpoint' \
-H 'accept: text/plain' \
-H 'Authorization: Bearer {yourBearerToken}'

Importante: custodisca con cura le proprie credenziali API e i token per impedire accessi non autorizzati.

Fiscalizzazione cloud

Per “Fiscalizzazione cloud” si intende la fornitura del RetailForce Middleware di fiscalizzazione come servizio cloud ospitato. Il servizio è gestito da RetailForce in ambiente cloud.

È possibile accedere al servizio tramite il punto di ingresso:

Acceda al servizio tramite il seguente link:

• https://fiscalisation.retailforce.cloud/swagger/index.html

Autenticazione manuale

Sono disponibili due opzioni per l’autenticazione al servizio RetailForce Cloud Fiscalization tramite l’interfaccia utente Swagger UI:

1. Apra l’interfaccia Swagger UI e faccia clic su «Autorizza».
2. Metodi di autenticazione
   1. Credenziali del portale (e-mail e password):
      • Consente l’accesso a più organizzazioni.
   2. Chiave API e codice segreto:
      • In genere associate a un distributore o a un'organizzazione specifici.
3. Fare clic su "Autorizza"

A questo punto è autorizzato a procedere con le attività di testing e a iniziare a utilizzare la fiscalizzazione Cloud.

Questo articolo è stato tradotto automaticamente.