In diesem Artikel lernen Sie, wie Sie den FiskalClient mittels nuget implementieren.
Voraussetzungen
- Kenntnisse in der .net Entwicklung
- Kenntnisse bei der Verwendung von nuget Packages
- Download des Packages RetailForce.
Fiscalisation - Umgebungsplattform die .net Standard 2.0 unterstützt
Implementierung
Configuration-Provider
Für das Speichern der Konfiguration benötigen Sie einen FileConfigurationProvider mit dem Pfad zur Konfigurationsdatei:
FileConfigurationProvider fileConfigurationProvider = new FileConfigurationProvider(System.IO.Path.Combine(this.FilesDir.ToString(), "fiscalclient.config.json"));
(Android).
Fiskal-Modulmanagement
Um Clients anzulegen oder die Konfiguration von der Cloud zu laden benötigen Sie die Klasse FiscalModuleManagement:
FiscalModuleManagement moduleManagement = new FiscalModuleManagement(_logger, fileConfigurationProvider);
Der Logger leitet sich von Microsoft.Extensions.Logging.ILogger ab.
WICHTIG: Wir empfehlen schon sehr bald das Logging sauber zu integrieren, da aus den Log-Dateien sehr hilfreiche Informationen gelesen werden können.
Client von der Cloud laden
Um den Client aus der Cloud zu laden kann man den Befehl CreateClientByCloud verwenden:
uniqueClientId = moduleManagement.CreateClientByCloud(new CompanyIdentification() { Identification = "ATU1234567", Type = CompanyIdentification.IdentificationType.VatNumber }, "T001", "T001", cloudApiKey, cloudApiSecret);
Client händisch erstellen
Den Client kann man auch händisch erstellen (FiscalClient). Sobald diese Klasse erstellt wurde, kann der Client mit CreateClient angelegt werden.
Erstellen eines Fiskalmoduls
Ein Fiskalmodul kann man mit der Klasse FiscalModuleCreator erstellen:
CloudService cloudService = new CloudService(_logger, storageBasePath, uniqueClientId.Value, cloudApiKey, cloudApiSecret);
FiscalModulCreator creator = new FiscalModulCreator(fileConfigurationProvider, _logger, cloudService);
Damit wird das Fiskalmodul erstellt. Der CloudService ist ein Klasse, die in der Software die gesamte Laufzeit gehalten werden sollte. Dieser kümmert sich um die Hintergrundübertragung in die Cloud.
Wenn keine Cloud-Unterstützung benötigt wird, dann kann CloudService auch weggelassen werden.
Erstellen des Fiskalmoduls
Nach die Klasse FiskalmodulCreator initialisiert wurde kann das Fiskalmodul erstellt werden.
TrustedFiscalModule fiscalModule = creator.CreateFiscalModuleForClient(uniqueClientId.Value, storageBasePath: this.GetExternalFilesDir(Android.OS.Environment.DirectoryDocuments).AbsolutePath, cloudApiKey: cloudApiKey, cloudApiSecret: cloudApiSecret);
Auch hier kann, wenn keine Cloudunterstützung gefragt ist, der CloudService und die Cloud-Securables (cloudApiKey, cloudApiSecret) weggelassen werden.
WICHTIG: Die Client-Konfiguration muss vorher angelegt worden sein. Entweder durch Download aus der Cloud oder über CreateClient (siehe oben).
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.