Neste artigo, irá aprender a implementar o FiscalClient utilizando o nuget.
Requisitos
- Conhecimentos de desenvolvimento em .NET
- Conhecimentos na utilização de pacotes nuget
-
Descarregue os pacotes
RetailForce.Fiscalização - Plataforma de ambiente compatível com .NET Standard 2.0
Implementação
Provedor de configuração
Para guardar a configuração, necessita de um FileConfigurationProvider com o caminho para o ficheiro de configuração e um registador:
FileConfigurationProvider fileConfigurationProvider = new FileConfigurationProvider(System.IO.Path.Combine(this.FilesDir.ToString(), "fiscalclient.config.json"), _logger);(Android).
Gestão do módulo fiscal
Para criar clientes ou carregar a configuração a partir da Cloud, necessita da classe FiscalModuleManagement:
IClientStatusReporter clientStatusReporter = new EmptyClientStatusReporter();
FiscalModuleManagement moduleManagement = new FiscalModuleManagement(_logger, fileConfigurationProvider, clientStatusReporter);O registador deriva de Microsoft.Extensions.Logging.ILogger.
O relator de estado do cliente (IClientStatusReporter) é obrigatório. Caso não processe os relatórios de estado por conta própria, utilize o EmptyClientStatusReporter.
Carregar o client a partir da Cloud
Para carregar o client a partir da Cloud, pode utilizar o comando CreateClientByCloud:
uniqueClientId = moduleManagement.CreateClientByCloud(new CompanyIdentification() { Identification = "ATU1234567", Type = CompanyIdentification.IdentificationType.VatNumber }, "T001", "T001", cloudApiKey, cloudApiSecret);Criar client manualmente
O client também pode ser criado manualmente (FiscalClient). Depois de criada esta classe, o client pode ser criado com CreateClient.
Criar um módulo fiscal
É possível criar um módulo fiscal com a classe FiscalModuleCreator:
CloudService cloudService = new CloudService(_logger, storageBasePath, uniqueClientId.Value, cloudApiKey, cloudApiSecret);
FiscalModulCreator creator = new FiscalModulCreator(fileConfigurationProvider, _logger, cloudService, null, clientStatusReporter);Isto cria o módulo fiscal. O CloudService é uma classe que deve ser mantida no software durante todo o tempo de execução. É responsável pela transferência em segundo plano para a nuvem.
O quarto parâmetro (IotService) é opcional e pode ser definido como null. O FiscalModuleCreator também aceita o valor null para o CloudService, mas o LocalMonitoringClient utilizado abaixo requer um CloudService.
Criação do módulo fiscal
Após a inicialização da classe FiscalModuleCreator, o módulo fiscal pode ser criado.
O módulo fiscal armazena os seus dados através de dois fornecedores de armazenamento: um FiscalDataStorageProvider para os dados fiscais e um AuditLogStorageProvider para o registo de auditoria. Para o armazenamento local, utilize o LocalFiscalDataStorageProvider e o LocalAuditLogStorageProvider. O storageBasePath é o diretório base sem o ID do cliente (Android: this.GetExternalFilesDir(Android.OS.Environment.DirectoryDocuments).AbsolutePath); o caminho para o registo de auditoria deve conter o ID do cliente.
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);Também neste caso, se o suporte à nuvem não for necessário, os elementos de segurança da nuvem (cloudApiKey, cloudApiSecret) podem ser omitidos.
IMPORTANTE: A configuração do client deve ter sido criada previamente. Quer seja através do download da Cloud, quer através de CreateClient (ver acima).
Este artigo foi traduzido automaticamente.
Comentários
0 comentários
iniciar sessão para comentar.