Dette endpoint muliggør gendannelse af en client i RetailForce Middleware med data (herunder konfigurationsoplysninger) fra RetailForce Cloud.
Det kan være nødvendigt at gendanne en client i tilfælde af udskiftning af kasseapparatets hardware eller hardwarefejl.
Funktionen POST /api/v1/management/clients/recovery/restoreByCloud er i det væsentlige identisk med PUT /api/v1/management/clients/byCloud, men sidstnævnte kan kun udføres én gang ved den indledende idriftsættelse af en klient.
Resultat
Et vellykket opkald til endpointet (200):
- Genindlæser konfigurationsobjektet for den pågældende client fra Cloud-systemet og konfigurerer klienten i overensstemmelse hermed.
- Gendanner en klient, der allerede er taget i brug i middlewaren, og tildeler den det tilsvarende uniqueClientId for terminalen fra RetailForce Cloud.
Anvendelse
Dette endpoint bruges, når en client, der allerede er oprettet én gang, og hvis clientId er kendt, skal gendannes (f.eks. i tilfælde af hardwareudskiftning).
Forudsætninger
- Clients skal være oprettet én gang, og clientId'et skal være kendt.
- Organisationsstrukturen og konfigurationsobjektet er oprettet i RetailForce Cloud og tildelt i overensstemmelse hermed.
- 'storeNumber' og 'terminalNumber' er kendt.
- 'LicenseConsumerId' er kendt.
- Fiscal Middleware er installeret.
- RestoreByCloud kan kun bruges, hvis:
- der anvendes en tilsvarende licens (licenspakke, der inkluderer 'Cloud Archive Access'),
- checkboxen 'Cloud Archive' er markeret i konfigurationen (Cloud),
- the client already transferred data to the cloud archive (FØR gendannelsen).
- I Tyskland skal der være registreret mindst én daglig afslutning (på et hvilket som helst tidspunkt i fortiden) i clienten og overført til Cloud-arkivet.
Bemærk: restoreByCloud fungerer kun korrekt, hvis
- middleware er blevet nyinstalleret på systemet, FØR restoreByCloud køres,
- eller (uden geninstallation) at fiscalisationstjenesten (RetailForce-tjenesten) er blevet genstartet, før restoreByCloud køres.
Formularfelter
Følgende oplysninger skal indtastes:
| Navn | Beskrivelse | Eksempler |
| LicenseConsumerId | Organisationens ID. | ID: d92254ca-d0fe-XXXX-bc3c-XXXXXX |
| storeNumber |
Nummeret på den filial, hvor kasseapparatet er placeret. Skal stemme overens med de oplysninger, der er indtastet i RetailForce Cloud. Landespecifikke oplysninger:
|
|
| terminalNumber | Kasseapparatnummer. Skal stemme overens med de oplysninger, der er indtastet i RetailForce Cloud. | 0010 |
| cloudApiKey | API-nøgle til godkendelse af kommunikationen med Cloud | RFC_4a2abc... |
| cloudApiSecret | API Secret til autentificering af cloud-kommunikation | ypts7u5OU... |
Svar
Mulige svar:
| Kode | Beskrivelse | Eksempel |
| 200 | Klienten er blevet gendannet og konfigureret. Svarobjektet returnerer den gendannede klients uniqueClientId. uniqueClientId skal gemmes af kassesystemet og anvendes i hele den videre kommunikationsproces vedrørende klienten. | b7cf6d59-cec4-4cc2-a647-01XXXX |
| 406 |
Den angivne virksomhedsidentifikator er ikke en unik type. Fejlhåndtering: Brug en af følgende virksomhedsidentifikatorer: [0] = VatNumber, |
- |
Denne artikel er oversat automatisk.
Kommentarer
0 kommentarer
Log ind for at kommentere.