In questo articolo imparerete quali passaggi è necessario eseguire dopo aver ristabilito la connessione con FiskalService.
Gli stessi passaggi devono essere eseguiti con l’integrazione .NET.;
Prerequisiti
- Il servizio fiscale è installato e l’URL è noto / l’integrazione della libreria .NET è stata completata
- Si dispone dell’accesso a RetailForce Cloud tramite cloud ApiKey/apiSecret
- Si utilizza la configurazione scaricandola dal Cloud
- Conoscete il numero UID / codice fiscale dell’organizzazione del sistema POS
- Conoscete il numero del punto vendita e del terminal
Procedura
Per minimizzare la persistenza dei dati all’interno del sistema POS, è possibile procedere come segue. È a sua discrezione memorizzare gli stati nel sistema di cassa, ma dovrà aggiornarli ripetutamente.
Verifichi innanzitutto se la configurazione del client esiste già
Una volta completato questo passaggio, riceverà l’uniqueClientId del modulo fiscale relativo al registratore di cassa richiesto. (L’uniqueClientId corrisponde al terminalId in RetailForce Cloud).
Servizio fiscale
Per verificare se la configurazione del client esiste già nel FiskalService, è necessario eseguire 2 metodi:
- GET management/clients/LicenseConsumerId
- GET management/clients/ID
Per informazioni dettagliate sulle funzionalità, si prega di fare riferimento alla documentazione Swagger del client Fiscalservice.
Integrazione .NET
Nell’ambito dell’integrazione .NET, è possibile utilizzare la classe FiscalModuleManagement e il metodo GetClients() per interrogare tutti i client disponibili nella configurazione.
Se il client non è ancora presente nella configurazione
Se il client è già presente nella configurazione e ha ricevuto un uniqueClientId, può saltare questo passaggio.
Scaricare la configurazione per il terminal dal Cloud; per le istruzioni, consultare l’articolo:
Connessione al Cloud
Servizio fiscale
Il modulo fiscale non memorizza le credenziali di accesso al Cloud (ApiKey/apiSecret). Pertanto, tali credenziali devono essere trasmesse al servizio o al modulo fiscale ogni volta che viene stabilita una nuova connessione.
I dati possono essere trasmessi mediante il seguente metodo:
Nota: se tali dati non vengono forniti, viene restituito un errore HTTP con codice HttpStatusCode 424 - FailedDependency. Se successivamente si richiama il metodo management/cloud/connect e si riprova a inviare la richiesta errata, l’operazione dovrebbe andare a buon fine.
Integrazione .NET
Nell’integrazione .NET, le credenziali per la Cloud devono essere fornite al momento della creazione del modulo fiscale (parametro del metodo CreateFiscalModuleForClient).
Si raccomanda di inizializzare e caricare il modulo fiscale all’avvio del software POS durante l’integrazione .NET, poiché in alcuni paesi è necessario eseguire passaggi di inizializzazione che richiedono un po’ più di tempo.
Per verificare se il FiskalClient è già stato inizializzato
Per verificare se l’inizializzazione di FiskalClient è già stata completata, è possibile interrogare lo stato di FiskalClient:
- GET /api/v1/information/client/{clientId}/status
- Integrazione .NET: proprietà FiscalClientStatus nel modulo fiscale
La proprietà State può assumere i seguenti valori:
- NotInitialized
- Initialized
- Disattivato
Inizializzazione del client fiscale
Se il FiskalClient è già stato inizializzato, è possibile saltare questo passaggio.
Una descrizione dettagliata delle modalità di inizializzazione è disponibile nel seguente articolo:
Conclusione
Una volta completati tali passaggi, il FiskalClient è pronto a ricevere le prime ricevute.
Questo articolo è stato tradotto automaticamente.
Commenti
0 commenti
Accedi per aggiungere un commento.