Tento koncový bod umožňuje obnovenie klienta v prostredí RetailForce Middleware s údajmi (vrátane konfiguračných informácií) z RetailForce Cloud.
Obnovenie klienta môže byť potrebné v prípade výmeny hardvéru pokladnice alebo v prípade poruchy hardvéru.
Funkcia POST /api/v1/management/clients/recovery/restoreByCloud je v podstate identická s funkciou PUT /api/v1/management/clients/byCloud, avšak táto funkcia sa môže vykonať len raz pri počiatočnom uvedení klienta do prevádzky.
Výsledok
Úspešné volanie koncového bodu (200):
- Znovu stiahne konfiguračný objekt pre príslušného klienta z Cloud systému a klienta podľa toho nakonfiguruje.
- Obnoví klienta, ktorý už bol uvedený do prevádzky v middleware, a priradí mu príslušné uniqueClientId terminálu z RetailForce Cloud.
Použitie
Tento koncový bod sa používa v prípade, ak je potrebné obnoviť klienta, ktorý už bol raz vytvorený a ktorého clientId je známy (napríklad v prípade výmeny hardvéru).
Predpoklady
- Klient musí byť už raz vytvorený a clientId by malo byť známe.
- Organizačná štruktúra a konfiguračný objekt boli vytvorené v RetailForce Cloud a príslušne priradené.
- Hodnoty „storeNumber“ a „terminalNumber“ sú známe.
- Je známe „LicenseConsumerId“.
- Je nainštalovaný Fiscal middleware.
- Funkcia „restoreByCloud“ sa dá použiť len vtedy, ak:
- sa používa príslušná licencia (licenčný balík, ktorý obsahuje „Cloud Archive Access“),
- je v konfigurácii (Cloud) zaškrtnutá checkbox „Cloud Archive“,
- client už preniesol údaje do cloudového archívu (PRED obnovením).
- V Nemecku musí byť v clientskom systéme zaznamenané a prenesené do cloudového archívu aspoň jedno denné uzávierkové vyúčtovanie (z akéhokoľvek obdobia v minulosti).
Poznámka: Funkcia restoreByCloud bude fungovať správne len vtedy, ak
- middleware nanovo nainštalovaný v systéme PRED spustením funkcie restoreByCloud,
- alebo (bez preinštalovania) bola pred spustením funkcie restoreByCloud reštartovaná služba fiskalizácie (služba RetailForce).
Pole formulára
Je potrebné zadať nasledujúce informácie:
| Meno | Popis | Príklady |
| LicenseConsumerId | ID organizácie. | ID: d92254ca-d0fe-XXXX-bc3c-XXXXXX |
| storeNumber |
Číslo pobočky, v ktorej sa nachádza pokladňa. Musí zodpovedať informáciám zadaným v RetailForce Cloud. Údaje o krajine:
|
|
| terminalNumber | Číslo pokladnice. Musí zodpovedať informáciám zadaným v RetailForce Cloud. | 0010 |
| cloudApiKey | Kľúč API na overenie komunikácie s Cloudom | RFC_4a2abc... |
| cloudApiSecret | API Secret na overenie komunikácie s Cloudom | ypts7u5OU... |
Odpoveď
Možné odpovede:
| Kód | Popis | Príklad |
| 200 | Klient bol úspešne obnovený a nakonfigurovaný. Objekt odpovede vráti uniqueClientId obnoveného klienta. uniqueClientId musí byť uložený v pokladničnom systéme a použitý pre celý ďalší proces komunikácie týkajúci sa klienta. | b7cf6d59-cec4-4cc2-a647-01XXXX |
| 406 |
Typ poskytnutého identifikátora spoločnosti nie je jedinečný. Riešenie chyby: Použite jeden z nasledujúcich identifikátorov spoločnosti: [0] = VatNumber, |
- |
Tento článok bol preložený automaticky.
Príspevky
0 komentárov
Ak chcete napísať komentár, prihlásiť sa.