Denna slutpunkt möjliggör återställning av en client i RetailForce Middleware med data (inklusive konfigurationsinformation) från RetailForce Cloud.
Det kan bli nödvändigt att återställa en client vid byte av kassahårdvara eller vid hårdvarufel.
Funktionen POST /api/v1/management/clients/recovery/restoreByCloud är i princip identisk med PUT /api/v1/management/clients/byCloud, men den senare kan endast utföras en gång vid den initiala driftsättningen av en klient.
Resultat
Ett lyckat anrop till slutpunkten (200):
- Laddar ned konfigurationsobjektet för den aktuella klienten på nytt från Cloud-systemet och konfigurerar klienten därefter.
- Återställer en klient som redan har tagits i drift i middlewaren och tilldelar den motsvarande uniqueClientId för terminalen från RetailForce Cloud.
Användning
Denna slutpunkt används när en client, som redan har skapats en gång och vars clientId är känt, behöver återställas (till exempel vid byte av hårdvara).
Förutsättningar
- Klienten måste ha skapats en gång och clientId bör vara känt.
- Organisationsstruktur och konfigurationsobjekt har skapats i RetailForce Cloud och tilldelats på lämpligt sätt.
- ”storeNumber” och ”terminalNumber” är kända.
- ”LicenseConsumerId” är känt.
- Fiscal Middleware är installerat.
- RestoreByCloud kan endast användas om:
- en motsvarande licens används (licenspaket som inkluderar ”Cloud Archive Access”),
- checkboxen ”Cloud Archive” är markerad i konfigurationen (Cloud),
- clienten redan har överfört data till molnarkivet (INNAN återställningen).
- I Tyskland måste minst en daglig avstängning (när som helst i det förflutna) ha registrerats i klienten och överförts till Cloud-arkivet.
Obs: restoreByCloud fungerar endast korrekt om
- middleware har installerats på nytt på systemet INNAN restoreByCloud körs,
- eller (utan ominstallation) att fiscalisationstjänsten (RetailForce-tjänsten) har startats om innan restoreByCloud körs.
Formulärfält
Följande information måste anges:
| Namn | Beskrivning | Exempel |
| LicenseConsumerId | Organisationens ID. | ID: d92254ca-d0fe-XXXX-bc3c-XXXXXX |
| storeNumber |
Numret på den filial där kassan är placerad. Måste stämma överens med den information som angetts i RetailForce Cloud. Landuppgifter:
|
|
| terminalNumber | Kassanummer. Måste stämma överens med den information som angetts i RetailForce Cloud. | 0010 |
| cloudApiKey | API-nyckel för att autentisera kommunikationen med Cloud | RFC_4a2abc... |
| cloudApiSecret | API Secret för autentisering av molnkommunikationen | ypts7u5OU... |
Svar
Möjliga svar:
| Kod | Beskrivning | Exempel |
| 200 | Klienten har återställts och konfigurerats. Svarobjektet returnerar den återställda klientens uniqueClientId. uniqueClientId måste lagras av kassasystemet och användas under hela den fortsatta kommunikationsprocessen som rör klienten. | b7cf6d59-cec4-4cc2-a647-01XXXX |
| 406 |
Typen för den angivna företagsidentifieraren är inte unik. Felhantering: Använd en av följande företagsidentifierare: [0] = VatNumber, |
- |
Den här artikeln har översatts automatiskt.
Kommentarer
0 kommentarer
logga in för att lämna en kommentar.