Dieser Endpunkt stellt die Verbindung eines bestimmten Mandant (Client) zur RetailForce Cloud her und lädt das Fiskalmodul in den Cache. CloudConnect sollte aufgerufen werden, bevor Transaktionen an den Fiskaldienst übermittelt werden.
Die Funktion muss mindestens nach einem Kassenneustart ausgeführt werden, bzw. nach einem Neustart des Systems, auf dem die Fiskal Middleware installiert ist. Wir empfehlen allerdings einen regelmäßigen Einsatz des Endpunktes, um eine ständige Verbindung zum Cloud-System zu gewährleisten.
Ergebnis
Ein erfolgreicher Aufruf des Endpunktes (200)
- stellt die Verbindung zwischen Fiskal Client und RetailForce Cloud her und
- lädt das das Fiskalmodul in den Cache.
Verwendung
- im Rahmen der Inbetriebnahmen, nach PUT /api/v1/management/clients/byCloud, bzw. PUT /api/v1/management/clients;
- regelmäßig, mindestens nach jedem Neustart des Host-Systems.
POST /api/v1/management/cloud/connect kann beispielsweise vor jeder Transaktionsübermittlung ausgeführt werden.
Voraussetzungen
- Fiskal Middleware installiert und mindestens PUT /api/v1/management/clients/byCloud, bzw. PUT /api/v1/management/clients erfolgreich durchgeführt.
Formularfelder
Folgende Informationen müssen übermittelt werden:
| Bezeichnung | Beschreibung | Beispiele |
| clientId |
Die uniqueClientId der Registrierkasse (aus RetailForce System) |
c1062c55-57c4-4ed2-9c53-aff1762326a4 |
| cloudApiKey |
API Key um die Cloud-Kommunikation zu authentisieren |
RFC_4a2abc... |
| cloudApiSecret |
API Secret zur Authentisierung der Cloud-Kommunikation Achtung: API secret muss immer unter einfachen Anführungszeichen gesetzt werden, z.B. 'ypmqt7s5UVZOyY9mDFzOeVgdpRnJ8GrOsQ'
|
ypts7u5OU... |
Antwort
Mögliche Antworten:
| Code | Beschreibung | Beispiel |
| 200 |
Cloudverbindung wurde erfolgreiche hergestellt |
- |
| 403 |
Zugangsdaten (Credentials = cloudApiKey und API secret) sind falsch Fehlerbehebung:
|
- |
| 422 |
Die angegebene clientId konnte im lokalen System nicht gefunden werden oder Zugangsdaten wurden nicht angegeben Fehlerbehebung:
|
- |
| 424 |
Wenn du das Cloud-Archiv nutzen möchtest, musst du eine Cloud-Verbindung herstellen, bevor du das vertrauenswürdige Fiskalmodul verwendest. Fehlerbehebung:
|
- |
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.