In diesem Artikel erfahren Sie, welche Schritte sie nach einem Kassenneustart bei der Wiederverbindung mit dem FiskalService machen müssen.
Dieselben Schritte sind auch bei der .net Integration zu machen.
Voraussetzungen
- Der Fiskalservice ist installiert und die Url ist bekannt / die Integration der .net Library ist soweit abgeschlossen
- Sie haben die Zugangsberechtigung zur Retailforce Cloud mittels cloud apiKey/apiSecret
- Sie verwenden die Konfiguration mittels Download der Konfiguration aus der Cloud
- Sie wissen die UID Nummer / Steuernummer der Organisation der Kasse
- Sie wissen Filial- und Kassennummer
Vorgehensweise
Um im Kassensystem möglichst wenig an Daten speichern zu müssen, können Sie wie folgt vorgehen. Es bleibt Ihnen vorbehalten die Zustände auch im Kassensystem abzuspeichern, sie müssen diese aber dann immer wieder aktualisieren.
Feststellen ob die Client-Konfiguration überhaupt bereits vorhanden ist
Nach Durchführung dieses Schrittes erhalten Sie die uniqueClientId des Fiskalmoduls für die angefragte Kasse.
(Die uniqueClientId entspricht der TerminalId in der RetailForce Cloud).
FiskalService
Um festzustellen ob die Client-Konfiguration überhaupt bereits im FiskalService vorhanden ist, müssen Sie 2 Methoden ausführen:
- GET management/clients/licenseConsumerId
- GET maangement/clients/id
Für detaillierte Information zu den Funktionen lesen Sie bitte die Swagger-Dokumentation des Fiskalservice Clients.
.net Integration
Bei der .net Integration können Sie über die Klasse FiscalModuleManagement und der Methode GetClients() alle in der Konfiguration verfügbaren Clients abfragen.
Client ist noch nicht in der Konfiguration vorhanden
Wenn der Client bereits in der Konfiguration vorhanden ist und Sie eine uniqueClientId erhalten haben, können Sie diesen Schritt überspringen.
Laden Sie die Konfiguration für das Terminal aus der Cloud herunter, eine Anleitung dazu finden Sie im Artikel:
Verbindung mit der Cloud herstellen
FiskalService
Das Fiskalmodul speichert die Zugangsdaten zur Cloud (apiKey/apiSecret) nicht. Daher sind diese Zugangsdaten jedes mal bei Neuverbindung zum Service / Fiskalmodul zu übergeben.
Die Daten können mittels folgender Methode übergeben werden:
Information: Werden diese Daten nicht mitgegeben wird eine HTTP Fehler mit HttpStatusCode 424 - FailedDependency zurückgegeben. Wird dann die Methode management/cloud/connect aufgerufen und der fehlerhafte Request wieder probiert sollte dieser funktionieren.
.net Integration
Bei der .net Integration sind die Anmeldedaten für die Cloud beim Erstellen des Fiskalmoduls zu übergeben (Parameter der Methode CreateFiscalModuleForClient.
Es empfiehlt sich bei der .net Integration das Fiskalmodul beim Start der Kassensoftware zu initialisieren und zu laden, da teilweise in manchen Ländern Initialisierungsschritte durchzuführen sind, die etwas länger dauern.
Abfragen ob der FiskalClient bereits initialisiert ist
Um festzustellen ob die Initialisierung des FiskalClients bereits erfolgt ist können Sie den Status des FiskalClients abfragen:
- GET /api/v1/information/client/{clientId}/status
- .net Integration: Property FiscalClientStatus am Fiskalmodul.
Die Eigenschaft State kann folgende Werte annehmen:
- NotInitialized - nicht initialisiert
- Initialized - initialisiert
- Decommissioned - außer Betrieb genommen
Initialisierung des FiskalClient
Wenn der FiskalClient bereits initialisiert ist (Initialized), dann können Sie diesen Schritt überspringen.
Eine Beschreibung wie die Initialisierung zu erfolgen hat finden Sie im folgenden Artikel:
Abschluss
Nach Durchführung der vorherigen Schritte ist der FiskalClient bereit um erste Belege zu erhalten.
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.