In questo articolo imparerete come implementare il FiscalClient utilizzando nuget.
Requisiti
- Conoscenza dello sviluppo .NET
- Conoscenza nell’uso dei pacchetti nuget
-
Scaricare i pacchetti
RetailForce.Fiscalisation - Piattaforma compatibile con .NET Standard 2.0
Implementazione
Provider di configurazione
Per persistere la configurazione, è necessario un FileConfigurationProvider che punti al percorso del file di configurazione e un logger:
FileConfigurationProvider fileConfigurationProvider = new FileConfigurationProvider(System.IO.Path.Combine(this.FilesDir.ToString(), "fiscalclient.config.json"), _logger);(Android).
Gestione del modulo fiscale
Per istanziare i client o caricare la configurazione dal Cloud, è necessaria la classe FiscalModuleManagement:
IClientStatusReporter clientStatusReporter = new EmptyClientStatusReporter();
FiscalModuleManagement moduleManagement = new FiscalModuleManagement(_logger, fileConfigurationProvider, clientStatusReporter);Il logger deriva da Microsoft.Extensions.Logging.ILogger.
È richiesto il reporter di stato del client (IClientStatusReporter). Se non si elaborano autonomamente i rapporti di stato, utilizzare EmptyClientStatusReporter.
Caricamento del client dal Cloud
Per caricare il client dal Cloud, è possibile utilizzare il comando CreateClientByCloud:
uniqueClientId = moduleManagement.CreateClientByCloud(new CompanyIdentification() { Identification = "ATU1234567", Type = CompanyIdentification.IdentificationType.VatNumber }, "T001", "T001", cloudApiKey, cloudApiSecret);Creare il client manualmente
Il client può essere creato anche manualmente (FiscalClient). Una volta istanziata tale classe, è possibile creare il client con CreateClient.
Creazione di un modulo fiscale
È possibile creare un modulo fiscale utilizzando la classe FiscalModuleCreator:
CloudService cloudService = new CloudService(_logger, storageBasePath, uniqueClientId.Value, cloudApiKey, cloudApiSecret);
FiscalModulCreator creator = new FiscalModulCreator(fileConfigurationProvider, _logger, cloudService, null, clientStatusReporter);In questo modo si crea il modulo fiscale. La classe CloudService deve rimanere istanziata per l’intera durata dell’esecuzione, poiché si occupa del trasferimento in background verso il cloud.
Il quarto parametro (IotService) è facoltativo e può essere impostato su null. Anche FiscalModuleCreator accetta il valore null per CloudService, ma il LocalMonitoringClient utilizzato di seguito richiede un CloudService.
Creazione del modulo fiscale
Una volta inizializzata la classe FiscalModuleCreator, è possibile creare il modulo fiscale.
Il modulo fiscale memorizza i propri dati tramite due provider di archiviazione: un FiscalDataStorageProvider per i dati fiscali e un AuditLogStorageProvider per il registro di audit. Per l’archiviazione locale, utilizzare LocalFiscalDataStorageProvider e LocalAuditLogStorageProvider. storageBasePath è la directory di base senza l’ID client (Android: this.GetExternalFilesDir(Android.OS.Environment.DirectoryDocuments).AbsolutePath); il percorso del registro di audit deve contenere l’ID client.
IMonitoringClient monitoringClient = new LocalMonitoringClient(cloudService);
FiscalDataStorageProvider storageProvider = new LocalFiscalDataStorageProvider(_logger, uniqueClientId.Value, monitoringClient, storageBasePath);
AuditLogStorageProvider auditLogStorageProvider = new LocalAuditLogStorageProvider(uniqueClientId.Value, _logger, System.IO.Path.Combine(storageBasePath, uniqueClientId.Value.ToString()));
TrustedFiscalModule fiscalModule = creator.CreateFiscalModuleForClient(uniqueClientId.Value, storageProvider, auditLogStorageProvider, cloudApiKey: cloudApiKey, cloudApiSecret: cloudApiSecret);Anche in questo caso, se non è richiesto il supporto cloud, è possibile omettere le credenziali di sicurezza cloud (cloudApiKey, cloudApiSecret).
IMPORTANTE: La configurazione del client deve essere stata creata in precedenza, scaricandola dalla Cloud oppure tramite CreateClient (vedere sopra).
Questo articolo è stato tradotto automaticamente.
Commenti
0 commenti
Accedi per aggiungere un commento.