Il trasferimento delle ricevute digitali può avvenire tramite i metodi del modulo client fiscale (dll/servizio) oppure direttamente tramite RetailForce Cloud.
Prerequisiti
Per utilizzare la comunicazione diretta con il RetailForce Cloud, è necessario disporre dei seguenti prerequisiti e delle relative competenze tecniche.
- È necessario disporre di un account distributore e delle relative chiave API e API Secret del distributore
- È necessario possedere conoscenze relative alle chiamate ai servizi web JSON/REST (HTTP)
- È necessario possedere conoscenze relative all’autenticazione JWT Bearer (utilizzata)
- È necessario creare un terminal in Retailforce Cloud e assegnargli la licenza appropriata (DigitalReceipt/DigitalReceiptLight).
È possibile trovare informazioni sull’autenticazione JWT Bearer qui:
Trasferimento della ricevuta digitale
Per trasferire una ricevuta digitale è necessario richiamare i seguenti metodi nell’ordine indicato:

Metodi:
-
https://api.retailforce.cloud/api/v1.0/authenticate/logon
(POST)
key: parametro
FORM secret: parametro FORM -
https://api.retailforce.cloud/api/v1.0/licensing/token
(GET)
uniqueClientId: parametro
QUERY accessLicenseId: parametro QUERY -
https://functions.retailforce.cloud/api/digitalReceipt
(POST)
uniqueClientId: parametro QUERY/FORM (entrambi possibili)
licenseToken: parametro QUERY/FORM (entrambi possibili)
file: parametro FORM (contenuto)
Nota: è possibile inviare lo stesso nome di file più di una volta per lo stesso sistema POS (uniqueClientId).
Per informazioni dettagliate sulle funzioni disponibili all’indirizzo https://api.retailforce.cloud, si prega di consultare il seguente link: https://api.retailforce.cloud/swagger.
Importante: non è necessario eseguire l’intero flusso ogni volta. Il token di licenza acquisito tramite la funzione licensing/token (GET) rimane valido per 30 giorni. È possibile utilizzare jwt/decode sul lato client per verificare la validità del token di licenza.
NOTA: se la funzione licensing/token viene richiamata con troppa frequenza, verrà bloccata. Pertanto, utilizzarla esclusivamente come descritto sopra.
NOTA: se la funzione licensing/token viene richiamata con troppa frequenza, verrà bloccata. Pertanto, utilizzarla esclusivamente come descritto sopra.
Questo articolo è stato tradotto automaticamente.
Commenti
0 commenti
Accedi per aggiungere un commento.