Zertifikatstausch Dänemark

Dieser Artikel beschreibt die durchzuführenden Schritte, wenn ein OCES3-Zertifikat, welches in Dänemark zur Signierung von Dokumenten verwendet wird, abläuft und ersetzt werden muss.

Die Vorgehensweise unterscheidet sich für Systeme, die mit einer Client-Version vor 1.11.23 in Betriebe genommen (initialisiert) wurden, und für jene, bei denen im Rahmen des Initialisierungsprozesses bereits Version 1.11.23 oder höher verwendet wurde.

Zertifikatswechsel für Systeme < 1.11.23

Ausgangssituation:

• Der Fiscal Client wurde mit einer Version < 1.11.23 initialisiert.
• Das OCES3-Zertifikat muss aktualisiert werden (da die Gültigkeit bald abläuft)

Voraussetzungen:

• neues OCES3-Zertifikat vorhanden
• lokale Installation des Fiscalisation Service

Vorgehensweise zum Ändern des Zertifikats:

1. Das neue OCES3-Zertifikat muss in das RetailForce Cloud Portal hochgeladen werden (siehe Upload Fiskalisierungs-Zertifikate)
   1. Für das neue Zertifikat ist im Feld 'Certificate Name' der Name 'DKSignCertificate' zu hinterlegen.
   2. Das alte 'Default'-Zertifikat bleibt unverändert (löschen Sie es bitte nicht); ein Löschen sollte grundsätzlich nicht möglich sein, da das Zertifikat auf 'schreibgeschützt' gesetzt wurde.
   3. Falls noch kein neues Zertifikat verfügbar ist, aber bereits Version 1.11.23 oder höher installiert wurde, laden Sie das alte (ablaufende) Zertifikat ein zweites Mal unter Angabe des 'Certificate Name' 'DKSignCertificate' hoch. Der Austausch von Zertifikaten in den Versionen 1.11.23 oder höher wird im nachfolgenden Kapitel beschrieben.
2. Aktualisieren Sie den Fiskalisierungsdienst (Fiscalisation Service) auf der Registrierkasse auf eine neuere Version (1.11.23 oder höher).
3. Sobald der jeweilige Client eine Verbindung zur RetailForce Cloud herstellt (POST /api/v1/management/cloud/connect), lädt der IoT-Service des Clients automatisch das neue Zertifikat herunter.
   1. Sowohl das alte 'Default' als auch das neue 'DKSignCertificate' sollten nun im Client-Verzeichnis vorhanden sein (z.B. Windows: C:\ProgramData\RetailForce\Fiscal Webservice\{clientId}\certificates).
   2. Falls das Zertifikat nicht automatisch heruntergeladen wurde, überprüfen Sie bitte die Firewall-Einstellungen – der Port 8883 für den IoT-Dienst muss offen sein. Weitere Informationen finden Sie unter Notwendige Ports und Adressfreigaben.
4. Nachdem das Zertifikat vom Client erfolgreich heruntergeladen wurde, kann der reguläre Kassenbetrieb fortgesetzt werden.

Zertifikatswechsel für Systeme ab Version 1.11.23

Ausgangssituation:

• Der Fiscal Client wurde mit Version 1.11.23 oder höher initialisiert ODER
• Der Fiscal Client wurde ursprünglich mit einer Version < 1.11.23 initialisiert, jedoch bereits auf 1.11.23 (>) aktualisiert und verwendet noch ein altes Zertifikat (der Zertifikatsname ist jedoch bereits auf 'DKSignCertificate' gesetzt)
• Das OCES3-Zertifikat muss aktualisiert werden (da die Gültigkeit bald abläuft)

Voraussetzungen:

• neues OCES3-Zertifikat vorhanden
• lokale Installation des Fiscalisation Service

Vorgehensweise zum Ändern des Zertifikats:

1. Löschen Sie das ALTE (ablaufende) Zertifikat mit dem Namen 'DKSignCertificate' im Cloud-Portal,
2. laden Sie das neue Zertifikat hoch und geben Sie als 'Certificate Name' ebenfalls 'DKSignCertificate' ein,
3. stellen Sie die Verbindung zwischen dem Client und der RetailForce Cloud her (POST /api/v1/management/cloud/connect),
4. anschließend sollte das Zertifikat im lokalen Client automatisch aktualisiert werden.

Nutzung des Cloud-Fiskalisierungsservices

Manuelles Aktualisieren des Zertifikats

Falls der automatische Tausch des Zertifikats nicht erfolgreich war, können Sie diesen auch vom lokalen Client aus auslösen.

Zu diesem Zweck kann der Endpunkt PUT /api/v1/management/clients/{clientId}/certificate verwendet werden.

Bitte beachten Sie, dass der Parameter 'certificateName' des Endpunkts mit dem im RetailForce Cloud Portal eingegebenen 'Certificate Name' ('DKSignCertificate') übereinstimmen muss.