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/ID er i det væsentlige identisk med PUT /api/v1/management/clients/byCloud, men sidstnævnte kan kun udføres én gang under den indledende idriftsættelse af en client.
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 et skift af hardware).
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.
- Fiscal Middleware skal være 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),
- clienten allerede har overført data til cloudarkivet (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 fiskaliseringstjenesten (RetailForce-tjenesten) er blevet genstartet, før restoreByCloud køres.
Formularfelter
Følgende oplysninger skal overføres:
| Navn | Beskrivelse | Eksempler |
| Type |
Type af virksomhedsidentifikation. Typen skal også indtastes og findes i RetailForce Cloud. Følgende typer er tilgængelige: [0] = VatNumber, Se også: Virksomhedsidentifikation Vi anbefaler at bruge type [0] = VatNumber som primær ID i alle lande (EU), selvom det ikke anvendes som obligatorisk virksomhedsidentifikator i det pågældende land. |
[0] = VatNumber |
| Identifikation | Selve virksomhedsidentifikatoren. Den skal stemme overens med de oplysninger, der er indtastet i RetailForce Cloud. | ATU57780814 |
| storeNumber |
Nummeret på den butik, hvor kasseapparatet er placeret. Det skal stemme overens med de oplysninger, der er indtastet i RetailForce Cloud.
BEMÆRK:
I Frankrig skal SIRET-nummeret (en udvidelse af SIREN-nummeret med butiksnummeret) angives her.
|
|
| terminalNumber | Kasseapparatnummer. Det skal stemme overens med de oplysninger, der blev indtastet i RetailForce Cloud. | 0010 |
| cloudApiKey | API-nøgle til godkendelse af Cloud-kommunikationen | RFC_4a2abc... |
| cloudApiSecret | API Secret til godkendelse af cloud-kommunikation | ypts7u5OU... |
Svar
Mulige svar:
| Kode | Beskrivelse | Eksempel |
| 200 | Klienten blev gendannet og konfigureret uden problemer. 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.