Während des regelmäßigen Kassenbetriebes, kann es vorkommen, dass es notwendig ist Daten wiederherzustellen, etwas aufgrund von Hardware-Defekten, um mit dem Aufzeichnungssystem weiterarbeiten zu können.
Achtung: in manchen Ländern sind die unten beschriebenen Prozesse zur Wiederherstellung von Clients des RetailForce Fiskalisierungs-Services, aufgrund von gesetzlicher Regelungen nicht erlaubt. Ist das Aufzeichnungssystem (Registrierkassen,...) defekt, darf keine Datenwiederherstellung erfolgen, sondern es muss ein neue Kasse in Betrieb genommen werden. Weitere Informationen siehe weiter unten.
Wiederherstellung über RetailForce Cloud
Eine Systemwiederherstellung kann auf Basis der in der RetailForce Cloud gespeicherten Daten erfolgen.
Voraussetzungen
- Lizenz für Cloud Archivierung aktiviert,
- Lizenz GetConfiguration aktiviert,
- Cloud Archive - Option in der Konfiguration aktiviert,
- Datenverzeichnis des wiederherzustellenden Clients (z.B. auf Windows-Systemen: C:\ProgramData\RetailForce\Fiscal Webservice\{clientId} darf nicht vorhanden sein,
- Konfiguration des wiederherzustellenden Clients darf nicht im Config-Store enthalten sein (kein Eintrag zur entsprechenden ClientId in fiscalService.config.json).
Achtung: eine Wiederherstellung kann nur dann erfolgen, wenn der entsprechende Client bereits zu einem früheren Zeitpunkt in Betrieb war, d.h. Daten für eine Wiederherstellung vorhanden sind. Sollte bei der Erstinbetriebnahme (vor der Initialisierung) ein Fehler aufgetreten sein, schlägt auch eine Wiederherstellung fehl! In diesem Fall ist nur eine vollständige Neuinbetriebnahme möglich. Prüfen Sie, ob benötigte Hardwarekomponenten (TSE in DE, Sicherheitsmodul in LT, u.a.) bereits initialisiert wurden. Ist dies der Fall müssen diese u.U. getauscht werden!
Wiederherstellungsfunktion
Eine Datenwiederherstellung erfolgt durch Aufruf der Endpunkte:
-
POST /api/v1/management/clients/recovery/restoreByCloud
oder - POST /api/v1/management/clients/recovery/restoreByCloud/id
Hinweis: Es können nur jede Daten wiederhergestelltwerden, welche bereits an die RetailForce Cloud übertragen wurden. Daten, welche nicht an das Cloud-System übertragen wurden (Daten, welche sich im \tempcloud-Ordner befanden und z.B. aufgrund einer Netzwerkunterbrechung noch nicht an die Cloud übertragen wurden, können nicht wiederhergestellt werden und sind ggf. verloren.
Wichtig: eine Client-Wiederherstellung, über die oben genannten Funktionen, kann nur dann erfolgreich durchgeführt werden, wenn bei der betreffenden Kasse (Client / Terminal) in der Vergangenheit mindestens ein Tagesabschluss (EndOfDay Dokument) gespeichert und an das Cloud-Archiv übertragen wurde.
Wiederanlauf
Um mit der Neuen Registrierkassen weiterarbeiten zu können, ist es notwendig, das zuletzt durch den Client verarbeitete Dokument zu kennen.
Dieses kann über den Endpunkt
- GET /api/v1/transactions/document/{clientId}/last
aus dem Dokumenten-Speicher abgerufen werden. Dabei wird allerdding lediglich der JSON Payload, welchen das Kassensystem an den Client gesendet hat, abgerufen und nicht die Response (fiscalResponse).
Um auch die entsprechende fiscalResponse anzurufen, muss der Endpunkt
- GET /api/v1/transactions/document/{clientId}/{documentGuid}/response
unter Angabe der Parameter
- ClientId und
- documentGuid (aus dem JSON Objekt, welches zuvor bei Aufruf von GET /api/v1/transactions/document/{clientId}/last zurückgegeben wurde)
verwendet werden.
Über die in Payload sowie fiscalResponse enthaltenen Informationen, sollte es dem Kassensystem möglich sein, mit der nächsten Dokumentennummer in Folge fortzusetzen.
Wiederherstellung über Backup-Daten
Das RetailForce Fiskalisierungs-Service erlaubt die Erstellung von lokalen Daten-Backups. Diese können jederzeit über den Aufruf des Endpunktes:
- GET /api/v1/management/clients/recovery/{clientId}/backup
erzeugt werden.
Dabei wird eine zip-Datei mit sämtlichen, zum Zeitpunkt der Backup-Erstellung lokal (!) vorhandenen, Stamm- und Bewegungsdaten, den entsprechenden Client betreffend, erzeugt.
Im Falle eines Systemausfalls (Kassen-PC defekt und muss neu aufgesetzt werden), kann eine vorhandene Backup-Datei mithilfe des Endpunktes
- POST /api/v1/management/clients/recovery/restore
den jeweiligen Client wiederherstellen. Der Datenbestand entspricht natürlich jedem der Backup-Erzeugung. Es erfolgt kein Herunterladen von Daten aus der RetailForce Cloud (z.B. jene welche nach Erstellung der Backup-Datei an die RetailForce Cloud übertragen wurden).
Der Ablauf ist dabei identisch wie beim Verschieben eines FiskalClients von einem Rechner auf einen anderen.
Achtung: um Datenschiefstände zwischen der Registrierkasse und dem RetailForce Cloud-Archiv zu vermeiden, empfehlen wir, diese Funktion nur für Offline-Systeme (z.B. wenn ein Lizenz-Paket OHNE Cloud-Archivierung gewählt wurde).
Wiederanlauf
Der Wiederanlauf, beim Einspielen einer lokalen Backup-Datei, funktioniert identisch zur Wiederherstellung über die RetailForce Cloud. Beachten Sie allerdings hierbei, sofern beim jeweiligen Client eine Cloud-Archivierung der Fiskaldaten aktiviert ist, dass ggf. ein Datenschiefstand zwischen Backup-Datei und Cloud-System vorhanden sein kann.
Um dies zu prüfen, nutzen Sie die Datenexport-Funktionen des jeweiligen Clients im RetailForce Portal.
Neuanlage
In manchen Fällen ist der einzige Ausweg, die Kasse vollkommen neu, ohne Datenwiederherstellung, aufzusetzen. Auch können rechtliche Bestimmungen in den jeweiligen Ländern, eine Neuanlage erforderlich machen, z.B. wenn das litauische Sicherheitsmodul (Hardware) defekt ist, ist eine Neuregistrierung einer neue Kasse erforderlich.
Die Neuanlage eines Terminals / Clients erfolgt nach dem bekannten Schema.
Ländern in denen eine Client-Wiederherstellung nicht erlaubt sind:
- Litauen
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.